ctstap - Single-Threaded Version of Multi-Threaded Test
In V11 and later, a new test program has been added: ctstap, which is a single-threaded version of ctmtap. This test program is useful for checking that concurrent add, delete, and update operations on a file by multiple FPUTFGET processes work properly.
Description
ctstap is FairCom's Singlethreaded API sample program. This sample program is an IFIL version of ctmark. As in ctmark, the main routine runs a trial of database operations.
Supported options:
a<action>, where <action> is one of the following values:
A - add data
D - delete data retrieved in random order
G - retrieve data in random order (this is the default action)
S - call STPUSR() and terminate immediately
T - run cttestfunc() routine
U - update data retrieved in random order
e<cipher> - Encrypt the files using the specified cipher, where <cipher> is the numeric value of one of the cipher types listed in ctport.h. For example, for AES32 encryption specify e62. Use with the fc option.
fc - Create the data and index files. If not specified, open existing files.
g<transaction aborts> - Approximate number of transactions to be aborted. For example, a value of 2 implies that about 20% of the transactions will be aborted. Defaults to 1 (10% aborted transactions).
h<filename> - Use the specified file name (without extension).
ic - Create files that use record compression. Use with the fc option.
ih - Create files that use 8-byte offsets. Use with the fc option.
in - Create files without extended header. Use with the fc option.
is - Create segmented files. Use with the fc option.
iv - Create variable-length record files. Use with the fc option.
L - Use a local connection, otherwise use a client connection. This option is supported only in the LOCLIB model.
mc - Create files with offset compression in index nodes. Use with the fc option.
md<data cache_size in MB> - Set the data cache size in megabytes.
mi<index cache size in MB> - Set the index cache size in megabytes.
mm - Create files with optimized transaction marks. Use with the fc option.
mN - Create files with no transaction processing. Use with the fc option.
mt - Create files with transaction processing without logging. Use with the fc option.
mT - Create files with transaction processing with logging. Use with the fc option.
mta - Create files with auto switch to ctPREIMG mode. Use with the fc option.
mTa - Create files with auto switch to ctTRNLOG mode. Use with the fc option.
mxa - Create files with variable length index node format. Use with the fc option.
n<number of iterations> - Number of iterations of the specified action per trial. Defaults to 100 if not specified.
od<data cache size in bytes> - Set the data cache size in bytes.
oi<index cache size in bytes> - Set the index cache size in bytes.
op<page size in bytes> - Set the page size in bytes.
ox - Open the files in exclusive mode.
p<password> - Use the specified user password.
q - Quiet mode - don't print progress messages.
r<seed> - Random number seed (0-65535); defaults to 1
s<server name> - Name of FairComDB Server. Defaults to FAIRCOMS.
