MSMQINSTTOFORMAT

Returns a queue identifier that represents a format name based on the instance identifier provided.

Syntax

CALL MSMQINSTTOFORMAT(instance, qid, rc);

Required Arguments

instance
Character, input
Specifies the universal unique identifier (UUID) instance of the queue.
qid
Numeric, output
Returns the queue identifier that represents the format name of the queue.
rc
Numeric, output
Provides the return code from the CALL routine. If an error occurs, then the return code is nonzero. A return code of -1 reflects a SAS internal error. Otherwise, it represents an MSMQ error code. You can use the SAS function SYSMSG() to obtain a textual description of the return code.

Example: Example

This example obtains the format name of a queue from an instance UUID.
length msg $ 200;
qid=0;
rc=0;
CALL MSMQINSTTOFORMAT(guid, qid, rc);
if rc ^= 0 then do;
   put 'MSMQInstToFormat: failed';
   msg = sysmsg();
   put msg;
end;
else put 'MSMQInstToFormat: succeeded';