MQPUT
Puts a message on a WebSphere MQ queue that has
been previously opened.
Syntax
CALL MQPUT(hConn, hObj, hmd, hpmo, hData, compCode, reason , compCode1,
reason1, compCode2, reason2, ...>);
Required Arguments
- hConn
-
Numeric, input
Specifies the WebSphere
MQ Connection handle that is obtained from a previous MQCONN function
call.
- hObj
-
Numeric, input
Specifies the WebSphere
MQ handle to an open object that is obtained from a previous MQOPEN
call.
- hmd
-
Numeric, input
Specifies the Base
SAS internal message descriptor handle that is obtained from a previous
MQMD function call.
- hpmo
-
Numeric, input
Specifies the Base
SAS internal put message options handle that is obtained from a previous
MQPMO function call.
- hData
-
Numeric, input
Specifies the Base
SAS internal data descriptor handle that is obtained from a previous
MQSETPARMS function call. If set to zero, then it is assumed that
no data will accompany this message. For WebSphere MQ Version 5.1
and later,
hData can also
represent a reference message header that is obtained from a previous
MQRMH function call.
- compCode
-
Numeric, output
Returns the WebSphere
MQ completion code. This parameter can be used to determine whether
an error occurred during the execution of this routine. If an error
occurred, then the
compCode parameter will be nonzero, and the
reason parameter will be set to the appropriate reason code.
- reason
-
Numeric, output
Returns the WebSphere
MQ reason code that qualifies
compCode.
Note: A reason code of -1 reflects
a Base SAS internal error, not a WebSphere MQ error. To obtain a textual
description of a failure (either Base SAS or WebSphere MQ), use the
SYSMSG() Base SAS function call.
- compCodex, reasonx
-
Numeric, output
The
compCodex and
reasonx are an optional series of paired values that can be used when opening
a distribution list in order to discern failures for specific queues
within the distribution list. These parameters support features of
WebSphere MQ Version 5.1 and later.
Example
This example sends a
message to a queue.
compCode=0;
reason=0;
CALL MQPUT(hConn, hObj, hmd, hpmo, hData,
compCode,
reason);