Request information on printer pool names
Component: | SPOOL |
Functional area: | Controlling spoolout job |
Domain: | SPOOL-PRINT-ADMINISTRATION |
Privileges: | STD-PROCESSING |
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 | ||||||||||||||||||||||||||||||
|
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 | 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 | 4 |