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.


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