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

Previous Topic: ILOGG()

Next Topic: IROUTE()
ILOGR()

Use the ILOGR() function to record data in an ILOG file.

Syntax

The ILOGR() function has this syntax:

ILOGR(lognum,rectype,{VAR|STEM|STACK},data)

Arguments

The ILOGR() function takes these arguments:

lognum

ILOG number where the record is to be written.

rectype

Record-type number for the record. Record types range from 100 to 32,767. Values less than 100 are reserved for use by CA.

VAR

Indicates that a single line of text is supplied in a variable or as a literal.

STEM

Indicates that multiple lines of text are supplied in a stem variable.

STACK

Indicates that multiple lines of text are supplied from the stack.

data

Text to be recorded, as follows:

(if VAR was specified): Text string or variable.

(if STEM was specified): Name of a stem variable, including the period.

(if STACK was specified): Number of the stack containing the data lines.

Each data line can be no longer than 255 characters. The maximum number of data lines is 32,767, and the maximum number of characters in an entire record is 32,715 minus the number of lines returned.

Text records taken from stem variables are processed in the same order as the individual members were created.

Return Codes

The ILOGR() function produces these return codes:

101 - 104 ARG n MISSING OR INVALID

122 REQUESTED LOG NOT FOUND

123 ILOG IS FULL

124 REQUESTED LOG NOT ACCESSIBLE

125 STEM ITEM IS NUMERIC, NOT TEXT

126 STEM ITEM IS TOO LONG

Example

Consider this example:

ilogr(0,1200,'VAR','Process 7 successful')
                               /* Write text on ILOG file 0 */
ilogr(1,2321,'STEM','rec.')    /* Write multi-line record from
                                  rec. variables  */
ilogr(0,9999,'STACK',5)        /* Write multi-line record
                                  using contents of stack 5 */