Updates to the DFSMSdss Application Programming Interface

In support of the TS1130 tape drive the following new fields are added to the ADREID0 data area to allow an installation-supplied program to determine whether a tape device is encrypting data:

EI00SWNCRYPT: DFSMSdss sets this bit on to indicate that software encryption is requested. You can reference this bit, but you should not change it.
EI00CANSFE: You can set this bit on to indicate that software encryption is to be cancelled. DFSMSdss honors this bit only when the EI00SWNCRYPT bit is turned on.
EI00MIXDEV: You can set this bit on to indicate that the data is to be written to a mixture of devices where some are encrypting the data and some are not. DFSMSdss honors this bit only when the EI00SWNCRYPT bit is turned on.

Table 1 shows the ADREID0 mapping.

Table 1. ADREID0 Mapping
Offsets		Type	Len	Name (Dim)	Description
Dec	Hex	Type	Len	Name (Dim)	Description
0	(0)	STRUCTURE	16	EIREC00
0	(0)	UNSIGNED	1	EI00SBPL	SHARED SUBPOOL NUMBER
1	(1)	BITSTRING	1	EI00FLGS	STARTUP FLAGS
		1... ....		EI00SENQ	SHORT VTOC ENQUEUE
		.1.. ....		EI00NONF	DO NOT ALLOW IGWNOTIF CALL
		..1. ....		EI00NOLK	DO NOT PERFORM ADRLOCK ENQUEUE OR DEQUEUE
		...1 ....		EI00NENQ	NO INPUT VOLUME SERIALIZATION. VALID DURING PHYSICAL COPY AND DUMP FUNCTION STARTUPS
		.... 1...		EI00BSEC	BYPASS SECURITY VERIFICATION FOR DATA SETS ON THE VOLUME DURING COPY FULL/TRACKS, DUMP FULL/TRACKS, AND RESTORE FULL/TRACKS FUNCTION STARTUPS
		.... .1..		EI00MVOLRECOV	1=CALLER IS PERFORMING A MULTI-VOLUME RECOVERY USING PHYSICAL DATA SET RESTORE AND IT IS ACCEPTABLE FOR DFSMSDSS TO SCRATCH PREALLOCATED TARGET DATA SETS THAT ARE NOT THE CORRECT SIZE
		.... ..1.		EI00BSER	1=BYPASS SERIALIZATION OF THE DATA SETS BEING RESTORED DURING A PHYSICAL DATA SET RESTORE OPERATION
		.... ...1		*	RESERVED
2	(2)	CHARACTER	6	EI00SVOL	SOURCE VOLSER. VALID DURING COPY FULL/TRACKS, DUMP FULL/TRACKS, AND RESTORE FULL/TRACKS FUNCTION STARTUPS. FOR RESTORE, THIS FIELD CONTAINS THE VOLSER OF THE INPUT VOLUME WHERE THE DUMP DATA SET RESIDES
8	(8)	BITSTRING	1	EI00FLG2	SECOND FLAG AREA
		1... ....		EI00SWNCRYPT	SOFTWARE ENCRYPTION WAS REQUESTED (RSA OR KEYPASSWORD WAS SPECIFIED)
		.1.. ....		EI00CANSFE	CANCEL SOFTWARE ENCRYPTION
		..1. ....		EI00MIXDEV	MIXTURE OF DEVICES; SOME ARE PERFORMING HARDWARE ENCRYPTION AND OTHERS ARE NOT.
		...1 1111		*	RESERVED
9	(9)	CHARACTER	7	*	RESERVED