/AWS1/IF_DRS=>STARTFAILBACKLAUNCH()

About StartFailbackLaunch

Initiates a Job for launching the machine that is being failed back to from the specified Recovery Instance. This will run conversion on the failback client and will reboot your machine, thus completing the failback process.

Method Signature

METHODS /AWS1/IF_DRS~STARTFAILBACKLAUNCH
  IMPORTING
    !IT_RECOVERYINSTANCEIDS TYPE /AWS1/CL_DRSSTRTFAILBACKREQR00=>TT_STARTFAILBACKREQRECINSTIDS OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_DRSTAGSMAP_W=>TT_TAGSMAP OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_drsstrtfailbacklaun01
  RAISING
    /AWS1/CX_DRSCONFLICTEXCEPTION
    /AWS1/CX_DRSINTERNALSERVEREX
    /AWS1/CX_DRSSERVICEQUOTAEXCDEX
    /AWS1/CX_DRSTHROTTLINGEX
    /AWS1/CX_DRSUNINITIALIZEDACEX
    /AWS1/CX_DRSVALIDATIONEX
    /AWS1/CX_DRSCLIENTEXC
    /AWS1/CX_DRSSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

it_recoveryinstanceids TYPE /AWS1/CL_DRSSTRTFAILBACKREQR00=>TT_STARTFAILBACKREQRECINSTIDS TT_STARTFAILBACKREQRECINSTIDS

The IDs of the Recovery Instance whose failback launch we want to request.

Optional arguments:

it_tags TYPE /AWS1/CL_DRSTAGSMAP_W=>TT_TAGSMAP TT_TAGSMAP

The tags to be associated with the failback launch Job.

RETURNING

oo_output TYPE REF TO /aws1/cl_drsstrtfailbacklaun01 /AWS1/CL_DRSSTRTFAILBACKLAUN01

Domain	/AWS1/RT_ACCOUNT_ID
Primitive Type	NUMC

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->startfailbacklaunch(
  it_recoveryinstanceids = VALUE /aws1/cl_drsstrtfailbackreqr00=>tt_startfailbackreqrecinstids(
    ( new /aws1/cl_drsstrtfailbackreqr00( |string| ) )
  )
  it_tags = VALUE /aws1/cl_drstagsmap_w=>tt_tagsmap(
    (
      VALUE /aws1/cl_drstagsmap_w=>ts_tagsmap_maprow(
        key = |string|
        value = new /aws1/cl_drstagsmap_w( |string| )
      )
    )
  )
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_job = lo_result->get_job( ).
  IF lo_job IS NOT INITIAL.
    lv_jobid = lo_job->get_jobid( ).
    lv_arn = lo_job->get_arn( ).
    lv_jobtype = lo_job->get_type( ).
    lv_initiatedby = lo_job->get_initiatedby( ).
    lv_iso8601datetimestring = lo_job->get_creationdatetime( ).
    lv_iso8601datetimestring = lo_job->get_enddatetime( ).
    lv_jobstatus = lo_job->get_status( ).
    LOOP AT lo_job->get_participatingservers( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_sourceserverid = lo_row_1->get_sourceserverid( ).
        lv_recoveryinstanceid = lo_row_1->get_recoveryinstanceid( ).
        lv_launchstatus = lo_row_1->get_launchstatus( ).
        lo_launchactionsstatus = lo_row_1->get_launchactionsstatus( ).
        IF lo_launchactionsstatus IS NOT INITIAL.
          lv_iso8601datetimestring = lo_launchactionsstatus->get_ssmagentdiscoverydatet00( ).
          LOOP AT lo_launchactionsstatus->get_runs( ) into lo_row_2.
            lo_row_3 = lo_row_2.
            IF lo_row_3 IS NOT INITIAL.
              lo_launchaction = lo_row_3->get_action( ).
              IF lo_launchaction IS NOT INITIAL.
                lv_launchactionid = lo_launchaction->get_actionid( ).
                lv_ssmdocumentname = lo_launchaction->get_actioncode( ).
                lv_launchactiontype = lo_launchaction->get_type( ).
                lv_launchactionname = lo_launchaction->get_name( ).
                lv_boolean = lo_launchaction->get_active( ).
                lv_launchactionorder = lo_launchaction->get_order( ).
                lv_launchactionversion = lo_launchaction->get_actionversion( ).
                lv_boolean = lo_launchaction->get_optional( ).
                LOOP AT lo_launchaction->get_parameters( ) into ls_row_4.
                  lv_key = ls_row_4-key.
                  lo_value = ls_row_4-value.
                  IF lo_value IS NOT INITIAL.
                    lv_launchactionparameterva = lo_value->get_value( ).
                    lv_launchactionparameterty = lo_value->get_type( ).
                  ENDIF.
                ENDLOOP.
                lv_launchactiondescription = lo_launchaction->get_description( ).
                lv_launchactioncategory = lo_launchaction->get_category( ).
              ENDIF.
              lv_launchactionrunid = lo_row_3->get_runid( ).
              lv_launchactionrunstatus = lo_row_3->get_status( ).
              lv_failurereason = lo_row_3->get_failurereason( ).
            ENDIF.
          ENDLOOP.
        ENDIF.
      ENDIF.
    ENDLOOP.
    LOOP AT lo_job->get_tags( ) into ls_row_5.
      lv_key_1 = ls_row_5-key.
      lo_value_1 = ls_row_5-value.
      IF lo_value_1 IS NOT INITIAL.
        lv_tagvalue = lo_value_1->get_value( ).
      ENDIF.
    ENDLOOP.
    LOOP AT lo_job->get_participatingresources( ) into lo_row_6.
      lo_row_7 = lo_row_6.
      IF lo_row_7 IS NOT INITIAL.
        lo_participatingresourceid = lo_row_7->get_participatingresourceid( ).
        IF lo_participatingresourceid IS NOT INITIAL.
          lv_sourcenetworkid = lo_participatingresourceid->get_sourcenetworkid( ).
        ENDIF.
        lv_launchstatus = lo_row_7->get_launchstatus( ).
      ENDIF.
    ENDLOOP.
  ENDIF.
ENDIF.