Skip to content
English
  • There are no suggestions because the search field is empty.

Profiling FairCom DB Application Performance

Use the SNAPSHOT statistics feature to capture ISAM call times as spent within the FairCom DB Server process.

A core area to examine with FairCom DB application how much time is spent in each c-tree function. This provides areas of your application or even the FairCom Server for additional optimizations. 
 
To gather these statistics, run the following:
 
1. ctstat -wrktime on -u ADMIN -p ADMIN -s FAIRCOMS
where "FAIRCOMS" should be replaced with the name of your c-tree Server and appropriate credentials. This enables internal FairCom DB function call metrics. Note this impacts performance slightly and we only recommend doing this on a limited basis when needed.
 
2. ctstat -text -u ADMIN -p ADMIN -s FAIRCOMS  -i 60
This command will not return to the command line. It will log all c-tree Server statistics (including function call timings) to the text file SNAPSHOT.FCS every minute. We recommend capturing data for at least 10 minutes so as to have have several traces to analyze. To stop this execution, press ctrl-c to interrupt the program.
 
3. ctstat -wrktime off -u ADMIN -p ADMIN -s FAIRCOMS
Once the test in step 2 above is terminated, disable "wrktime" server metrics by making this call.
 
Please attach SNAPSHOT.FCS to a support ticket and we can help you analyze. Note SNAPSHOT.FCS is in clear text format so it's easily readable if you'd like to review yourself.

Example output
                   function name    count    elapsed average
                          LKISAM    14212    0.049    0.00000
                          DELREC       31    0.020    0.00066
                         DELVREC       31    0.001    0.00003
                          CLISAM        9    0.000    0.00004
                          CLSFIL       16    0.000    0.00000
                          ADDREC       58    0.002    0.00004
                          RWTREC       58    0.001    0.00002
                          NXTREC    50188    0.689    0.00001
                          FRSREC     1223    0.022    0.00001
                       GETALTSEQ       44    0.001    0.00002
                         EQLVREC    22187    0.184    0.00000
                         GTEVREC    15544    0.066    0.00000
                          GTVREC    12574    0.170    0.00001
                          GETSEG      440    0.001    0.00000
                          GETMAP      259    0.000    0.00000
                          EQLREC    12122    0.082    0.00000
                          GTEREC     6174    0.051    0.00000
                           GTREC       84    0.001    0.00001
                          CLIFIL      257    0.002    0.00001
                         OPNIFIL      319    0.006    0.00002
                         NXTVREC     8777    0.065    0.00000
                         FRSVREC       55    0.000    0.00001
                         INTISAM       11    0.001    0.00009
                         ADDVREC       73    0.003    0.00004
                         RWTVREC      865    0.020    0.00002
                         REDVREC      278    0.002    0.00000
                          DATENT      153    0.000    0.00000
                          IDXENT      166    0.000    0.00000
                          GETRES       20    0.000    0.00001
                         GETVLEN      278    0.001    0.00000
                        GETDODAX      132    0.001    0.00000
                         COMMBUF       18    0.000    0.00000
                       AVLFILNUM       20    0.000    0.00000
                          OPNFIL       20    0.000    0.00001
                      ctSNAPSHOT       68    0.047    0.00069