COPYSTR copies a delta tree with its structure being retained.
ED1 specifies the delta tree to be copied, LD1 the source library, ED2 the type and name of the copied delta tree and LD2 the target library.
LD1 and LD2 may designate the same library.
The complete type and name of the input and output delta tree must be specified. No member of the type and name specified with ED2 may exist. Version information and userspecified date and time of day are not interpreted but transferred unchanged to the output delta tree. All versions are copied.
Parameters DESTROY and PROT-IND are interpreted so that a delta member can be physically deleted if necessary.
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 PROT-IND LD-RETURN | Function control block Interface version Function code X’0B’ Subcode currently not used: UNUSE Subroutine access identification Physical overwriting Member protection (STD or SAME) Full DMS file name in LD |
LD1 | PASSWORD LINK MAX-NAME-LEN NAME | Library descriptor (source library) Password as per PASSWORD command Link name Maximum length of library name Library name |
ED1 | TYP NAME | Member descriptor (source member) Member type Member name |
LD2 | PASSWORD LINK MAX-NAME-LEN NAME | Library descriptor (target library) Password as per PASSWORD command Link name Maximum length of library name Library name |
ED2 | TYP NAME | Member descriptor (target member) Member type Member name |
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 |
LD1 | NAME | Source library descriptor Full DMS file name of library (dependent on LD-RETURN field of CB) |
LD2 | NAME | Target library descriptor Full DMS file name of library (dependent on LD-RETURN field of CB) |