EXEC parameters for EDGINERS

Figure 1 describes the EXEC parameters.

Figure 1. EDGINERS EXEC parameters


>>-+-----------------------------------+------------------------>
   | .-parmlib_DEVSUPxx_member_value-. |   
   '-+-------------------------------+-'   
     +-ALVER3------------------------+     
     '-ALVER4------------------------'     

>--+------------------------------+--+------------------+------->
   |                          (1) |  |              (1) |   
   '-BATCH(number_of_batches)-----'  '-COUNT(count)-----'   

>--+---------------------------+--+----------------+------------>
   |        .-DSE------.   (1) |  |            (1) |   
   '-ERASE(-+-INIT-----+-)-----'  '-INITIALIZE-----'   
            +-SHRED----+                               
            '-SHREDDSE-'                               

>--+------------------------------------------------+----------->
   |            .-parmlib_default_medianame-.   (1) |   
   +-MEDIANAME(-+-medianame-----------------+-)-----+   
   |                   (1)                          |   
   +-POOL(pool_prefix)------------------------------+   
   +-LOCATION(-+-library_name-+-)-------------------+   
   |           '-SHELF--------'                     |   
   |                              (1)               |   
   +-MEDIATYPE(-+-*-----------+-)-------------------+   
   |            +-CST---------+                     |   
   |            +-ECCST-------+                     |   
   |            +-EHPCT-------+                     |   
   |            +-HPCT--------+                     |   
   |            +-+-MEDIA5-+--+                     |   
   |            | '-ETC----'  |                     |   
   |            +-+-MEDIA6-+--+                     |   
   |            | '-EWTC---'  |                     |   
   |            +-+-MEDIA7-+--+                     |   
   |            | '-EETC---'  |                     |   
   |            +-+-MEDIA8-+--+                     |   
   |            | '-EEWTC--'  |                     |   
   |            +-+-MEDIA9-+--+                     |   
   |            | '-EXTC---'  |                     |   
   |            +-+-MEDIA10-+-+                     |   
   |            | '-EXWTC---' |                     |   
   |            +-+-MEDIA11-+-+                     |   
   |            | '-EATC----' |                     |   
   |            +-+-MEDIA12-+-+                     |   
   |            | '-EAWTC---' |                     |   
   |            '-+-MEDIA13-+-'                     |   
   |              '-EAETC---'                       |   
   |                                 (1)            |   
   '-RECORDINGFORMAT(-+-*--------+-)----------------'   
                      +-18TRACK--+                      
                      +-36TRACK--+                      
                      +-128TRACK-+                      
                      +-256TRACK-+                      
                      +-384TRACK-+                      
                      +-EFMT1----+                      
                      +-EFMT2----+                      
                      +-EEFMT2---+                      
                      +-EFMT3----+                      
                      +-EEFMT3---+                      
                      +-EFMT4----+                      
                      '-EEFMT4---'                      

>--+-----------------------------+--+----------+---------------->
   |        (1)  .-NOTMASTER-.   |  +-VERIFY---+   
   '-STATUS----(-+-ALL-------+-)-'  '-NOVERIFY-'   
                 '-SCRATCH---'                     

>--+-----------------------------+-----------------------------><
   |             .-FAIL------.   |   
   '-WRONGLABEL(-+-IGNORE----+-)-'   
                 +-PROMPT----+       
                 '-RMMPROMPT-'

Notes:

Specify this parameter for automatic processing.

ALVER3

Use ALVER3 to set the EDGINERS processing default value for ISO/ANSI label tapes to version 3. To understand how the DFSMSrmm assigns the label version, see How DFSMSrmm selects an ISO/ANSI label Version.

ALVER4

Use ALVER4 to set the EDGINERS processing default value for ISO/ANSI label tapes to version 4. To understand how the DFSMSrmm assigns the label version, see How DFSMSrmm selects an ISO/ANSI label Version.

BATCH(number_of_batches)

Use BATCH to specify the number of batches of volumes to be processed in a single run of EDGINERS automatic processing. Use the COUNT parameter to specify the number of volumes in each batch. The COUNT is the number of volumes that are initialized or erased before DFSMSrmm verifies the volumes. After DFSMSrmm verifies the volumes in a batch, EDGINERS starts again to initialize or erase the volumes in the next batch.

If you specified the NOVERIFY parameter, the number of volumes that are processed is the BATCH value or its default, multiplied by the value of COUNT or its default. However, DFSMSrmm does not batch the processing of these volumes.

The default for BATCH is BATCH(1). To process all volumes that have actions pending, specify BATCH(0). DFSMSrmm treats BATCH(0) as BATCH(X'FFFFFFFF'), which is the upper limit for the number of batches that DFSMSrmm can process.

COUNT(count)

Use COUNT to specify the number of volumes to initialize or to erase when DFSMSrmm performs automatic processing. Use COUNT with the BATCH parameter to specify the number of volumes in each batch of volumes to be processed. The maximum value that you can specify is 99. If automatic processing is in effect but COUNT is omitted, then the default value is 10. When you specify COUNT, DFSMSrmm performs automatic processing.

ERASE(DSE|INIT|SHRED|SHREDDSE)

Use ERASE to request that DFSMSrmm selects volumes that have the erase action pending. If automatic processing is in effect but ERASE is not specified then DFSMSrmm will only select volumes with the initialize action pending. When you specify ERASE, DFSMSrmm performs automatic processing.

ERASE can be specified either as ERASE or as ERASE(value). Specifying ERASE without a value (that is, as ERASE) is the same as specifying ERASE(DSE). You can optionally specify one of the following values for ERASE to select the action to be performed by the tape drive:

DSE: Specifies that a Data Secure Erase (DSE) should be attempted. This exploits the tape drive hardware capability to erase data from the volume. This is the default value if the ERASE parameter is omitted or specified without a value.
INIT: Specifies that an ERASE action equates to an INIT action; no secure erase is attempted and the volume is relabelled as if the INIT action had been requested.
SHRED: For encrypted volumes, this value specifies that the Data Key should be made unusable by the drive. For non-encrypted volumes the DSE action is attempted.
SHREDDSE: For encrypted volumes, this value specifies that the Data Key should be made unusable by the drive, and that any non-encrypted residual data on the volume should be subject to DSE. For non-encrypted volumes, the DSE action is attempted.

INITIALIZE

Use INITIALIZE to request that DFSMSrmm selects volumes that have the initialize action pending. If automatic processing is in effect but neither INITIALIZE nor ERASE are specified, then INITIALIZE is the default. You can also specify INITIALISE for INITIALIZE. When you specify INITIALIZE, DFSMSrmm performs automatic processing.

LOCATION(library_name)

Use LOCATION to specify a subset of volumes for automatic processing. The library_name must be the name of a system-managed tape library that is on the running system or SHELF. If you specify LOCATION, you cannot specify MEDIANAME, MEDIATYPE, POOL, or RECORDINGFORMAT.

There is no default library_name value. If you do not specify LOCATION, MEDIANAME, MEDIATYPE, POOL, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes defined with the default medianame are selected if they have the required action pending.

MEDIANAME(medianame | parmlib_default_medianame)

Use MEDIANAME to specify a subset of volumes for automatic processing. If you specify MEDIANAME, you cannot specify LOCATION, MEDIATYPE, POOL, or RECORDINGFORMAT. If you do not specify LOCATION, MEDIANAME, MEDIATYPE, POOL, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes defined with the default medianame are selected if they have the required action pending.

DFSMSrmm does not use MEDIANAME to set a default for the SYSIN INIT and ERASE commands MEDIANAME operand.

The default MEDIANAME is the value that you define with the EDGRMMxx parmlib OPTION MEDIANAME operand described in Defining system options: OPTION.

Use MEDIATYPE to specify a subset of volumes for automatic processing. Specifies the volume's physical media type. Use one of these:

*: The volume is not a cartridge.
CST: Cartridge System Tape
ECCST: Enhanced Capacity Cartridge System Tape
EHPCT: Extended High Performance Cartridge Tape
HPCT: High Performance Cartridge Tape
MEDIA5/ETC: IBM TotalStorage Enterprise Tape Cartridge
MEDIA6/EWTC: IBM TotalStorage Enterprise WORM Tape Cartridge 3592
MEDIA7/EETC: IBM TotalStorage Enterprise Economy Tape Cartridge 3592
MEDIA8/EEWTC: IBM TotalStorage Enterprise Economy WORM Tape Cartridge 3592
MEDIA9/EXTC: IBM TotalStorage Enterprise Extended Tape Cartridge 3592
MEDIA10/EXWTC: IBM TotalStorage Enterprise Extended WORM Tape Cartridge 3592
MEDIA11/EATC: IBM Enterprise Advanced Tape Cartridge
MEDIA12/EAWTC: IBM Enterprise Advanced WORM Tape Cartridge
MEDIA13/EAETC: IBM Enterprise Advanced Economy Cartridge

When you specify MEDIATYPE, DFSMSrmm performs automatic processing. If you specify MEDIATYPE, you cannot specify LOCATION, MEDIANAME, POOL, or RECORDINGFORMAT.

There is no default MEDIATYPE value. If you do not specify LOCATION, MEDIANAME, MEDIATYPE, POOL, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes defined with the default medianame are selected if they have the required action pending.

POOL(pool_prefix)

Use POOL to specify a subset of volumes for automatic processing. A pool prefix is one-to-five alphanumeric, national, or special characters followed by an asterisk (*). The pool must be one that is defined to DFSMSrmm on the running system. If you specify POOL, you cannot specify LOCATION, MEDIANAME, MEDIATYPE, or RECORDINGFORMAT.

There is no default pool_prefix value. If you do not specify LOCATION, MEDIANAME, MEDIATYPE, POOL, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes defined with the default medianame are selected if they have the required action pending.

Use RECORDINGFORMAT to specify a subset of volumes for automatic processing. RECORDINGFORMAT specifies the basic recording format for tape volumes.

*: An asterisk indicates that the format is unknown or that the volume is not a tape volume.
18TRACK: Data has been written to the volume in 18-track format. A recording format of 18TRACK is valid with MEDIATYPE(CST) and MEDIATYPE(ECCST) only.
36TRACK: Data has been written to the volume in 36-track format. A recording format of 36TRACK is valid with MEDIATYPE(CST) and MEDIATYPE(ECCST) only.
128TRACK: Data has been written to the volume in 128-track format. A recording format of 128TRACK is valid with MEDIATYPE(EHPCT) and MEDIATYPE(HPCT) only.
256TRACK: Data has been written to the volume in 256-track format. A recording format of 256TRACK is valid with MEDIATYPE(EHPCT) and MEDIATYPE(HPCT) only.
384TRACK: Data has been written to the volume in 384-track format. A recording format of 384TRACK is valid with MEDIATYPE(EHPCT) and MEDIATYPE(HPCT) only.
EFMT1: Data has been written to the volume in EFMT1 (enterprise format 1) recording format. A recording format of EFMT1 is valid with MEDIATYPE(MEDIA5), MEDIATYPE(MEDIA6), MEDIATYPE(MEDIA7), and MEDIATYPE(MEDIA8) only.
EFMT2: Data has been written to the volume in EFMT2 (enterprise format 2) recording format. A recording format of EFMT2 is valid with MEDIATYPE(MEDIA5), MEDIATYPE(MEDIA6), MEDIATYPE(MEDIA7), MEDIATYPE(MEDIA8), MEDIATYPE(MEDIA9), and MEDIATYPE(MEDIA10) only.
EEFMT2: Data has been written to the volume in EEFMT2 (enterprise encrypted format 2) recording format. A recording format of EEFMT2 is valid with MEDIATYPE(MEDIA5), MEDIATYPE(MEDIA6), MEDIATYPE(MEDIA7), MEDIATYPE(MEDIA8), MEDIATYPE(MEDIA9), and MEDIATYPE(MEDIA10) only.
EFMT3: Data has been written to the volume in EFMT3 (enterprise format 3) recording format. A recording format of EFMT3 is valid with MEDIATYPE(MEDIA5, MEDIA6, MEDIA7, MEDIA8, MEDIA9, and MEDIA10) only.
EEFMT3: Data has been written to the volume in EEFMT3 (enterprise encrypted format 3) recording format. A recording format of EEFMT3 is valid with MEDIATYPE(MEDIA5, MEDIA6, MEDIA7, MEDIA8, MEDIA9, and MEDIA10) only.
EFMT4: Data has been written to the volume in EFMT4 (enterprise format 4) recording format. A recording format of EFMT4 is valid with MEDIATYPE(MEDIA9, MEDIA10, MEDIA11, MEDIA12, and MEDIA13) only.
EEFMT4: Data has been written to the volume in EEFMT4 (enterprise encrypted format 4) recording format. A recording format of EEFMT4 is valid with MEDIATYPE(MEDIA9, MEDIA10, MEDIA11, MEDIA12, and MEDIA13) only.

There is no default RECORDINGFORMAT. If you do not specify LOCATION, MEDIANAME, MEDIATYPE, POOL, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes defined with the default medianame are selected if they have the required action pending.

STATUS

Use STATUS to control the kind of tapes that you want DFSMSrmm to initialize or erase. The default for STATUS is NOTMASTER. Specifying STATUS requests automatic processing.

ALL: EDGINERS processes all volumes that have the INITIALIZE or ERASE action pending.
NOTMASTER: EDGINERS processes all volumes in SCRATCH, USER, INIT, ENTRY or PENDING RELEASE status that have the INITIALIZE or ERASE action pending. EDGINERS does not process any volumes in MASTER status. NOTMASTER is the default.
SCRATCH: EDGINERS processes volumes in SCRATCH, INIT, ENTRY or PENDING RELEASE status that have the INITIALIZE or ERASE action pending. EDGINERS does not process any volumes in MASTER or USER status.

VERIFY|NOVERIFY

Use VERIFY to request that DFSMSrmm ask the operator to remount each volume that has been successfully erased or labeled. The volumes are requested in reverse order, and the volume labels read to ensure no operator errors have occurred, for example, a mismatch between the internal label and the external label.

For automatic processing VERIFY is the default. For manual processing NOVERIFY is the default.

WRONGLABEL

Use WRONGLABEL to specify the processing that DFSMSrmm performs when a wrong volume is mounted. WRONGLABEL processing does not apply to NL tapes. For NL tapes, DFSMSrmm issues the WTOR EDG6628A to obtain the volume serial number or rack number for the volume that has been mounted. You can use WRONGLABEL when you are running EDGINERS in automatic mode and manual mode.

FAIL: DFSMSrmm does not prompt the operator to accept a mounted volume that does not match the requested volume. The mount request is rejected, the volume demounted, and DFSMSrmm issues message EDG6661E or message EDG6662E. FAIL is the default.
IGNORE: When the wrong volume is mounted, DFSMSrmm does not issue any operator prompt. DFSMSrmm issues message EDG6661E or EDG6662E to log the relabeling and processing proceeds. This is an extremely dangerous option and should be used with caution because any volume can be relabeled as long as the requested volume has the INIT action or is not defined to DFSMSrmm. Use of this option requires CONTROL access to RACF FACILITY class resource STGADMIN.EDG.INERS.WRONGLABEL.
PROMPT: When an incorrect volume label is detected by EDGINERS for the mounted volume, the operator is always prompted to confirm the processing to be performed. DFSMSrmm issues message EDG6661E or message EDG662E, followed by message EDG6663D. Processing continues according to the response to message EDG6663D. This option should be used with caution because any volume can be relabeled as long as the requested volume is either known to DFSMSrmm and has the INIT action, or is not known to DFSMSrmm. No additional authorization is required, other than the authorization required for running EDGINERS.
RMMPROMPT: When the volume serial number of the mounted volume that is defined to DFSMSrmm does not match the volume serial number of the requested volume, DFSMSrmm issues message EDG6663D to prompt the operator to confirm processing. If the magnetic volume serial number of the tape is not known to DFSMSrmm, initialization continues as if the tape had no magnetic label. If the volume is known to DFSMSrmm, DFSMSrmm issues messages EDG6662E and EDG6663D to prompt the operator or issues message EDG6661E to log the relabeling. Use this option when your installation has defined all its volumes to DFSMSrmm; otherwise caution is required. Use of this option requires UPDATE access to RACF FACILITY class resource STGADMIN.EDG.INERS.WRONGLABEL.