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


dfhs3_PGCHinquire_channel.html | Timestamp icon Last updated: Monday, 5 June 2017