Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

OPENUPD: open a member for reading and writing

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
structure

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
structure

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)