Control Statements

DBTEST (Execute Test/Analysis Programs) › DBTEST DBTSTPR (Test Program) › Control Statements

Control Statements

When you specify DBTSTPR, you must supply control statements immediately following the DBTEST statement in your job stream. Two types of control statements are accepted by the CA Datacom/DB test program. The first type specifies the DUMP printing options. These options remain in effect until the next DUMP statement. The second type of control statement is the command statement. You can use any valid CA Datacom/DB random read, sequential read, or locate command on this statement. The format of each of the control statements follows.

Print Control Statement

The Print Control statement is formatted as follows:

Starting Column	Value and Description
1	DUMP= Required.
6	Enter one of the following values. P Print input statements and one line of returned elements in character format. The output results of the P option are directed to SYSPRINT. R Print request area and work area in snap dump format. B Print a memory dump of the Master List, including buffers. L Print a memory dump of the Master List, excluding buffers. M Use at the direction of CA Support. Print an internal trace of buffer requests (hex). N Print nothing and reset (turn off) all print options.

Starting Column

Value and Description

DUMP=

Required.

Enter one of the following values.

Print input statements and one line of returned elements in character format. The output results of the P option are directed to SYSPRINT.

Print request area and work area in snap dump format.

Print a memory dump of the Master List, including buffers.

Print a memory dump of the Master List, excluding buffers.

Use at the direction of CA Support.

Print an internal trace of buffer requests (hex).

Print nothing and reset (turn off) all print options.

You can enter multiple print control statements. The effect of each control value is cumulative until you enter a print control statement with DUMP=N specified.

Command Control Statement

The Command Control statement is formatted as follows:

Starting Column	Field Length	Description
1	5	Requested command code.
6	3	Requested table name.
9	5	Requested key name.
14	1	Null - not used.
15	1	Special control. Can be blank, or can indicate the number of elements entered (1, 2, 3). The Element List start column varies as shown later in this table. The use of a number (1, 2, or 3) is to allow the key value length to increase as needed. The maximum length is limited to 33 positions.
16	4	Optional database ID.
20	15	Key value for commands that require a value. See the CA Datacom/DB Programming" Guide for individual command requirements.
35	24	Element List. Varies with the number used in column 15.
70	2	Repeat factor to cause this command to be executed from 01 through 99 times.

Any statement with an asterisk (*) in column 1 is treated as a comment statement and printed if the P option is on; otherwise, it is ignored.

To use a key value larger than 15 bytes in the Command Control Statement, modify the start column of the element list by placing a control character in column 15 as follows:

Column 15 Contents	Maximum Key Length	Element List Starting Column	Maximum Element List Entries
Blank	15	35	4
3	21	41	3
2	27	47	2
1	33	53	1