SHOW-PRINTER-POOLS

Request information on printer pool names

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

Function

Requests information on printer pools (output to SYSOUT).

Information can be requested for the following:

• Device pools (BY-POOL operand); the RSO devices or local printers associated with the specified pools are listed.

• RSO devices or local printers (BY-DEVICE operand); the names of the device pools to which the specified RSO devices or local printers belong are listed.

A device pool may contain either local spool devices or RSO devices, but not both at the same time. The wildcard format can also be used to specify a pool or device name.

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

Format

SHOW-PRINTER-POOLS

SELECT = *BY-POOL (...) / *BY-DEVICE(...)
	*BY-POOL(...)
		|		POOL-NAME = *ALL / <name 1..8> / <alphanum-name 1..8 with-wild(24)>
	*BY-DEVICE(...)
		|		DEVICE-NAME = *ALL / <alphanum-name 1..8 with-wild(24)>
,SERVER-NAME = *HOME / <alphanum-name 1..8>

Operands

SELECT =
Determines whether to output the devices belonging to a pool or a list of pools (BY-POOLS) or the pools to which a device belongs or a list of devices (BY-DEVICE).

SELECT = BY-POOL(...)

POOL-NAME = *ALL / <name 1..8> / <alphanum-name 1..8 with-wild(24)>
All devices (RSO or local) belonging to the specified pool (RSO or local), or to a list of pools, are to be output on SYSOUT.

SELECT = BY-DEVICE(...)

DEVICE-NAME = *ALL / <alphanum-name 1..8 with-wild(24)>
All pools to which the specified device (RSO or local) or the list of devices (RSO or local) belong are to be output on SYSOUT.

SERVER-NAME = *HOME / <alphanum-name 1..8>
Identifies the server for which information is required.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	SPM0455	No pool found
	32	SCP0974	System error. Command rejected
	128	SPS0266	SPOOL administrator task not available

Output formats

Output for a single RSO device pool

POOL-NAME:   @@@@@@@@     POOL-TYPE:    @@@@@@
DEVICE-NAME(S):
@@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
...

Output for a single RSO device

DEVICE-NAME:  @@@@@@@@
POOL-NAME(S):
@@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
...

Output for a pool list

POOL-NAME(S) :
@@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
...

Output for a device list

DEVICE-NAME(S) :
@@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@ @@@@@@@@
...

Output in S variables

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

Notation used in command	Abbreviated form used in table
SELECT = *BY-DEVICE(DEVICE-NAME=<name with-wild>)	1
SELECT = *BY-DEVICE(DEVICE-NAME=<name>)	2
SELECT = *BY-POOL(POOL-NAME=<name with-wild>)	3
SELECT = *BY-POOL(POOL-NAME=<name>)	4

Output information	Name of the S variable	T	Contents	Condition
Device names	var(*LIST).DEV-NAME(*LIST)	S	<device-name>	1,4
	var(*LIST).DEV-NAME	S	<device-name>	2
Time stamp	var(*LIST).LAST-ACCESS	S	*NONE <yyyy-mm-dd>	INF=*ALL
Pool name	var(*LIST).POOL-NAME(*LIST)	S	<pool-name>	2,3
	var(*LIST).POOL-NAME	S	<pool-name>	4
Pool type	var(*LIST).POOL-TYPE	S	*LOC *REM	4