filename.peqs File/Spooler, spooler.account Definition/Spooler

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

spooler.account

Command spooler.account Definition/Spooler
Applicable release versions: AP 6.2
Category Spooler (24)
Description account holding a file called "Peqs" which is used to reference spooler jobs as normal Pick items.

The data section of this file is a "QS" pointer to the "peqs:" driver. The "QS" signals the save processor to dump booth the spooler header information and the spooler jobs to tape. In general, this is the only account that should contain a "QS" pointer to the peqs: driver. All other accounts should contain simple "Q" pointers.

At the present time, the spooler account does not serve any purpose beyond this. The "QS" super-q-pointer was not put into dm because confusion could result if the peqs file was restored accidently.

It is now possible to restore spooler jobs from previous file-saves. Two options are available; individual items or the entire file can be restored to a temporary file, then copied to the spooler as needed, or the entire contents of the previous spooler can be overlaid on the current spooler.

Note that the save must be done with the "E" option to save spooler jobs.
Syntax
Options
Example
Purpose
Related filename.peqs
general.super.q.ptr