The main characteristics of GLI output are as follows:
GLI Output records are 2,000 characters long.
There are two types of output:
Status messages
Requested data
Status messages are always returned in the following cases:
At startup, to indicate normal operation or a recovery situation
When GLI encounters a fatal condition, forcing it to terminate
Other status messages might be returned depending on what you specify:
If REQD.ACK; YES is specified, then each input record (except the FINISH record) is acknowledged with one of the statuses: OK, NOT OK or FATAL.
If ERROR.MSG; YES is specified in the GLI header record, then ERROR statuses are also returned, with up to ten ERROR or ATTENTION messages. Message output starts at position 153, with each message occupying 66 positions. A message consists of two parts: a value (16 characters), and associated text (50 characters).
Note: For Copy.From Ispecs, the Copy.from line number is returned in the first two positions of the message text.
ERROR output precedes the acknowledgment status message and any requested data for that input record.
Requested data from your database can be obtained for Standard, Table, and Multiple Ordinate Memo Components when the input value of Maint is one of INQ, REC, FIR, LAS, NEX, or BAC.
An appropriate Ordinate value must be supplied where required. The remainder of your input record should be spaces.
If your request is valid, positions 1 through 6 contain OK (and four spaces), and the requested data starts at position 153.
In all cases, the first six positions indicate the status and type of output. Depending on the status and type, the remaining positions might contain system messages, error messages, requested data, or spaces.
Positions 1–6 | Record Description/Conditions |
---|---|
OK | Always output at start of normal GLI operation. |
RECOVE | Always output at startup under recovery. Positions 7–14 give number of records to skip. |
FATAL | Always output if GLI terminates abnormally. |
OK | Input accepted. Returned if REQD.ACK; YES specified or data requested. Positions 153 onwards contain any data requested. |
NOT.OK | Input rejected. |
ERROR | ERROR or ATTENTION messages apply to GLI input. Positions 153 – end contain text for messages. Up to ten messages, 66 characters each. |