Figure 1 describes the syntax for replying to prompts for an ERASE or INIT request:

>>-+-ERASE-+--VOLUME(volser-+-------------+-)------------------->
   '-INIT--'                '-,new_volser-'     

>--+--------------+--+----------------------------+------------->
   '-ACCESS(code)-'  '-+-LABELVERSION-+-(-+-3-+-)-'   
                       '-VERSION------'   '-4-'       

>--+-----------------+--+----------------------------------+---->
   |        .-SL-.   |  |            .-parmlib_default-.   |   
   '-LABEL(-+-AL-+-)-'  '-MEDIANAME(-+-medianame-------+-)-'   
            '-NL-'                                             

>--+-----------------+--+-------------------+------------------->
   '-OWNERTEXT(text)-'  +-RACK(rack_number)-+   
                        '-POOL(pool_name)---'   

>--+--------------+--------------------------------------------><
   '-VOL1(volser)-'   

ERASE

Specifies a security erase of a volume and writing a new label on the volume.

You must specify one of ERASE, INIT, or SCAN.

INIT

Specifies initializing a volume.

You must specify one of ERASE, INIT, or SCAN.

VOLUME(volser, new_volser)

volser specifies the volume serial number of the volume to be erased or initialized. Volser is required. If you are adding volumes with a volume serial number less than six characters, you must supply a rack number or a pool, otherwise DFSMSrmm issues an error message.

If the volume is already defined in the DFSMSrmm control data set, DFSMSrmm ensures that the requested action is pending for the volume. If this action is not pending, DFSMSrmm fails the request.

If the volume mounted is already labeled, DFSMSrmm reads the label to ensure that the volume serial number matches the one you specify. If the volume mounted does not have a recognizable volume label but contains data (no label tapes or nonstandard label tapes), DFSMSrmm issues a WTOR. The operator must reply to this message before DFSMSrmm can initialize or erase the volume.

If the volume is not defined in the DFSMSrmm control data set and you do not specify a new volume serial number, DFSMSrmm adds the volume to the control data set.

new_volserspecifies a new volume serial number. Use it if you want to label a volume with a new volume serial number. If you have already defined this new volume in the DFSMSrmm control data set, DFSMSrmm fails the request.

DFSMSrmm adds information about the new volume to the DFSMSrmm control data set. DFSMSrmm then deletes information about the volume you are replacing.

ACCESS(code)

Specifies the ISO/ANSI volume accessibility code. A valid code is in uppercase, alphabetic characters. You must specify LABEL(AL) if you specify an accessibility code.

You must modify the volume access installation exit routine in z/OS® to allow subsequent use of the volume if you specify ACCESS.

The default is blank, allowing unlimited access to the volume.

LABEL(AL|NL|SL)

Specifies the type of label that should be written on the volume.

AL

Specifies an ISO/ANSI Label.

NL

Specifies no label.

SL

Specifies a standard label.

If you do not specify the label type and the volume is already defined in DFSMSrmm, DFSMSrmm uses the label type defined in the DFSMSrmm control data set.

If you do not specify the label type and the volume is not already defined in the control data set, DFSMSrmm uses IBM® standard label (SL) as the default.

LABELVERSION(3|4)

Specifies the ISO/ANSI volume label version for AL tape labels.

Valid values are 3 or 4 only. The default is the value specified in the parameter field of the EXEC JCL statement. If nothing is specified in the EXEC statement, the default is taken from the DEVSUPxx member in parmlib.

Specifying LABELVERSION is equivalent to using the CHANGEVOLUME volserREQUIREDLABELVERSION subcommand. LABELVERSION sets the required label version for ISO/ANSI output tapes in the control data set volume record for this volume.

You must specify LABEL(AL) if you specify LABELVERSION.

MEDIANAME(medianame)

Specifies the volume's media name.

If the volume is already defined in the DFSMSrmm control data set, DFSMSrmm compares the value you specify to the media name that is defined in the control data set. DFSMSrmm fails the request if the media name does not match.

If the volume is not already defined in the control data set and you do not specify a media name, DFSMSrmm uses the parmlib default medianame. The default MEDIANAME is the value you define with the EDGRMMxx parmlib OPTION MEDIANAME operand.

OWNERTEXT(text)

Specifies the owner's name or similar identification. text is fourteen characters. Enclose in single quotation marks if it includes blanks or special characters. The text 10 bytes for SL, 14 bytes for AL.

The information is specified as character constants, and can be up to 10 bytes long for EBCDIC and BCDIC volume labels, or up to 14 bytes long for volume labels written in ASCII.

POOL(pool_name)

Specifies a pool ID for a pool to which you want to assign the volume. If the volume is not defined to DFSMSrmm, DFSMSrmm selects an available rack number for the volume in the pool you specify. If the volume is already defined in the DFSMSrmm control data set, DFSMSrmm changes the volume's rack number to move the volume.

If you do not supply a pool ID or a rack number and the volume is already defined in the DFSMSrmm control data set, DFSMSrmm uses the volume's existing rack number. If the volume is not defined in the control data set and you do not supply a pool ID or a rack number, DFSMSrmm assigns the volume a rack number matching its volume serial number.

RACK(rack_number)

Specifies a shelf location for the volume. If the volume is already defined in the DFSMSrmm control data set, DFSMSrmm compares the value you specify. DFSMSrmm fails the request if it does not match the value in the control data set.

If you do not supply a pool ID or a rack number and the volume is already defined in the control data set, DFSMSrmm uses the volume's existing rack number. If the volume is not defined in the DFSMSrmm control data set and you do not supply a pool ID or a rack number, DFSMSrmm assigns the volume a rack number matching its volume serial number.

VOL1(volser)

Specifies a VOL1 label volume serial number to be written in the tape label. To initialize or erase a duplicate volume, specify a value that is different from the volume serial number or the VOL1 label volume serial number that is defined to DFSMSrmm. The volser value is one-to-six alphanumeric, national, or special characters.

R 21,INIT VOLUME(ABC123) LABEL(AL) POOL(AB*)