Using the LABEL procedure to request EDGINERS processing

To use the LABEL procedure, use the command in Figure 1
Figure 1. LABEL command syntax diagram

1 S LABEL
1! OPT=NOVERIFY
1 OPT='%inersoptions'
1! ,U=3480
1 ,U=type
1! ,SOUT=DUMMY
1 ,SOUT=sysout
inersoptions

1! parmlib_default
1 ALVER3
1 ALVER4
2? BATCH(number_of_batches)
2? ,COUNT(count)
2? ERASE(
3.1! DSE
3.1 INIT
3.1 SHRED
3.1 SHREDDSE
2)
2? ,INITIALIZE
1 ,LOCATION(
2.1 library_name
2.1 SHELF
1)
1 ,MEDIANAME(
2.1! parmlib_default
2.1 medianame
1)
1 ,MEDIATYPE(
2.1 *
2.1 CST
2.1 ECCST
2.1 EHPCT
2.1 HPCT
2.2.1 MEDIA5
2.2.1 ETC
2.2.1 MEDIA6
2.2.1 EWTC
2.2.1 MEDIA7
2.2.1 EETC
2.2.1 MEDIA8
2.2.1 EEWTC
2.2.1 MEDIA9
2.2.1 EXTC
2.2.1 MEDIA10
2.2.1 EXWTC
2.2.1 MEDIA11
2.2.1 EATC
2.2.1 MEDIA12
2.2.1 EAWTC
2.2.1 MEDIA13
2.2.1 EAETC
1)
1 ,POOL(pool_prefix)
1 ,RECORDINGFORMAT(
2.1 *
2.1 18TRACK
2.1 36TRACK
2.1 128TRACK
2.1 256TRACK
2.1 384TRACK
2.1 EFMT1
2.1 EFMT2
2.1 EEFMT2
2.1 EFMT3
2.1 EEFMT3
2.1 EFMT4
2.1 EEFMT4
1)
1 STATUS(
2.1! NOTMASTER
2.1 ALL
2.1 SCRATCH
1)
1? NOVERIFY
1? VERIFY
1 WRONGLABEL(
2.1! FAIL
2.1 IGNORE
2.1 PROMPT
2.1 RMMPROMPT
1)
where:
OPT=NOVERIFY
This is the default value for OPT. NOVERIFY means that no additional verification is needed. If VERIFY is used, DFSMSrmm prompts you to remount each volume that has been erased or labeled. The volumes are requested in reverse order and the volume labels are read to ensure there are no label mismatches or other errors. Respond at the console to WTORs issued by EDGINERS.
OPT='inersoptions'
You can use any valid combination of EDGINERS EXEC parameters as a substitute for inersoptions. Separate each parameter with a comma. If you use any parameters, other than VERIFY or NOVERIFY, you are requesting an automatic run of EDGINERS. During an automatic run, EDGINERS uses the DFSMSrmm control data set for input and not the console.
ALVER3|ALVER4|parmlib_default
ALVER3
Use ALVER3 to initialize tape volumes with ISO/ANSI version 3 VOL1 and HDR1 labels. If you do not specify ALVER3 or ALVER4, DFSMSrmm uses the default label value from the parmlib DEVSUPxx member.
ALVER4
Use ALVER4 to initialize tape volumes with ISO/ANSI version 4 VOL1 and HDR1 labels. If you do not specify ALVER3 or ALVER4, DFSMSrmm uses the default label value from the parmlib DEVSUPxx member.
parmlib_default
DFSMSrmm uses the default label value from the parmlib DEVSUPxx member if you do not specify ALVER3 or ALVER4.
BATCH(number_of_batches)
Use BATCH to specify the number of batches of volumes to be processed in a single run of EDGINERS in automatic mode. Use the COUNT parameter to specify the batch size. Batch size is the number of volumes that will be initialized or erased before those volumes are verified. After verification is completed for one batch, EDGINERS starts again for the next batch.

If no verification is requested, the number of volumes 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). If all volumes in a location or pool with actions pending are to be processed, specify BATCH(0). DFSMSrmm treats BATCH(0) as BATCH(X'FFFFFFFF'), the upper limit for the number of batches that DFSMSrmm can process.

COUNT(count)
Use COUNT to specify the number of volumes to be selected for erasure or initialization by DFSMSrmm. The maximum value you can use is 99. If automatic processing is in effect but COUNT is omitted, then the default value is 10.
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.
You can optionally specify an operand value for ERASE to select the action to be performed by the tape drive for the ERASE action. The following values can be specified:
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 for the ERASE operand.
INIT
Specifies that an ERASE action equates to an INIT action; no secure data 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 select 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 use INITIALISE for INITIALIZE.
LOCATION(library_name|SHELF)
Use LOCATION to specify a subset of volumes for automatic processing. The library_name the name of a system-managed tape library that is on the running system. SHELF indicates that the library is a non-system-managed library. 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 DFSMSrmm selects all volumes that are defined with the default media name for processing if they have the required action pending.

MEDIANAME(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 MEDIANAME, MEDIATYPE, LOCATION, POOL, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes that are defined with the default medianame are selected if they have the required action pending.

DFSMSrmm does not use MEDIANAME to set a default media name for the z/OS® SYSIN INIT and ERASE commands MEDIANAME operand.

The default MEDIANAME is the value you define with the EDGRMMxx parmlib OPTION MEDIANAME operand.

MEDIATYPE(*| CST | ECCST | EHPCT | HPCT | MEDIA5 | MEDIA6 | MEDIA7 | MEDIA8 | MEDIA9 | MEDIA10 | MEDIA11 | MEDIA12 | MEDIA13)
Specifies the volume's physical media type. Use MEDIATYPE to specify a subset of volumes for automatic processing. Use one of these values:
*
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® Enterprise Tape Cartridge
MEDIA6/EWTC
IBM Enterprise WORM Tape Cartridge 3592
MEDIA7/EETC
IBM Enterprise Economy Tape Cartridge 3592
MEDIA8/EEWTC
IBM Enterprise Economy WORM Tape Cartridge 3592
MEDIA9/EXTC
IBM Enterprise Extended Tape Cartridge 3592
MEDIA10/EXWTC
IBM 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 Tape 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 MEDIATYPE, LOCATION, MEDIANAME, POOL, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes that are 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 value is one-to-five alphanumeric, national, or special characters followed by an asterisk (*). The pool 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 POOL, LOCATION, MEDIANAME, MEDIATYPE, or RECORDINGFORMAT, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes that are defined with the default medianame are selected if they have the required action pending.

RECORDINGFORMAT(* | 18TRACK | 36TRACK | 128TRACK | 256TRACK | 384TRACK | EFMT1 | EFMT2 | EEFMT2 | EFMT3 | EEFMT3 | EFMT4 | EEFMT4 )
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, MEDIA6, MEDIA7, and 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, MEDIA6, MEDIA7, MEDIA8, MEDIA9, and 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, MEDIA6, MEDIA7, MEDIA8, MEDIA9, and 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 RECORDINGFORMAT, LOCATION, MEDIANAME, MEDIATYPE, or POOL, DFSMSrmm uses MEDIANAME as the default parameter for automatic processing. This means that all volumes that are defined with the default media name 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 are read to ensure that no operator errors have occurred, for example, a mismatch between the internal label and the external label.

NOVERIFY means that no additional verification is needed. NOVERIFY is the default value.

WRONGLABEL
When DFSMSrmm detects that a wrong volume is mounted, it checks to see if the volume is defined to DFSMSrmm.
Use WRONGLABEL to specify the processing DFSMSrmm performs when the volume is mounted. WRONGLABEL can be used when running EDGINERS in both automatic 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 EDG6662E.
IGNORE
When the wrong volume is mounted, no operator involvement is required and processing proceeds after issuing a message to log the label that was detected. Either message EDG6661E or EDG6662E is issued to log the relabeling. This is an extremely dangerous option and should only be used with great caution. ANY volume can be relabeled as long as the requested volume has the INIT action or is not defined to DFSMSrmm. Using 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 either message EDG6661E or EDG662E, followed by message EDG6663D. Processing continues according to the response to message EDG6663D. This option should be used with caution as 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 that required for running EDGINERS.
RMMPROMPT
When the volume serial number of the mounted volume does not match the volser of the requested volume and the mounted volume is defined to DFSMSrmm, DFSMSrmm issues message EDG6663D to prompt the operator to confirm the processing to be performed. If the volser of the tape is not known to DFSMSrmm, initialization continues as if the tape had no label. If the volume is known to DFSMSrmm, DFSMSrmm issues messages EDG6662E and EDG6663D for the PROMPT option; otherwise EDG6661E is issued to log the relabeling. Use the PROMPT option only if all your volumes are known to DFSMSrmm; otherwise, caution is required when you specify PROMPT. UPDATE access to RACF FACILITY class resource STGADMIN.EDG.INERS.WRONGLABEL is required to use this option.
U=3480
This is the default value. Use the U keyword to identify either the device number or device type to be used for tape initialization or erase processing.
U=type
Use the U keyword to identify either the device number or device type to be used for tape initialization or erase processing. Your installation can define any type that is meaningful.
SOUT=DUMMY
This is the default value. It is used to ensure that the EDGINERS SYSPRINT file is not produced.
SOUT=sysout
Use SOUT to provide a valid DD statement keyword combination that is used for the EDGINERS SYSPRINT file. For example, by using SOUT='SYSOUT=A', the SYSPRINT file is produced in sysout class A. If this is a class that is available for printing, you can print the report and review any messages that DFSMSrmm has produced.

Tape mounts are issued for each volume you request to be initialized.