Request information on print jobs
Component: | SPOOL |
Functional area: | Controlling spoolout job |
Domain: | SPOOL-PRINT-ADMINISTRATION |
Privileges: | STD-PROCESSING |
Routing code: | S |
Function
The SHOW-PRINT-JOB-STATUS command requests information on print jobs. The print jobs can be selected by specifying the server involved and the cluster in which they are processed. The operand INFORMATION=*DISTRIBUTED allows you to request client and server information for the specified print job.
The command supports structured output in S variables (see "Output in S variables").
Note
The SHOW-PRINT-JOB-STATUS command corresponds to the SHOW-SPOOL-JOB-STATUS command; the command name SHOW-SPOOL-JOB-STATUS is still accepted as an alias.
Privileged functions
RSO device administrators and spool and cluster administrators can request information about any print job scheduled for printing on any device that they manage.
For more information on these user groups see the manuals “RSO” [32], “SPOOL” [43] and “Distributed Print Services” [10].
Format
SHOW-PRINT-JOB-STATUS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
INFORMATION =
Types of information on spoolout jobs to be output to SYSOUT or SYSLST (OUTPUT operand). Although all available information on all spoolout jobs can be requested simultaneously, you should use this operand (INFORMATION) to select a subset of the available information to avoid cluttering up the screen.
INFORMATION = *ORIGIN
Outputs the following information on the origin of the spoolout jobs:
TSN
name of the server on which the job is processed
user ID
account number of the user who generated the spoolout job
number of specified page copies
number of specified file copies
spoolout name of the job
type and size of the file
name of the client host
TSN of the job issuing the job
This information is primarily of interest to the nonprivileged user.
INFORMATION = *DESTINATION
Outputs information on the output medium of the spoolout job:
TSN
name of the server on which the job is processed
job type (RSO or local SPOOL)
name of the device
name of the device pool
device types
status and type of job (WAIT,ACTIVE,KEEP, etc.)
Error code and error message (RSO, Dprint)
This information is primarily of interest to the device administrator.
INFORMATION = *TRAITS
Outputs information on the following attributes of the spoolout jobs:
priority
form name
spoolout class
number of character sets required
size of the FOB data overlay required
name of the film overlay required
use of the page rotation module
output control (CONTROL)
name of the server on which the job is processed
location of the resources
This information is primarily of interest to system administration since it relates to the attributes (traits) of the local SPOOL devices.
INFORMATION = *SUMMARY
Outputs the number of spoolout jobs selected and the number of PAM pages provided for these jobs.
INFORMATION = *DISTRIBUTED
Global information on print jobs is output:
TSN on the local and remote host (client and server TSN)
Name of the client host
Name of the server on which the job is processed
Job type (local, distributed, between clusters)
Information on the requesting user ID
INFORMATION = *SPOOL-FILTER / *RSO-FILTER
These values can be used to display selective information on the destination and status of a print job. The list of device types corresponds to those on which the print job can be executed after applying the filter.
Depending on the filter, the print jobs can be executed by SPOOL (if INFORMATION = *SPOOL-FILTER is specified) or by RSO (if INFORMATION = *RSO-FILTER is specified). Both values can be specified in coordination with INFORMATION=*DESTINATION if the field ERMSG (error message) contains 'FILTER' or 'DEL/FLT'.
Output information:
TSN
name of the server on which the job is processed
job type (RSO or local SPOOL)
name of the device
name of the device pool
device types
status and type of job (WAIT,ACTIVE,KEEP,...)
error code
error message
Note
These details are primarily only of interest to the device manager and to systems support (PRINT-SERVICE-ADMINISTRATION).
CLUSTER-NAME = *LOCAL-CLUSTER / <name 1..8>
Name of the cluster in which the command is executed. If a cluster of UNIX-based systems is specified, only a subset of operands and values is permitted for selecting the print job. You will find detailed information on this in the “Distributed Print Services” manual [10].
OUTPUT = *SYSOUT / *SYSLST
Specifies whether the information is to be output to SYSOUT (screen) or SYSLST.
SELECT = *PARAMETERS(...) / *STD
Specifies the print jobs on which the information is to be issued. With SELECT=*STD, the information is output for all print jobs that fulfill the criteria specified with SELECT = *PARAMETERS(...).
SELECT = *PARAMETERS(...)
Selection criteria for spoolout jobs on which information is to be output.
SPOOLOUT-NAME = *ALL / <alphanum-name 1..8 with-wild(24)> / list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low> / *NONE
Spoolout names of the spoolout jobs on which information is to be output.
USER-IDENTIFICATION = *STD / *OWN / <alphanum-name 1..8 with-wild(24)> /*ALL /
list-poss(16): <name 1..8> / <c-string 1..8 with-low>
User IDs of the print jobs on which information is to be output. *STD means *ALL for operator tasks and *OWN for all other tasks.
HOST-NAME = *HOME / *ALL / <alphanum-name 1..8 with-wild(24)> /
list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
Information is output on print jobs started from the specified hosts.
HOST-NAME = *HOME
Only print jobs started from the local host are selected.
HOST-NAME = *ALL
Information is output on all print jobs of all hosts. Nonprivileged users who specify this value only receive information on their own print jobs.
HOST-NAME = <alphanum-name 1..8 with-wild(24)> / list-poss(16): <alphanum-name 1..8>
Information is output on print jobs started from the specified hosts. Nonprivileged users do not receive any information if they specify a remote host; they can only obtain information on their own print jobs.
SERVER-NAME = *HOME / *ALL / <alphanum-name 1..8 with-wild(24)> /
list-poss(16): <alphanum-name 1..8>
Information is output on print jobs processed on the specified server.
SERVER-NAME = *HOME
Only print jobs on the local server are selected.
SERVER-NAME = *ALL
All print jobs on all available servers are selected.
SERVER-NAME = <alphanum-name 1..8 with-wild(24)> / list-poss(16): <alphanum-name 1..8>
Only the specified servers are selected, provided they belong to the local cluster.
FORM-NAME = *ALL / <alphanum-name 1..6 with-wild(24)> / list-poss(16): <alphanum-name 1..6>
Form names of the spoolout jobs on which information is to be output.
TSN = *ALL / list-poss(16): <alphanum-name 1..4>
Task sequence numbers of the spoolout jobs on which information is to be output.
IDENTIFICATION = *ALL / <c-string 1..255 with-low>
Print jobs on a UNIX-based system can be addressed by means of their identification. A cluster of UNIX-based systems must be selected in this case. To find out which operands and values are permitted, see the “Distributed Print Services” manual [10].
SERVER-TSN = *ALL / list-poss(16): <alphanum-name 1..4>
Server TSN of the print jobs on which information is to be output.
FORMS-OVERLAY = *ALL / list-poss(16): <alphanum-name 2..2>
Information is to be output on spoolout jobs for which the named physical forms overlays have been specified.
SPOOLOUT-CLASS = *ALL / list-poss(16): <integer 1..255>
Spoolout classes of the spoolout jobs on which information is to be output.
ACCOUNT = *ALL / list-poss(16): <alphanum-name 1..8>
Account numbers of the spoolout jobs on which information is to be output.
VIRTUAL-PRINTER-NAME = *ALL / list-poss(16): <alphanum-name 1..8>
If the name of a virtual printer is specified, information will be output for all print jobs that were allocated to that virtual printer.
DESTINATION = *ALL / *LOCAL(...) / *REMOTE(...) / *CENTRAL / *MANAGED-DEVICES(...) / *DEVICE(...) / <alphanum-name 1..8 with-wild(24)> /list-poss(16): <alphanum-name 1..8>
Information is to be output on the print jobs processed on the specified output media. Information can be requested on:
all jobs (*ALL)
jobs for local SPOOL devices (*LOCAL)
jobs for RSO devices (*REMOTE)
jobs whose destination is the central printer pool (*CENTRAL)
jobs for devices managed by the user (*MANAGED-DEVICES)
jobs for specific devices (*DEVICE)
DESTINATION = *LOCAL(...)
Information is requested on spoolout jobs to be processed on local SPOOL devices.
SELECTION-TYPE = *MAY / *MUST
Selection of local spoolout jobs is restricted to those that may be output on at least one of the specified device types (*MAY) or to those that must be output on one of the specified device types and must not be output on any device type other than the ones specified (*MUST).
DEVICE-TYPE = *ALL / list-poss(16): *HP-PRINTER / *HP90-PRINTER / *LP-PRINTER /
*LP48-PRINTER / *LP-EMULATED-PRINTER / *LP65-PRINTER / *TAPE / *2050-APA-PRINTER /
*2090-APA-PRINTER / *2090-TWIN-PRINTER / *VIRTUAL-PRINTER / *PCL-PRINTER
Device types for local spoolout jobs on which information is requested.
DESTINATION = *REMOTE(...)
Information is requested on spoolout jobs to be processed on RSO devices.
SELECTION-TYPE = *MAY / *MUST
Selection of RSO spoolout jobs is restricted to those that may be output on at least one of the specified device types (*MAY) or to those that must be output on one of the specified device types and may not be output on any device type other than the ones specified (*MUST).
DEVICE-TYPE = *ALL / list-poss(16): *DJET-REMOTE-PRINTER / ...
Device types for RSO jobs on which information is requested. For possible values see the syntax chart.
DESTINATION = *CENTRAL(...)
Information is requested on spoolout jobs to be processed on SPOOL devices
belonging to the central printer pool.
SELECTION-TYPE = *MAY / *MUST
Selection of local spoolout jobs is restricted to those that may be output on at least one of the specified device types (*MAY) or to those that must be output on one of the specified device types and may not be output on any device type other than the ones specified (*MUST).
DEVICE-TYPE =*ALL / list-poss(16): *HP-PRINTER / *HP90-PRINTER / *LP-PRINTER /
*LP48-PRINTER / *LP-EMULATED-PRINTER / *LP65-PRINTER / *TAPE / *2050-APA-PRINTER /
*2090-APA-PRINTER / *2090-TWIN-PRINTER / *VIRTUAL-PRINTER / *PCL-PRINTER
Device types for local spoolout jobs on which information is requested.
DESTINATION = *MANAGED-DEVICES(...)
Requests information on jobs for devices that you yourself manage.
SELECTION-TYPE = *MAY / *MUST
Selection of self-managed spoolout jobs is restricted to those that may be output on at least one of the specified device types (MAY) or to those that must be output on one of the specified device types and must not be output on any device type other than the ones specified (MUST).
DEVICE-TYPE = *ALL / list-poss(16): *DJET-REMOTE-PRINTER / ...
Device types for self-managed jobs on which information is requested. For possible values see the syntax chart.
DESTINATION = *DEVICE(...)
Information is requested on spoolout jobs for the devices specified in the substructure.
NAME = *OWN / *ALL / <alphanum-name 1..8 with-wild(24)> / list-poss(16): <alphanum-name 1..8>
Names of the devices on which information is requested.
FORMS-OVERLAY-BUFFER = *ANY / *ONLY / *NO / *RANGE(...)
Information is to be output on spoolout jobs for which
a particular FOB data overlay has been specified (*ONLY)
no FOB data overlay has been specified (*NO)
FOB data overlays in the specified range have been specified (*RANGE)
If you specify *ANY, the operand does not act as a selection criterion.
FORMS-OVERLAY-BUFFER = *RANGE(...)
Specifies a range of values.
LOW = 0 / <integer 0..32767>
Bottom of range.
HIGH = 32767 / <integer 1..32767>
Top of range.
CHARACTER-SET-NUMBER = *ALL / *ONE / *RANGE(...)
Information is to be output on spoolout jobs that
require only one character set (*ONE)
require a number of character sets within the specified range (*RANGE)
CHARACTER-SET-NUMBER = *RANGE(...)
Specifies a range of values.
LOW = 1 / <integer 0..32767>
Bottom of range.
HIGH = 32767 / <integer 1..32767>
Top of range.
PRIORITY = *ALL / *RANGE(...)
Information is to be output on spoolout jobs with priorities within the specified range (*RANGE). If you specify *ALL, the operand does not act as a selection criterion.
PRIORITY = *RANGE(...)
Specifies a range of values.
LOW = 30 / <integer 30..255>
Bottom of range.
HIGH = 255 / <integer 30..255>
Top of range.
ROTATION = *ANY / *YES / *NO
The following information is to be output on spoolout jobs for which
page rotation has been requested in PRINT-DOCUMENT (*YES)
page rotation has not been requested in PRINT-DOCUMENT (*NO)
If you specify *ANY, the operand does not act as a selection criterion.
JOB-TYPE = *ALL / list-poss(10): *WAIT / *ACTIVE / *KEEP / *REPLAY / *WAIT-PREPROCESSING /
*PREPROCESSING / *BEFORE-APA-PRINT / *AFTER-APA-PRINT / *WAIT-FILE-TRANSFER /
*FILE-TRANSFER
Information is to be output on the following types of spoolout job:
- waiting spoolout jobs: *WAIT
active spoolout jobs: *ACTIVE
suspended spoolout jobs: *KEEP
spoolout jobs to be output to replay tape: *REPLAY
waiting SECTION-SPOOLOUT jobs (output section by section): *WAIT-PREPROCESSING
active SECTION-SPOOLOUT jobs (output section by section): *PREPROCESSING
*BEFORE-APA (APA printers: job status = “TRANSFERRED” (see also the “Spool & Print Commands” manual [42]))
*AFTER-APA (APA printers: job status = “TRANSIT” (see also the “Spool & Print Commands” manual [42]))
jobs waiting for file transfer: *WAIT-FILE-TRANSFER
jobs currently undergoing file transfer: *FILE-TRANSFER
FORMAT-NAME = *ALL / list-poss(16): *TEXT / *HP / *SPDS / *PCL / *PLAIN-TEXT /
<c-string 1..63 with-low>
Allows print jobs to be included in the selection on the basis of their document format name.
FORMAT-NAME = *ALL
Information is output on all print jobs.
FORMAT-NAME = list-poss(16): *TEXT / *HP / *SPDS / *PCL / *PLAIN-TEXT /
<c-string 1..63 with-low>
Print jobs whose document format name is contained in the list are included in the selection.
EXCEPT = *NONE / *PARAMETERS(...)
Specifies whether the information is to be output on all print jobs or whether jobs with certain attributes (EXCEPT = *PARAMETERS) are to be excluded from output.
EXCEPT = *PARAMETERS(...)
Criteria for print jobs to be excluded from the information output.
SPOOLOUT-NAME = *NONE / <alphanum-name 1..8 with-wild(24)> /
list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
Spoolout names of the spoolout jobs to be excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
USER-IDENTIFICATION = *NONE / <alphanum-name 1..8 with-wild(24)> / list-poss(16): <name 1..8> /
<c-string 1..8 with-low>
User IDs of the spoolout jobs to be excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
HOST-NAME = *NONE / *ALL / <alphanum-name 1..8 with-wild(24)> /
list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
Print jobs started from the specified hosts are excluded from the information output. The specified hosts must belong to the local cluster. If you specify *NONE, the operand does not act as a selection criterion.
SERVER-NAME = *NONE / <alphanum-name 1..8 with-wild(24)> /list-poss(16): <alphanum-name 1..8>
Print jobs to be processed on the specified server are excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
FORM-NAME = *NONE / <alphanum-name 1..6 with-wild(24)> / list-poss(16): <alphanum-name 1..6>
Form names of the spoolout jobs to be excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
TSN = *NONE / list-poss(16): <alphanum-name 1..4>
Task sequence numbers of the spoolout jobs to be excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
SERVER-TSN = *NONE / list-poss(16): <alphanum-name 1..4>
Print jobs with the specified server TSN are excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
FORMS-OVERLAY = *NONE / list-poss(16): <alphanum-name 2..2>
Spoolout jobs for which these physical forms overlays have been specified are to be excluded from the information output.
SPOOLOUT-CLASS = *NONE / list-poss(16): <integer 1..255>
Spoolout classes of the spoolout jobs to be excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
VIRTUAL-PRINTER-NAME = *NONE / list-poss(16): <alphanum-name 1..8>
Print jobs allocated to the specified virtual printer are removed from the selection.
ACCOUNT = *NONE / list-poss(16): <alphanum-name 1..8>
Account numbers of the spoolout jobs to be excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
DESTINATION = *NONE / <alphanum-name 1..8 with-wild(24)> / *DEVICE(...) / *CENTRAL /
list-poss(16): <alphanum-name 1..8>
Print jobs to be processed on the specified output media (pool or devices) are excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
DESTINATION = *DEVICE(...)
Print jobs to be processed on the specified devices are excluded from the information output.
NAME = *NONE / <alphanum-name 1..8 with-wild(24)> / list-poss(16): <alphanum-name 1..8>
Names of the devices to be excluded from the information output. If you specify *NONE, the operand does not act as a selection criterion.
FORMAT-NAME = *ALL / list-poss(16): *TEXT / *HP / *SPDS / *PCL / *PLAIN-TEXT /
<c-string 1..63 with-low>
Allows print jobs to be excluded from the selection on the basis of their document format name.
FORMAT-NAME = *ALL
Information is output on all print jobs.
FORMAT-NAME = list-poss(16): *TEXT / *HP / *SPDS / *PCL / *PLAIN-TEXT / <c-string 1..63 with-low>
Print jobs whose document format name is contained in the list are excluded from the selection.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | SCP0932 | No corresponding job exists |
2 | 0 | SCP1052 | One or more servers unavailable |
1 | CMD0202 | Syntax error | |
32 | SCP0974 | System error. Command rejected | |
2 | 64 | SCP0975 | No authorization for command |
4 | 64 | SCP0976 | Invalid operand value |
6 | 128 | SPC1063 | DPRINTCL subsystem not loaded |
1 | 128 | SPS0266 | SPOOL subsystem or SPOOL administrator task not available |
Notes
When INFO=*ORIGIN / *DESTINATION / *TRAITS is specified, the local TSN is displayed in the TSN field, i.e. the TSN assigned to the print job locally. This is either the server TSN (for a print job issued on a remote client and processed on the local server) or the client TSN (for a print job issued on the local client and processed locally or on a remote server).
For nonprivileged users and the SPOOL administrator, this has no effect on subsequent processing; i.e. the TSN displayed is the TSN that must be specified in order to cancel, display and modify the print job.For the cluster administrator, this command always displays the TSN at the server end. For other users (nonprivileged users and the SPOOL administrator), if *HOME is displayed in the SERVER field, this means that the print job is processed on the local server and the server TSN is displayed in the TSN field. If not, the client TSN is displayed. In the case of global output, if the fields TSN and P-TSN are identical, this means that the print job is processed by the client’s local server.
If the DPRINTCL subsystem is not loaded, distributed print jobs issued on a remote server are not displayed. The next time DPRINTCL is loaded, a check establishes whether the print job has been processed by the remote server.
If values other than the defaults are specified for the CLUSTER-NAME and IDENTIFICATION operands when DPRINTCL is not loaded, the command is rejected.
If the DPRINTSV subsystem is not loaded, distributed print jobs issued by a remote client to the local server are not displayed. They are restarted the next time DPRINTSV is loaded. For the cluster administrator, the selected jobs are searched for on the server. If SERVER-NAME=*ALL is specified, the jobs of unavailable servers are not displayed.
For nonprivileged users, however, jobs issued to a server are displayed even when this server is not available.
If the specified cluster name is not the local cluster, the value DESTINATION=*ALL has the same effect as DESTINATION=*LOCAL.
Only for the cluster administrator:
If the server of the cluster whose jobs are to be displayed is not accessible, the information is obtained from all the cluster’s accessible clients (if the jobs have not already been returned to the server).If the server’s name is defined in the UNIX-based system with a maximum of 8 characters, it may be assumed that the job ID (global ID) is a maximum 14 characters long (<server-name>: integer 1..30000).
The server’s name is shortened to 8 characters in every output format.
Output
There are various output formats depending on what is specified for the INFO operand. The meanings of the output fields are listed alphabetically in a table after the output formats.
Output when INFO=*ORIGIN is specified
In BS2000
TSN SERVER SP-NAME RTSN HOST USER-ID ACCOUNT F-C P-C F-T FCB-T F-SIZE @@@@ @@@@@@@@ @@@@@@@@ @@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@ @@@ @@@ @@@@ @@@@@@ Access to print jobs on a UNIX-based system IDENTIFICATION SERVER SP-NAME HOST USER-ID F-C P-C ########## @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@ @@@
Access to print jobs on a UNIX-based system
IDENTIFICATION SERVER SP-NAME HOST USER-ID F-C P-C ########## @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@ @@@
Output when INFO=*DESTINATION is specified
In BS2000
TSN SERVER M STA R DEVICE DESTIN ERCOD ERMSG DEVICE TYPE
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@-@@,@@@@,@@@@,.
@@@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@,@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@,@@@@,@@@@
Access to print jobs on a UNIX-based system
IDENTIFICATION SERVER SP-NAME HOST USER-ID F-C P-C ########## @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@ @@@
Output when INFO=*TRAITS is specified
In BS2000
TSN SERVER PRI FORM-N CLAS C-S-N F-O-B F-O ROT CONT RES-LOC @@@@ @@@@@@@@ @@@ @@@@@@ @@@@ @@@ @@@@ @@ @@@/@@@ @@@@ @@@@@@
Access to print jobs on a UNIX-based system
IDENTIFICATION SERVER PRI FORM-N ROT ########## @@@@@@@@ @@@ @@@@@@ @@
Output when INFO=*DISTRIBUTED is specified
TSN SERVER P-TSN J-TYPE HOST USER-ID ACCOUNT ERCOD ERMSG @@@@ @@@@@@@@ @@@@ @@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@
Output when INFO=*SPOOL-FILTER
TSN SERVER M STA R DEVICE DESTIN ERCOD ERMSG DEVICE TYPE
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@-
@@,@@@@,@@@@,.
@@@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@,@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@,@@@@,@@@@
Output when INFO=*RSO-FILTER
TSN SERVER M STA R DEVICE DESTIN ERCOD ERMSG DEVICE TYPE
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@-
@@,@@@@,@@@@,.
@@@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@,@@,@@@@
@@@@ @@@@@@@@ @ @@@ @ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@,@@@@,@@@@,@@@@
Meanings of the output fields
Output field | Meaning / Contents |
|---|---|
ACCOUNT | Account number of the user who issued the command; output only under TSOS and the user’s own user ID |
C-S-N | In the case of SPOOL jobs for HP printers: |
CLAS | Spoolout class as defined in the JOIN entry (blank if no spoolout class has been defined) |
CONT | Control character interpretation specified in PRINT-DOCUMENT for this SPOOL job: |
DESTIN | Name of the device pool |
DEVICE | Device name of the local or RSO printer |
DEVICE TYPE | List of device types (separated by commas) on which the specified job can be processed. |
ERCOD | FT error code, POSIX error code or RSO error code |
ERMSG | FT error message, POSIX error message or RSO error message. |
F-C | Number of copies (FILE COPIES) requested (in the ADDITIONAL-COPIES operand of the PRINT-DOCUMENT command) |
FCB-T | FCB type (access method) |
FORM-N | Form with which the SPOOL job must be processed |
F-O | EFO data overlay (HP90) specified for the SPOOL job or physical overlay specified for the RSO job |
F-O-B | Size of the FOB data overlay to be processed for this SPOOL job |
F-SIZE | File size in PAM pages (FILE-SIZE) |
F-T | File type (FILE TYPE): |
HOST | BCAM name of the host on which the command was issued |
J-TYPE | Type of print job: |
M | Job type (MODE): |
P-C | Number of page copies requested (in the PAGE-COPIES operand of the PRINT-DOCUMENT command) |
PRI | Priority of the print job |
P-TSN | Task sequence number of the print job (only for Distributed Print Services; see the manual “Distributed Print Services” [10]) |
R | * - Job from replay tape in COPY mode (the job can have the status WAIT, KEEP or ACTIVE) |
RES-LOC | Specifies whether the resources for processing the print job are used by the client or by the server: |
ROT | Only for local SPOOL (page rotation module) |
RTSN | TSN of the task issuing the command |
SERVER | Logical name of the server that processes the print job (only for Distributed Print Services; see the manual “Distributed Print Services” [10]) |
SP-NAME | Job name of the print job |
STA | Job status: |
TSN | Task sequence number of the print job |
USER-ID | User ID of the user who issued the command; output only under TSOS and the user’s own user ID |
Output in S variables
The command's INFORMATION operand identifies the S variables which are to be created. The following specifications are possible for INFORMATION:
Notation used in command | Abbreviated form used in table |
|---|---|
INFORMATION = *ORIGIN | INF=ORIG |
INFORMATION = *DESTINATION | INF=DEST |
INFORMATION = *TRAITS | INF=TRAITS |
INFORMATION = *SUMMARY | INF=SUM |
INFORMATION = *DISTRIBUTED | INF=DISTR |
INFORMATION = *SPOOL-FILTER | INF=SP |
INFORMATION = *RSO-FILTER | INF=RSO |
Note
S variables marked S/X in the “Name of the S variable” column are generated both for SPOOL and for Xprint jobs. S variables marked X are generated for Xprint jobs only. All other (unmarked) S variables are generated for SPOOL jobs only.
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Access method (FCB type) | var(*LIST).ACCESS-METHOD | S | *BTAM | INF=ORIG |
Account number of the user issuing the command | var(*LIST).ACCOUNT | S | ' ' | INF=DISTR/ |
Number of copies requested | var(*LIST).ADD-COPS/X | S | 0..255 | INF=ORIG |
Number of character sets specified for this SPOOL job | var(*LIST).CHAR-SET-NUM | S | 1..32767 | INF=TRAITS |
Control character interpretation | var(*LIST).CONTR-CHAR | S | ' ' | INF=TRAITS |
Print job destination | var(*LIST).DEST | S | ' ' | INF=DEST/ |
Device name of the local or RSO printer | var(*LIST).DEV-NAMES/X | S | ' ' | INF=DEST/ |
Type of device on which the current job is being processed | var(*LIST).DEV-TYPE(*LIST) | ’ ’ | INF=DEST/ | |
RSO error code | var(*LIST).ERROR-CODE | S | ’ ’ | INF=DEST/ |
RSO error message | var(*LIST).ERROR-MSG | S | ’ ’ | INF=DEST/ |
File size (in PAM pages) | var(*LIST).F-SIZE | S | 0..32767 | INF=ORIG |
File type | var(*LIST).FILE-TYPE | S | *DMS | INF=ORIG |
Size of the FOB overlay resource | var(*LIST).FOB | S | <integer> | INF=TRAITS |
Name of the form handling the SPOOL job | var(*LIST).FORM-NAMES/X | S | ’ ’ | INF=TRAITS |
EFO overlay resource | var(*LIST).FORM-OVERLAY | S | ’ ’ | INF=TRAITS |
Host name | var(*LIST).HOST-NAMES/X | S | ’ ’ | INF=DISTR/ |
Xprint job identification | var(*LIST).IDENTIFICATIONX | S | <identification> | INF=DEST/ |
Number of jobs | var(*LIST).JOB-COUNTS/X | S | <integer> | INF=SUM |
Method of job processing | var(*LIST).JOB-TYPE | S | *LOC | INF=DEST |
S | *DIST | INF=DISTR | ||
Number of requested page copies | var(*LIST).PAGE-COPS/X | S | 0..255 | INF=ORIG |
Number of PAM pages | var(*LIST).PAM-PAGE-COUNT | S | <integer> | INF=SUM |
TSN of the partner print job | var(*LIST).PARTNER-TSN | S | <tsn> | INF=DISTR |
Spoolout class | var(*LIST).PRINT-JOB-CLASS | S | 0..255 | INF=TRAITS |
SPOOL job priority | var(*LIST).PRINT-JOB-PRIOS/X | S | 30..255 | INF=TRAITS |
Replay tape | var(*LIST).REPLAY-TAPE | S | *NO | INF=DEST/ |
Use client or server resources to print the file | var(*LIST).RESOURCE-LOC | S | *HOME | INF=TRAITS |
Pages are rotated by a defined number of degrees for printing | var(*LIST).ROTS/X | S | 0 | INF=TRAITS |
TSN of the job issuing the command | var(*LIST).RTSN | S | <tsn> | INF=ORIG |
Name of the server | var(*LIST).SERVER-NAMES/X | S | ' ' | INF=DEST/ |
SPOOL job name | var(*LIST).SPOOL-NAMES/X | S | ' ' | INF=ORIG |
Current status of the job | var(*LIST).STAS/X | S | *ACT | INF=DEST/ |
SPOOL job number | var(*LIST).TSN | S | <tsn> | INF=DEST/ |
ID of the user who issued the command | var(*LIST).USER-IDS/X | S | ' ' | INF=DISTR/ |
Examples
Output in S variable
/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd (show-print-job-status select=*par(host=*all,server=*all),inf=*origin),
text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal,list-index=*yes)
VAR#1.IDENTIFICATION = ' ' VAR#1.TSN = '3DNB' VAR#1.SERVER-NAME = 'GH5090Y0' VAR#1.SPOOL-NAME = ' ' VAR#1.RTSN = '3DHC' VAR#1.HOST-NAME = 'D016ZE04' VAR#1.USER-ID = 'USER1' VAR#1.ACCOUNT = '89001' VAR#1.ADD-COP = '0' VAR#1.PAGE-COP = '0' VAR#1.FILE-TYPE = '*DMS' VAR#1.ACCESS-METHOD = '*SAM' VAR#1.F-SIZE = '13' *END-OF-VAR VAR#2.IDENTIFICATION = ' ' VAR#2.TSN = '3DND' VAR#2.SERVER-NAME = 'GH5090Y0' VAR#2.SPOOL-NAME = ' ' VAR#2.RTSN = '3DHC' VAR#2.HOST-NAME = 'D016ZE04' VAR#2.USER-ID = 'USER1' VAR#2.ACCOUNT = '89001' VAR#2.ADD-COP = '0' VAR#2.PAGE-COP = '0' VAR#2.FILE-TYPE = '*DMS' VAR#2.ACCESS-METHOD = '*SAM' VAR#2.F-SIZE = '12' *END-OF-VAR
/exec-cmd cmd=(show-print-job-status select=*par(host=*all,server=*all),
inf=*traits),text-output=*none,structure-output=var
/show-var var,inf=*par(val=*c-literal)
VAR#1.IDENTIFICATION = ' ' VAR#1.TSN = '3DNB' VAR#1.SERVER-NAME = 'GH5090Y0' VAR#1.PRINT-JOB-PRIO = '240' VAR#1.FORM-NAME = 'STD' VAR#1.PRINT-JOB-CLASS = '1' VAR#1.CHAR-SET-NUM = '1' VAR#1.FOB = '0' VAR#1.FORM-OVERLAY = ' ' VAR#1.ROT = '*NO' VAR#1.CONTR-CHAR = '*NO' VAR#1.RESOURCE-LOC = '*HOME' *END-OF-VAR VAR#2.IDENTIFICATION = ' ' VAR#2.TSN = '3DND' VAR#2.SERVER-NAME = 'GH5090Y0' VAR#2.PRINT-JOB-PRIO = '240' VAR#2.FORM-NAME = 'STD' VAR#2.PRINT-JOB-CLASS = '1' VAR#2.CHAR-SET-NUM = '1' VAR#2.FOB = '0' VAR#2.FORM-OVERLAY = ' ' VAR#2.ROT = '*NO' VAR#2.CONTR-CHAR = '*NO' VAR#2.RESOURCE-LOC = '*HOME' *END-OF-VAR
Output to SYSOUT
/print-doc $tsos.sysrme.archive.090.d,line-spacing=*by-ebcdic,
scheduling=*earliest(time=23:00)
% SCP0810 SPOOLOUT FOR FILE ':2OSH:$TSOS.SYSRME.ARCHIVE.090.D' ACCEPTED. TSN: '3QY4', SPOOLOUT-NAME: '*NONE', MONJV: '*NONE' % SCP1025 PRINT JOB ACCEPTED BY SERVER 'GH5090Y0' WITH TSN '41IH'
/print-doc $tsos.sysrme.archive.090.e,line-spacing=*by-ebcdic,
scheduling=*earliest(time=23:00)
% SCP0810 SPOOLOUT FOR FILE ':2OSH:$TSOS.SYSRME.ARCHIVE.090.E' ACCEPTED. TSN: '3QY5', SPOOLOUT-NAME: '*NONE', MONJV: '*NONE' % SCP1025 PRINT JOB ACCEPTED BY SERVER 'GH5090Y0' WITH TSN '41II'
/show-print-job-status select=*par(host-name=*all,server-name=*all)
TSN SERVER SP-NAME RTSN HOST USER-ID ACCOUNT F-C P-C F-T FCB-T F-SIZE 3PIU GH5090Y0 ALT 3PBR D016ZE04 USER1 89001 0 0 DMS SAM 13 3QY4 GH5090Y0 3QY3 D016ZE04 USER1 89001 0 0 DMS SAM 44 3QY5 GH5090Y0 3QY3 D016ZE04 USER1 89001 0 0 DMS SAM 44 % SCP0947 3 JOBS FOUND WITH 101 PAM PAGES. COMMAND TERMINATED