The MQ_CHANNEL_EXIT call has the following parameters.
Channel exit parameter block.
This structure contains additional information relating to the invocation of the exit. The exit sets information in this structure to indicate how the MCA should proceed.
Channel definition.
This structure contains parameters set by the administrator to control the behavior of the channel.
Length of data.
When the exit is invoked, this contains the length of data in the AgentBuffer parameter. The exit must set this to the length of the data in either the AgentBuffer or the ExitBufferAddr (as determined by the ExitResponse2 field in the ChannelExitParms parameter) that is to proceed.
The data depends on the type of exit:
The content of security messages is the sole responsibility of the security exits.
If a security exit sends a message, and there is no security exit at the other end of the channel, or the other end sets an ExitResponse of MQXCC_OK, the initiating exit is re-invoked with MQXR_SEC_MSG and a null response (DataLength=0).
Length of agent buffer.
This can be greater than DataLength on invocation.
For channel message, send, and receive exits, any unused space on invocation can be used by the exit to expand the data in place. If this is done, the DataLength parameter must be set appropriately by the exit.
In the C programming language, this parameter is passed by address.
Agent buffer.
The contents of this depend upon the exit type:
If the message is to proceed, the exit can do one of the following:
Any changes that the exit makes to the transmission queue header are not checked; however, erroneous modifications may mean that the message cannot be put at the destination.
Note that the first 8 bytes of the data must not be changed by the exit.
Length of exit buffer.
On the first invocation of the exit, this is set to zero. Thereafter whatever value is passed back by the exit, on each invocation, is presented to the exit next time it is invoked. The value is not used by the MCA.
Address of exit buffer.
This is a pointer to the address of a buffer of storage managed by the exit, where it can choose to return message or transmission data (depending upon the type of exit) to the agent if the agent's buffer is or may not be large enough, or if it is more convenient for the exit to do so.
On the first invocation of the exit, the address passed to the exit is null. Thereafter whatever address is passed back by the exit, on each invocation, is presented to the exit the next time it is invoked.
Notices |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
csqzae10307 |