z/OS DFSMSrmm Implementation and Customization Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


REJECT command syntax

z/OS DFSMSrmm Implementation and Customization Guide
SC23-6874-00

Figure 1 shows the syntax of the REJECT command:

Figure 1. Parmlib member EDGRMMxx REJECT command syntax
Read syntax diagramSkip visual syntax diagram
>>-REJECT--+-OUTPUT(prefix)-+----------------+-+---------------><
           |                '-ANYUSE(prefix)-' |   
           '-ANYUSE(prefix)-+----------------+-'   
                            '-OUTPUT(prefix)-'     

You can specify multiple REJECT commands to define different ranges of tapes. However, use only one ANYUSE operand and one OUTPUT operand for each REJECT command, as shown in Figure 1.

DFSMSrmm allows all volume mounts. DFSMSrmm checks volume validity only when a data set on the volume is opened. When a data set on a volume is opened, DFSMSrmm checks the volume's shelf location against the prefixes specified in the REJECT command. If a volume has no library shelf location, DFSMSrmm checks the volume serial number against the prefixes specified in the REJECT command. DFSMSrmm recognizes the most specific prefix match. If you specify both ANYUSE and OUTPUT for the same prefix, ANYUSE overrides OUTPUT. Normally, REJECT prefixes match those that are used on VLPOOL commands, but it is not mandatory.

At OPEN time, DFSMSrmm can reject a range of tapes if you define the range of volumes to DFSMSrmm. DFSMSrmm cannot reject a range of tapes that are not defined to it.

You can use the REJECT ANYUSE command with an automated tape library to prevent volumes from being automatically defined in the TCDB when they are entered in an automated tape library. If the volume matches the REJECT ANYUSE command, the volume is not defined to the TCDB. Another system sharing the automated tape library can take the volume to define it in its TCDB only. You can also prevent a volume from being defined in the TCDB by specifying other than the USE(MVS) attribute when defining the volume to DFSMSrmm.

If you use REJECT OUTPUT commands, the volume is defined in the TCDB and can be entered into an automated tape library.

Use caution when using the REJECT command with an automated tape library as it is possible to continue needless rejecting of volumes.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014