ADDRACK: Adding a shelf location

Purpose

Before you begin: To use the RMM ADDRACK subcommand, you need CONTROL access to the STGADMIN.EDG.MASTER resource profile.

This topic describes the combined description for the ADDRACK subcommand and its alias ADDBIN. See ADDBIN: Adding a bin number in a storage location for information about using the RMM ADDRACK subcommand alias.

Use the ADDRACK subcommand to define shelf locations in the removable media library and storage locations. DFSMSrmm defines shelf space in the removable media library as rack numbers and bin numbers in storage locations. Use the ADDRACK subcommand to define available rack numbers and bin numbers to DFSMSrmm.

You can add rack numbers to particular pools in your removable media library, as defined by your installation. Pools are groups of rack numbers with a common prefix. Use the LISTCONTROL subcommand with the VLPOOL operand to view the pool IDs defined for your installation, as well as information on individual pools. See z/OS DFSMSrmm Implementation and Customization Guide for more information on pooling strategies.

To add one or more rack numbers to the removable media library, you must supply an initial rack number. You can also indicate how many rack numbers you want to add. If you add more than one rack number at a time, use an initial rack number that can accommodate the number of volumes you might add. For example, if you supply an initial rack number of RA9992, you can only add eight rack numbers. If you add ten rack numbers, DFSMSrmm issues a warning message indicating that it cannot add all rack numbers.

To add rack numbers to be used for volumes in a specific system-managed library in the removable media library, add them to a pool in that library. For example, if you have a manual tape library in which pool KD* resides, you can add rack numbers to that library by using a rack number with the prefix KD as the initial rack number.

Table 1 shows the relationship between rack numbers and the three types of volumes that DFSMSrmm manages.

Table 1. Assigning rack numbers to volumes that DFSMSrmm manages
For a	You	Optionally
Physical Volume	Can specify a rack number or pool prefix.	DFSMSrmm tries to use the volume serial number of the volume as the rack number. If DFSMSrmm cannot find the rack number that matches the volume serial number, no rack number is assigned.
Logical Volume	Cannot specify a rack number or pool prefix.	DFSMSrmm does not assign a rack number to the logical volume because the logical volume is associated with a stacked volume container or library rather than a rack number or pool.
Stacked Volume	Can specify a rack number or pool prefix.	DFSMSrmm tries to use the volume serial number of the volume as the rack number. If DFSMSrmm cannot find the rack number that matches the volume serial number, no rack number is assigned.

To add bin numbers to a built-in storage location, use * as the bin number and provide a storage location name. You can also specify how many bins you want to add. DFSMSrmm automatically assigns the bin numbers. To add bin numbers to an installation-defined storage location, provide an initial bin number, a storage location name, and a media name. You can also specify how many bins you want to add.

Use the LISTCONTROL subcommand with the CNTL operand to determine how many bin numbers are already defined and how many bin numbers are currently in use as shown in LISTCONTROL: Displaying parmlib options and control information.

See LISTBIN: Displaying information about a shelf location to obtain information about individual bin numbers.

Format


>>-+-ADDRACK-+-------------------------------------------------->
   +-AR------+   
   +-ADDBIN--+   
   '-AB------'   

                  .-LOCATION(SHELF)-.                              
>--+-rack_number--+-----------------+--------------------------+-->
   +-bin_number--LOCATION(LOCDEF_location_name)--| MEDIANAME |-+   
   '-*--LOCATION(-+-LOCAL---+-)--------------------------------'   
                  +-DISTANT-+                                      
                  '-REMOTE--'                                      

>--+--------------------------------------+--------------------->
   |        .-1-----------------------.   |   
   '-COUNT(-+-number_of_racks_or_bins-+-)-'   

>--+-----------------------+-----------------------------------><
   '-TZ({+|-}HH[:MM[:SS]])-'   

MEDIANAME

|--MEDIANAME(-+-*---------+-)-----------------------------------|
              '-medianame-'

Parameters

bin_number,*

Specifies the shelf location in a storage location. Use a bin number to define a shelf location in an installation defined storage location. A bin number in an installation defined storage location is six alphanumeric or national characters in any combination. You must also give a location name and media name.

Use an * to add bin numbers to a built-in storage location. If you use one of the built-in storage location names, LOCAL, DISTANT or REMOTE, DFSMSrmm determines the bin numbers that are used.

You must use either a bin number or an *, immediately following the ADDBIN subcommand.

COUNT(number_of_racks_or_bins)

Specifies the number of rack numbers to add to the removable media library or the number of bin numbers to add to a storage location. The value is one to five numbers. The maximum allowable decimal value is 99999.

The default value is 1.

LOCATION(SHELF|DISTANT|LOCAL|REMOTE|LOCDEF_location_name)

Specifies the location where you want to add shelf space. Use SHELF to add shelf locations to your removable media library. A removable media library is either a SHELF location or a system-managed library.

The DFSMSrmm built-in storage location names are LOCAL, DISTANT, and REMOTE. You cannot use the MEDIANAME with DISTANT, LOCAL, or REMOTE when they are used as built-in storage location names.

LOCDEF_location_name can be a name up to eight characters long. It is the installation defined storage location name defined on LOCDEF in the current parmlib. To add bin numbers to an installation defined storage location, you provide the bin numbers that DFSMSrmm assigns. MEDIANAME must also be specified. If you do not use the LOCATION operand, DFSMSrmm adds rack numbers to the removable media library.

MEDIANAME(medianame|*)

Specifies the media that can reside in a shelf location. medianame can be up to eight characters and must appear in the MEDIANAME value in the parmlib LOCDEF parameters for the LOCATION specified or DFSMSrmm rejects the request. If an * is specified, bins are allocated for a volume of any media name. Any other media name specifies that only volumes of that media name can be allocated to the bin number.

MEDIANAME is not specified for adding rack numbers because the media name is obtained from the current VLPOOL definitions.

rack_number

Specifies a rack number to be added to the removable media library. This can be either a single rack number or the initial rack number, if you are adding more than one rack number. If you are adding multiple rack numbers, your initial rack number must contain numeric suffixes so that DFSMSrmm can automatically define each new rack number. A rack number is one-to-six alphanumeric, national, or special characters. Enclose it in single quotation marks if it contains any special characters.

You must use either a bin number, rack number or an asterisk (*), immediately following the ADDRACK subcommand.

If you specify library_name as the LOCATION value, the rack number the same as the volume serial number.

TZ({+|-}HH[:MM[:SS]])

Specifies the time zone offset when date and time values are specified. The format is {+|-}HH[:MM[:SS]] where:

+|- is the offset direction. Specify + to indicate that the offset is East of the zero median (UT). Specify - to indicate that the offset is West of the zero median (UT). The offset direction is required.
HH is hours
MM is minutes
SS is seconds

An optional colon (:) separates hours from optional minutes and optional seconds.

You can specify a time in the range between 00:00:00 to 15:00:00 for HH:MM:SS. MM and SS value range is 00 to 59.

Task: Add five empty racks to the removable media library, starting with rack number ABUB02.

Command:

  RMM ADDRACK ABUB02 COUNT(5)

Task: Add ten empty bin numbers to the LOCAL storage location by using the alias ADDBIN.

Command:

  RMM ADDBIN * LOCATION(LOCAL) COUNT(10)

Return codes

See DFSMSrmm return codes and reason codes for DFSMSrmm reason codes.

0: Subcommand completed normally.
4: Warning. Subcommand completed but some operands could have been ignored or modified. DFSMSrmm sets a reason code.
8: User not authorized.
12: Subcommand ended with an error. DFSMSrmm sets a reason code.
16: Error. The DFSMSrmm subsystem is not active.
20: Error. The data is incomplete or incorrect and the TSO user has set NOPROMPT.
24: The TSO subcommand is not APF authorized.
28: The user pressed the attention key.