PGCH gate, INQUIRE_CHANNEL function
The INQUIRE_CHANNEL function of the PGCH gate is used to retrieve the properties of a named channel, including its address (returned as a token). To find the named channel, CICS scans the channels accessible from the specified link level.
Input Parameters
- CHANNEL_NAME
- is the 16-character name of the channel to be created.
- LINK_LEVEL
- Optional Parameter
- whether the channel is to be created on the current chain, the previous link level's chain, or on no chain (NONE). NONE is used when creating a channel for transfer on a START or RETURN command.
- Values for the parameter are:
- CURRENT
- PREVIOUS
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- CHANNEL_NOT_FOUND
- The following values are returned when RESPONSE is INVALID:
- INVALID_LINK_LEVEL
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- CCSID
- Optional Parameter
- is the default coded character set identifier (CCSID) for character data in the named channel.
- CHANNEL_TOKEN
- Optional Parameter
- is a token referencing the newly-created channel.
- CONTAINER_POOL_TOKEN
- Optional Parameter
- is a token to access a pool of containers.
- CURRENT_CHANNEL
- Optional Parameter
- whether the named channel is the current channel.
- Values for the parameter are:
- NO
- YES
- OWNER
- Optional Parameter
- whether the named channel is owned by the specified link level.
- Values for the parameter are:
- NO
- YES