Common Messaging Interface Call Routines

FREETRANSACTION

Frees a transaction object and its associated resources.

Transports supported:

MQSeries, MQSeries-C, MSMQ

Syntax
Arguments
Example

Syntax

CALL FREETRANSACTION(transid, rc);

Arguments

transid

Numeric, input

Specifies the handle to a transaction object that is obtained from the BEGINTRANSACTION function.

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 frees the resources that are associated with a transaction object:

length msg $ 200;
length transid rc 8;
rc=0;
call freetransaction(transid, rc);
if rc ^= 0 then do;
  put 'FREETRANSACTION: failed';
  msg = sysmsg();
  put msg;
end;
else put 'FREETRANSACTION: succeeded';

Top of Page