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

ILOGC()

This function returns information from an ILOG subfile.

Syntax

Form 1:

result = ILOGC(OPEN, lognum)

Form 2:

result = ILOGC(CLOSE, lognum)

Form 3:

status = ILOGC(STATUS, lognum)

Parameters

OPEN

Opens the ILOG and prepares it for logging.

CLOSE

Closes the ILOG.

STATUS

Request ILOG allocation status

lognum

ILOG file number, 0 through 99.

result

null, if successful. If not successful, an error text is returned. See Return Codes for text.

status

for the STATUS request, the possible status that can be returned are:

OPEN

ILOG specified by lognum is open.

CLOSED

ILOG specified by lognum is closed.

OPEN NOOPEN

ILOG specified by lognum is open. ILOG was defined in RUNPARMS as NOOPEN.

CLOSED NOOPEN

ILOG specified by lognum is closed. ILOG was defined in RUNPARMS as NOOPEN.

NOT-DEFINED

ILOG specified by lognum is not defined to CA GSS.

Return Codes

101 – 102

ARG n MISSING OR INVALID

122

REQUESTED LOG NOT FOUND

124

REQUESTED LOG NOT ACCESSIBLE

151

REQUESTED LOG ALREADY OPEN/|CLOSED

152

REQUESTED LOG IN USE BY ANOTHER GSS

Usage Notes

By default CA GSS opens ILOGS during initialization and they remain open until CA GSS is terminated. The initialization parameter NOOPEN in the ILOG statement can be used to delay the opening on the ILOG data set. An ILOGC(OPEN,lognum) function call can then open the data set. The ILOGC(CLOSE,lognum) function call can be used on any open ILOG data set, whether it was opened during initialization or by an ILOGC function call.

Example:

/* ILOG 55 was defined to GSS with the NOOPEN option */
result=ILOGC(‘OPEN’.55)   /* open ilog 55 */
if result\='' then y=wto(result)     /* if result is not null, WTO the error text */