Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

cttctx Performance Test Utility

cttctx is a multi-threaded c-tree client test for comprehensive testing of FairCom Server operations. This utility was designed specifically for profiling FairCom Server performance. Use this utility to simulate high load conditions against the FairCom Server for verifying application performance.


cttctx <uid> <upw> <svn> [create [-t<trnmod>] | <nThrds> [-c<concurrency>]

[-d<dist>] [-e] [-h] [-j] [-o<op>] [-p] [-r<msec>] [-n<niter>] ]


  • <uid> User name
  • <upw> User password
  • <svn> FairCom Server name
  • create Create new test data/index files
  • -t<trnmod> Transaction mode to use when creating the files

    trnmod is one of the following

    • t ctTRNLOG
    • p ctPREIMG
    • n no tran
  • <nThrds> Number of c-tree threads to spawn
  • -c<concurrency> Change thread concurrency to <concurrency>
  • -e Use the embedded FairCom SQL interface (otherwise use the ISAM interface)
  • -h Hard exit, abrupt termination without thread cleanup
  • -j Add to vlength files
  • -o<op> Operation to apply

    <op> is one of the following:

    • a Add
    • r Read
    • d Delete
  • -p[1 | 2] track performance stats such as latency of operations. p1 tracks total elapsed time. p2 enables full profiling (elapsed time plus individual call times. This is the equivalent of a previous -p option).

    Output of these stats are written to a file named fnc.<PID>.<THREADID>.log where PID is the cttctx process ID and THREADID is the executing thread ID.

  • -r<msec> Number of milliseconds between performing each operation
  • -n<niter> Number of loop iterations to perform

In This Section

cttctx locking options for record read