COPYLIB: copy a library

COPYLIB permits logical copying of a complete library with all its library, type and member attributes.

LD1 defines the source library, LD2 the target library. The target library must not yet exist or it must have FCBTYPE=NONE.

With COPYLIB, the ATTR-IND field of the CB parameter is evaluated. If its value is “S” (SAME), the file protection attributes of the source library are applied to the target library.

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 ATTR-IND LD-RETURN	Function control block Interface version Function code X’1B’ Subcode currently not used: UNUSE Subroutine access identification Copy library attributes (STD/SAME) Full DMS file name in LD
LD1	PASSWORD LINK MAX-NAME-LEN NAME	Source library descriptor Password as per PASSWORD command Link name Maximum length of library name Library name
LD2	PASSWORD LINK MAX-NAME-LEN NAME	Target library descriptor Password as per PASSWORD command Link name Maximum length of library name Library name

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
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)