Common Messaging Interface Call Routines

DELETEALIAS

Deletes a transport or queue alias definition from the information repository.

Transports supported:

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

Syntax
Arguments
Example

Syntax

CALL DELETEALIAS(type, name, storage, rc);

Arguments

type

Character, input

Specifies the type of alias that is to be deleted. The following types are valid:

TRANSPORT
QUEUE

name

Character, input

Identifies the transport alias or queue alias that is to be deleted.

storage

Character, input

Specifies the location of 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.

Example

The following example deletes a queue alias from the SAS registry:

length msg $ 200;
length rc 8;
rc=0;
call deletealias('QUEUE', 'MYQUEUE', 'REGISTRY', rc);
if rc ^= 0 then do;
  put 'DELETEALIAS: failed';
  msg = sysmsg();
  put msg;
end;
else put 'DELETEALIAS: succeeded';

Top of Page