DELETEBIN: Deleting bin number information

Purpose

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

The DELETEBIN subcommand is an alias for the DELETERACK subcommand. See DELETERACK: Deleting shelf location information for the combined description of the DELETERACK and DELETEBIN operands.

DFSMSrmm defines shelf space in storage locations as bin numbers. Use the DELETEBIN subcommand to delete information about shelf locations you are no longer using in built-in or installation defined storage locations.

To delete bin numbers from a built-in storage location, specify an asterisk as the bin number and the name of a built-in storage location, LOCAL, REMOTE, or DISTANT. Specify a COUNT value to indicate how many bin numbers DFSMSrmm deletes. DFSMSrmm deletes bin numbers starting with the highest bin number defined for the storage location until it reaches either the count value you specify or a bin number still containing a volume. If DFSMSrmm cannot delete all the bin numbers you requested, it displays an error message indicating that it could not reach the count.

To delete one or more bin numbers from an installation-defined storage location, provide the initial bin number, the location name, and the media name. Specify a COUNT value to indicate how many bin numbers DFSMSrmm deletes. DFSMSrmm deletes bin numbers starting from the initial bin number and deletes bin numbers following the initial bin number until it reaches the count value you specify or a bin number containing a volume.

You can use location names and media names on the DELETEBIN subcommand that are not currently defined to DFSMSrmm. This lets you clean up bin numbers that have been defined in error or after the change or removal of LOCDEF commands from the EDGRMMxx parmlib.

Format


>>-+-DELETEBIN-+------------------------------------------------>
   '-DB--------'   

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

>--+-----------------------------+-----------------------------><
   |        .-1--------------.   |   
   '-COUNT(-+-number_of_bins-+-)-'   

MEDIANAME

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

Parameters

bin_number|*

Specifies the shelf location in a storage location. Immediately following the DELETEBIN subcommand you must use either a bin number for an installation defined storage location or an * for a built-in storage location. You must also give a location name and media name.

A bin number in an installation defined storage location is six alphanumeric or national characters in any combination.

Specify an * to delete a bin number from a built-in storage location. When you use one of the built-in storage location names, LOCAL, DISTANT, or REMOTE, you do not provide a bin number because DFSMSrmm keeps track of bin numbers for built-in storage locations. The bin_number to be deleted empty.

COUNT(number_of_bins)

Specifies how many bin numbers DFSMSrmm deletes from a specified 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 delete shelf space.

Installation defined storage locations are names up to eight characters long and are defined using the LOCDEF parmlib command. You can delete bin numbers in installation defined storage locations even if the LOCDEF command for the installation is not in the current parmlib. To delete one or more bin numbers from an installation defined storage location, provide an initial bin number. MEDIANAME must also be specified. You can specify a COUNT value. If you use one of the built-in storage location names, LOCAL, DISTANT, or REMOTE, use an * as the bin number. You can specify a COUNT value. You cannot use MEDIANAME with a built-in storage location name.

MEDIANAME(medianame|*)

Specifies the media that can reside in a shelf location. medianame can be eight characters. Specify an * to delete bin numbers from a built-in storage location.

Task: Remove information about eight shelf locations in the installation defined storage location MYLOC that no longer have volumes assigned to them. The bin numbers are A00001 to A00008 inclusive.

Command:

  RMM DELETEBIN A00001 LOCATION(MYLOC) COUNT(8) MEDIANAME(SQUARE)

Task: Remove 10 empty bin numbers from the DISTANT storage location. If there are 100 bin numbers defined in the storage location, DFSMSrmm deletes bin numbers 91 through 100 inclusive.

Command:

RMM DELETEBIN * LOCATION(DISTANT) COUNT(10)

Task:

If you changed DFSMSrmm built-in storage locations, LOCAL, DISTANT and REMOTE, to installation defined locations, you might still have some DFSMSrmm assigned bin numbers for the location. To delete these bin numbers, issue the DELETEBIN subcommand with an * for the bin number and provide one of the built-in storage location names. Use the RMM LISTCONTROL subcommand to find out how many bin numbers can be deleted.

Command:

RMM DELETEBIN * LOCATION(REMOTE) COUNT(nnnnn)

Return codes

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

0: Subcommand completed normally.
4: Warning. Subcommand completed but some operands might 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.