MSMQ Call Routines

MSMQINSTTOFORMAT

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

Syntax
Arguments
Example

Syntax

CALL MSMQINSTTOFORMAT(instance, qid, rc);

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

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';

Top of Page