PER (Peripheral Status)

The PER (Peripheral Status) command displays the status of peripheral units.

Syntax

<unit number range>

Explanation

PER

Displays the status of all peripheral units.

PER <unit number range>

The PER display shows only units in the range from the first unit number to the second unit number, inclusive. The second unit number must be greater than the first unit number. If you specify only one unit number, the system displays information only for units whose unit number is equal to or greater than the specified unit number.

PER <device type>

Displays the status of all peripheral units of the specified device type.

PER =

PER -

Displays the status of all peripheral units, including unlabeled and unready devices. For mirrored disks, this command displays all members (PER PK displays only one member of each mirrored set).

PER <device type> =

PER <device type> -

Displays the status of all peripheral units of the specified device type, including unlabeled and unready devices.

If a pack or a CD-ROM on a given unit has a status of U (unavailable for normal use), any of the following messages might be displayed.

Message

Explanation

BLASTED

Indicates that the pack or CD-ROM was cleared and must be closed and readied before being used or indicates that the pack was released from a mirrored set. In either case, you can reconfigure disk packs without having to close and ready them again.

CLOSED

Indicates that the pack or CD-ROM was closed with the CLOSE (Close Pack) command.

DUP SERIAL

Indicates that a serial number for the pack matches a serial number of another pack on the system.

NOT AVAILABLE TO GROUP

Indicates that the unit has not been acquired into the current running system group.

NOT READY

Indicates that the unit is physically not ready.

RESERVED

Indicates that the pack has been taken offline with the UR (Unit Reserved) command.

SAVED

Indicates that the pack or CD-ROM has been marked with the SV (Save) command.

SCRATCH

Indicates that the pack has been purged with the PG (Purge) command.

UNINITIALIZED

Indicates that the pack has not been reconfigured with an RC (Reconfigure Disk) command.

UNLABELED, LABEL ERROR

Indicates that no label information exists in memory for the pack. One of the following actions has occurred:

  • The pack has not been initialized.

  • The directory complementor failed while it was reading the directories on the pack.

  • An error occurred in one of the following commands: LB (Relabel Pack), PG (Purge), or RC (Reconfigure Disk).

Examples

Example 1

This example shows a response for a PER MT command:

PER MT
  44*C      [DMTAPE] ST9940 C #1/1 1:1 <11/23/2004> DMSIITAPETEST2/TAPESET
  50*H D    [005050] 36TRK  C #1 1:0 <11/18/2004> ABC/FILE000
  51*\      [DDSDDS] DDS3     #1 1:0 <11/24/2004> DMSIIFILES/FILE000
  52*H      [000052] 36TRK  C #1 1:0 <11/18/2004> XYZ/FILE000
  56*H      38000    UNLABELLED
  59*H  R   [UNISYS] 38000  C #1 1:0 <01/20/2001> MYTAPE/FILE000
  85*L  E   [LTO4MT] LTO4     #1/1 1:0 <03/14/2008> TEST/3BEARS
  91*D      [007248] DLT40  C  S C R A T C H POOL: DLTTAPES
  97*H      [MT57  ] 38000  C #1 1:0 COMPRESSION MISMATCH, CAN'T READ (SEE OL)
  116 P     SAVED
  180*H     [DMTAPE] ST9840CC #1/1 1:1 <11/23/2004> DMSIITAPETEST2/TAPESET
  240@H     [JJTAPE] ST9840 C #1 1:0 <11/19/2004> DMSSTUFF/FILE000
  300*8    K[123456] 11000    #1/1 1:0 <08/17/2000> FILEA
  302*H     [234567] 38000     S C R A T C H  POOL: ROOM
  303*H     [345678] 38000    #1 1:0 <11/04/2000> DCW (FROM POOL TWH)

The example shows the following information:

  • The unit number

  • A write-enabled flag

    Symbol

    Description

    *

    Indicates that the tape is write enabled.

    @

    Indicates that the tape is write enabled but has been locked by the LOCKEDFILE file attribute.

  • A media-type flag

    Symbol

    Description

    8

    Indicates an 8-millimeter cartridge tape.

    H

    Indicates a half-inch cartridge tape and similar cartridge tape.

    Q

    Indicates a quarter-inch cartridge tape.

    D

    Indicates a digital linear tape (DLT).

    4

    Indicates a 4-millimeter cartridge tape.

    A

    Indicates an advanced intelligent tape (AIT).

    L

    Indicates a linear tape open (LTO) tape.

    T

    Indicates a Sun T10000 tape.

  • Optional flags

    Value

    Description

    \

    Indicates that the mounted volume is listed in the Volume Library.

    D

    Indicates that the mounted volume is listed in the Volume Directory.

    R

    Indicates that the unit has had security restrictions imposed on it. For more information, refer to RESTRICT (Set Restrictions).

    E

    (encryption full) Indicates that all data on the unit is encrypted, both in-use and not-in-use sectors.

    e

    (encryption inuse) Indicates that a disk volume was RCed with the KEY option, where all in-use user data is encrypted; however, in-use physical disk sectors may contain unencrypted data left over from some previous use of the disk volume.

    P

    (encryption partial) Indicates that a disk volume is in the process of being encrypted with the ENCRYPT command; therefore, some in-use user data is encrypted and some is not.

    K

    Indicates that the tape is a library maintenance tape that contains one or more files with LICENSEKEYS.

  • The serial number in brackets ([ ])

  • The mix number in parentheses, showing that the tape is in use by the program with that mix number

  • The tape density

  • The letter C if compression is being used

  • The file section number

  • The volume sequence number preceded by a slash (/), if the tape has ANSI87 tape labels

  • The cycle number and version number separated by a colon (:)

  • The creation date in angle brackets (<>)

  • The file name of a file on the tape or the following designation

    Name

    Description

    SAVED

    Indicates that the tape unit is saved.

    SCRATCH

    Indicates that the tape has been purged or contains an ordinary data file that is expired.

    UNLABELED

    Indicates that the tape does not have a recognizable label.

If the label of the tape mounted on a tape drive indicates that the block size of the file exceeds the maximum block size that the unit can handle, the following message is displayed in place of the title, <I> is the block size in the label: 

BLOCKSIZE <I> TOO LARGE, CAN'T READ

The first three lines of the example contain messages that pertain to tape compression. MT 56 represents an unlabeled tape on a compression-capable drive. MT 59 represents a compressed tape mounted on a compression-capable drive. MT 97 represents a compressed tape mounted on a drive that does not support compression.

Note: If you load a tape with a write ring, and the tape contains an ordinary data file that is expired, and the SYSOPS TAPEEXPIRATION option is set to TRUE, then the display shows the tape as a SCRATCH tape. If an expired tape is mounted without a write ring, the display shows the tape with the name of the expired file.

Example 2

This example shows the response for a PER PK command:

PER PK
  ------------------------- PK STATUS ----------------------
   96*B         [000097] (MCP) #1 DAMISDB (1) (TO BE SAVED)
   97*B\     c  [000096] #1 SSDMASTER (11)
   98*C         [000098:000097:096] #2 DAMISDB (0)
   99 U         C L O S E D
  100*U         U N I N I T I A L I Z E D
  103 B       t [000099] #1 TRIAL (1)
  112 B  R      [002112] #1 HAZARD (0)
  160*B      c  [682180] #1 DMPACK (418)
  200*B     (c) [000200] #1 CACHE1 (1)
  201*B      c  [000201] #1 CACHE2 (1)
  202*B      c- [000202] #1 CACHE3 (1)
  203*B     Mc  [659003] #1 DISK (17)
  210*B         [123456:000000] #1 S P A R E
  211*B         [659009:000000] #1 S C R A T C H
  245*C         [000245:000240: NO BP]  #2 GOOD240
  701*C      ctr[161200] #1 DK7434 (0)

Each pack entry in the PER PK display includes the unit number, type of pack, and label information (family name and serial number). The display also indicates whether the pack is currently being used by an MCP procedure (for example, READPACKLBL). For all systems that support the Mirrored Disk Pooling Facility (MDPF), the display identifies free spare disks assigned to the spare disk pool. Spare disks can be assigned to a new or existing family if you remove the spare designation with the RC (Reconfigure Disk) command. The following fields are displayed.

Field

Description

1

This field displays the unit number.

2

This field displays an asterisk (*) if the write-enable switch is on and the MODE is IO or OUT; a blank if the write-enable switch is off or the MODE is IN.

3

This field displays the pack type. The following codes can be displayed:

  • B: Base pack

  • C: Continuation pack

  • U: A pack that is not available for normal use

4

The letter A indicates that the disk is a base pack and has a local system access directory. Refer to FAMILYACCESS (Directory Location).

5

A backslash (\) designates a disk entered in the volume library.

6

The letter R if security restrictions were imposed on the pack. For more information, refer to RESTRICT (Set Restrictions).

7

This field is blank.

8

The letter M indicates if the pack is mirrored. If a mirrored set is in the process of coming online but is waiting for another previously online member, it is considered a partial mirrored set. These packs are marked with a lowercase m instead of an uppercase M. This display does not show such an example.

9

The letter c indicates that caching is preferred for the pack. That is, caching was previously indicated in a successful CACHE + system command.

If the letter c has parentheses around it, caching is desired for the pack, but the disk caching subsystem has not attempted to activate caching. Packs in this caching state are not included in the count of caching packs displayed by the CACHE (Disk Cache) command. This state can occur when the pack is offline, has no path, or is a mirrored copy of a cached pack.

If the letter c is followed by a minus sign (−), caching is preferred for the pack, and the disk caching subsystem has attempted to activate caching, but this action has failed for one of the following reasons:

  • Memory reconfiguration has resulted in insufficient cache memory.

  • Packs in the c state are included in the count of caching packs displayed by the CACHE (Disk Cache) command.

10

The letter t indicates that a user-specified I/O time limit is assigned to the disk.

11

The letter r indicates that the disk was resized by an LB (Relabel Pack) or RC (Reconfigure Disk) command.

12

The disk pack family description in brackets ([ ]). Use the IOTIMER or OL PK command to display the actual time limit value. The family description consists of the following three items, with colons (:) separating them:

  • Item 1. The serial number of the disk pack on this unit.

  • Item 2. The serial number of the pack used to identify the family; that is, the first pack created in the family. Note that this is not necessarily the base pack if the family has duplicated directories.

  • Item 3. The unit number of the current base pack for this family. If item 3 refers to the unit itself, then it is omitted. If item 3 refers to the unit itself and item 2 is the serial number of the pack on this unit, then items 2 and 3 are omitted. If the base pack is absent, the continuation packs display the warning indication NO BP. The base pack for the family might be offline, freed, saved, not ready, closed, reconfigured, or purged. All continuation packs in the family might be unusable. You need to determine the status and history of all base-capable packs for the family and whether the continuation packs from another backup directory are usable.

13

The family index number, from 1 through 255.

14

The family name.

15

The open count (in parentheses) on the disk. This count includes the number of open files and the number of MCP tasks that are using the entire pack. A pack with no open files and that is not in use by the MCP displays an open count of zero. If the value in parentheses is an asterisk (*), the computation time to derive the in-use count was excessive.

16

(TO BE SAVED) text, if applicable. This text indicates that the pack is a critical pack which will be saved at the next halt/load. A critical pack is a pack that has been specified in a DL (Disk Location) command.

Example 3

This example shows a display for a memory disk. The designation B designates a base pack: 

PER DK
  --------------------- DK STATUS ----------------------
  255*B           [000255] #1 MEMDISK (27)

Example 4

The open count of each pack is displayed in parentheses if the total time to compute the number of open files for all packs on a page does not exceed 5 seconds. If the computation time exceeds 5 seconds, the field is not displayed. (A pack without open files, on the other hand, displays an open count of zero.)

If the value in parentheses is an asterisk (*), the computation time to derive the in-use count was excessive. 

PER PK
  150*B  [207150] #1 DISK (27)
  151*B  [206151] #1 TESTPACK (0)
  153*B  [207153] #1 PACK (*)
  162*B  [207162] #1 DBUNIT (*)

Example 5

This example shows the display for three ODTs. The first two are not restricted; the third is restricted: 

PER SC
  ------------------------  SC STATUS-------------------
  1    S C R A T C H
  2    S C R A T C H
  3    (MCP) COMS/ODT/DRIVER  RESTRICTED

Example 6

This example shows displays for line printers attached to the system: 

PER LP =
  -------------------------  LP STATUS-----------------------
   4                   S C R A T C H  EBCDIC96
   5   (0007)          SERVER/LP5/"R#8476"/"J#3284" ASCII86
   7   (0030)          *SYSTEM/PRINTCOPY  (UNKNOWN TRAINID)
   8   (6969) FORMED : MEDFORM  SERVER/LP8/"R#8476"/"J#3299"
   9          FORMED : "MEDICAL FORM # 2"
  10   (MCP)           SAVED              (DEFAULT DESTINATION)
  11                   N O T  R E A D Y  EBCDIC96  (DEFAULT
                                                   DESTINATION)
  12                   R E S E R V E D

Each entry in the PER LP display includes the external unit number and the status of the printer. The following fields are displayed.

Field

Description

1

Indicates the external unit number of the printer.

2

Optional field that shows special I/O status enclosed in angle brackets (<>).

3

If the printer is in use, this optional field indicates the system or the mix number of the stack using the printer.

If the printer is not in use, this optional field indicates that the printer is configured for special forms with the designation FORMED, followed by the form identifier.

4

Indicates the status of the printer or who is controlling the printer. Terms used in this field include TO BE SAVED, SAVED, LOCKED, S C R A T C H, NOT READY, the file title, and the name of the print server if a file is printing.

5

If the printer is not in use, this optional field contains either the name of the TRAINID character or the statement (UNKNOWN TRAINID). TRAINID is a file attribute that refers to the character set that is available to the printer.

Example 7

This example shows the response to a PER NP command. NP represents network processors: 

PER NP
  ---------------------NP STATUS-----------------------------
  155   (ICPIIIM, LEVEL: 2.1) ACTIVE, COMMUNICATING
  156   (ICP10-A, LEVEL: 7.1) ACTIVE, COMMUNICATING
  161   (ICPII, LEVEL: 0.2) ACTIVE, COMMUNICATING
  210   (MAICP4, LEVEL: 9.1) ACTIVE, COMMUNICATING

The following table describes the display.

Entry

Description

1

NP number.

2

The ICP type and its firmware level.

The first number of the firmware level describes its DLP type, and the second number describes the functional level. If the system cannot determine the ICP type, the display is presented as ICP, LEVEL: NOT AVAILABLE.

3

The actual status of the NP.

Example 8

This example shows the response for a PER command with a unit range: 

PER 100-199 PK
---------------------------- PK STATUS ----------------------
    100 C        c   [008556:400103:14103] #3 NI00 (9)
    101*C        c   [000226:191232:19132] #2 PCBACKUP (0)
    102*B            [008370] #1 TOMSDISK (0)
    103*B        c   [000659] #1 Z103Z1971 (0)
Prev  Up  Next
PDIR (Process Directory)  Home  PF (Print Fetch)