Home

 

AgentBuffer (MQBYTE×AgentBufferLength) – input/output

 

Agent buffer.

The contents of this depend upon the exit type:

• For a channel security exit, on invocation of the exit it contains a security message if ExitReason is MQXR_SEC_MSG. If the exit wishes to send a security message back, it can either use this buffer or its own buffer (ExitBufferAddr).

• For a channel message exit, on invocation of the exit this contains:

  • The transmission queue header (MQXQH), which includes the message descriptor (which itself contains the context information for the message), immediately followed by

  • The message data

  If the message is to proceed, the exit can do one of the following:

  • Leave the contents of the buffer untouched

  • Modify the contents in place (returning the new length of the data in DataLength; this must not be greater then AgentBufferLength)

  • Copy the contents to the ExitBufferAddr, making any required changes

  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.

• For a channel send or receive exit, on invocation of the exit this contains the transmission data. The exit can do one of the following:

  • Leave the contents of the buffer untouched

  • Modify the contents in place (returning the new length of the data in DataLength; this must not be greater then AgentBufferLength)

  • Copy the contents to the ExitBufferAddr, making any required changes

  Note that the first 8 bytes of the data must not be changed by the exit.

 

Parent topic:

Parameters

ic17820_

 

Home