DBTEST (Execute Test/Analysis Programs)

The DBTEST function of DBUTLTY is a debugging and analysis tool. You can use it to execute any of three testing and debugging programs as follows:
datacom150
The DBTEST function of DBUTLTY is a debugging and analysis tool. You can use it to execute any of three testing and debugging programs as follows:
Although this program executes under the control of DBUTLTY, it does not execute under the special authority of DBUTLTY.
  • DBTSTPR
    Is the
    Datacom/DB
    test program. It executes data access commands without requiring you to code a test program or assemble a User Requirements Table. The output results of each command can be printed.
  • DBIDCPR
    Is the
    Datacom/DB
    Index Area analysis program which allows you to review an Index Area (IXX) for correctness.
  • DBIDPPR
    Is the
    Datacom/DB
    Index Area population analysis program. The DBIDPPR program prints an analysis of the distribution of key values for each level of the Index and totals for each level.
The DBTEST function must be preceded by the user requirements definitions, namely DBURSTR, DBURTBL, and DBUREND. These are considered a set. The control statements containing the data access command requests are expected to follow the DBTEST function.
The DBURSTR, DBURTBL, and DBUREND functions are nearly identical to the macros required to assemble a User Requirements Table. In most cases, you can use the input to assemble these macros as input to the DBTEST process. Parameters not supported and the macros in which they occur are in the following list:
Macro
Unsupported Parameters
DBURSTR
CBSIO=
CSECT=
JOBSTAT=
OPTMIZE=
TIMEMIN=
TIMESEC=
WRITE=
DBURTBL
AREANAM=
DBFLSUB=
You cannot run any other DBUTLTY function in the same job step as DBTEST. All the input that follows the DBTEST command is considered a command or request for the DBTSTPR program.
The DBTSTPR program can run in Single User mode if NO is specified for the MULTUSE= keyword. To invoke the
Datacom/DB
test program, execute DBUTLTY using the commands described on the following pages. Maintain the command input order described next, repeating DBURTBL multiple times to build the applicable User Requirements Table entries.