Using the ARM Interface

Using Performance Macros

When you use the performance macros, you do not need to define user metrics. There are default user metrics within the %PERFSTRT and %PERFSTOP macros. The default user metrics simplify performance tracking. To compare the features of performance macros and ARM macros, see Comparing the SAS 9.1 ARM Interface with the SAS 9.2 ARM Interface. There are four performance macros:

%PERFINIT Macro: names the application instance and initializes the ARM interface. Typically, you insert this macro in your code once.
%PERFSTRT Macro: specifies the start of an instance of a transaction. Insert the %PERFSTRT macro before each transaction that you want to log.
%PERFSTOP Macro: ends an instance of a transaction. Insert the %PERFSTOP macro where the transaction is known to be completed.
%PERFEND Macro: signals the termination of the application.

The %PERFSTRT and %PERFSTOP macros contain default user metrics, which alleviates defining and adding user-metric definitions, types, and values to the macros.

The following program uses the performance macros:

%log4sas();
%log4sas_logger(Perf.ARM, 'level=info'); 
options armagent=log4sas; 
options armsubsys=(arm_proc); 
%let _armexec = 1; 
%perfinit(appname="Perf_App");

%perfstrt(txnname="Perf_Tran_1");
  data x;
  do i=1 to 10000;
  x=i; y=0-i;
  output;
  end; run;

  proc sort  data=x threads; by y;  run;
%perfstop;

%perfstrt(txnname="Perf_Tran_2");
  data x;
  do i=1 to 10000;
  x=i; y=0-i;
  output;
  end; 
  run;
 
 proc sort  data=x threads; by y;  run;
%perfstop;

%perfend;
run;

Here is the output to the SAS log:

39   %log4sas();
40   %log4sas_logger(Perf.ARM, 'level=info');
41   options armagent=log4sas;
42   options armsubsys=(arm_proc);
43   %let _armexec = 1;
44   %perfinit(appname="Perf_App");
NOTE: INIT Perf_App 13f01e0 I,1533752349.599000,3,2.093750,8.437500,Perf_App,userid
45
46   %perfstrt(txnname="Perf_Tran_1");
NOTE: REGISTER Perf_Tran_1 13f0438
      G,1533752349.599000,3,5,Perf_Tran_1,,_IOCOUNT_,Count64,_MEMCURR_,
      Gauge64,_MEMHIGH_,Gauge64,_THREADCURR_,Gauge32,_THREADHIGH_,
      Gauge32NOTE: START Perf_Tran_1 13f0438 0
      S,1533752349.599000,3,5,8,2.093750,8.437500,266202463,13754368,15114240,3,7
47     data x;
NOTE: START PROCEDURE 13ef148 0 S,1533752349.614000,1,2,9,2.125000,8.437500,
               DATASTEP,0,0,
48     do i=1 to 10000;
49     x=i; y=0-i;
50     output;
51     end; run;

NOTE: The data set WORK.X has 10000 observations and 3 variables.
NOTE: STOP PROCEDURE 13ef148 0
      P,1533752349.630000,1,2,9,2.125000,8.453125,0,DATASTEP,278854,164944,
NOTE: DATA statement used (Total process time):
      real time           0.01 seconds
      cpu time            0.01 seconds


52
53     proc sort  data=x threads; by y;  run;
NOTE: START PROCEDURE 13ef148 0 S,1533752349.630000,1,2,10,2.125000,8.453125,
                SORT    ,0,0,

NOTE: There were 10000 observations read from the data set WORK.X.
NOTE: The data set WORK.X has 10000 observations and 3 variables.
NOTE: STOP PROCEDURE 13ef148 0 P,1533752358.681000,1,2,10,2.171875,8.453125,0,SORT
      ,524967,1989360,
NOTE: PROCEDURE SORT used (Total process time):
      real time           9.05 seconds
      cpu time            0.04 seconds


54   %perfstop;
NOTE: STOP Perf_Tran_1 13f0438 0
      P,1533752358.697000,3,5,8,2.171875,8.468750,0,267014988,13754368,15114240,3,7
5556   %perfstrt(txnname="Perf_Tran_2");
NOTE: REGISTER Perf_Tran_2 13f0b68
      G,1533752358.697000,3,6,Perf_Tran_2,,_IOCOUNT_,Count64,_MEMCURR_,
      Gauge64,_MEMHIGH_,Gauge64,_THREADCURR_,Gauge32,_THREADHIGH_,Gauge32
NOTE: START Perf_Tran_2 13f0b68 0
      S,1533752358.697000,3,6,11,2.171875,8.468750,267019084,13754368,15114240,3,7
57     data x;
NOTE: START PROCEDURE 13ef148 0 S,1533752358.712000,1,2,12,2.187500,8.468750,
               DATASTEP,0,0,
58     do i=1 to 10000;
59     x=i; y=0-i;
60     output;
61     end;
62     run;

NOTE: The data set WORK.X has 10000 observations and 3 variables.
NOTE: STOP PROCEDURE 13ef148 0
      P,1533752358.728000,1,2,12,2.187500,8.484375,0,DATASTEP,278854,164944,
NOTE: DATA statement used (Total process time):
      real time           0.01 seconds
      cpu time            0.01 seconds


63
64    proc sort  data=x threads; by y;  run;
NOTE: START PROCEDURE 13ef148 0 S,1533752358.728000,1,2,13,2.187500,8.484375,
                SORT    ,0,0,

NOTE: There were 10000 observations read from the data set WORK.X.
NOTE: The data set WORK.X has 10000 observations and 3 variables.
NOTE: STOP PROCEDURE 13ef148 0 P,1533752358.822000,1,2,13,2.234375,8.484375,0,SORT
      ,524614,1989840,
NOTE: PROCEDURE SORT used (Total process time):
      real time           0.07 seconds
      cpu time            0.04 seconds


65   %perfstop;
NOTE: STOP Perf_Tran_2 13f0b68 0
      P,1533752358.837000,3,6,11,2.250000,8.484375,0,267835352,13754368,15114240,3,7
66
67   %perfend;
NOTE: END Perf_App 13f01e0 E,1533752358.837000,3,2.250000,8.484375
68   run;

Top of Page