peqs

peqs


_ Index Level spooler
Syntax
Category Spooler
Type File
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.
Options
See Also hosts Super-Q-Pointer Open Systems File Interface peqs qs-pointer qs-pointer sp-assign pr-spool-job spooler
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
Warnings
Compatibility D3 7.0
_ Index Level spooler