|
|
|
|
|
When a rule is in command-response mode, that is, when WAITMODE=Y is specified in a DO COMMAND statement, Control-O suspends rule execution until either the specified time-out is reached, or a "last" line (that is, the last line of a multiline message) is detected.
Some command responses can contain more than one "last" line, for example, if the response contains more than one multiline message. In such cases Control-O normally exits command-response mode when it detects the first "last" line. To avoid this problem, a %%$MLLEND statement can be used to disable the search for a "last" line, in this way causing the rule to remain in command-response mode until the specified time-out is reached. The time-out is specified in the TIMEOUT subparameter in the DO COMMAND statement.
Valid %%$MLLEND control statements are shown in Table 193.
Table 193 %%$MLLEND Control Statements
Statement |
Description |
|---|---|
%%$MLLEND NO |
Disable the search for the last line of the message. Rule execution will not exit command-response mode until the time-out specified in the DO COMMAND statement is reached. The search for the last line remains disabled until the end of the execution of the rule (that is, for subsequent DO COMMAND statements in the same rule), or until DO SET %%$MLLEND YES is specified. If %%$MLLEND NO is specified the value of system variable %%WAITRC is always 522 (ended due to time-out). |
%%$MLLEND YES |
Enable the search for the last line of the message. This control statement is only necessary if the search is to be re-enabled in a rule in which the search was disabled. |
For more information, see DO COMMAND: Automated Console Action Parameter.
Example
Figure 248 %%$MLLEND Control Statement Example
DO SET = %%$MLLEND = NO
DO COMMAND = F CICST,CEMT I TASK
WAITMODE Y WAITRESP Y
.
ENDMSG
All DO statements specified after the DO COMMAND statement and before (above) the ENDMSG statement are performed for each line of the command response.
Parent Topic |