DFSMSrmm processing for OAM support

DFSMSrmm processing is dependent on these conditions:

The OPMODE processing mode specified in the DFSMSrmm EDGRMMxx parmlib member. When DFSMSrmm is running in manual mode, no DFSMSrmm processing is performed. When DFSMSrmm is running in warning mode, DFSMSrmm issues messages but does not fail any requests.
The TCDB purge option specified in the DFSMSrmm EDGRMMxx parmlib member. Use the SMSTAPE(PURGE) option to control the processing that DFSMSrmm performs when a volume is ejected. DFSMSrmm can always keep the TCDB record, always purge the record, or accept the requestor's decision. If the requestor did not make a decision, DFSMSrmm uses the ISMF default value. The ISMF default can be set at the library level. If the TCDB record is kept, DFSMSrmm adds the destination location and bin information to the OAM shelf location information. This avoids the WTOR to the operator prompting for shelf information. If the shelf location is still set to 'DEST=' during entry processing, DFSMSrmm clears the field. Library partitioning driven by REJECT ANYUSE(prefix) and volume not for use on z/OS, is performed by DFSMSrmm in all modes except manual mode.
DFSMSrmm performing library partitioning driven by REJECT ANYUSE(ANYUSE(prefix)) and volume not for use on z/OS when DFSMSrmm is running in all modes except manual mode.
The DFSMSrmm EDGRMMxx parmlib OPTION SMSTAPE(UPDATE(EXITS)) operand. Information provided by OAM to the exits is used to enhance the information recorded by DFSMSrmm. You can decide whether the OAM information overrides the information already defined to DFSMSrmm. Use the SMSTAPE(UPDATE(EXITS)) option to use DFSMSrmm information to override other information and to activate the volume-not-library processing. When DFSMSrmm is running in protect mode, the DFSMSrmm information overrides the information from OAM and performs volume-not-library processing

See Defining system options: OPTION for information about the options.

Table 1 describes DFSMSrmm processing for OAM support.

Table 1. Processing for the change use attribute, cartridge entry and cartridge eject parameter list
Variable	Field Name	Input	Output
Checkpoint volume indicator	UXCCHKPT UXECHKPT UXJCHKPT	Not used	Not used
Installation exit information	UXCEXITI UXEEXITI UXJEXITI	DFSMSrmm uses this for communication between different parts of DFSMSrmm.	Input only
Last entry or ejection date	UXCENTEJ UXEENTEJ UXJENTEJ	DFSMSrmm updates the control data set with this value if no date is recorded or if the input date is later than the existing date. DFSMSrmm uses this to set the movement tracking date.	Input only
Last mounted date	UXCMOUNT UXEMOUNT UXJMOUNT	DFSMSrmm records this date if no date exists or if this date is more current than the existing date.	DFSMSrmm returns a date in the parameter list if the date is less than the date already recorded by DFSMSrmm. DFSMSrmm sets return code UXyCHG to indicate that the parameter list has been changed.
Last written date	UXCWRITE UXEWRITE UXJWRITE	DFSMSrmm records this date if no date exists or if this date is later than the existing date.	If the date is less than the existing date, DFSMSrmm returns the last written date and sets return code UXyCHG to show that the parameter list has been changed.
Library console name	UXCLCON UXELCON UXJLCON	All error messages issued by DFSMSrmm to support the OAM functions are issued to the named console and to consoles using the correct routing codes.	Input only
Library description	UXCLDESC UXELDESC UXJLDESC	Not used	Input only
Library device type	UXCLDEV UXELDEV UXJLDEV	Not used	Input only
Library logical type	UXCLTYP UXELTYP UXJLTYP	If the volume is being defined to DFSMSrmm resides in a system-managed tape library, the location type identifies if the volume resides in an automated tape library or manual tape library. For a volume that is already defined to DFSMSrmm, DFSMSrmm updates the location type with this value. When a volume residing in a system-managed tape library is not defined to DFSMSrmm, DFSMSrmm creates a volume record. The latest information is recorded by DFSMSrmm when volumes are ejected from the system-managed tape library. This ensures information will be available if the volume is ever entered into any other library controlled by the same control data set.	Input only
Library name	UXCLIB UXELIB UXJLIB	Location name If the volume is being defined for the first time, DFSMSrmm records this value as the home location and location name for the volume. If the volume is already defined to DFSMSrmm, DFSMSrmm will update the volume location name to this value if the existing location name is different. If the rack number for the volume is not the same as the volume serial number, then DFSMSrmm sets a return code and reason code and issues message EDG8189I. If the rack number is not available, DFSMSrmm sets a return code and reason code and issues message EDG8198I.	Input only
New use attribute	UXCUSEA UXEUSEA UXJUSEA	The value can be: S for scratch For change use attribute processing, volumes that are scratch candidates are returned to scratch by any OAM CBRUXCUA request, such as those generated by the EDGSPLCS utility or the ISMF mountable tape volume list processing. Attempts to use OAM CBRUXCUA requests to change the status of a non-scratch-candidate volume to a scratch volume fail with message EDG8194I. For cartridge eject processing, if the volume currently is defined to DFSMSrmm as a master or user volume, then this request is rejected and DFSMSrmm does not change the use attribute. DFSMSrmm sets a reason code and return code and issues message EDG8194I. For cartridge entry processing, if the volume is currently defined as a master or user volume, then DFSMSrmm returns the volume status recorded in the control data set to the caller. P for private The volume information is changed or added to DFSMSrmm regardless of its current status.	This value is input only for change use attribute and cartridge eject processing. DFSMSrmm updates this information during cartridge entry processing if the volume is defined to DFSMSrmm and the status recorded in control data set is different.
Notification call	UXJNCALL	DFSMSrmm uses this field to avoid rejecting or failing an export of a logical volume.	Input only
Shelf location	UXCSHLOC UXESHLOC UXJSHLOC	Not used	Not used Cleared if the location name starts with DEST= Set to DEST=destination name, bin number, and medianame if TCDB record is kept.
Stacked volume	UXJSTKVS	DFSMSrmm uses this field as the 'in container' value.	Input only
Storage group name	UXCGROUP UXEGROUP UXJGROUP	DFSMSrmm updates the DFSMSrmm control data set with the storage group name, except during cartridge entry processing when the storage group name is already set.	DFSMSrmm updates this value during cartridge entry processing if the storage group name is already set.
Tape drive selection information	UXCTDSI UXETDSI UXJTDSI	DFSMSrmm uses this value to replace tape drive selection information during change use attribute and cartridge eject processing. Tape drive selection information corresponds to the DFSMSrmm recording format, media type, compaction, and special attributes.	DFSMSrmm uses this value to update tape drive selection information during cartridge entry processing. DFSMSrmm merges the known information from OAM with the information in the control data set to produce tape drive selection information.
Volume attribute	UXEVATTR	Volume type. DFSMSrmm uses the physical volume to process the volume as a real volume. DFSMSrmm uses the logical volume and imported logical volume attributes to identify the volume type as a logical volume. DFSMSrmm checks to see if logical volumes have been correctly imported or entered to control entry and import processing. For imported volumes, the volumes must not already be defined to DFSMSrmm or must be defined as an exported logical volumes. If the volumes are not correctly defined, DFSMSrmm issues message EDG8182I or EDG8184I and appropriate reason codes.	Input only
Volume expiration date	UXCEXPIR UXEEXPIR UXJEXPIR	DFSMSrmm records this value when a new private volume is added or when a volume is changed from scratch to master status. If the volume is already defined as a master volume, DFSMSrmm ignores this value. If the date exceeds the maximum retention period then DFSMSrmm fails the request and issues message EDG8196I and sets return code UXCFAIL.	If the input date is less than the existing date, DFSMSrmm returns the most recent date in the parameter list and sets return code UXyCHG to show that the parameter list has been changed. Note that this is an output field when changing the status to PRIVATE.
Volume location code	UXCLOC UXELOC UXJLOC	Values can be: S for SHELF The volume was ejected from the system-managed tape library and is in transit. L for LIBRARY The volume is resident in the system-managed tape library.	Input only
Volume owner information	UXCOWNER UXEOWNER UXJOWNER	The first 8 characters are used to identify the DFSMSrmm owner. If the volume is changing from scratch to master status or is being added as master then DFSMSrmm checks the owner information. If this is a valid DFSMSrmm owner then DFSMSrmm adds or updates the volume owner information in the control data set. If the owner is not a valid owner name, DFSMSrmm sets a default, which is the DFSMSrmm user ID or its step name if the DFSMSrmm ACEE cannot be located. If DFSMSrmm is running in protect mode during change use attribute processing, DFSMSrmm rejects the request and issues message EDG8195I and sets the CBRUXCUA return code UXCFAIL. If the volume is a master volume, DFSMSrmm examines the first 8 characters of the owner information. If the owner information is valid but is different from the current DFSMSrmm owner then DFSMSrmm uses the information to update the owner information for the volume. If the owner information is not valid, DFSMSrmm sets a return code and issues message EDG8195I. During cartridge entry processing, or when owner information does not exist, DFSMSrmm returns owner information in the parameter list.	For volumes to be added as scratch volumes, there should be no owner information. If the first 8 characters of owner information are not null or blank, DFSMSrmm set a null owner name and sets CBRUXCUA return code to UXCCHG. During cartridge entry processing, or if the input owner information was not provided, DFSMSrmm returns the first 8 bytes of owner information.
Volume record creation date	UXCCREAT UXECREAT UXJCREAT	Not used	Input only
Volume serial	UXCVOLSR UXEVOLSR UXJVOLSR	This value is used to identify the volume to be processed.	Input only
Write protection status	UXCWPROT UXEWPROT UXJWPROT	Not used	Not used