APCR gate, IMPORT_ALL function
The IMPORT_ALL function of the APCR gate is used to import the complete contents of a channel.
Input Parameters
- COMMAND
- is the type of API command that caused the channel to be shipped.
- Values for the parameter are:
- LINK
- RETURN
- SIBUS
- START_ISC
- START_MRO
- CHANNEL_TOKEN_IN
- Optional Parameter
- is a token referencing an existing channel into which the channel data is to be imported.
- DATA_START
- Optional Parameter
- is the position of the beginning of the channel data in the inbound TIOA.
- RS_TOKEN
- Optional Parameter
- is a token referencing the request stream with which the channel is associated. If RS_TOKEN is specified, the channel is exported from a listener region by request streams. (RZSO SEND_REQUEST is used).
- TERMINAL_TOKEN
- Optional Parameter
- is a token referencing the terminal with which the channel is associated. If TERMINAL_TOKEN is specified, CICS terminal control is used to export the channel.
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- DATA_ERROR
- TERMINAL_ERROR
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- CHANNEL_NAME
- Optional Parameter
- is the name of the channel that has been created.
- CHANNEL_TOKEN
- Optional Parameter
- is a token referencing the channel that has been created.
- CONTAINER_LIST
- Optional Parameter
- is the address of a control block that identifies the initial state of the channel. It can be passed to a subsequent EXPORT_CHANGED call, when it is used to identify what changes have been made by comparing the initial state of the channel to the current state. This allows CICS to re-export only the changed containers.
- CORRELATION_ID
- Optional Parameter
- DATA_END
- Optional Parameter
- SIZE
- Optional Parameter
- TC_ABEND
- Optional Parameter
- is the terminal control abend code.
- TC_RESPONSE
- Optional Parameter
- is the terminal control response code.
- TC_SENSE
- Optional Parameter
- is the terminal sense code.