ADDBIN: Adding a bin number in a storage location

Purpose

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

The ADDBIN subcommand is an alias for the ADDRACK subcommand. See ADDRACK: Adding a shelf location for the combined description of the ADDRACK and ADDBIN operands.

DFSMSrmm defines shelf space in storage locations as bin numbers. Use the ADDBIN subcommand to define empty or available shelf locations in storage locations. The storage locations can be DFSMSrmm built-in storage locations or storage locations that are defined by your installation.

To add one or more bin numbers to an installation-defined storage location, supply an initial bin number that identifies the shelf location, the installation-defined location name, and a media name. You indicate the number of bin numbers you want to add, by using the COUNT operand. If you add more than one bin number at a time, select an initial bin number that is long enough and low enough to accommodate the count value you specify, without exceeding the numeric capabilities of the suffix. For example, if you supply an initial bin number of RA9992 and request that ten bin numbers be added, DFSMSrmm issues a warning message indicating that it cannot add all bin numbers.

To add bin numbers to a DFSMSrmm built-in storage location, use an * in place of a bin number and provide a built-in storage location name LOCAL, REMOTE, or DISTANT. You can provide the number of bins you want to add. DFSMSrmm automatically assigns the bin numbers.

You can use the LISTCONTROL CNTL subcommand to determine how many bin numbers are defined and how many bin numbers are currently in use in the built-in storage locations. See LISTCONTROL: Displaying parmlib options and control information for more information.

Format


>>-+-ADDBIN-+--------------------------------------------------->
   '-AB-----'   

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

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

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_bins)

Specifies the number of bins 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(LOCAL|DISTANT|REMOTE|LOCDEF_location_name)

Specifies the storage location where you want to add shelf space. LOCAL, DISTANT, and REMOTE are DFSMSrmm built-in storage location names. You cannot use MEDIANAME with a built-in storage location name.

LOCDEF_location_name can be any name up to eight characters. 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 to use. MEDIANAME must also be specified if you use a LOCDEF_location_name.

MEDIANAME(medianame|*)

Defines 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 use by volumes of any media name. Any other media name specifies that only volumes of that media name can be allocated to the bin 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 5 empty shelf locations to the installation defined storage location, MYLOC, starting with bin number LN0002. Round media are accepted into this storage location.

Command:

  RMM ADDBIN LN0002 LOCATION(MYLOC) COUNT(5) MEDIANAME(ROUND)

Task: Add ten empty bin numbers to the LOCAL built-in storage location.

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.