SETALIAS
Defines a transport or queue alias in the information
repository.
| Supports: |
MQSeries, MQSeries C, MSMQ, Rendezvous, Rendezvous-CM |
Syntax
CALL SETALIAS(type, name, storage, rc, transport , queue>);
Required Arguments
- type
-
Character, input
Specifies the type
of alias to be defined. The following types are valid:
- name
-
Character, input
Identifies the transport
alias or queue alias that is assigned.
- storage
-
Character, input
Specifies the location
for the alias definition. The REGISTRY location is valid.
- rc
-
Numeric, output
Provides the return
code from the CALL routine. If an error occurs, then the return code
is nonzero. You can use the SAS function SYSMSG() in order to obtain
a textual description of the return code.
- transport
-
Character, input
Identifies the name
of the transport. The following transports are valid:
-
MQSERIES (trantab=SAS_trantab_override)
-
MQSeries C (trantab=SAS_trantab_override)
-
-
-
Note: With the MQSeries transport,
if you use SAS to perform the conversion instead of using an MQSeries
conversion exit, then you can specify which TRANTAB to use for converting
the application data. If the TRANTAB is not specified, SAS will use
the session encoding information to convert the data.
- queue
-
Character, input
Identifies the name
of the queue that is defined. This parameter is optional.
Note: This queue is valid only
if a queue alias is being defined.
Details
An alias provides a
level of indirection that simplifies the programming interface by
encapsulating information for all other programs. For details about
administrator programs, see
Administrator Programs.
Example
This example defines
an MSMQ queue alias in the SAS registry.
length msg $ 200;
length rc 8;
rc=0;
call setalias('QUEUE', 'MYQUEUE', 'REGISTRY', rc,
'MSMQ', 'machine_name\queue_name');
if rc ^= 0 then do;
put 'SETALIAS: failed';
msg = sysmsg();
put msg;
end;
else put 'SETALIAS: succeeded';