OPENGET opens a member for reading. ED specifies the member to be read and LD the library containing this member. The complete type, name and version of the existing member must be specified.
During opening, an access path identification is stored in field REC-ACC-ID of RD. If an error occurred during opening, this identification has the value 4 x X’FF’.
A member can be multiply opened for reading if several OPENGETs with the same member name and library name are given. A separate RD should be created for each OPEN, as every OPENGET causes a new access path identification to be stored in field REC-ACC-ID of RD. This identification is required for all further accesses and for closing the member.
A member cannot be simultaneously opened with OPENGET, OPENPUT and OPENUPD.
After opening, the read pointer (for sequential reading) is located at the beginning of the member.
USER-DATE, USER-TIME and STORE-FORM information from ED is not interpreted.
Members containing format B records cannot be read with GET unless the EXTRA subcode is set in the OPENGET function.
Call parameters
The parameter structures must be given in the following sequence in the subroutine call.
Parameter | Field | Meaning |
CB | SCBVERSION FUNCTION SUBCODE ACC LD-RETURN | Function control block Interface version Function code X’0E’ EXTRA: Format B records allowed in member Subroutine access identification Full DMS file name in LD |
RD | - | Record descriptor Does not have to be supplied |
LD | PASSWORD LINK MAX-NAME-LEN NAME | Library descriptor Password as per PASSWORD command Link name Maximum length of library name Library name |
ED | TYP NAME VERSION | Member descriptor Member type Member name Member version |
Return parameters
Parameter | Field | Meaning |
CB | RETURNCODE LMS-MSG DMS-MSG PLAM-MSG | Function control block Return code LMS message code DMS message code PLAM message code |
RD | REC-ACC-ID | Record descriptor Access path identification |
LD | NAME | Library descriptor Full DMS file name of library (dependent on LD-RETURN field of CB) |
ED | VERSION | Member descriptor Member version (if call used *HIGH) |