tcl.pr-spool-job Verb: Access/Spooler, filename.peqs File/Spooler

tcl.pr-spool-job

Command tcl.pr-spool-job Verb: Access/Spooler
Applicable release versions: AP 6.2
Category Spooler (24)
Description re-spools a spooler hold job. The user can select a one-time sp-assignment for this job by placing the desired sp-assign options after the open parenthesis at tcl. Some sp-assign options are not valid in this context, they are "c", "i", "o", "rnnn", "t" and "?". See filename.peqs for more information.
Syntax pr-spool-job spooler.job {(assignment.options}
Options See tcl.sp-assign for options with the caveats described above.
Example
pr-spool-job 3 (f2,4

This will re-spool spooler job number 3 to form queue number two. Four copies 
of the job will be output.  Note that a comma is used to seperate the form 
queue number "2" from the number of copies "4". Spaces 
cannot be used.
Purpose
Related filename.peqs
tcl.sp-assign

filename.peqs

Command filename.peqs File/Spooler
Applicable release versions: AP 6.2
Category Spooler (24)
Description a super-Q-pointer used to access spooler jobs.

The "peqs" super-Q-pointer allows access to spooler jobs as if they were standard files.

The following translations are applied on both retrieval and update (note that a DLE is character 16):

Raw Job Simulated File Item

CR,LF AM
DLE DLE,DLE
SM DLE,'_'
AM DLE,'^'
VM DLE,']'

Note also that all trailing null characters are removed when reading a job.

This translation makes it easy to read, modify, and update jobs using BASIC, ED, or the Update processor.

The "COPY" verb can be used to copy jobs into standard files for archival purposes.

The "DELETE" and "CLEARFILE" operations are supported, but only affect unlocked hold files (as with the associated SP-EDIT operation).

An update of an existing, unlocked, hold job updates the job contents without changing the job number. An update of a non-existent job creates a new spooler job with the current SP-ASSIGN options. An update of a locked or non-hold job fails and does nothing.

When reading an item for later update, it is suggested to use a READU. This operation will fail if the job is locked or not a hold file.

If the user updates the "peqs" item "0", then the job is re-spooled with the current sp-assign options to the first available entry number. The user may optionally override the current sp-assign parameters by directly following the "0" in the item id by the new options. Note that there can be no spaces in the item id and that the sp-assign options "c","i","o","rnnn","t" and "?" are ignored.

When using the Update processor to edit "peqs" items, it is suggested to use the "(r" option to better handle control characters and to prevent truncation of trailing attribute marks.

The following pseudo-attributes are defined off of the peqs file. These attributes actually translate from the peqs item-id into the header section of the peqs file (called "hdr:peqs"):

Job The job number
Size The size of the spooler entry
User The user who last modified the job
Pib The PIB of the user who last modified the job
Line The PIB of the user who last modified the job
Date The date of last modification
Time The time of last modification
Permissions Indicates ability to read or write a job
Form The form queue number
Copies The number of copies set
Status The job status information (similar to list-peqs)
Prio Indicates printing priority within a form queue

The "SPOOLER" account holds a super-Q-pointer with the file definition attribute set to "qs". This signals the save processor to dump the both the spooler header information and the spooler job itself to tape. For more information see the spooler.account entry.
Syntax
Options
Example
:list peqs
Page 1    Peqs           10:57:12 12 Sep 1994

peqs

1
2
3

[405] 3 items listed out of 3 items.
:u peqs 3 (r

peqs '3' size = 167
01 .:list md md (p
02 Page 1 md           10:57:59 12 Sep 1994
03
04 md...................
05
06 md
07
08 [405] 1 items listed out of 1 items.
09
peqs '3' size = 167 filed
Purpose
Related filename.hosts
general.super.q.ptr
general.remote
filename.peqs.link
qs-pointer
s-pointer
tcl.sp-assign
tcl.pr-spool-job
spooler.account