MQSET

Changes the attributes of a queue object.

Syntax

CALL MQSET(hConn, hObj, compCode, reason, parms, value1 ,value2, ...>);

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 object handle that is obtained from a previous MQOPEN function call that specified the SET option. This handle represents a queue object.
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 the completion code.
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.
parms
Character, input
Specifies a string of queue attributes that you want to set for a WebSphere MQ queue. Each queue attribute must be separated by a comma and must have a value associated with it. Only certain attributes (a subset of list for MQINQ) can be changed by using this function call. Refer to the IBM WebSphere MQ documentation for more details.
value
Numeric or character, input
Provides the value for an attribute that is specified in the parms string. You must provide a value parameter for each attribute that is specified in the parms string, and the data type must be of the proper type.

Example

This example changes the queue properties by inhibiting messages to be sent (put) to the queue.
length parms $ 30;
compCode=0;
reason=0;
parms="INHIBIT_PUT";
inhibit=1;
CALL MQSET(hConn, hObj, compCode,
reason, parms,
inhibit);