LISTBIN: Displaying information about a shelf location

Purpose

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

The LISTBIN subcommand is an alias for the LISTRACK subcommand. See LISTRACK: Displaying information about a shelf location for the combined description of the LISTRACK and LISTBIN operands.

Use the LISTBIN subcommand to display information about a single shelf location defined to DFSMSrmm. DFSMSrmm defines shelf space in the storage location as bin numbers.

Use the RMM SEARCHBIN subcommand to request a list of bin numbers that are defined to DFSMSrmm. See SEARCHBIN: Creating a list of bin numbers for more information.

Format


>>-+-LISTBIN-+--+-bin_number--LOCATION(-+-LOCAL---+-)-+--------><
   '-LB------'  |                       +-DISTANT-+   |   
                |                       '-REMOTE--'   |   
                '-bin_number--| LOCDEF bin numbers |--'   

LOCDEF bin numbers

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

Parameters

bin_number

Specifies a shelf location in a storage location. When used with the built-in storage location names, LOCAL DISTANT, and REMOTE, a bin number is six numeric characters. You must specify leading zeros. When used with installation defined storage locations, a bin number is six alphanumeric or national characters and MEDIANAME specified.

A bin number is required and must immediately follow the LISTBIN subcommand.

LOCATION(LOCAL|DISTANT|REMOTE|LOCDEF_location_name)

Specifies to request information about a shelf location in a specific storage location. Specify a DFSMSrmm built-in storage location name, DISTANT, LOCAL, or REMOTE.

LOCDEF_location_name. can be any name up to eight characters long. For an installation defined storage location, MEDIANAME must also be specified.

The storage location name does not have to be one that is currently defined using the LOCDEF command. If you do not specify the LOCATION operand, DFSMSrmm lists information about a rack number in the removable media library.

MEDIANAME(medianame|*)

Specifies the media for the bins that are displayed. MEDIANAME is required when you request a display of an installation defined storage location.

Examples

Task: Request information recorded by DFSMSrmm about the shelf location in the storage location, MYLOC, identified by bin number BIN100, with a media name of SQUARE.

Command:

  RMM LISTBIN BIN100 LOCATION(MYLOC) MEDIANAME(SQUARE)

Output: DFSMSrmm displays information as that shown in Figure 1:

Figure 1. Sample LISTBIN output

Rack/bin number = M00001   Location = MAZBIN     Media name = 3480 
Status          = IN USE                         Pool       =      
Volume:                                                            
  Current       =                                                  
  Moving-in     = V10000                                           
  Moving-out    =                                                  
  Old           = V10000                                           
                                                                   
Last Change information:                                           
Date             = 01/05/2011  Time = 02:29:53  System  = EZU0000  
User change date = 01/05/2011  Time = 02:29:50  User ID = *HKP

Return codes

See DFSMSrmm return codes and reason codes for DFSMSrmm return and 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.