CA-GSS Statements and Commands › GSS Extended Functions › IO Functions › Number, String, and Variable Functions › System Information Functions › IROUTE()

Previous Topic: ILOGR()

Next Topic: KEYVAL()
IROUTE()

Use the IROUTE() function to control ILOG routing of the WTO text that triggered the currently running IMOD. The currently assigned routing may be inspected and a new routing assigned.

Syntax

The IROUTE() function has this syntax.

Form 1:

lognum = IROUTE(FETCH)

Form 2:

IROUTE(SET,newlog)

Arguments

The IROUTE() function takes these arguments:

lognum

ILOG file where the WTO text is to be recorded, following completion of the IMOD. A null value indicates the text will not be recorded on any file.

FETCH

Returns the number (0 to 99) of the currently assigned ILOG file.

SET

Sets a new ILOG destination.

newlog

Number (0 to 99) identifying the ILOG file where the WTO text is to be recorded. A null value prevents recording on any ILOG.

Any ILOG number that is syntactically valid is accepted by the function. No attempt is made to ensure that the specified ILOG exists and is available.

Return Codes

The IROUTE() function produces these return codes:

101 - 102 ARG n MISSING OR INVALID

121 ILOG FILE NOT DEFINED

Example

dest = iroute('FETCH')     /* Obtain the ILOG file number where
                              the message is to be recorded    */
iroute('SET',1) == ''      /* Change the destination to ILOG 1 */