OPENUPD opens a member for reading and writing. ED specifies the member to be read and written and LD the library containing this member. The complete type, name and version of the existing member must be specified. Moreover, the user may enter a date or time of day in fields USER-DATE and USER-TIME of ED, respectively. If the current date and time are to be taken over, these fields must contain blanks.
The DESTROY parameter is interpreted so that a member can be physically deleted if necessary.
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’.
Several successive OPENUPD calls for different members, but not for the same member, are possible. A separate RD should be created for each call, as every OPENUPD causes a new access path identification to be written to field REC-ACC-ID of RD.
GET and PUT accesses are coordinated. The old variant can still be read while a new variant is being written. GET and PUT calls issued under the same access path identification do not affect each other.
A member cannot be opened simultaneously with OPENGET, OPENPUT and OPENUPD.
Field STORE-FORM of ED is not interpreted; the old value cannot be changed.
Member types C and L are not allowed, as members of these types contain records which cannot be processed.
OPENUPD for delta members is only possible if they are part of a delta tree.
Even if only one record is to be changed, the whole member must be read and written.
Call parameters
The parameter structures must be given in the following sequence in the subroutine call.
Parameter | Field | Meaning |
CB | SCBVERSION FUNCTION SUBCODE ACC DESTROY LD-RETURN | Function control block Interface version Function code X’10’ Subcode currently not used: UNUSE Subroutine access identification Physical overwriting 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 USER-DATE USER-TIME | Member descriptor (source, target) Member type Member name Member version Date specified by user Time of day specified by user |
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 | Source and target member descriptor Member version (with version automation and *HIGH) |