PGCH gate, CREATE_CHANNEL function
The CREATE_CHANNEL function of the PGCH gate is used to create a channel.
Input Parameters
- CHANNEL_NAME
- is the 16-character name of the channel to be created.
- CCSID
- Optional Parameter
- is the default coded character set identifier (CCSID) for character data in this channel.
- CURRENT_CHANNEL
- Optional Parameter
- whether or not the created channel is to be the current channel of the current link level.
- Values for the parameter are:
- NO
- YES
- 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
- NONE
- PREVIOUS
PERSISTENT
- Optional Parameter.
- whether or not the created channel is to persist beyond task termination.
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is INVALID:
- CCSID_INVALID
- CHANNEL_ALREADY_EXISTS
- CHANNEL_ALREADY_SET
- INVALID_CHANNEL_NAME
- The following values are returned when RESPONSE is INVALID:
- INVALID_LINK_LEVEL
- INVALID_PARAMETERS
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- 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.