BW_RESTART_CHAIN

Use the BW_ACTIVATE_CHAIN script element to continue an interrupted process chain. If the process chain continues, it is monitored until it ends.The process chain log is always saved in the activation report. Additionally, the script elements lets you store individual process logs or process background job logs.

Transaction: RSA1
SAP BW Version:  3.0B and later with Patch SAPKW30B11

Syntax

BW_RESTART_CHAIN

Syntax

Description / Format

ID=

Technical designation of the process chain
Value format: script literal

LOGID=

25-digit Log ID
Value format: script literal

Tip: Use PREP_PROCESS_REPORT to retrieve the Log ID from an AE job report.

NOFOUND=

Handling if the process chain cannot be found.
Value format: script literal

Allowed values:

  • NORMAL (default)
    Script continues, the AE job ends normally
  • ABEND
    Script aborts, the AE job ends abnormally

ERROR=

Handling if the process chain ends abnormally.
Value format: script literal

Allowed values:

  • ABEND (default)
    Script aborts, the AE job ends abnormally
  • IGNORE
    Script continues, the AE job ends normally
  • SUSPEND
    Job remains active until a restart of the process chain or its child processes has been successful, or the job has been canceled manually

Tip: You can use this parameter in order to restart process chains or their child processes. The advantage is that the job does not end which would include that processing continues in a parent (such as a workflow).

PROCESSLOGS=

Output of a process chain's individual process logs
Format: script literal

Allowed values:

  • YES (default)

    Individual process logs are added to the process chain log
  • NO

    Only the process chain log is output
  • ERROR
    Individual process logs are output only in case of error

JOBLOGS=

Log output of the process background job
Format: script literal

Allowed values:

  • YES (default)

    Process background job logs are output
  • NO

    Process background job logs are not output
  • ERROR
    Process background job logs are only output if an error occurs

LONGTEXT=

Output of a long text (diagnostics text) to a log message

Format: script literal

Allowed values:

  • YES
    The log message's long text is output
  • NO
    The log message's long text is not output
  • ERROR (default)
    The log message long text is only output if an error occurs

REPLICATE=

Handling of the children of a process chain

Format of the value: script literal

Allowed values:

  • ALL
    Replicates all child processes of a job in the AE system (including skipped ones)
    The child processes are shown in the Process Monitoring perspective. Statistical records and reports are also generated in the AE system.
  • YES
    Replicates the children of a job in the AE system
    The children are displayed in the Process Monitoring perspective. Statistical records and reports are also generated in the AE system.
  • NO (default)
    No replication in the AE system
GET_SPOOL=

Requests the spool list of the started job.
Format of the value: script literal

Allowed values:

  • YES
    Requests the spool list
    The spool list is stored as a text file in the directory that has been defined in the INI file of the SAP Agent, with the parameter Download_dir= (Sektion [GLOBAL]). The name of this file is structured as follows:
    <SAP job count>_<step number>_<spool number>.txt
    This file is also registered as job output in the AE job.
    For more information, see Agent SAP and Registered Job Output.
  • NO (default)
    The spool list is not requested
COLLECTLOGS=

Writes the reports of the activated process chain's child processes to the job report.

The reports of replicated child processes are by default available in the job report AND the task of the child process. Therefore, this information is redundant in the job and you can decide not to assume this information here.

Allowed values: YES (default) or NO 

  • YES (default)
    Logs of child processes are written to the job report
  • NO
    Logs of the process chain's child processes are not assumed to the job report

 Note: The reports of the child processes are not available if you specify NO in the REPLICATE and COLLECTLOGS parameters .

Examples

This example serves to determine whether the ZSBB1 process chain has been interrupted in a job's post script by using the error number. If so, the 25-digit Log ID is saved in a variable.

:SET &HND# = PREP_PROCESS_REPORT(,,PLOG,'*U2004111*','COL=DELIMITER',"DELIMITER=@'@")
:
SET &LOGID# = ''

:
PROCESS &HND#
:   
SET &LOGID# = GET_PROCESS_LINE(&HND#,4)
:
ENDPROCESS

:
IF &LOGID# <> ''
:   
PUT_VAR VARA.CHAINS,'ZSBB1',&LOGID#
:
ENDIF

An additional job reads the Log ID from the variable and restarts the process chain to continue processing.

:SET &LOGID# = GET_VAR(VARA.CHAINS,ZSBB1)
BW_RESTART_CHAIN ID='ZSBB1',LOGID='&LOGID#',ERROR='ABEND',NOFOUND='NORMAL'