Common Messaging Interface Call Routines

SETALIAS

Defines a transport or queue alias in the information repository.

Transports supported:

MQSeries, MQSeries-C, MSMQ, Rendezvous, Rendezvous-CM

Syntax
Arguments
Details
Example

Syntax

CALL SETALIAS(type, name, storage, rc, transport <, queue>);

Arguments

type

Character, input

Specifies the type of alias to be defined. The following types are valid:

TRANSPORT
QUEUE

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)
MSMQ
RENDEZVOUS
RENDEZVOUS-CM

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. [cautionend]

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. [cautionend]

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

Top of Page