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