INIT opens a subroutine access and is the first function call to LMS. The subroutine access identification is returned in field ACC of the CB. This identification is required for all further function calls. Field LMSVERSION of the CB contains the current LMS version number. The processing operands are set to default values.
Several INIT calls may be issued in succession if parallel subroutine accesses are to be implemented. A separate CB must be created for each subroutine access, since every INIT call causes a new subroutine access identification to be stored in field ACC of the CB.
If an error occurred during the INIT call, field ACC in the CB contains 4 x X’FF’.
Subroutine access is terminated with END and the appropriate subroutine access identification.
Call parameters
The parameter structures must be given in the following sequence in the subroutine call.
Parameter | Field | Meaning |
CB | SCBVERSION FUNCTION SUBCODE | Function control block Interface version Function code X’01’ Subcode currently not used: UNUSE |
Return parameters
Parameter | Field | Meaning |
CB | RETURNCODE LMS-MSG DMS-MSG PLAM-MSG ACC LMSVERSION DESTROY FCB RKEY OVERWRITE COLUMN-P LINE-P PROT-IND ATTR-IND INFO LD-RETURN | Function control block Return code LMS message code DMS message code PLAM message code Subroutine access identification LMS version Physical overwriting File attributes (for Select) ISAM key and file attributes Logical overwriting Columns per line Lines per page Member protection Copy library attributes Member subarea to be processed Use NAME field of LD as return parameter for full DMS |