Home

 

ReceiveUserDataPtr (MQPTR)

 

Address of first ReceiveUserData field.

If ReceiveExitsDefined is greater than zero, this is the address of the list of user data item for each channel receive exit in the chain.

Each user data item is in a field of length ExitDataLength, padded to the right with blanks. There are ReceiveExitsDefined fields adjoining one another – one for each exit. If the number of user data items defined is less than the number of exit names, undefined user data items are set to blanks. Conversely, if the number of user data items defined is greater than the number of exit names, the excess user data items are ignored and not presented to the exit.

Any changes made to these values by an exit are preserved. This allows one exit to pass information to another exit. No validation is carried out on any changes so, for example, binary data can be written to these fields if required.

If ReceiveExitsDefined is zero, this field is the null pointer.

On platforms where the programming language does not support the pointer data type, this field is declared as a byte string of the appropriate length.

This is an input field to the exit. The field is not present if Vis less than MQCD_VERSION_4.

The following fields in this structure are not present if Vis less than MQCD_VERSION_5.

 

Parent topic:

Fields

ic18680_

 

Home