CA-GSS/ISERV Commands › CA-GSS Initialization Parameters › WTO

WTO

This parameter screens and selects WTOs, based on the message ID or fragment. CA‑GSS then logs the WTO to a specified ILOG file or trigger an IMOD task. If an IMOD is executed, the text of the WTO is passed to the IMOD as the argument string.

Syntax

WTO ID msgid [IMOD imodname] [ILOG ilognum] [USERID userid]

Parameters

msgid

1- to 16-character message ID or beginning fragment of message to be selected. Scan begins with left-most character of message and must match each specified character. If no mismatch has occurred when pattern is exhausted, message is selected. If the first character of the source message ID is not in the range of A to Z, it is skipped, and comparison starts on the next character regardless of its value.

imodname

IMOD name to be executed each time specified message is found.

ilognum

Number of the ILOG file where the message is to be recorded.

userid

User ID assigned to IMOD task created to process the WTO text. If omitted, IMOD task executes under the authority of the task that issued the WTO, if it can be determined. If user ID cannot be determined, IMOD task executes under the default user ID, as specified with the SECURITY parameter.

Usage Notes

• All logging and IMOD-based processing is performed on a delayed basis and not as part of system WTO processing.
• ILOG recording is performed after all IMOD processing associated with the message.
• If ILOG and IMOD are specified for the same message, the IMOD can change the ILOG number.
• If an IMOD executed as the result of a WTO spawns another IMOD, a copy of the original message is passed. However, the spawned messages have no default ILOG routing that is associated with it. The spawned IMOD can establish its own ILOG routing (using the IROUTE() function), but cannot affect the recording of the original message text. Therefore, if you are not careful, duplicate recording of the same message is possible.
• When a message ID matches more than one WTO specification, the last-matched occurrence is the one whose IMOD is executed or whose ILOG routine code is assigned. Therefore, when coding specific and generic WTO IDs, enter the generic IDs first, followed by the specific IDs.