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

ILOGR()

This function records data in an ILOG file.

Syntax

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

Parameters

lognum

ILOG number where the record is 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 Technologies.

VAR

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

STEM

Multiple lines of text are supplied in a stem variable.

STACK

Multiple lines of text are supplied from the stack.

data

Text to be recorded, as follows:

(if VAR was specified): A text string or variable.

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

(if STACK was specified): The 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

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

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