QUERY ALL

Read syntax diagramSkip visual syntax diagram Query ALL ACTiveALLATTachuseridBOXedFREeOFFlineQUIescedSYStem

Authorization

Privilege Class: B

Purpose

Use QUERY ALL to display the status of all the real devices attached to the system. It also displays the size of real storage.

Operands

ACTive
indicates all active devices. An active device is one that is in use by a user or the system and is specified as neither FREE nor OFFLINE.
ALL
indicates all devices attached to the system. The status is displayed in the order of ACTIVE, FREE, and OFFLINE. You receive the same response as you would receive if you entered all of the following commands:
query all active
query all free
query all offline
ATTach userid
indicates the devices that are dedicated to a user on the system. If you specify userid, only devices attached to that user's virtual machine are indicated. If you do not specify userid, you receive the status of all devices dedicated to any user on the system. Attached devices are always active.
BOXed
indicates the devices that are unavailable (usually because of a hardware condition). A boxed device may also be active, free, or offline.
FREe
indicates all free devices. A free device is one that is not currently in use by a user or the system and is specified as neither ACTIVE nor OFFLINE.
OFFline
indicates all offline devices. An offline device is specified as neither ACTIVE nor FREE. The offline response will also show offline devices which are quiesced.
QUIesced
indicated all quiesced DASD. A quiesced device is an offline device which cannot be varied online until a resume request is received for the device.
SYStem
indicates the devices in use by the system. A system device is always active.

Usage Notes

  1. When you enter a QUERY ALL command, you must make sure the command's options are valid for each virtual machine associated with one or more prtids. For example, if you enter a QUERY ALL command with the ALL parameter and a service virtual machine (SVM) controlling a printer does not accept that parameter, you get an error message from the service virtual machine.

Responses

The response to a QUERY ALL command is a mixture of all of the following responses. CP presents the information you request in ascending order of real device numbers.

Response about Real Storage:

At the beginning of the response to any QUERY ALL command, you receive a line like this:
STORAGE = 0128768K
This means the system's real storage is approximately 128 megabytes.

Response for Devices Needing Intervention:

If the system is using any device that is in an intervention-required state and you enter QUERY ALL, you receive a response like this:
A DASD 1801 intervention required.
DASD is the real device type, and might be replaced by one of the following:
Type Meaning
FCP SCSI device adapter
TAPE Magnetic tape
RDR Card reader
PRT Printer
PUN Card punch
GRAF Display device
LINE Communication line
CTCA Channel-to-channel adapter
OSA Open Systems Adapter
CTLR 3745 Communications Controller
MSC Mass Storage Controller
SWCH Dynamic Switching device
DEV Any other device.
1801 is the real device number of the device that needs the operator's intervention.
Note: This response will be preceded by a combination of messages that look like the following.

Responses from Real Channel-to-Channel Adapters:

If there are channel-to-channel adapters attached to the system, you see something like this:
CTCA 0480 ATTACHED TO PVM      0480
CTCA 0481 ATTACHED TO PVM      0481
CTCA 0482 ATTACHED TO RSCS     0482
CTCA 0483 ATTACHED TO RSCS     0483
CTCA 0484 ATTACHED TO PVM      0485
CTCA 0485 ATTACHED TO PVM      0484
CTCA 0486 ATTACHED TO VTAM     0486
CTCA 0700 ATTACHED TO TCPIP    0500
CTCA 0701 ATTACHED TO TCPIP    0501
The first number (for example, 0480) is the real device number of the channel-to-channel adapter. The ATTACHED operand might also read BOX/ATTC, which means that although the device is attached and dedicated to a user, it is unavailable. PVM, RSCS, TCPIP, and VMNET are user IDs to which the CTCAs are dedicated. The last number (for example, 0480) is the virtual device number that each virtual machine uses to refer to a CTCA.
If there are free channel-to-channel adapters attached to the system, you see something like this:
CTCA 0487 FREE    , CTCA 04A1 FREE    , CTCA 04A2 FREE    , CTCA 04A3 FREE
CTCA 04A4 FREE    , CTCA 04A5 FREE    , CTCA 04A9 FREE    , CTCA 04AA FREE
CTCA 04AB FREE    , CTCA 04BC FREE    , CTCA 04BD FREE    , CTCA 04BE FREE
CTCA 04BF FREE
This response shows the real device number for each free CTCA.

The responses for offline and boxed adapters are in the same format.

Responses from FCP Adapter Devices:

If there are FCP devices attached to the system, you see something like this:
FCP  0480 ATTACHED TO LINUX1   0480 CHPID F1
FCP  0481 ATTACHED TO LINUX1   0481 CHPID F1
FCP  0482 ATTACHED TO LINUX2   0482 CHPID F1
FCP  0483 ATTACHED TO LINUX3   0483 CHPID F1
FCP  0484 ATTACHED TO TEST1    0485 CHPID F1
FCP  0485 ATTACHED TO TEST1    0484 CHPID F1
The first number is the real device number of the FCP adapter device. The ATTACHED operand might also read BOX/ATTC, which means that although the device is attached and dedicated to a user, it is unavailable. LINUX1, LINUX2, LINUX3, and TEST1 are user IDs to which the FCP devices are dedicated. The next number is the virtual device number that each virtual machine uses to refer to an FCP device. The last number is the CHPID number (channel path) associated with the device number.
If there are free FCP devices attached to the system, you see something like this:
FCP 04A1 FREE    , FCP 04A2 FREE    , FCP 04A3 FREE    , FCP 04A4 FREE
FCP 04A5 FREE    , FCP 04A6 FREE    , FCP 04A9 FREE    , FCP 04AA FREE
FCP 04AB FREE    , FCP 04BC FREE    , FCP 04BD FREE    , FCP 04BE FREE
FCP 04BF FREE
This response shows the real device number for each free FCP device.

The responses for offline and boxed devices are in the same format.

Responses from Real DASD:

You see responses like the following if real DASDs are attached to the system for access as user minidisks or for system paging, spooling, or temporary disk space.
DASD 0280 CP SYSTEM XAUSR1   49
DASD 0281 CP SYSTEM XAUSR2   24
DASD 0282 CP SYSTEM XAUSR3   49
DASD 0283 CP SYSTEM XAUSR4   34
DASD 0284 CP SYSTEM XAUSR5   42
DASD 0285 CP SYSTEM XAUSR6   20
DASD 0A01 CP OWNED  ESAP01   3
DASD 0A02 CP OWNED  ESAP02   1
DASD 0A03 CP OWNED  ESAP03   1
DASD 0A04 CP OWNED  ESAP04   1
DASD 0A05 CP OWNED  ESAP05   1
DASD 0C08 CP SYSTEM ESAP7    1
DASD 0C09 CP SYSTEM ESAP6    1
DASD 1800 CP SYSTEM USPK1    4
DASD 1801 CP SYSTEM USPK2    2
The first number listed (for example, 0280) is the real device number of the DASD. SYSTEM indicates the device is allocated to the system for use as users' minidisks. OWNED indicates the device is used by the system for paging and spooling activity. XAUSR1, ESAP01, and the rest are volume labels of the devices. The last number (for example, 49) indicates the number of links to minidisks contained on the volume.
The following response is also displayed if real DASDs are attached to the system for access as user minidisks or for system paging, spooling, or temporary disk space. This response is longer than the response above because the device may be reserved (shared option is on), it may have a reserve pending, or it is currently reserved.
DASD 181A CP SYSTEM ESAP2C SHARED
DASD 181B CP OWNED  ESAP2F RESERVE  PENDING FOR USER DAVID
DASD 181C CP OWNED  ESAP30 RESERVED BY  SYSTEM
If a DASD is dedicated to a user, you see a message like this:
DASD 0820 ATTACHED TO OLIVER 01FC R/0 XAUSR4
This means that the DASD at the real device number 0820 is attached to OLIVER's virtual machine as the virtual device 01FC. The DASD's volume identifier is XAUSR4. R/O means the user OLIVER has read-only access to the DASD. R/O might also read R/W, which means the user has read-write access. ATTACHED may be replaced with BOX/ATTC, which means that although the device is dedicated to a user, it is unavailable (usually because of a hardware condition).

Responses from Real Graphic Display Devices:

If a real graphic display is dedicated to a virtual machine, you see something like this:
GRAF  0BCD ATTACHED TO OLIVER 0010
This message means the graphic display device at the real device number 0BCD is attached to OLIVER's virtual machine as the virtual device 0010. ATTACHED may be replaced with BOX/ATTC, which means that although the device is dedicated to a user, it is unavailable (usually because of a hardware condition).
If a graphic display device has a user logged on or dialed through it, you see something like this:
GRAF  08E0 LOGON  AS SVCDIR   0009
VTAM     CONTROLS THE FOLLOWING LU'S
GRAF WGU9E316 LOGON AS  DONNA    0009
GRAF TN6PV192 LOGON AS  CORAK    0009
This response tells you the user SVCDIR is logged on through the graphic display device at 08E0. The number 0009 is SVCDIR's virtual console device number.

The second line of the response tells you the terminals are SNA terminals and the user ID VTAM® controls them. VTAM is a VTAM service machine (VSM) recognized by z/VM CP. Any logical units controlled by this VTAM service machine that are logged onto or dialed into the system are described in the response lines following this line.

The numbers WGU9E316 and TN6PV192 identify SNA terminals controlled by a VTAM service machine. They are the names from the VTAM definition of the terminals as SNA logical units.

DONNA and CORAK are the users logged on through VTAM; each has 0009 as the virtual console device number.

If there are free graphic display devices, you see something like this:
LINE 00E5 FREE    , LINE 00E6 FREE    , LINE 00C0 FREE
GRAF 08E1 ENABLED , GRAF 08E2 ENABLED , GRAF 08E3 ENABLED , GRAF 08E4 ENABLED
GRAF 08E5 ENABLED , GRAF 08E6 ENABLED , PRT  08E7 ENABLED , GRAF 0BC0 ENABLED
GRAF 0BC1 ENABLED , GRAF 0BC2 ENABLED , GRAF 0BC3 ENABLED , GRAF 0BC4 ENABLED
GRAF 0BC5 ENABLED , GRAF 0BC6 ENABLED , GRAF 0BC7 ENABLED , GRAF 0BC8 ENABLED

The responses for offline and boxed displays are in the same format.

Responses from Real Communication Lines:

If a real communication line is dedicated to a user, you see something like this:
LINE  00F0 ATTACHED TO OLIVER 0010
This response means the communication line with the real device number 00F0 is attached to OLIVER's virtual machine as the virtual device 0010. ATTACHED may be replaced with BOX/ATTC, which means that although the device is dedicated to a user, it is unavailable (usually because of a hardware condition).
If there are communication lines that have users logged on at them or dialed through them, you see something like this:
LINE 00FA LOGON  AS DAVID    0009
LINE 00FB DIALED TO PVM      00F9
This response tells you the user DAVID is logged on through the communication line at 00FA. The number 0009 is the virtual device number of the virtual console where DAVID is logged on. The second line tells you the terminal connected to communications line 00FB is dialed to PVM's virtual device number 00F9.
If there are free communication lines, you see something like this:
LINE 00C1 FREE    , LINE 00C2 FREE    , LINE 00C3 FREE    , LINE 00C4 FREE
LINE 00C5 FREE    , LINE 00C6 FREE    , LINE 00C7 FREE    , LINE 00C8 FREE
LINE 00E1 FREE    , LINE 00E2 FREE    , LINE 00E3 FREE    , LINE 00E4 FREE
LINE 00E5 FREE    , LINE 00E6 FREE    , LINE 00C0 FREE
Responses for boxed and offline communication lines are in the same format.

Responses from Open Systems Adapter Devices:

If there are Open Systems Adapter devices attached to the system at the addresses specified, you see something like this:
q 480-486
OSA 0480 ATTACHED TO PVM      0480
OSA 0481 ATTACHED TO PVM      0481
OSA 0482 ATTACHED TO RSCS     0482
OSA 0483 ATTACHED TO RSCS     0483
OSA 0484 ATTACHED TO PVM      0485
OSA 0485 ATTACHED TO PVM      0484
OSA 0486 ATTACHED TO VTAM     0486
Ready;
The first number is the real device number of the Open Systems Adapter devices. The ATTACHED operand might also read BOX/ATTC, meaning that although the device is attached and dedicated to a user, it is unavailable. PVM, RSCS, TCPIP, and VMNET are user IDs to which the OSA devices are dedicated. The last number is the virtual device number which each virtual machine uses to refer to an OSA device.
If there are free OSA devices attached to the system at the specified addresses, you see something like this:
q 4a1-4bf free
OSA 04A1 FREE   , OSA 04A2 FREE   , OSA 04A3 FREE   , OSA 04A4 FREE
OSA 04A4 FREE   , OSA 04A5 FREE   , OSA 04A9 FREE   , OSA 04AA FREE
OSA 04AB FREE   , OSA 04BC FREE   , OSA 04BD FREE   , OSA 04BE FREE
OSA 04BF FREE
This response shows the real device number for each free OSA device.

The responses for offline and boxed devices are in the same format.

Responses from Real Dynamic Switching Devices:

If there is a dynamic switching device dedicated to a user, you see something like this:
SWCH 0CD5 ATTACHED TO EMILY 0012
This means the switching device at the real device number 0CD5 is attached to EMILY's virtual machine as the virtual device number 0012. ATTACHED may be replaced by BOX/ATTC, which indicates that the dedicated switching device is not available (usually because of a hardware condition).
If there are free switching devices attached to the system, you see something like this:
SWCH 0387 FREE   , SWCH 03A1 FREE   , SWCH 03A2 FREE   , SWCH 03A3 FREE
SWCH 03A4 FREE   , SWCH 03A5 FREE   , SWCH 03A9 FREE   , SWCH 03AA FREE
This response shows the real device number for each free switching device. Responses for boxed and offline switching devices are in the same format.

Responses from Real Magnetic Tape Drives:

If there is a tape drive dedicated to a user, you see something like this:
TAPE 0102 ATTACHED TO RALPH 0236 R/W
This means that the magnetic tape drive at the address 0102 is attached to RALPH's virtual machine as the virtual device number 0236. R/W means that the user RALPH has read-write access to the tape drive. R/W might also read R/O, which means the user has read-only access.
If the tape drive is currently being used by the TRSAVE command, you see something like this:
TAPE 0242 ASSIGNED SYSTEM TRSAVE
If a tape that is not dedicated to a user is not available (boxed), you see something like this:
TAPE 0244 BOXED
If a tape drive has been attached MULTIUSER to one or more users, you see something like this:
TAPE 2100 ATTACHED TO USER1    0181 R/W  NOASSIGN MULTIUSER
TAPE 2100 ATTACHED TO USER2    0181 R/W  NOASSIGN MULTIUSER
This means that the tape drive at real address 2100 is attached to USER1 and USER2 at virtual device address 0181. MULTIUSER indicates that the tape drive is shared by both users, and NOASSIGN states that the users must manage the assignment of the tape drive by using assign and unassign I/O.

Responses for free or offline tape drives will be in the same format.

Responses from Real Unit Record Devices:

If a unit record device is dedicated to a user, you see something like this:
RDR  000C ATTACHED TO JAMES 02F0
This response means that the real card reader at the device number 000C is dedicated to JAMES's virtual machine at the virtual device number 02F0. RDR might be replaced by PRT or PUN, depending on the kind of unit record device. ATTACHED might be replaced by BOX/ATTC, which indicates that the device is attached to the virtual machine but is unavailable (usually because of a hardware problem).

Responses from Active Readers:

If a reader is assigned to the system for spooling activity and it is currently active with a spool file, you see a message like this:
RDR  000C STARTED SYSTEM
RDR  000C READING PERCY FILE 0021
000C is the real device number of the card reader. STARTED indicates the device is available for spooling activity. SYSTEM means the device is available for input with user identification cards. STARTED might be replaced by any of the following:
  • DRAINING, which means the device would be unavailable for spooling activity as soon as it finished processing the current file.
  • DRAINED, which means the device was unavailable for spooling activity. You could enter the CP START command to restart it.
  • INT REQ, which means the device is not ready and requires manual intervention before spool file processing could resume.
Note: If STARTED were replaced by any of the above options, except DRAINING, the second line of the response would not appear.

SYSTEM might be replaced by a user ID, which means the device was available for input without user identification cards. All input decks would be assigned to the user ID specified.

The second line of the response means the card reader is currently active with a spool file. In this example, the reader at the real device number 000C is reading a card deck and creating a file that will be the user PERCY's spool file 0021.

Responses from Active Printers:

If there is an impact printer in use as a system spooling device, you see a response like this:
PRT  0E0E STARTED    SYSTEM CLASS 1         SECLABEL
PRT  0E0E FORM STANDARD MANUAL   SEP   NO3800  DEFFCB  LIMIT NONE
PRT  0E0E FOLD   IMAGE IMAG4248 CHARS      FCB FCB8          LPP 068
PRT  0E0E DEST OFF      DEST - NONE - DEST - NONE - DEST - NONE -
PRT  0E0E NOAFP
This response tells you the following about the impact printer at the real device number 0E0E. The first line tells you the printer will:
  • Be available for spooling activity
  • Process files for any user ID
  • Select only class 1 spool files for processing.
The second line tells you it will:
  • Select files requesting the STANDARD form
  • Wait for the operator to schedule forms output
  • Generate a separator page for output files
  • Not accept spool files that contain 3800 load CCWs
  • Use the default forms control buffer that was loaded into it
  • Process spool files regardless of their length.
The third line tells you it will:
  • Translate (fold) lower case characters into upper case
  • Use the system image library file IMAG4248
  • Not use a character set
  • Use the forms control buffer FCB8.
  • Print separator pages with 68 lines per page.
The fourth line tells you the printer will not use destination values as a criterion for selecting files.

The fifth line tells you the printer will not process files with advanced function printer (AFP) characteristics, that is, files that contain X'5A' CCWs or an extended attributes buffer (XAB). For more information about each line of the response, see the tables below.

If there is a 3800 printer in use as a system spooling device and that printer is currently active with a spool file, you see a response like this:
PRT  0F10 STARTED    SYSTEM CLASS *         SECLABEL
PRT  0F10 FORM STANDARD AUTO   SEP   ANY3800 LIMIT NONE
PRT  0F10 FLASH 0987 IMAGE IMAG3800 CHARS GF10  FCB 6    HOLD  LPP 060
PRT  0F10 DEST OFF      DEST - NONE - DEST - NONE - DEST - NONE -
PRT  0F10 AFP     MARK
PRT  0F10 PRINTING DAVID    FILE 0002 RECS 130K COPY 005 SEQ 001
This response tells you the following about the printer at the real device number 0F10. The first line means the printer will:
  • Be available for spooling activity
  • Process files for any user ID
  • Select spool files regardless of class.
The second line tells you the printer will:
  • Select files requesting the STANDARD form
  • Automatically schedule forms output
  • Generate a separator page for output files
  • Accept spool files that contain 3800 load CCWs
  • Process spool files regardless of their length.
The third line tells you the printer will:
  • Use the forms overlay negative called 0987
  • Use the system image library file IMAG3800
  • Use the character set GF10
  • Print six lines per inch
  • Put spool files causing 3800 load checks into system HOLD status.
  • Print separator pages with 60 lines per page.
The fourth line tells you that the printer will not use destination values as a criterion for selecting files.
The fifth line tells you that the printer will:
  • Process files with advanced function printer (AFP) characteristics, that is, files that contain X'5A' CCWs or an extended attributes buffer (XAB).
  • Mark separator trailer pages with separator bars.
The last line tells you:
  • The printer is active with the spool file 0002, owned by the user DAVID.
  • The number of records remaining for output in the file is 130K. K is the number of records in thousands rounded to the nearest 1000. If the number is greater than 999499, the number is shown as nnnM, where M represents the number of lines in millions rounded to the nearest million.
  • There are five copies remaining for output.
  • The sequence for the file on the printer is 001.

The parts of the first line of the response for impact printers and 3800 printers might also be as follows:

Category Possible Values Meaning
Status STARTED Device is available for spooling activity.
DRAINING Device is processing a file, but will be drained after the file is finished.
DRAINED Device is not available for spooling activity. Issue the CP START command to activate the device.
INT REQ Device is not available, and needs manual intervention before it can continue to process spool files.
SETUP REQ Printer is ready to print an alignment page so that the operator can align the forms properly on an impact printer. The operator must press the STOP and START buttons to print another alignment page, or enter the START command to begin printing the entire file.
MOUNT REQ Printer is waiting for the operator to mount a new form.
User ID SYSTEM Device processes files for any user ID.
userid Device processes files only for the specified user ID.
Spool file class CLASS cl Device services spool files of the specified classes, in the specified order. An output device can service as many as 8 output classes.

The parts of the second line of the response can be:

Category Possible Values Meaning
Form FORM form Device services the specified 1- to 8-character operator form number.
Scheduling MANUAL Operator schedules forms output. Only spool files with the form currently active on the device are processed. When the last spool file with the current form is printed, the printer stops.
AUTO Operator wants CP to schedule forms output. The form that is currently active is processed first. When all files with the current form have been printed, CP selects a new form for the device.
SETUP Operator wants CP to print a page for forms alignment verification. (Only valid for impact printers.) The operator receives a message to set up the form. After setting up the form, the operator must press the STOP button, then the START button. An alignment page prints with letters replaced by X's and numbers replaced by 9's on the first page of the file.

Each time the operator presses STOP and START after a full alignment page is printed, another alignment page prints. After aligning the forms, the operator enters the START command for the device. The printer then returns to its previous mode (AUTO or MANUAL), and the file prints in its entirety.

Note: If neither MANUAL, AUTO, nor SETUP is specified and the printer is currently in SETUP mode, it returns to the previous mode, AUTO or MANUAL. The default forms output is MANUAL.
File separator SEP File separator prints between output files.
NOSEP File separator does not print between output files.
3800 load CCWs NO3800 Printer does not print any spool files containing 3800 load CCWs. This option ensures a fast output queue, because load CCWs issued to 3800 printers can take a lot of time.
BEG3800 Only spool files without 3800 load CCWs, or spool files with 3800 load CCWs only at the beginning of the file, print on this device. This allows the user an initial setup with which the entire file can be printed.
ANY3800 Output device will process spool files regardless of whether they contain 3800 load CCWs. This option may cause a slower output queue, based on the number of 3800 load CCWs issued by the spool files.
Default FCB DEFFCB Printer uses the default FCB with which it was loaded. CP does not send imbedded LOAD FCB CCWs to the printer. The LOADBUF command specifies the default FCB.
FILEFCB CP sends FCBs to the real printer. File FCBs are LOAD FCB CCWs imbedded in the spool file. This is the default when you start the printer after a cold start.
Note: DEFFCB and FILEFCB only appear for non-1403 impact printers.
Length limit LIMIT NONE CP selects files for printing regardless of the number of records.
LIMIT nnnnnnnnnn CP only selects spool files for printing that are less than or equal to the specified number of records. The spool file record number is the number of copies multiplied by the size of the file.

The parts of the third line of the response can be:

Category Possible Values Meaning
Folding into upper case FOLD CP translates (folds) lower case characters into upper case.
NOFOLD CP does not translate lower case characters into upper case.
Note: FOLD and NOFOLD only appear for impact printers.
Forms overlay negative FLASH name Printer uses the specified forms overlay negative, which is from 1 to 4 characters long.
Note: FLASH only appears for 3800 printers.
Image library IMAGE imagelib Printer uses the specified system image library file, which contains the load images (character sets, FCBs, graphic character modifications, or copy modifications) used for printing files and separator pages.
Character set CHARS chars Printer uses the specified character set, which is from 1 to 4 characters long, when printing the separator page.
FCB FCB name For impact printers: printer uses the specified FCB when printing the file or the separator page. For 3800 printers: the FCB is the number of lines per inch.
Note: FCB does not appear for 1403-type printers.
3800 load checks HOLD Printer puts spool files causing 3800 load checks in system HOLD status.
PURGE Printer deletes spool files causing 3800 load checks.
Note: HOLD and PURGE only appear for 3800 printers.
Lines per page LPP Defines the number of lines for file separator pages on the printer.

The parts of the next-to-last line of this response can be:

Category Possible Values Meaning
Destination DEST Printer services the specified destination values. The printer can service up to 4 destination values. The first value for the device is always OFF if it was not specifically set by either a START command, or at initialization with the RDEVICE statement in the system configuration file. If it was set, the specified destination is shown. If the remaining destination values were not specified, the values are null and are shown as – NONE –. If they were specified, the specified value is shown.
AFP AFP Printer processes files with advanced function printer (AFP) characteristics, that is, files that contain X'5A' CCWs or an extended attributes buffer (XAB).
NOAFP Printer does not process files with AFP characteristics.
Mark separator trailer pages MARK Printer marks 3800 trailer pages with separator bars.
NOMARK Printer does not mark 3800 trailer pages with separator bars.
Note: MARK and NOMARK only appear for 3800 printers.

Responses from Active Card Punches

If a punch is attached to a user and is currently active with a spool file, you see a message like:
q 1f30
PUN  1F30 STARTED    SYSTEM CLASS 1
PUN  1F30 FORM STANDARD AUTO   NOSEP LIMIT NONE
PUN  1F30 DEST OFF      DEST - NONE - DEST - NONE - DEST - NONE -
PUN  1F30 PUNCHING JAMES    FILE 0042 RECS 012K COPY 002 SEQ 001
Ready;
This response tells you the following about the card punch at the real device number 1F30. The first line means that the punch will:
  • Be available for spooling activity
  • Process files for any user ID
  • Select class 1 spool files.
The second line tells you that the punch will:
  • Select files requesting STANDARD form
  • Automatically schedule forms output
  • Not generate a separator page for output files.

The third line tells you that the punch will not use destination values as a criterion for selecting files.

The parts of the first line of the response can also be:

Category Possible Values Meaning
Status STARTED Device is available for spooling activity.
DRAINING Device is processing a file, but will be drained when the file is finished.
DRAINED Device is not available for spooling activity. Issue the CP START command to activate the device.
INT REQ Device is not available; it needs manual intervention before it can continue to process spool files.
SETUP REQ Punch is ready to generate an alignment page to let the operator align the forms properly on an impact printer. The operator must press the STOP and START buttons to print another alignment page, or enter the START command to begin printing the entire file.
MOUNT REQ Punch is waiting for the operator to mount a new form.
User ID SYSTEM Device processes files for any user ID.
userid Device processes files only for the specified user ID.
Spool file class CLASS cl Device services spool files of the specified classes, in the specified order. An output device can service as many as 8 output classes.

The options for the second line of the response can be:

Category Possible Values Meaning
Form FORM form Device services the specified 1- to 8-character operator form number.
Scheduling MANUAL Operator schedules forms output. Only spool files with the form currently active on the device are processed. When the last spool file with the current form is punched, the punch stops.
AUTO Operator wants CP to schedule forms output. The form that is currently active is processed first. After punching all files with the current form, CP selects a new form for the device.
File separator SEP File separator prints between output files.
NOSEP File separator does not print between output files.
Length limit LIMIT NONE CP selects files for punching regardless of the number of records.
LIMIT nnnnnnnnnn CP only selects spool files for punching that are less than or equal to the specified number of records. The spool file record number is the number of copies multiplied by the size of the file.

The options for the third line of the response can be:

Category Possible Values Meaning
Destination value DEST Printer services the specified destination values. The printer can service up to 4 destination values. The first value for the device is always OFF if it was not specifically set by either a START command, or at initialization with the RDEVICE statement in the system configuration file. If it was set, the specified destination is shown. If the remaining destination values were not specified, the values are null and are shown as – NONE –. If they were specified, the specified value is shown.

The last line of this response only appears if there is a file active on the card punch. The line in the example above tells you the punch at the real device number 1F30 is punching the spool file 0042, owned by the user JAMES. The number of records remaining for output in the file is 12K. K is the number of records in thousands rounded to the nearest 1000. If the number is greater than 999499, the number is shown as nnnM. M represents the number of lines in millions rounded to the nearest million. There are two copies remaining for output. The sequence for the file on the punch is 001.

Responses from Boxed Unit Record Devices:

If a unit record that is not dedicated to a user is unavailable, you see a message like the following:
RDR 000F BOXED
000F is the real device number of the card reader that is unavailable. RDR might be replaced by PRT or PUN.

Messages

  • HCP003E Invalid option - option
  • HCP020E Userid missing or invalid.
  • HCP263E Too many operands were supplied for this command.