tcl.listpeqs Verb: Access/Spooler

tcl.listpeqs

Command tcl.listpeqs Verb: Access/Spooler
Applicable release versions: AP, R83
Category Spooler (24)
Description displays the status of all Spooler controlled print job elements.

Outputs a list of spooled entries. The following column headings appear in the report:

"job#" is the element (job) number assigned by Spooler.

"stat" is the "encoded" print file status (see "status").

"lnk". In a linked form queue, this is the job# of the next output job after this one.

"line" is the port.number that generated this queue element.

"status" is the assignment parameters on the print file:

a: available; may be edited, spooled or deleted.
c: closed; "spooling", job is ready to de-spool to device.
g: align; phantom "alignment" print job (see startptr)
h: hold file; see sp-assign.
i: immediate output; see sp-assign.
l: locked; see sp-edit, "l" option.
n: no close; see sp-open or sp-assign "o" option.
o: output is currently being generated by the user.
p: assigned to printer output.
r: re-queued; has been edited/spooled with sp-edit.
s: spooled; linked to an output queue.
t: assigned to tape output.
x: aborted; has been aborted by sp-kill.

"copies" is the number of copies remaining to print.

"form" is the assigned output form queue.

"frames" is the number of frames in use by the print file. If the word "open" appears here, the printfile is still being spooled. If the print file was created with the "c" ("choke") option, the number of frames used reflects the number of frames left to print when the print file was closed, instead of the actual number of frames used.

"date" is the date the print file was added to the job queue.

"time" is the time the print file was added to the job queue.

"user" is the user-id of the user who created the print file.

"Frms" is the size of the print file. A trailing "+" indicates an increasing file, a trailing "-" indicates a decreasing file. A blank entry indicates a file build is being done, or no data has been spooled out. See option "e".

"CurFID" is the current frame-id being output (in hexadecimal). See option "e".

"curpos" is the current position of the despooling process. See option "e".

"begfid" is the beginning frame-id of the start of the print file. See option "e"
Syntax listpeqs {options}
lq
Options 'account.name' In R83, this displays the Spooler entries created by the specified account name. Single quotes are required around the account name.

'user-id' In AP, Spooler entries are stored under the user-id of the user who generated them. This displays the Spooler entries created by the specified user-id. Single quotes are required around the user-id.

n{-m} (integer number(s)). Displays element "n", or elements "n" through "m". The current maximum is about 600.

a Outputs the status of all reports created by the current account.

c Outputs only the count of spooled entries and total storage (frames) used.

e Outputs print file absolute (disk) location. When this is in effect, the display has two additonal columns of output: "curpos" indicates the current frame and displacement into that frame being printed. "begfid" is the first frame of the printfile. Both frame references are indicated as hexadecimal addresses. Under the "frames" column next to this printfile, if a "+" character follows the number, it is still being Spooled; if a "-" follows, it is despooling (printing).

f{form.queue.number}
Outputs status of jobs queued for output in form queue order (0-125). The optional "form.queue.number" limits display to the specified form queue.

h Outputs hold files only.

l Displays status of elements which have been deleted, as well as those which are active.

p Directs output to system printer, via the Spooler.
Example
listpeqs 'mlb'

listpeqs (e)

listpeqs 'jack' (n

listpeqs 13-22
Purpose
Related tcl.sp-close
tcl.sp-assign
tcl.lq
tcl.stopptr
spooler.commands
spooler.options
tcl.sp-open
tcl.sp-edit
tcl.startptr
tcl.sp-kill
tcl.listpeqs.link
tcl.lq.link