Volume-not-in-library specific processing

The DFSMSrmm EDGLCSUX programming interface returns information for a volume, indicating whether the volume is a logical exported volume and the stacked volume on which it is exported.

Table 1 describes volume-not-in-library processing.

Table 1. Processing for the volume-not-in-library parameter list
Variable	Field Name	Input	Output
Library name	UXNLIB	Contains library name into which the volume should be entered, or blanks. DFSMSrmm adds this library name to message EDG8121D so that the operator can enter the volume into the correct library. A value of blanks is displayed as the value `ANY`.	Input only

With volume-not-in-library processing, you can set flags to enable DFSMSrmm to retrieve volume information and to request that DFSMSrmm uses WTOR processing to communicate with the operator. When EDGLCSUX is called from CBRUXVNL, you can set either LCSUP_VNL flag or LCSUP_ACTVNL flag. You must first specify LCSUP_VNL to enable DFSMSrmm to retrieve volume information. Your second request, which is optional, must specify LCSUP_ACTVNL to request that DFSMSrmm uses WTOR processing to communicate with the operator. Between calls to EDGLCSUX from CBRUXVNL, do not modify any of the data returned by DFSMSrmm because the information is used in the messages sent to the operator.

When DFSMSrmm is first called from CBRUXVNL, DFSMSrmm retrieves information about the subject volume from the DFSMSrmm control data set if the volume is defined to DFSMSrmm. DFSMSrmm passes back volume location, movement, and status information in output fields in the EDGLCSUP parameter list. When DFSMSrmm is called a second time, and you have set the LCSUP_ACTVNL flag, DFSMSrmm issues message EDG8124I - VOLUME req_volser RACK rack_number LOCATION loc_name BIN bin_number HOME LOCATION home - NOT IN LIBRARY lib_name, followed by either message EDG8121D, EDG8122D, or EDG8123D which prompt the operator to enter the volume into the identified library. If the LCSUP_ACTVNL flag is not set, DFSMSrmm does not issue these WTORs for the operator to move the volume into the system-managed library.

EDG8121D ENTER VOLUME req_volser INTO LIBRARY lib_name AND REPLY "RETRY", OTHERWISE REPLY "CANCEL" OR CONTINUE
EDG8122D ENTER VOLUME req_volser INTO LIBRARY lib_name AND REPLY "RETRY", OTHERWISE REPLY "CANCEL"

For volumes residing in a IBM TotalStorage Peer-to-Peer Virtual Tape Server (PtP VTS), DFSMSrmm issues the message EDG8123D.

EDG8123D IMPORT VOLUME req_volserTO LIBRARY lib_name AND REPLY "RETRY", OTHERWISE REPLY "CANCEL"

Based on the reply, the return code for OAM, is set in field LCSUP_LCSRC ready to be passed back direct to OAM by the CBRUXVNL exit. The LCSUP_LCSRC field returns these values.

Reply: Return Code
CONTINUE: 0 - UXNNORML
RETRY: 4 - UXNRETRY
CANCEL: 8 - UXNFAIL in PROTECT mode, UXNNORML in other modes.

Table 2 defines the OAM return codes generated when the EDGLCSUX return code is not zero. The return code is the value in register 15 on return from EDGLCSUX.

Table 2. DFSMSrmm OAM return codes from EDGLCSUX register 15
Return Code	Description	Related Message Number	OAM Return Code
LCSUP_RC_OK R0 is LCSUP_RS_OK	Processing successful	none	See reason code in LCSUP_LCSRS field
LCSUP_RC_OK R0 is LCSUP_RS _NOACTION	Subsystem not required by installation	none	UXxNOCHG¹,² UXNNORMAL³
LCSUP_RC_OK R0 is LCSUP_RS_DONT	DFSMSrmm not licensed by installation	none	UXxDONT ¹
LCSUP_RC_SSNA	Subsystem not available	EDG8102D EDG8108D EDG8110D	UXxFAIL ¹
LCSUP_RC _LERR	Logic error in DFSMSrmm processing	EDG8105I EDG8106I EDG8107I	UXxFAIL ¹
LCSUP_RC_ENV	Environment error detected	EDG8101I EDG8111I EDG8112I	UXxFAIL ¹
Notes: x can be: C for change use return codes E for volume entry J for volume eject return codes N for not in volume return codes UXxNOCHG is issued for change use, volume entry and volume eject UXNNORML is issued for not in library only