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