Previous Topic: ILOGR()Next Topic: KEYVAL()


IROUTE()

This function controls ILOG routing of the WTO text that triggered the currently running IMOD. The currently assigned routing can be inspected and a new routing assigned.

Syntax

Form 1:

lognum = IROUTE(FETCH)

Form 2:

IROUTE(SET,newlog)

Parameters

lognum

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

FETCH

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

SET

Sets a new ILOG destination.

newlog

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

This function accepts any ILOG number that is syntactically valid. No attempt is made to ensure that the specified ILOG exists and is available.

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 */