Show allocation of ISAM pools to pool link names
Component: | BS2000 |
Functional area: | File processing |
Domain: | FILE |
Privileges: | STD-PROCESSING |
Function
The SHOW-ISAM-POOL-LINK command provides the user with information on all the existing pool link names that were assigned to ISAM pools by the user with the ADD-ISAM-POOL-LINK command since the start of the job.
For each pool link name, the name of the associated ISAM pool is shown along with its catalog ID and scope. The user can select the assignments to be displayed by specifying pool link names or ISAM pool names and direct the output to either SYSLST or SYSOUT.
The command supports structured output in S variables (see "Output in S variables").
Format
SHOW-ISAM-POOL-LINK | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
Operands
POOL-LINK-NAME = *ALL / <name 1..8>
Specifies the pool link names for which the associated ISAM pools are to be shown.
POOL-LINK-NAME = *ALL
Displays all assignments of pool link names to ISAM pools.
POOL-LINK-NAME = <name 1..8>
Specifies a pool link name for which the associated ISAM pool is to be shown. A pool link name can only be assigned to one ISAM pool.
The specification of a pool link name is given precedence over any pool name that may be specified in the POOL-NAME operand.
POOL-NAME = *ALL / <name 1..8>(...)
Specifies the ISAM pools for which the assigned pool link names are to be output.
POOL-NAME = *ALL
Displays the assigned pool link names for all pool names.
POOL-NAME = <name 1..8>(...)
Shows the pool link names assigned to the specified ISAM pool. More than one pool link name may be assigned to one ISAM pool. The desired ISAM pool is uniquely identified by the specified name, the catalog ID (see the CAT-ID operand) and the scope (see the SCOPE operand).
CAT-ID = *DEFAULT-PUBSET / <alphanum-name 1..4>
Catalog ID of the pubset to which the specified ISAM pool is assigned.
CAT-ID = *DEFAULT-PUBSET
The ISAM pool is assigned to the catalog that was set with the system parameter ISPLDEFC (ISAM-POOL-DEFAULT-CATID):
X’00’:
| default catalog ID from the user entry (see the SHOW-USER-ATTRIBUTES command, output field DEFAULT-PUBSET) |
X’01’: | catalog ID of the home pubset |
CAT-ID = <alphanum-name 1..4>
Catalog ID of the specified ISAM pool.
SCOPE = *TASK / *HOST-SYSTEM / *USER-ID / *USER-GROUP
Scope of the specified ISAM pool.
SCOPE = *TASK
Returns information on all pool link names assigned to the corresponding task-local ISAM pool.
SCOPE = *HOST-SYSTEM
Returns information on all pool link names assigned to the corresponding cross-task ISAM pool.
SCOPE = *USER-ID / *USER-GROUP
These scopes are only supported for reasons of compatibility (see the CREATE-ISAM-POOL command).
OUTPUT = *SYSOUT / *SYSLST(...)
Specifies the output medium to which the information is to be sent. The output is written to SYSOUT by default.
OUTPUT = *SYSOUT
The information is output to SYSOUT.
OUTPUT = *SYSLST(...)
The information is output to SYSLST.
SYSLST-NUMBER = 00 / <integer 0..99>
Number of a SYSLST file from the set SYSLST01 to SYSLST99. The value 00 (the default) corresponds to the system file SYSLST.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without errors | |
32 | DMS0A62 | Internal system error | |
64 | DMS0A22 | User group does not exist | |
64 | DMS0A60 | Pool link name does not exist | |
64 | DMS0A61 | No pool link name exists | |
130 | DMS0A63 | Insufficient virtual memory |
Output format
The information returned by the SHOW-ISAM-POOL-LINK command is output in a table with the following output columns:
Output column | Values | Meaning |
|---|---|---|
LINKNAME | <name 1..8> | Pool link name |
CATID | <cat-id 1..4> | Catalog ID of the associated ISAM pool |
POOLNAME | <name 1..8> | Name of the ISAM pool |
SCOPE | TASK | Task-specific ISAM pool |
USERID=<userid> | ISAM pool for jobs of the user ID <userid> | |
USERGP=<groupid> | ISAM pool for jobs of the user group <groupid> | |
HOST | System-wide global ISAM pool |
Output in S variables
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Catalog ID of the ISAM pool | var(*LIST).CAT-ID | S | <c-string 1..4> | |
Pool link name | var(*LIST).LINK-NAME | S | <c-string 1..8> | |
ISAM pool name | var(*LIST).POOL-NAME | S | <c-string 1..8> | |
Scope of the ISAM pool | var(*LIST).SCOPE | S | *HOST | |
User group | var(*LIST).USER-GROUP | S | <c-string 1..8> | |
User ID | var(*LIST).USER-ID | S | <c-string1..8> |
Examples
See the ADD-ISAM-POOL-LINK command.