WAIT for PROCESS CHAIN - USAP Command

Description

The WAIT for PROCESS CHAIN command monitors the specified process chain to completion.

Command Line Syntax

The following figure illustrates the command line syntax of the WAIT for PROCESS CHAIN command, using the command line, long form of its configuration options.

-wait-chainid ID -logid ID [-chainlog {yes|no}] [-processlogs {yes|no}] [-joblog {yes|no}] [-spoollist {yes|no}] [-rawspool {yes|no}] [-first_page page] [-last_page page] [-spool_recv_buffer size]

Configuration Options

The following table describes all WAIT for PROCESS CHAIN configuration options and provides the command line, long form of each option illustrated in the WAIT for PROCESS CHAIN command line syntax, above.

Configuration
Option Name

Command Line
Long Form

Description

WAIT

-wait

Causes USAP to monitor the specified process chain to completion.

CHAIN_ID

-chainid

Chain ID of process chain to be monitored to completion.

CHAIN_LOG

-chainlog

Specification for whether or not the process chain log will be returned.

FIRST_PAGE

-first_page

Starting page from which a spool list will be returned.

LAST_PAGE

-last_page

Last page of a spool list to be returned.

SPOOL_RECEIVE_BUFFER

-spool_recv_buffer

Size of the blocks (number of pages) used when transferring spool lists.

LOG_ID

-logid

Chain ID of process chain to be monitored to completion.

PROCESS_LOGS

-processlogs

Specification for whether or not the process logs will be returned.

RAW_SPOOL

-rawspool

Specification for whether the SAP spool lists will be returned from the SAP system in raw or plain format.

RETURN_JOB_LOG

-joblog

Specification for whether or not the job's job log is returned.

RETURN_SPOOL_LIST

-spoollist

Specification for whether or not the spoollists of all job steps are returned.

Output

  • stdout: Spool lists (if specified).
  • stderr: UNV messages and logs (if specified).

Exit Codes

If the WAIT for PROCESS CHAIN command is specified, Universal Connector will map the status of the job, upon its completion, to the user-definable Process Chain exit code parameters.

The following table illustrates this mapping; Universal Connector default values are listed in parentheses.

Process Chain Completion Status in SAP

Exit Code

'X' - Aborted

pcaborted_exit_code (8)

'R' - Red

pcred_exit_code (4)

'A' - Active

pcactive_exit_code (10)

'G' - Green

pcgreen_exit_code (0)

Error in Universal Connector processing
(see All Other Command Exit Codes)

> 200