Appendix F.  Accessing the LINCCNTL File

LINCCNTL File Structure

The LINCCNTL file is a standard system data file, with the following attributes:

FILESTRUCTURE

BLOCKED

MAXRECSIZE

30 words

BLOCKSIZE

30 words

The file is read exclusively by the LINCSUPPORT library.

Program Access via Lincsupport Library

The LINCSUPPORT library provides access to the LINCCNTL file by exporting the specified entrypoints. You must declare each required entrypoint as a library procedure in your program. The declared library must be title equated to systemname/ LINCSUPPORT. Two read entrypoints are provided for user access, GET-RUN-INFO and GET-IspecS, as detailed in the following subsections. Update entrypoints, UPDATE-RUN-INFO and UPDATE-GEN-INFO, are provided in the sample file NGEN28/SAMPLE/LINCCNTL/UPDATE.

Notes:

  • The entrypoints can be spelt with either hyphens (-) or under-scores (_).

  • For entrypoints returning information to the caller, if there is no information available of the type requested, a null-filled record area is returned to the caller.

  • The parameter array is resized if required.

Entrypoint GET-RUN-INFO

This entrypoint returns all the commonly required LINCCNTL information from the current LINCCNTL file.

Entrypoint GET-ISPECS

This entrypoint returns the NIspec table from the LINCCNTL information. The entrypoint result value specifies the number of entries in the table.

Entrypoint UPDATE-Run-INFO

Refer to the sample file in NGEN28/SAMPLE/LINCCNTL/UPDATE to access this entrypoint.