LD (Library Description)

The descriptor LD identifies a library. If a link name (LINK) exists, the associated library is processed. Any additional library name (NAME) specified for LD is ignored. LMS enters in the NAME field the library name associated with LINK. If no link name exists, the library identified by NAME is processed. The length of the library name is determined by the first blank. However, if a smaller value is entered in the MAX-NAME-LEN field, this value is assumed as the length of the library name. The library name must not exceed the length (1-54) entered in MAX-NAME-LEN. The value MAX-NAME-LEN=54 is recommended.

The NAME field is also used as a return parameter, depending on the LD-RETURN field of CB:

LD-RETURN=NO	If the library is specified via a link name, LMS enters the library name belonging to LINK in the NAME field. Otherwise the NAME field remains unchanged.
LD-RETURN=YES	LMS enters in the NAME field the full DMS file name of the library with catalog ID and user ID after ACS conversion, or the hit library in the case of library lists.

If LD-RETURN=YES is specified, note that the NAME field of LD must be supplied with the library name before each subroutine call if the same library is to be addressed.

Field	Meaning	Length in bytes	Contents after initialization
PASSWORD	Password as per PASSWORD command	4	4 x X'00'
LINK	Link name	8	8 x X'40'
	reserved	8	8 x X'00'
MAX-NAME-LEN	Maximum length of library name	2	Length field
NAME	Library name	54	54 x X'40'

The descriptor LD is required in the following functions:

ADD, CLOSLIB, COPY, COPYLIB, COPYSTR, DEL, GSYSELEM, LOCK, LST, MODEA, MODEP, MODLA, MODTA, OPENGET, OPENPUT, OPENUPD, PROVIDE, REN, REORGLIB, RETURN, SEL, SHOWLA, SHOWTA, TOCPRIM, TOCSEC, UNLOCK.