*ON Define Events for Latent Conditions

*ON %OUT=srch CONTINUE [AFTER INPUT] | SKIP [AFTER INPUT] .label | RETURN | RESUME

srch single or multiple search argument in the form 'string' | L'string' | A'string' | X'string'.

It should be noted when entering a search string in the form 'string' that lowercase letters will be converted to uppercase.

Entering L'string' will retain the letters in their original case, with no conversion taking place.

If A'string' (Any) is specified, the case of both the search string entered, as well as the text being searched, is irrelevant, with all text being converted to uppercase before the comparison.

Multiple search arguments can be linked with one another by + (AND) / , (OR) / * (Wildcard) operators, and can be stored as a file or library element (*ON %OUT=(file) ...). An example can be found on page 19-.

The %OUT condition is satisfied when the search string(s) is/are contained in the output message (WROUT or the output section of a WRTRD). In this case, a pointer, %PTR, will be set to the end of the search string in the output message. The pointer can be used to assign a substring of the output message to a procedure variable. For further information, see page 19-.

CONTINUE The procedure will be restarted. If a WROUT call was made, the next input will be made by the procedure. If a WRTRD call was made, that input requested by the call will be provided by the procedure.

CONTINUE AFTER INPUT

The procedure will be restarted after the user has entered the input for the current WRTRD.

SKIP .label The procedure will be restarted at the specified label.

SKIP AFTER INPUT .label

The procedure will be restarted automatically, after the user has entered the input for the current WRTRD, at the specified label.

RETURN The user will be returned from a Connection to the main CFS task (command field).

RESUME When the condition has been satisfied, the procedure will be restarted, even if there is no user input at that moment. The ability to resume the execution of a procedure without user input is particularly useful for Connections to $CONSOLE.

*ON %OUT The last *ON %OUT condition to have been defined will be reactivated. The evaluation of the search conditions will not take place.

A full description of the search conditions can be found on pages 8- and 8-.