OutputDataLength (MQLONG)

This field holds the length of the user data to be returned to the client in a reply message. This length includes the 8-byte program name.

If your request is passing data to the user program in a COMMAREA then the user program can return response data in the COMMAREA. The response data can be longer than the request data. If it is, then you must specify the length of the response data in OutputDataLength. This length includes the 8-byte program name.

If your request is passing data to the user program in a channel/container, then the user program returns any response data in a container. The container itself indicates the length of the data it holds, so that OutputDataLength is not used.
Note: The length of the user data in a message is the length of the message excluding the MQCIH structure.

If the length of the user data in the request message is smaller than OutputDataLength, the DATALENGTH option of the LINK command is used; this option allows the LINK to be function-shipped efficiently to another CICS® region.

You can use the following special value:
MQCODL_AS_INPUT
Output length is same as input length.

This value might be needed even if no reply is requested, to ensure that the COMMAREA passed to the linked program is of sufficient size.

This request field is used only for DPL programs. The initial value of this field is MQCODL_AS_INPUT.



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