CB (Control Block)

The CB identifies the interface version (SCBVERSION), the appropriate access (ACC) and the desired function (FUNCTION). In addition a subcode (SUBCODE) can be specified. For all functions, a return code (RETURNCODE) and error codes for LMS, DMS and PLAM (LMS-MSG, DMS-MSG, PLAM-MSG) will be returned. Following the INIT call, the LMSVERSION field contains the version number of the LMS installation. The processing operands are set to the default values in the INIT call.

The CB control block is required for all functions. It must always be the first parameter in the parameter list.

If the CB is translated with a new version, all other parts of the program which use LMSUP structures must also be translated.

Field	Meaning	Length in bytes	Contents after initialization [after INIT]
SCBVERSION	Interface version	2	X'F0F4'
FUNCTION	Function code	1	1 x X'01'
SUBCODE	Subcode	1	1 x X'40'
ACC	Subroutine access identification	4	4 x X'FF'
RETURNCODE	Return code class	1	1 x X'00'
	reserved	1	1 x X'00'
LMS-MSG	LMS message code	2	2 x X'00'
DMS-MSG	DMS message code	2	2 x X'00'
PLAM-MSG	PLAM message code	2	2 x X'00'
LMSVERSION	LMS version	12	12 x X'40'
	reserved	4	4 x X'00'
****************	LMS parameters *********************
DESTROY	Physical overwriting Y: Overwrite data with X’00’ N: Do not overwrite data	1	1 x X'40' [N]
FCB	File attributes S: As stored, or default value I: ISAM Q: SAM C: As described in catalog	1	1 x X'40' [S]
RKEY	ISAM key and file attributes Y: Store ISAM key and file attributes N: Do not store ISAM key and file attributes	1	1 x X'40' [N]
OVERWRITE	Logical overwriting Y: Target member/file is overwritten (YES) N: Target member/file is not overwritten (NO) O: Target member/file must exist (ONLY) E: Target member/file extended (EXT) A: All target versions for the specified name are overwritten (NAME) (only applies to COPY, error in all other cases)	1	1 x X'40' [N]
COLUMN-P	Number of columns per line: 132/80	2	H'0' [132]
LINE-P	Number of lines per page LINE-P= 60; 21≤LINE-P≤255 0: title not output	2	H'0' [60]
PROT-IND	PROTECTION INDICATOR S: Target members/files have standard protection (STD) M: Target members/files have same protection as source (SAME)	1	1 x X'40' [S]
ATTR-IND	ATTRIBUTES INDICATOR (COPY-LIB) S: The target library is created with standard protection (STD) M: The target library takes the same attributes as the library file (source) (SAME)	1	1 x X'40' [N]
INFO	Member subarea to be processed S: Process standard area (STD) X'01': Process text proper (record type 1) (TXT) X'02': Process comment/documentation (record type 2) (COM)	1	1 x X'40' [S]
LD-RETURN	The NAME field in LD is used as the return parameter for the full DMS file name of the library: N: name is only written if library is specified via link name Y: full library name with catalog ID and user ID after ACS conversion, or hit library in the case of library lists	1	1 x X‘40‘ [N]
	reserved	4	4 x X'40'