INQUIRE SUBPOOL

Description

The INQUIRE SUBPOOL command returns information about a particular storage subpool.

Browsing

You can also browse through all the storage subpools in the region using the browse options (START, AT, NEXT, and END) on INQUIRE SUBPOOL command. In browse mode, the definitions are returned in alphabetic order of subpool name. You can specify a starting point anywhere in the full range of subpools using the AT option. If you want to see all the subpools with names beginning with a certain string of characters, for example, you can start your browse with an AT value comprising those characters, padded on the right with nulls (X'00') to make up the eight characters.

See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

DSANAME(data-area)

Returns an 8-character field giving the name of the dynamic storage area (DSA) in which the specified subpool resides. The value can be one of the following, padded with trailing blanks (X'40'):

CDSA
ECDSA
ERDSA
ESDSA
ETDSA
GCDSA
RDSA
SDSA

SUBPOOL(data-area)

Specifies the 8-character name of a storage subpool. For a full list of all storage subpools that can exist in a CICS region, see CICS subpools.

For browse operations, specify SUBPOOL on the START browse request only, not on the NEXT or END requests.

Conditions

END

RESP2 values:

2

There are no more resource definitions of this type.

ILLOGIC

RESP2 values:

1

You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress.

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

NOTFND

RESP2 values:

1

The subpool name specified on the command does not exist.