SHOW-ACTIVE-SPOOL-DEVICES

Request information on active SPOOL devices

Component:	SPOOL
Functional area:	Controlling spoolout job
Domain:	SPOOL-PRINT-ADMINISTRATION SPOOL-PRINT-SERVICES
Privileges:	STD-PROCESSING OPERATING PRINT-SERVICE-ADMINISTRATION SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION
Routing code:	S

Function

The SHOW-ACTIVE-SPOOL-DEVICES command requests information on assigned SPOOL and RSO devices (i.e. on devices to which a START-PRINTER-OUTPUT command has been issued; output to SYSOUT).

Starting with BS2000 OSD/BC V11.0, printers that are connectable to the channel are no longer supported. However, print jobs for “local” printers defined in SPOOL are still accepted and can be forwarded to real, LAN-connected high-performance printers by using a SPOOL add-on product (e.g. ROUTER by Océ).

The state of the printer in BS2000 has no effect on this forwarding. The SHOW-ACTIVE-SPOOL-DEVICES command is therefore now only relevant for RSO printers and virtual devices.

The command supports structured output in S variables (see "Output in S variables").

Privileged functions

Nonprivileged users are only given information on devices whose authorization list contains the user ID or *ALL. RSO device administrators also receive information on the devices they manage, while systems support staff can call down information on all devices. Information on user IDs and account numbers is only output to privileged users (RSO device administrators or systems support). 

Effect of the device specification in START-PRINTER-OUTPUT

The following table shows how the devices specified (explicitly/implicitly) in the START-PRINTER-OUTPUT command are displayed in the output of the SHOW-ACTIVE-SPOOL-DEVICES command:

Value specified in SHOW-ACTIVE-SPOOL-DEVICES	Value specified in START-PRINTER-OUTPUT
	*ALL	(A,B)	*EX(A,B)	A	*EX(A)
*ALL	EXPL	EXPL	EXPL	EXPL	EXPL
A	IMPL	EXPL	====	EXPL	====
C	IMPL	====	IMPL	====	IMPL
*EX(A)	====	====	EXPL	====	EXPL
*EX(C)	====	IMPL	====	IMPL	====
(A,B)	IMPL	EXPL	====	EXPL	IMPL
(A,C)	IMPL	EXPL	IMPL	EXPL	IMPL
*EX(A,B)	====	====	EXPL	IMPL	EXPL
*EX(A,C)	====	IMPL	EXPL	IMPL	EXPL

Table 87: Explicit/implicit specifications in START-PRINTER-OUTPUT

Format

SHOW-ACTIVE-SPOOL-DEVICES

DEVICE-NAME = *ALL / list-poss(8): <alphanum-name 1..8 with-wild(24)> / <alphanum-name 2..2>
,INFORMATION = *STD / *COUNT
,SERVER-NAME = *ALL / *HOME / <alphanum-name 1..8 with-wild(24)> /
list-poss(8): <alphanum-name 1..8>
,CLUSTER-NAME = *LOCAL-CLUSTER / <name 1..8> /
,SCHEDULING-STATE = *NEXT-JOB / *CURRENT-JOB
,DESTINATION = *LOC AL / *ALL / *REMOTE / *PUBLIC-REMOTE /
list-poss(16): *CENTRAL / <name 1..8>
,FORM-NAME = *ALL / *STD / *EXCEPT(...) / list-poss(8): <alphanum-name 1..6>
	*EXCEPT(...)
		|		FORMS-LIST = list-poss(16): <alphanum-name 1..6>
,USER-IDENTIFICATION = *ALL / *EXCEPT(...) / list-poss(16): <name 1..8> / <c-string 1..8 with-low>
	*EXCEPT(...)
		|		USER-IDENT-LIST = list-poss(16): <name 1..8> / <c-string 1..8 with-low>
,HOST-NAME = *ALL-CLUSTERS / *HOME / *LOCAL-CLUSTER / *EXCEPT(...) /
list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
	*EXCEPT(...)
		|		HOST-LIST = list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
,SPOOLOUT-CLASS = *ALL / *EXCEPT(...) / list-poss(16): <integer 1..255>
	*EXCEPT(...)
		|		SPOOLOUT-CLASS-LIST = list-poss(16): <integer 1..255>
,SPOOLOUT-NAME = *ALL / *EXCEPT(...) / list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
	*EXCEPT(...)
		|		SPOOLOUT-NAME-LIST = list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
,ACCOUNT = *ALL / *EXCEPT(...) / list-poss(16): <alphanum-name 1..8>
	*EXCEPT(...)
		|		ACCOUNT-LIST = list-poss(16): <alphanum-name 1..8>
,FORMS-OVERLAY = *ALL / *NONE / *ONLY / *EXCEPT(...) / list-poss(16): <alphanum-name 2..2>
	*EXCEPT(...)
		|		FORMS-OVERLAY-LIST = list-poss(16): <alphanum-name 2..2>
,FORMS-OVERLAY-BUFFER = *ANY / *ONLY / *NO / *RANGE(...)
	*RANGE(...)
		|		LOW = 0 / <integer 0..32767>
		|		,HIGH = 4032 / <integer 0..32767>
,PRIORITY = *ALL / *RANGE(...)
	*RANGE(...)
		|		FROM = 30 / <integer 30..255>
		|		,TO = 255 / <integer 30..255>
,CHARACTER-SET-NUMBER = *ALL / *ONE / *RANGE(...)
	*RANGE(...)
		|		LOW = 1 / <integer 1..32767>
		|		,HIGH = 64 / <integer 1..32767>
,ROTATION = * ANY / *YES / *NO / *MANUAL
,TWO-UP-PROCESSING = *ANY / *YES / *NO / *MODE-1 / *MODE-2

Operands

DEVICE-NAME = *ALL / list-poss(8): <alphanum-name 1..8> / <alphanum-name 1..24 with-wild>
Names of active SPOOL devices on which information is requested. If *ALL is specified, brief information is output on each device you are allowed to access. If a device name is specified, only the SCHEDULING-STATE operand may be specified in addition.
If the character string ALL occurs in a name (e.g. FIXALL) and this name is addressed using the *ALL wildcard pattern, the asterisk must be doubled: **ALL.

INFORMATION = *STD / *COUNT
Determines the type of information returned.

INFORMATION = *STD
Returns information on the devices which match the selection criteria either in the form of a summary list if DEVICE-NAME=*ALL or contains wildcards, or in the form of a complete list if an explicit list without wildcards is specified in the DEVICE-NAME operand.

INFORMATION = *COUNT
Returns the number of devices which match the selection criteria with the message SCP1124.

SERVER-NAME = *ALL / *HOME / list-poss(16): <alphanum-name 1..8> /
<alphanum-name 1..24 with-wild>
Selects the SPOOL device by means of the server that manages it. An active printer can only process print jobs accepted by the server belonging to the host to which the printer is connected.
If a remote cluster is specified, *ALL is the only value permitted here.

SERVER-NAME = *ALL
Addresses SPOOL devices managed by all the servers on all the hosts in the addressed cluster.

SERVER-NAME = *HOME
Addresses only SPOOL devices managed by the local server. The printers can be started on a distributed or local basis.

SERVER-NAME = list-poss(16): <alphanum-name 1..8>
Selects the SPOOL devices managed by the specified servers on the hosts in the specified clusters.

CLUSTER-NAME = *LOCAL-CLUSTER / <name 1..8>
Selects the SPOOL device by means of the cluster containing the server that manages it.

SCHEDULING-STATE = *NEXT-JOB / *CURRENT-JOB
Determines whether the operand values for the next scheduling operation on SYSOUT (default value) or those valid for the current job should be output. Differences can arise only if changes have been made with MODIFY-PRINTER-OUTPUT during the current job.
The following applies to all the operands that follow:
If several devices are specified information is output only for those devices which satisfy all the selection criteria defined with the subsequent operands. The values ANY and *ALL each mean that there are no restrictions. 

DESTINATION = *LOCAL / *ALL / *REMOTE / *PUBLIC-REMOTE / list-poss(16): *CENTRAL / 
<alphanum-name 1..8>
Information is requested on active SPOOL devices which have been defined in START-PRINTER-OUTPUT under DESTINATION as

• local printers (default value)

• RSO printers - private devices

• RSO printers - public devices

• central printers

• any printers

or the specified active printers.

FORM-NAME = *ALL / *STD / *EXCEPT(...) / list-poss(8): <alphanum-name 1..6>
Information is requested on active SPOOL devices to which the specified forms have been assigned or for which they have been excluded (START-PRINTER-OUTPUT).

FORM-NAME = *EXCEPT(...)
Information is requested on active SPOOL devices for which the specified forms are not admitted.

FORMS-LIST = list-poss(16): <alphanum-name 1..6>
List of forms which are not admitted.

USER-IDENTIFICATION = *ALL / *EXCEPT(...) / list-poss(16): <name 1..8> / <c-string 1..8 with-low>
Information is requested on active SPOOL devices to which the specified user IDs have been assigned or for which they have been excluded (START-PRINTER-OUTPUT).

USER-IDENTIFICATION = *EXCEPT(...)
Information is requested on active SPOOL devices for which the specified user IDs are not admitted.

USER-IDENT-LIST = list-poss(16): <name 1..8> / <c-string 1..8 with-low>
List of user IDs which are not admitted.

HOST-NAME = *ALL-CLUSTERS / *HOME / *LOCAL-CLUSTER / *EXCEPT(...) / 
list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
Information is requested on active SPOOL devices on which print jobs coming from the specified host can or cannot be printed (see also the START-PRINTER-OUTPUT command).

HOST-NAME = *ALL-CLUSTERS
Information is output on active SPOOL devices on which print jobs from any host in any cluster can be processed.

HOST-NAME = *HOME
Information is output on active SPOOL devices on which print jobs from the local host can be processed.

HOST-NAME = *LOCAL-CLUSTER
Information is output on active SPOOL devices on which print jobs from any host in the local cluster can be processed.

HOST-NAME = *EXCEPT(...)
Information is output on active SPOOL devices on which print jobs from any host except those specified in this list can be processed.

HOST-LIST = list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
Specifies the active devices that cannot accept print jobs from the specified hosts (see also the START-PRINTER-OUTPUT command).

HOST-NAME = list-poss(16): <alphanum-name 1..8>
Information is output on active SPOOL devices on which print jobs from the specified hosts can be processed.

SPOOLOUT-CLASS = *ALL / *EXCEPT(...) / list-poss(16): <integer 1..255>
Information is requested on active SPOOL devices to which the specified spoolout classes have been assigned or for which they have been excluded (START-PRINTER-OUTPUT).

SPOOLOUT-CLASS = *EXCEPT(...)
Information is requested on active SPOOL devices for which the specified spoolout classes are not admitted.

SPOOLOUT-CLASS-LIST = list-poss(16): <integer 1..255>
List of spoolout classes which are not admitted.

SPOOLOUT-NAME = *ALL / *EXCEPT(...) / list-poss(16): <alphanum-name 1..8 / <c-string 1..8 with-low>
Information is requested on active SPOOL devices to which the specified job names have been assigned or for which they have been excluded (START-PRINTER-OUTPUT).

SPOOLOUT-NAME = *EXCEPT(...)
Information is requested on active SPOOL devices for which the specified job names are not admitted.

SPOOLOUT-NAME-LIST = list-poss(16): <alphanum-name 1..8> / <c-string 1..8 with-low>
List of job names which are not admitted.

ACCOUNT = *ALL / *EXCEPT(...) / list-poss(16): <alphanum-name 1..8>
Information is requested on active SPOOL devices to which the specified account numbers have been assigned or for which they have been excluded (START-PRINTER-OUTPUT).

ACCOUNT = *EXCEPT(...)
Information is requested on active SPOOL devices for which the specified account numbers are not admitted.

ACCOUNT-LIST = list-poss(16): <alphanum-name 1..8>
List of account numbers which are not admitted.

FORMS-OVERLAY = *ALL / *NONE / *ONLY / *EXCEPT(...) / list-poss(16): <alphanum-name 2..2>
Information is requested on active SPOOL devices to which the specified film overlays have been assigned or for which they have been excluded (START-PRINTER-OUTPUT).

FORMS-OVERLAY = *NONE
Information is requested about devices which do not process film overlays.

FORMS-OVERLAY = *ONLY
Information is requested about devices which do process film overlays.

FORMS-OVERLAY = *EXCEPT(...)
Information is requested on active SPOOL devices for which the specified film overlays are not admitted.

FORMS-OVERLAY-LIST = list-poss(16): <alphanum-name 2..2>
List of film overlays which are not admitted. 

FORMS-OVERLAY-BUFFER = *ANY / *ONLY / *NO / *RANGE(...)
Information is requested on active SPOOL devices for which matching entries have been made in the FORMS-OVERLAY-BUFFER (FOB data overlays) operand in the START-PRINTER-OUTPUT command.
The values for RANGE in the START-PRINTER-OUTPUT command (number of sublines) must lie within the range specified here.
Information on printers without graphics buffer is only output for the operand value *ANY.

FORMS-OVERLAY-BUFFER = *RANGE(...)
Graphics buffer range.

LOW = 0 / <integer 0..32767>
Lower limit of the range.

HIGH = 4032 / <integer 0..32767>
Upper limit of the range.

PRIORITY = *ALL / *RANGE(...)
Information is requested on active SPOOL devices for which a priority in the range has been defined (START-PRINTER-OUTPUT).

PRIORITY = *RANGE(...)
Priority range.

FROM = 30 / <integer 30..255>
Lower limit of the range.

TO = 255 / <integer 30..255>
Upper limit of the range.

CHARACTER-SET-NUMBER = *ALL / *ONE / *RANGE(...)
Information is requested on active SPOOL devices for which any number character sets or a single character set or a number of character sets within the range (RANGE) are admitted (START-PRINTER-OUTPUT).
Information on non-HP printers is only output if CHARACTER-SET-NUMBER=ALL is specified.

CHARACTER-SET-NUMBER = *RANGE(...)
Information is requested on active SPOOL devices for which a number of character sets within a specified range are admitted.

LOW = 1 / <integer 1..32767>
Lower limit of the range.

HIGH = 64 / <integer 1..32767>
Upper limit of the range.

ROTATION = *ANY / *YES / *NO / *MANUAL
Information is requested on active SPOOL devices according to the entry in the ROTATION operand in the START-PRINTER-OUTPUT or START-TAPE-OUTPUT or START-TAPE-REPLAY command.
Information on printers without page rotation modules is only output for ROTATION=*ANY. (*NO means that ROTATION is deactivated).

TWO-UP-PROCESSING = *ANY / *YES / *NO / *MODE-1 / *MODE-2
Information is requested about printers (LP65) for which the corresponding value for TWO-UP-PROCESSING was specified in the START-PRINTER-OUTPUT command. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	SCP1052	Information incomplete
	1	CMD0202	Syntax error
	1	SCP0973	Semantic error
	32	SCP0974	System error. Command rejected
	64	SCP0976	Invalid operand value
	128	SPS0266	SPOOL subsystem not available

Notes

Within the framework of support for interoperability between BS2000- and UNIX-based systems, new printer statuses based on an ISO reference have been introduced. The following statuses are displayed by means of the SHOW-ACTIVE-SPOOL-DEVICES command:

• I(IDLE): the printer is ready to output; no print job is currently being processed

• R(RUN): the printer is active

• M(Message): there is a console message concerning the printer

• D(DETACHED): this is the status between the entry of the START-PRINTER-OUTPUT command and its execution by the controller task or the status after the STOP-PRINTER-OUTPUT command is entered

• T(TRANSFER): a started spoolout job is waiting for transport confirmation

• U(UNKNOWN): the status is not known

The connections between the statuses above and the statuses in the ISO reference are shown in the following table:

Displayed status	Print jobs for printers of type			ISO statuses
	Spool	APA	RSO
A (ATTACHED)			X	idle
I (IDLE)	X	X	X	idle
T (TRANSFER)	X		X	running
R (RUN)	X	X	X	running
M (MESSAGE)	X	X	X	needs attention
S (STOPPED)			X	needs attention
W (WORKING FOR ADM)			X	needs attention
D (DETACHED)	X	X	X	shutdown
U (UNKNOWN)	X	X	X	shutdown

Output forms

Output when no device is specified or if a device name is specified with a wildcard

DEV-NAME DEV-TYPE C-USERID C-TSN EXIT C-FORM C-CL SSU ADM CRI
@@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@   @@@ @@@@@@  ### @@@ @@@ @@@
...      ...      ...      ...    ... ...     ... ... ... ...

Meanings of the output fields

Output field	Meaning
DEV-NAME	Device name
DEV-TYPE	Device type
C-USERID	User ID of the current job (output for systems support and RSO device administrator only; otherwise blank).
C-TSN	TSN of the current job (output for systems support and RSO device administrator only; otherwise blank).
EXIT	Exit routines activated: YES/NO
C-FORM	Form used for printing out the current job
C-CL	Spoolout class of the current job
SSU	S: printer status, see notes S: printer area; the printer is started locally (L) or as a distributed printer (C) U: STOP-... command issued. NO/blank.
ADM	Caller of the command is systems support / RSO device administrator for this device: YES/blank
CRI	Selection criteria were all specified explicitly in the START-... command for the specified device (EXP) not specified at all (blank).

Table 88: SHOW-ACTIVE-SPOOL-DEVICES; output with no device specification or with wildcard specification

Output when an individual device is specified

Output for all device types

DEV-NAME:  @@@@@@@@  DEV-TYP: @@@@@@@@@ REV: ### SCHED: @@@@-JOB
C-USERID:  @@@@@@@@  PRIORITY: ###/###  USE: @@@ C-TSN: @@@@
CLASSES(@): ### ### ### ### ### ### ### ### ### ### ### ### ###
            ### ### ###
FORM(@@): @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@
          @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@
          @@@@@@ @@@@@@
PNAME(@): @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
USER (@): @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
ACC  (@): @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@
DESTS: @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
       @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
       ...
       @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@

Meanings of the output fields

Output field	Meaning
DEV-NAME	Device name
DEV-TYP	Device type
USE	Type of device activation
REV	Revision number; processing state of the device; a counter is incremented by 1 for each MODIFY-PRINTER-OUTPUT-STATUS command
SCHED	SCHEDULING-STATE: During a job, device characteristics can be changed via MODIFY-...-OUTPUT-STATUS; this does not take effect until the subsequent job. The field indicates whether the values output apply to the current job or the next job.
PRIORITY	Value range of the priorities admitted for the specified device
C-USERID	User ID of the current job (output for RSO device administrator and systems support only; otherwise blank)
C-TSN	TSN of the current job (output for RSO device administrator and systems support only; otherwise blank)
CLASSES(@)	Spoolout classes admitted for the specified device.
Auxiliary field	A : All spoolout classes are admitted P : All specified spoolout classes are admitted N : All spoolout classes except those specified here are admitted
FORM(@@)	Forms admitted for the specified device.
Auxiliary field 1	A : All forms are admitted. P : All specified forms are admitted. N : All forms except those specified here are admitted.
Auxiliary field 2	E : The specified forms are equivalent. _ : The specified forms are not equivalent.
PNAME(@)	Job names admitted for the specified device.
Auxiliary field	A : All job names are admitted P : All specified job names are admitted N : All job names except those specified here are admitted
USER(@)	User IDs admitted for the specified device (output to systems support and RSO device administrator only; otherwise blank).
Auxiliary field	A : All user IDs are admitted P : All specified user IDs are admitted N : All user IDs except those specified here are admitted
ACC(@)	Account numbers admitted for the specified device (displayed only to systems support and the device administrator; otherwise blank).
Auxiliary field	A : All account numbers are admitted P : All specified account numbers are admitted N : All account numbers except those specified here are admitted
DESTS	Device pools that can contain the specified device.

Table 89: SHOW-ACTIVE-SPOOL-DEVICES output for all device types

Additional information on local printers

CURRENT-FORM: @@@@@@  SAMPLE: @@@        EXIT: @     TRACE: @@@
SERVER-NAME: @@@@@@@@ HOST-NAME : @@@@@@@@
PRINTER-STATE: @      PRINTER-SCOPE: @   PRINTER-ERR-TYPE : @@@@
HOSTS(@): @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@

Additional information when an APA printer is specified

CURRENT-FORM: @@@@@@  TRACE: @@@(LEVEL=@)  EXIT: @
SERVER-NAME: @@@@@@@@ HOST-NAME : @@@@@@@@
PRINTER-STATE: @      PRINTER-SCOPE: @   PRINTER-ERR-TYPE : @@@@
HOSTS(@): @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@

Meanings of the output fields

Output field	Meaning
CHAR-SET	HP printers only: Number of character sets (range) that can be processed on the specified device.
CURRENT-DIA	Film overlay loaded on the specified device.
CURRENT-FORM	Form loaded on the specified device
DIAS	In local SPOOL only for HP and HP90: List of film overlays that can be processed on the device.
Auxiliary field:	(A): All film overlays (P): The specified film overlays (positive list) (N): All except the specified film overlays (negative list) (ONLY): Only devices on which film overlays can be processed (NONE): Only devices on which film overlays cannot be processed
EXIT	Exit routines activated for the specified device: yes/no
FOB	HP or LED printers only. Size range of an FOB data overlay that can be processed on the specified device.
PRINTER STATE	See "Notes".
PRINTER SCOPE	Printer scope (L: local or C: distributed).
PRINTER-ERR-TYPE	Error class based on the printer error status: OPER: Technical error: manual intervention is necessary before the message can be answered at the console. DATA: Data error: the message at the console must be answered. LOAD: Loading error: the message at the console must be answered. JOB: Job error: the message at the console concerning the job just processed by the printer must be answered. UNDEF: Undefined error.
ROTATION	Jobs that call the page rotation module can be processed on the specified device: YES/NO/ANY/MANUAL (see START-PRINTER-OUTPUT)
SAMPLE	Sample printout: yes/no
T-UP-P	TWO-UP-PROCESSING: output of two pages side by side on HP90 printers
TRACE Auxiliary field:	TRACE activated with START-PRINTER-OUTPUT command y/n LEVEL: trace level activated

Table 90: Output fields of SHOW-ACTIVE-SPOOL-DEVICES for local printers

Additional information when a virtual printer is specified

This information is only output if a virtual printer is specified in the NAME operand.

PRINTER-STATE: @      PRINTER-SCOPE: @   PRINTER-ERR-TYPE : @@@@
SERVER-NAME: @@@@@@@@ HOST-NAME : @@@@@@@@ PROGRAM-TASK : @@@@
HOSTS(@): @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
          @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@

Additional information when an RSO printer is specified

This information is only output if an RSO printer is specified in the NAME operand.

CURRENT-FORM: @@@@@@   TRACE: @@@     EXIT: @@@    SAMPLE: @@@ 
PRINTER-STATE: @   MONJV:@@@@@@@@@@@@@@@@@@@@@@ 
ACCESSES : @@@@ @@@@ @@@@ @@@@

Meanings of the output fields

Output field	Meaning
CURRENT-FORM	Form loaded on the specified device.
TRACE	A TRACE file is to be created for the specified device: YES/NO (this is only issued to systems support; the field remains empty in all other cases).
EXIT	EXIT routine activated for the specified device: YES/NO.
SAMPLE	Sample printout: YES/NO
PRINTER STATE	See "Notes".
MONJV	Name of the monitoring job variable if specified in the device record of the SPOOL parameter file ($SYSSPOOL.PRT.RSO.<device-name>), otherwise *NONE
ACCESSES	Access paths allowed, e.g. RSO, UTM

Table 91: Output fields of SHOW-ACTIVE-SPOOL-DEVICES for RSO printers

Information when a printer of a UNIX-based system is specified

This information is only output if a printer of a UNIX-based system is specified in the NAME operand.

DEV-NAME CURRENT-FORM PRINTER-STATE
@@@@@@@@ @@@@@@       @

Additional information when a tape device is specified

This information is only output if a tape device is specified in the NAME operand.

ROTATION: @@@   FOB: #####/#####  CHAR-SET: #####/#####
DIAS    (@@@@): @@ @@ @@ @@ @@ @@ @@ @@ @@ @@ @@ @@ @@ @@ @@ @@ 
RETPD:    @@@   RMODE: @@@@@      IMPORT: @@@@@@
DENSITY: @@@@@@@@  T-UP-P: @@@@@@ 
TYPE (@@@@): @@@@@ @@@@@ @@@@@ @@@@@ @@@@@ @@@@@ 
VSN: @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@
     @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@ @@@@@@

Meaning of the output fields

Output field	Meaning
ROTATION	See output for local printers.
FOB	See output for local printers.
CHAR-SET	See output for local printers.
DIAS Auxiliary field:	List of film overlays which can be processed on the device (A): All film overlays (P): The specified film overlays (positive list) (N): All except the specified film overlays (negative list) (ONLY): Only devices on which film overlays can be processed (NONE): Only devices on which film overlays cannot be processed
RETPD	Retention period for tape files in daysTape operating mode
RMODE	Outputs the tape processing mode: COPY/DIRECT.
IMPORT	VSN of the tape on which the directory file is stored
TYPE Auxiliary field:	Scheduling type defined in the SPOOLOUT-TYPE operand (START-TAPE-OUTPUT): LP, HP, FD, LP65, HP90, LP48, LP-EM, 2050-APA, 2090-APA (ALL): All types of job (MAY): Job for which SELECTION-TYPE = MAY has been specified (MUST): Job for which SELECTION-TYPE = MUST has been specified
DENSITY	Recording density for a tape (the recording density is not specified in START-TAPE.. but depends on the output device).
T-UP-P	See output for local printers.
VSN	List of volume serial numbers permitted on the device (output for systems support only; otherwise blank)

Table 92: Output fields of SHOW-ACTIVE-SPOOL-DEVICES for tape devices

Output in S variables

The command's DEVICE-NAME operand identifies the S variables which are to be created. The following specifications are possible for DEVICE-NAME:

Notation used in command	Abbreviated form used in table
DEVICE-NAME=*ALL	DEV =*ALL
DEVICE-NAME= <alphanum-name 1..8>	DEV =<name>
DEVICE-NAME= <alphanum-name 1..24 with-wild>	DEV =<name with-wild>

Note

S variables marked S/X in the “Name of the S variable” column are generated both for SPOOL and for Xprint jobs. All other S variables are generated for SPOOL jobs only.

Output information	Name of the S variable	T	Contents	Condition
Print jobs permitted for the specified device (RSO and UTM print jobs)	var(*LIST).ACCESS(*LIST)	S	' ' <allowed-accesses>	DEV=<name>
Account number	var(*LIST).ACCOUNT(*LIST)	S	' ' <account>	DEV=<name>
Account numbers with authorization for the specified device (output for system administrator/RSO device administrator only) *ALL = all numbers are authorized *NEGATIV = all except those listed *POSITIV = all those listed	var(*LIST).ACCOUNT-ADMIS	S	*ALL *NEGATIV *POSITIV	DEV=<name>
Command issued by the system administrator/RSO device administrator for this device	var(*LIST).ADM	S	*NO *YES	DEV=*ALL/ <name with-wild>
Form used to print the current job	var(*LIST).CURR-FORMS/X	S	' ' <form-name>	DEV=<name>
Current form name	var(*LIST).CURR-FORM-NAME	S	' ' <form-name>	DEV=*ALL/ <name with-wild>
Current forms overlay	var(*LIST).CURR-FORM-OVERLAY	S	<forms-overl>	DEV=<name>
Current SPOOLOUT class	var(*LIST).CURR-PRINT-JOB-CLASS	S	0..255	DEV=*ALL/ <name with-wild>
TSN of the current job	var(*LIST).CURR-TSN	S	' ' <tsn>
User ID of the current job	var(*LIST).CURR-USER-ID	S	' ' <user-id>
Number of character sets, bottom of range	var(*LIST).CHAR-SET-NUM.FROM	S	0..32767	DEV=<name>
Number of character sets, top of range	var(*LIST).CHAR-SET-NUM.TO	S	0..32767	DEV=<name>
Recording density supported by a tape	var(*LIST).DENSITY	S	' ' <density>	DEV=<name>
Device pool that may contain the device	var(*LIST).DEST(*LIST)	S	<destination>	DEV=<name>
Device name	var(*LIST).DEV-NAME S/X	S	' ' <dev-name>
Device type	var(*LIST).DEV-TYPE	S	' ' <dev-type>
Number of devices which match the selection criteria	var(*LIST).DEVICE-NUMBER	S	<0..999999>
Error code	var(*LIST).ERR-CODE	S	' ' <error code>	DEV=<name>
Error message	var(*LIST).ERR-MSG	S	' ' <error msg>	DEV=<name>
Are exit routines activated for the specified device?	var(*LIST).EXIT	S	*NO *YES
Forms overlay buffer, bottom of range	var(*LIST).FOB.FROM	S	0..32767	DEV=<name>
Forms overlay buffer, top of range	var(*LIST).FOB.TO	S	0..32767	DEV=<name>
Form name	var(*LIST).FORM-NAME(*LIST)	S	' ' <form-name>	DEV=<name>
Forms authorized for use on the specified device *ALL = all forms are authorized *NEGATIV = all except those listed *POSITIV = all those listed	var(*LIST).FORM-NAME-ADMIS	S	*ALL *NEGATIV *POSITIV	DEV=<name>
Equivalence of the output forms	var(*LIST).FORM-NAME-EQUIV	S	' ' *EQUIVALENT	DEV=<name>
Name of the forms overlay	var(*LIST).FORM-OVERLAY(*LIST)	S	' ' <forms-overl>	DEV=<name>
Forms overlays which can be processed on the device *ALL = all overlays *POSITIV = all those listed *NEGATIV = all except those listed *ONLY = only devices which support forms overlay processing *NONE = only devices which do not support forms overlay processing	var(*LIST).FORM-OVERLAY-ADMIS	S	*ALL *NEGATIV *NONE *ONLY *POSITIV	DEV=<name>
Host system	var(*LIST).HOST(*LIST)	S	' ' <host-name>	DEV=<name>
Hosts authorized to use the specified device *ALL=all hosts *POSITIV=all those listed *NEGATIV=all except those listed *LOCAL-HOST=local host *LOCAL-CLUSTER=all hosts in the local cluster	var(*LIST).HOST-ADMIS	S	*ALL *POSITIV *NEGATIV *LOCAL-HOST *LOCAL-CLUSTER	DEV=<name>
Name of the host	var(*LIST).HOST-NAME	S	' ' <host-name>	DEV=<name>
VSN of the tape containing the directory file	var(*LIST).IMPORT	S	' ' <import>	DEV=<name>
Date of most recent scheduling operation	var(*LIST).LAST-SCHED.DATE	S	*NONE <yyyy-mm-dd>
Time of most recent scheduling operation	var(*LIST).LAST-SCHED.TIME	S	*NONE <hh:mm>
Season information for the time of most recent scheduling operation	var(*LIST).LAST-SCHED.SEASON	S	*NONE *SUMMER *WINTER
Local name of the device as defined in the SPOOL parameters. With local printer: Logical name used when the printer is started. With distributed printer: Name of the logical device which is connected to the distributed printer.	var(*LIST).LOCAL-DEVICE-NAME S/X	S	<device-name>
Name of the RSO job variables	var(*LIST).MONJV	S	' ' $SYSSPOOL.PRT. RSO.<devicename>	DEV=<name>
Tape operating mode	var(*LIST).OUT-MODE	S	' ' *COPY *DIRECT	DEV=<name>
Spoolout class	var(*LIST).PRINT-JOB-CLASS(*LIST)	S	0..255	DEV=<name>
Spoolout classes authorized for use on the device *ALL = all classes *POSITIV = all those listed *NEGATIV = all except those listed	var(*LIST).PRINT-JOB-CLASS-ADMI	S	*ALL *NEGATIV *POSITIV	DEV=<name>
Spoolout name	var(*LIST).PRINT-JOB-NAME(*LIST)	S	' ' <spool-name>	DEV=<name>
Names of jobs authorized to use the device *ALL = all jobs *POSITIV = all those listed *NEGATIV = all except those listed	var(*LIST).PRINT-JOB-NAME-ADMIS	S	*ALL *NEGATIV *POSITIV	DEV=<name>
Job priority, bottom of range	var(*LIST).PRINT-JOB-PRIO.FROM	S	30..255	DEV=<name>
Job priority, top of range	var(*LIST).PRINT-JOB-PRIO.TO	S	30..255	DEV=<name>
Error class based on the printer error status: *OPER: Hardware error: manual intervention is necessary before the message on the console can be acknowledged. *DATA: Data error: requires the message on the console to be acknowledged. *LOAD: Load error: data error: Requires the message on the console to be acknowledged *JOB: Job error: requires the message on the console concerning the present print job to be acknowledged. *UNDEF: Error undefined.	var(*LIST).PRINTER-ERR-TYPE	S	*OPER *DATA *LOAD *JOB *UNDEF	DEV=<name>
Tape file retention period	var(*LIST).RETENT-PERIOD	S	<integer>	DEV=<name>
Revision number	var(*LIST).REVISION	S	0..255	DEV=<name>
Jobs that call the page rotation module	var(*LIST).ROT	S	' ' *ANY *MAN *NO *YES	DEV=<name>
Specimen printout required	var(*LIST).SAMPLE	S	*NO *YES	DEV=<name>
Applicability (data of current job or next job)	var(*LIST).SCHED-STA	S	*CURR-JOB *NEXT-JOB	DEV=<name>
Scope	var(*LIST).SCOPE	S	*CLUSTER *LOCAL
Selection criterion	var(*LIST).SEL-CRITERIA	S	' ' *EXP	DEV=*ALL/ <name with-wild>
Name of server	var(*LIST).SERVER-NAME	S	' ' <server-name>	DEV=<name>
Device types for which spoolout jobs can be processed on the specified devices	var(*LIST).SPOOL-TYPE(*LIST)	S	' ' <spool-type>	DEV=<name>
Device type limitation	var(*LIST).SPOOL-TYPE-ADMIS	S	*MAY *MUST	DEV=<name>
Printer status	var(*LIST).STAS/X	S	' ' <print-state>
Trace file required	var(*LIST).TRACE	S	*NO *YES	DEV=<name>
Active trace level	var(*LIST).TRACE-LEV	S	' ' <trace-level>	DEV=<name>
TWO-UP processing	var(*LIST).TWO-UP-PROCESS	S	' ' *ANY *MODE-1 *MODE-2 *NO *YES	DEV=<name>
Device activation style	var(*LIST).USE	S	' ' *NO	DEV=*ALL/ <name with-wild>
		S	*IN *NO *OUT *PAGE-PRINT-OUT	DEV=<name>
User ID	var(*LIST).USER-ID(*LIST)	S	' ' <user-id>	DEV=<name>
User IDs with authorization for the device *ALL = all user IDs *POSITIV = all those listed *NEGATIV = all except those listed	var(*LIST).USER-ID-ADMIS	S	*ALL *NEGATIV *POSITIV	DEV=<name>
VSN	var(*LIST).VOL(*LIST)	S	' ' <vsn>	DEV=<name>

Example

Four devices have been activated as follows:

Device 1:  START-PRINTER-OUTPUT DEV-NAME=L1
Device 2:  START-PRINTER-OUTPUT DEV-NAME=L2,(FORM-NAME=FORM01)
Device 3:  START-PRINTER-OUTPUT DEV-NAME=L3,(FORM-NAME=(FORM01,FORM02))
Device 4:  START-PRINTER-OUTPUT DEV-NAME=L4,(FORM=FORM02)

If the FORM operand is omitted in SHOW-ACTIVE-SPOOL-DEVICES, information on all four devices is output. For FORM=FORM01, information on device 2 and device 3 is output. For FORM=FORM02, information on device 3 and device 4 is output.
For FORM=(FORM01,FORM02), information on device 3 is output.