The SHOW command lists a collection of attributes associated with the mix or with the disk subsystem or tape subsystem. The command selects the items being reported by specifying the attribute selection.
You can use the SHOW command to
-
Get a report on what is in the mix.
-
Identify disk packs or magnetic tapes.
-
Get reports about disk drives or magnetic tapes.
Syntax
<object type>
<attribute list>
<attribute selection>
<wild card>
<delim>
Use one of the following characters
/ \ I ~ ! @ # $ % ^ & * ' .
The first delimiter must be the same as the second delimiter.
<date value>
For <date value>
-
<month> is two digits representing the selected month.
-
<day> is two digits representing the day of the month.
-
<year> is four digits representing the year.
-
TODAY selects today's date.
-
<integer value> is used to adjust today's date by the number of specified days. A minus sign must precede the value.
Explanation
SHOW MIX <attribute list>
Displays the selected attributes for all mix entries (including libraries).
Each line of the output begins with the mix number, followed by the attribute values and then the task name.
You can specify the following attributes in the attribute list.
|
Attribute Name |
Type |
Description |
|---|---|---|
|
ACCESS |
String |
Process access code |
|
ASDSINUSE |
Integer |
Number of ASDs in use |
|
CHARGE |
String |
Process charge code |
|
CODEFILE |
String |
Title of the object code file |
|
CODEMEMORY |
Integer |
Memory used by the segment dictionary of the process |
|
COMPILER |
Boolean |
TRUE if the process is a compiler |
|
CONTROL |
Boolean |
TRUE if the process is a control program |
|
CPURATE |
Integer |
Recent processor usage of the process as a percentage |
|
CPUTIME |
Integer |
Process processor time |
|
ELAPSEDTIME |
Integer |
Process elapsed time |
|
IDENTITY |
String |
Process identity (from MP <code> + IDENTITY) |
|
INITPBITS |
Integer |
Count of initial presence bits |
|
INITPBITTIME |
Integer |
Processor time used for initial presence bits |
|
IOTIME |
Integer |
Process I/O time |
|
JOBNO |
Integer |
Process job number |
|
LOCKED |
Boolean |
TRUE if the process is a locked program |
|
MEMORY |
Integer |
Process total memory |
|
MIXNO |
Integer |
Process mix number |
|
MPID |
String |
The MPID attribute of the process |
|
NAME |
String |
Process name |
|
ORGLSN |
Integer |
LSN of originating station |
|
ORGSTATION |
String |
Station name where process originated |
|
OTHERPBITS |
Integer |
Count of non-initial presence bits |
|
OTHERPBITTIME |
Integer |
Processor time used for non-initial presence bits |
|
PRIORITY |
Integer |
Process priority |
|
PU |
Boolean |
TRUE if the process is a privileged program |
|
QUEUE |
Integer |
The job queue, if any, that is the source of the process |
|
READYQTIME |
Integer |
Process ready queue time |
|
RELEASEID |
String |
Release identity of process |
|
SAVEMEMORY |
Integer |
Save memory in use by the process |
|
SAVECODEMEMORY |
Integer |
Save memory used by the segment |
|
SECADMIN |
Boolean |
TRUE if the process has SECADMIN privilege from the MP SECADMIN command |
|
SUPPRESSED |
Boolean |
TRUE if the process is suppressed |
|
TASKING |
Boolean |
TRUE if the process has tasking |
|
USER |
String |
Process user code |
SHOW LIBS <attribute list>
Displays the selected attributes for all libraries.
Each line of the output begins with the mix number, followed by the attribute values and then the library name.
The library attributes that can be specified are the same as the mix attributes that were listed previously.
SHOW PK <attribute list>
Displays the selected attributes for all disks.
Each line of the output begins with the unit number, followed by the attribute values, and then followed by the disk name.
You can use the following attributes in the attribute list.
|
Attribute Name |
Type |
Description |
|---|---|---|
|
AVAILGB |
Integer |
Available space on a pack in gigabytes |
|
AVAILSECTS |
Integer |
Available space on a pack, in sectors |
|
BASEUNIT |
Integer |
Unit number of a base pack |
|
CACHED |
Boolean |
TRUE if unit is being cached |
|
CAPACITY |
Integer |
Capacity of a pack, in sectors |
|
CAPACITYGB |
Integer |
Capacity of a pack, in gigabytes |
|
CERTIFIED |
Boolean |
Certification status of mirrored pack |
|
CERTTIMESTAMP |
Date |
Timestamp of mirror certification |
|
DISKKEY |
String |
Name of the Disk Key that was used to encrypt this unit |
|
ECRYPTION |
Boolean |
True if the unit is encrypted |
|
FAMILYINDEX |
Integer |
Index of family member |
|
IOTIMER |
Integer |
Timeout value in effect for READ and WRITE operations on a pack |
|
LARGESTSZSECTS |
Integer |
Largest single area available on a pack |
|
LOCALACCESS |
Boolean |
TRUE if unit uses local system access directory |
|
MIRRORED |
Boolean |
TRUE if unit is a member of a mirrored set |
|
NAME |
String |
Pack name |
|
ONLINE |
Boolean |
TRUE if unit is on line |
|
QUEUEDEPTH |
Integer |
Number of I/Os waiting for a pack |
|
REMOTEDISK |
Boolean |
TRUE if unit is a remote disk device |
|
SCRATCH |
Boolean |
Purged pack unit |
|
SERIAL |
String |
Serial number of a pack |
|
SHARED |
Boolean |
TRUE if unit is shared |
|
SITENAME |
String |
StoreSafe site name |
|
SPARE |
Boolean |
TRUE if unit has been entered in the spare disk pool (as either a free spare or an in-use spare) |
|
STORESAFESTATUS |
String |
StoreSafe status |
|
TOTALIOS |
Integer |
Total number of reads from a pack and writes to a pack |
|
TOTALREADS |
Integer |
Total number of reads from a pack |
|
TOTALWRITES |
Integer |
Total number of writes to a pack |
|
TYPE |
String |
Pack type: B = base pack C = continuation pack |
|
UNITNO |
Integer |
Unit number |
|
VSSTYPE |
Integer |
VSS Format: 0 =180-byte disk 1 =VSS-1 disk 2 =VSS-2 disk 3 =VSS-3 disk |
SHOW MT <attribute list>
Displays the selected attributes for all tapes.
Each line of the output begins with the unit number, followed by the attribute values, and then followed by the tape name.
The following attributes can be used when mounted tapes are the target of a SHOW command.
|
Attribute Name |
Type |
Description |
|---|---|---|
|
MIX |
Integer |
Mix number of the program using tape |
|
NAME |
String |
Tape name |
|
SCRATCH |
Boolean |
TRUE if tape mounted is a scratch tape |
|
SCRATCHPOOL |
String |
Scratch pool of mounted tape |
|
SERIAL |
String |
Serial number |
|
TOTALREADS |
Integer |
Total number of reads of tape on the drive |
|
TOTALWRITES |
Integer |
Total number of writes to the tape on the drive |
|
UNITNO |
Integer |
Unit number of tape drive |
SORT + <sort attribute>
SORT − <sort attribute>
Sorts the lines of output based on the value of the specified sort attribute. The attributes must be appropriate for the object type (MIX, LIBS, PK, or MT). A plus sign (+) requests a sort in ascending order. A minus sign (−) requests a sort in descending order.
The sort attribute cannot be a Boolean attribute.
The sort attribute can be the same as one of the attributes in the attribute list, but it does not have to be.
SELECT <object type> <Boolean attribute> = TRUE
SELECT <object type> <Boolean attribute> = FALSE
SELECT <object type> <Boolean attribute>
A value of TRUE selects objects for which the attribute has a value of TRUE.
A value of FALSE selects objects for which the attribute has a value of FALSE.
If neither TRUE nor FALSE is specified, the value is assumed to be TRUE. For example, SELECT MIX PU selects all the privileged programs in the mix.
SELECT <integer> <relation> <integer value>
Selects objects with a integer attribute that satisfies the relation. For example, SELECT MIX MEMORY > 5000 returns all mix entries using greater than 5000 words of memory. Following are the possible relations.
|
Relation |
Meaning |
|---|---|
|
= |
Equal to |
|
<> |
Mot equal to |
|
> |
Greater than |
|
>= |
Greater than or equal to |
|
< |
Less than |
|
<= |
Less than or equal to |
SELECT <string attribute> <wild card string>
SELECT <string attribute> <> <wild card string>
Shows objects with a string attribute matching the wild-card string. If the optional <> token is present, the selection includes any entry where the attribute does not match the wild-card string. The string can include the following special characters.
|
Character |
Description |
|---|---|
|
Equal sign ( = ) |
Matches any sequence of characters |
|
Question mark ( ? ) |
Matches any single character |
|
Tilde ( ~ ) |
Matches any sequence of characters except a slash ( /) |
The wild-card string is automatically uppercased, except for characters enclosed in quotation marks, and the system stops processing the string when it encounters a space character.
For example, if you enter the following syntax, the system returns entries that contain the string "SYSTEM":
SHOW MIX MEMORY SELECT NAME =system=
If you enter the following syntax, the system returns entries that contain the string "system":
SHOW MIX MEMORY SELECT NAME LIT ^=system=^
ALL
If information in the right-hand column of a SHOW display is truncated to fit your screen, you can specify the ALL parameter to use a display format that displays one attribute name and value per line.
Examples
Example 1
The following example displays several attributes for each mix entry:
SHOW MIX NAME, CONTROL, LOCKED, PU
MixNo-Control-Locked-PU-Name---------------------------- 8461 LOTSATASKS 8465 (PHIL) NOTHING 8439 X X *511/SYSTEM/DSSSUPPORT 8441 X X *SYSTEM/STATION/TRANSFER 8433 X *SYSTEM/NEWP ON SYS511 8429 X X *511/SYSTEM/HELP 8428 X *SYSTEM/MARC/AGENDA 8426 X *SYSTEM/MARC/COMMANDER 8422 X X X *SYSTEM/NPSCS/SUPPORT
Example 2
The following example displays various attributes for each mix entry, and also sorts the entries into descending order based on their CPUTIME attribute:
SHOW MIX NAME, CPUTIME, IOTIME, READYQTIME, INITPBITTIME SORT - CPUTIME
MixNo-CPUTime---IOTime---ReadyQTime-InitPBit---Name----------- 8465 14:32 :00 1:17 :00 NOTHING ON DISK 8411 2:35 :04 :45 :06 SYSTEM/TESTIT 8438 1:14 :01 :24 :09 SYSTEM/LCF 8441 1:05 :00 :24 :02 *SYSTEM/COMS 8419 :37 :31 :39 :02 PRINT/WORKER 8409 :23 :00 :09 :00 *SYSTEM/CANDE
Example 3
The following example displays only library entries that include the string COM. For each entry, this example lists the RELEASEID attribute:
SHOW LIBS RELEASEID, SELECT NAME =COM=
MixNo-ReleaseID---------------------------Name------------------ 618 MCP 12.0 [53.180.000] (53.180.0047) *SYSTEM/MARC/COMMANDER 597 MCP 12.0 [53.180.000] (53.180.0091) *SYSTEM/COMS 629 MCP 12.0 [53.180.000] (53.180.0003) *SYSTEM/COMS/PSH/TTP 628 MCP 12.0 [53.180.000] (53.180.0091) COMS/PA/FACILITY 606 MCP 12.0 [53.180.000] (53.180.0091) COMS/ROUTER 514 MCP 12.0 [53.180.000] (53.180.0003) *SYSTEM/DATACOMSUPPORT 520 MCP 12.0 [53.180.000] (53.180.0003) DATACOMSUPPORT/9
Example 4
The following example displays various attributes for each disk unit:
SHOW PK AVAILSECTS, LARGESTSZSECTS, TOTALREADS, TOTALWRITES
UnitNo--AvailSects-LargestSZSects-TotalReads-TotalWrites--Name-
44 250,827 38,682 1,420 363 PACK
45 437,220 167,983 3,840 1,150 DISK
47 1,112,719 662,691 110 168 DMSIITESTExample 5
The following example lists the SCRATCH attribute for all tape units:
SHOW MT SCRATCH
UnitNo-Scratch-Name--------------------- 35 DLTDUMPS/FILE000 36 X 37 HLCNSAVEDPS/FILE000 38 HLCNSAVEDPS/FILE003
Example 6
The following example uses the ALL option to display attribute values that match the string =CAN= without truncation.
SHOW MIX RELEASEID NAME SELECT NAME =CAN= ALL
------------------------------------------------ MixNo: 935 ReleaseID: MCP 12.0 [53.180.000] (53.180.0037) Name: *SYSTEM/CANDE ------------------------------------------------ MixNo: 937 ReleaseID: MCP 12.0 [53.180.000] (53.180.0037) Name: *CANDE/STACK03 ------------------------------------------------ MixNo: 842 ReleaseID: MCP 12.0 [53.180.000] (53.180.0019) Name: CCF/CANDE1/DRIVER
Example 7
The following example reports the certified status for mirrored packs.
SHOW PK CERTIFIED
UnitNo-Certified-Name 180 X T180
Example 8
The following example reports the certification timestamp for all certified mirrors which were certified today.
SHOW PK SERIALNAME SELECT CERT TIMESTAMP = TODAY UnitNo-Serial-Certification Date and TimeStamp-Name 180 000180 Mon, May 17, 2004 @14:40:03 T180
