The LISTPEQS command lists the status of print files and hold files currently managed by the Spooler.
Format
|
LISTPEQS [n [–m]] [account] [options] |
Parameter(s)
|
n |
Number of the print file. |
|
|
n-m |
Specifies a range of print file numbers. |
|
|
account |
Displays all print files generated by the specified account. The account name must be enclosed in single or double quotes. |
|
|
options |
Can be any of the following: |
|
|
A |
Lists only those print files generated by your current logon account. The A option only recognizes the first 16 characters of the account name. |
|
|
C |
Lists only the total number of print files and the total amount of space they use. |
|
|
E |
Lists the frame location of the specified print files. |
|
|
F |
Lists print jobs in order, first by form queue, then in the order in which they will be printed. Hold files are not listed. |
|
|
L |
Lists obsolete print files that have been deleted, in addition to active print files. |
|
|
P |
Sends the report to the printer. |
|
Description
If no options are specified, the status of all print files on the system is listed.
The LISTPEQS Report
LISTPEQS produces a report that looks like this:
The report generated by this command lists the following information:
|
# |
Print file number, sometimes called the entry number. |
|
STAT |
Status number. This number is for maintenance use only. |
|
LK |
Forward link, shown only if it is nonzero. |
|
LN |
Number of the line (process) on which the print file is generated or the hold file is being edited. |
|
STATUSES |
Status of the print file. For details on status codes, see the Statuses of Print Files section below. |
|
CP |
Number of copies. |
|
FO |
Number of the form queue. |
|
FRMS |
Number of frames of a closed print file; the word OPEN is displayed if the print file is open. |
|
DATE |
Date the print file was queued. |
|
TIME |
Time the print file was queued. |
|
ACCT |
Name of the account that generated the print file. |
Statuses of Print Files
The following status codes can appear in the STATUSES column of the report:
|
A |
Printer control block is available for reuse. No new control blocks are created for print files until the existing ones have been reused. All other status codes for these obsolete print files are enclosed in parentheses. Files in available control blocks are not accessible by the SP-EDIT command. |
|
C |
Print file is closed. If C does not appear, the print file is either currently being printed or in an SP-OPEN condition. |
|
G |
Print file is the alignment segment of another print file. When the A option of the STARTPTR command is used, a special print file is generated that is used only for aligning the printer. |
|
H |
File is a hold file. Hold files are created either because of their SP-ASSIGNment, because they are dequeued by the SP-KILL command with the F option, or because a cold-start has occurred. |
|
I |
Print file is to be printed immediately. This condition is specified by the SP-ASSIGN command with the I option. |
|
L |
Print file is locked. Files are locked when they are available, open, spooled, being printed, or being edited. Locked files are not available to the SP-EDIT command. |
|
N |
Print file was generated under an SP-OPEN condition. Open files are not available to the SP-EDIT command. |
|
O |
Print file is currently being printed. Files currently being printed are not available to the SP-EDIT command. |
|
P |
Print file is to be sent to the printer. |
|
R |
Print file has been edited and sent to the printer. |
|
S |
Print file was spooled to a form queue by the SP-EDIT command. Such spooled files are no longer available to the SP-EDIT command. |
|
T |
Print file is to be sent to the tape drive or floppy disk. |
|
X |
Print file was killed by the SP-KILL command. |
Listing Frame Locations of Print Files
The following example, which uses the E option, shows the real storage location (base frame ID) of each print file:
|
>LISTPEQS E |
|||||||||
|
PRINTER LIST ELEMENTS |
dd mmm yyyy 11:58:48 |
||||||||
|
|
|
|
|
|
|
|
|
|
|
|
STAT LK |
LN |
CURPOS |
BEGFID |
CP |
FO |
FRMS |
DATE |
TIME |
ACCT |
|
|
|
|
|
|
|
|
|
|
|
|
C088 |
41 |
000100024DAB |
00024DAB |
1 |
9 |
1 |
08/10/94 |
15:49:31 |
JOHNSON |
|
C880 |
41 |
000100024D99 |
00024D99 |
1 |
9 |
1 |
08/10/94 |
15:52:32 |
JOHNSON |
|
4885 |
41 |
00010002F737 |
0002F737 |
1 |
9 |
1 |
08/10/94 |
16:00:25 |
JOHNSON |
|
|
|
|
|
|
|
|
|
|
|
|
|
3 QUEUE ELEMENTS. |
|
|
3 FRAMES IN USE |
|
||||
|
|
|
|
|
|
|
|
|
|
|
|
> |
|
|
|
|
|
|
|
|
|
CURPOS lists the current position of the file, BEGID lists the beginning frame ID.