1 07/08/88 list_vols
  2 
  3 Syntax as a command:  list_vols {lv_name} {-control_args}
  4 
  5 
  6 Syntax as an active function:  [list_vols {lv_name} {-control_args}]
  7 
  8 
  9 Function:  prints information about currently-mounted physical or
 10 logical volumes.  Several of the items printed by list_vols can also be
 11 obtained as return values by invoking list_vols as an active function.
 12 
 13 
 14 Arguments:
 15 lv_names
 16    prints information about the logical volume lv_name.  This is the
 17    default if a name is given without -lv or -pv preceding it.
 18 
 19 
 20 Control arguments:
 21 -grand_total, -gtt
 22    prints a single number about the total records left or records used
 23    on the system.  This is used in conjunction with the -rec_used
 24    control argument, or if no other control argument is given,
 25    -rec_left is assumed.  This allows a command line equivalent of
 26    active function usage as:  [list_vols -rec_left] or [list_vols
 27    -rec_used] where -rec_left is also the default.
 28 -lv name(s)
 29    prints information about the logical volume(s) named.  A single name
 30    or several names, separated by space, can be given.
 31 -pv name
 32    prints information about only the physical volume named.
 33 
 34 
 35 -records, -rec
 36    prints only the number of records on the specified volume(s),
 37    exclusive of records occupied by partitions and the volume table of
 38    contents (VTOC).  This is one of the items that can be obtained as
 39    an active function return value.
 40 -records_left, -rec_left
 41    prints only the number of records on the specified volume(s) that
 42    are currently unused and are available to hold the pages of segments
 43    and directories.  This is one of the items that can be obtained as
 44    an active function return value.  (This is the default.)
 45 
 46 
 47 -records_used, -rec_used
 48    prints the number of records on the specified volume(s) that are
 49    used.  This can be obtained as an active function value.
 50 -totals, -tt
 51    does not print information for individual physical volumes but
 52    rather totals and prints for each logical volume.
 53 
 54 
 55 Access required:  This command requires access to phcs_ or
 56 metering_gate_ as well as mdc_.
 57 
 58 
 59 Notes:  If no volume name is given, the list_vols command prints
 60 information about all mounted logical volumes.
 61 
 62 If physical volume information is being printed, there may be up to two
 63 flags printed immediately to the right of the drive name.  The flags
 64 are "X" (if a drive is inoperative) and "I" (if a drive is inhibited
 65 for segment creation).
 66 
 67 If a physical volume information is being printed, the average segment
 68 size, to the nearest record, is printed per physical volume.
 69 
 70 If either logical volume or physical volume information is being
 71 printed, the percentages used or left for Records and VTOCEs is
 72 printed.
 73 
 74 If list_vols is used as an active function, either the -records or the
 75 -records_left control argument must be given.
 76 
 77 If the -totals argument is given together with the name of a logical
 78 volume, a single line containing totals information for that logical
 79 volume is printed.
 80 
 81 If physical volume information is being printed (-totals not given),
 82 the output lines contain the following items:
 83 
 84       Drive  flag  Records  Left  VTOCEs  Left  PV Name  PB/PD LV Name
 85 
 86 If logical volume information is being printed (-totals given), the
 87 output lines contain the following items:
 88 
 89       Records   Left   VTOCEs   Left PB/PD LV Name
 90 
 91 The following are brief descriptions of the above variables.
 92 Drive
 93    is the name of the drive on which the physical volume is mounted.
 94 flag
 95    is the letter "X" if the drive is inoperative.
 96 Records
 97    is the number of records not occupied by partitions or the VTOC, and
 98    therefore usable for the pages of segments and entries.
 99 
100 
101 Left
102    is the number of records currently unused and therefore available
103    for the pages of segments and directories.
104 VTOCEs
105    is the number of VTOC entries.
106 Left
107    is the number of unused VTOC directories.
108 PV Name
109    is the name of the physical volume.
110 
111 
112 PB/PD
113    contains "pb" if the logical volume is public, and "pd" if it has
114    been designated as being available to hold the segments in process
115    directories.
116 LV Name
117    is the name of the logical volume.