Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-PRINTER-POOLS

&pagelevel(3)&pagelevel

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