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
Start of changePERSISTENTEnd of change
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.


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