Continues an interrupted process chain.
Transaction: RSA1
SAP BW Version: 3.0B and later with Patch SAPKW30B11
BW_RESTART_CHAIN
ID=...
,LOGID=...
[,NOFOUND=...]
[,ERROR=...]
[,PROCESSLOGS=...]
[,JOBLOGS=...]
[,LONGTEXT=...]
[,REPLICATE=...]
[,GET_SPOOL=...]
[,COLLECTLOGS=...]
Syntax |
Description / Format |
---|---|
ID= |
Technical designation of the process chain. |
LOGID= |
25-digit Log ID. |
NOFOUND= |
Handling if the process chain cannot be found. NORMAL = The script continues, the AE job ends normally. |
ERROR= |
Handling if the process chain ends abnormally. ABEND = The script aborts, the AE job ends abnormally. |
PROCESSLOGS= |
Output of a process chain's individual process logs. Allowed values: YES (default value), NO or ERROR YES = Individual process logs are added to the process chain
log. |
JOBLOGS= |
Log output of the process background job. Allowed values: YES (default value), NO or ERROR YES = Process background job logs are output. |
LONGTEXT= |
Output of a long text (diagnostics text) to a log message. Allowed values: YES, NO or ERROR (default value) ERROR = 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, YES or NO (default value) ALL = Replicates all a job's child processes in the AE system (including skipped ones). They are shown in the UserInterface's Activity Window. Statistical records and reports are also generated in the AE system.
|
GET_SPOOL= |
Requests the spool list of the started job.
Allowed values: YES or NO (default) YES = The spool list is requested. It is stored as a text file in the directory that has been defined in the SAP agent's INI file with the parameter Download_dir= (Sektion [GLOBAL]). The name of this file is structured as follows: NO = 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 - Logs of child processes are written to the job report. Note that the reports of the child processes are not available if you specify NO in the parameters REPLICATE and COLLECTLOGS. |
This script element continues an interrupted process chain. A particular process chain execution is clearly identified with the parameter LOGID=. The Log ID can be determined using PREP_PROCESS_REPORT from an AE job report.
If the process chain continues, it is monitored until it ends.The process chain log is always saved in the activation report. Additionally, either individual process logs or process background job logs are output depending on the parameters PROCESSLOGS= and JOBLOGS=.
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'