ARM Performance Macros

%PERFSTRT Macro

Specifies the start of a transaction.

Category:	ARM Performance Macro
Restriction:	SAS 9.2 and later

Syntax
Required Argument
Details

Syntax

%PERFSTRT(TXNNAME='transaction-name');

Required Argument

TXNNAME='transaction-name'

is the transaction name, which must be a SAS character variable or a literal enclosed in single or double quotation marks.

Restriction:

The transaction name has a 127-character limit.

Details

Use the %PERFSTRT macro to signal the start of a transaction. The %PERFSTRT macro contains default user metrics. To see the relationships between %PERFSTRT and the default user metrics, see Default User Metrics and Performance Macros. For an example, see Example: ARM Performance Macros.

The %PERFSTRT and %PERFSTOP macros can be nested in other %PERFSTRT and %PERFSTOP macros. When nested, each %PERFSTOP macro that is initiated is paired with the currently active %PERFSTRT macro. In the following figure, there are three %PERFSTRT and %PERFSTOP macro pairs. The first %PERFSTOP macro terminates the transaction for the third %PERFSTRT macro, and so on. The following code creates nested macro pairs:

/* 
* Enable ARM subsystem; if needed, set the _armexec=1
*/ 
%let _armexec=1; 

%PERFINIT(APPNAME='SAS 9.2 Studio Test Application');
%PERFSTRT(TXNNAME='SAS 9.2 Studio Transaction One'); 
%PERFSTRT(TXNNAME='First Nested Macro Pair');
%PERFSTRT(TXNNAME='Second Nested Macro Pair');
          
/* 
*
* SAS code that represents a discrete unit of work, 
* *
*/ 
%PERFSTOP;		/* PERFSTOP for the Second Nested Macro Pair */
%PERFSTOP;		/* PERFSTOP for the First Nested Macro Pair */
%PERFSTOP;		/* PERFSTOP for the SAS 9.2 Studio Transaction One */
%PERFEND;

Nested %PERFSTRT and %PERFSTOP Macros

[Nested %PERFSTRT and %PERFSTOP Macros]

Top of Page