EDG_EXIT200 parameter list

All communication is done using the parameter lists fields. The parameter list is mapped by the macro EDGPL200 as shown in Installation exit mapping macro: EDGPL200.

The same parameter list area is passed to each exit module associated with the exit. Each exit module can update the output area of the parameter list to indicate what processing is required by DFSMSrmm. Depending on the order of the exit routines, your exit module could receive the parameter list before any other exit module has processed it, or it might already have been processed. Before taking a decision in your exit routine, you should check to see if an earlier exit routine has already taken a decision. You should be prepared for your decision to be negated by other exit routine processing.

The parameter list input values are:

PL200_VALID

This field defines which functions you can request during this call of the installation exit.

PL200_CAN_SCRTCH: If set to B'1' DFSMSrmm is returning the volume to scratch and you can request DFSMSrmm not to do this or can request DFSMSrmm to ignore data set name information for the volume.

PL200_VOLSER

This field contains the volume serial number of the volume being returned to scratch.

PL200_RACK_NUMBER

This field contains the rack number of the volume being returned to scratch.

PL200_MEDIA_NAME

This field contains the media name used for the volume being returned to scratch.

PL200_LOCATION

This field contains the location name used for the volume being returned to scratch. It can be any value that is valid for volumes in the installation. It can be any valid location name, including storage locations defined as Home locations, but not a regular storage location.

PL200_DSNAME

This field contains the name of the first data set on the volume. There might be other data sets on the volume, but this information is not available to the exit.

PL200_VOLUME_FLAGS

This flag byte is used to give you information about the volume.

PL200_SMS_VOL

If set to B'1' this volume is a system-managed volume. For system-managed volumes DFSMSrmm dynamically updates the TCDB so you do not need to.

PL200_HOME_LOCDEF

This flag byte is used to give you information that the volume is in the storage location defined as home.

PL200_MANUAL_SCRATCH

This flag byte is used to give you information that the volume is in VLPOOL with AUTOSCRATCH(NO).

PL200_EDGSVREC_ADDR

This flag byte is used to give you information about the address of the volume.

PL200_CATSYSID

This flag byte is used to give you information about the CATSYSID list for the running system.

PL200_DESCRIPTION

This field contains descriptive information about the volume that is returning to scratch status.

PL200_OWNER

This field contains the owner ID of the volume owner.

The parameter list can be updated as follows:

PL200_FUNCTION

This field describes functions that can be updated.

PL200_SET_NOSCRTCH: Set the PL200_SET_NOSCRTCH bit if you do not want DFSMSrmm to return the volume to scratch status at this time. You can control return to scratch processing each time inventory management expiration processing is run.
PL200_SET_IGNORE_DSN: Set the PL200_SET_IGNORE_DSN bit if you do not want DFSMSrmm to use the data set information for this volume. Setting this flag allows you to control the validation that DFSMSrmm performs at OPEN time. If DFSMSrmm cannot use the data set name information it cannot ensure that the volume has not changed since it was last used. DFSMSrmm will still use the internal volume label for validation.