Commands › DRAIN Command › When STAM is Active › Parameter Descriptions

Parameter Descriptions

The following provides a description of each parameter when STAM is active:

[ NOTAVL ]

Makes the specified drives unavailable for allocation. NOTAVL is provided for sites that need a drained status that is stronger than the normal drained status. When the status of a tape drive is NOTAVL, you must specify the AVL status on the START or STAM VARY command to make the drive available again.

{ raddrs | LOCation location }

Lists the real addresses (raddrs) or location of the tape drives to drain.

You can specify real addresses using one of the following formats:

• raddr

  Specifies one raddr

• raddr1 raddr2 ... raddrn

  Specifies multiple, non-contiguous raddrs

• name1 name2 ... namen

  Specifies multiple global names for tape drives

• raddr1-raddrn

  Specifies all raddrs in a range of contiguous raddrs

  You can specify an asterisk for raddrs to drain all configured drives on the indicated system or systems.

  Note: For more information about values for location, see LOCation location Option.

{ [ ON ] sysid | ALL }

Specifies whether to drain the specified drives on one system only (sysid) or on all systems in the STAM complex (ALL).

The variable sysid is the STAM ID of the system. The default for sysid is specified in the STAM parameter file unless it has been temporarily overridden by a STAM SETP VARYSYS command.