Specifying a Program to Test

The specification process is in several stages and it is only after all have been completed that the information is logged and available via F6 (Logged Programs) in the first stage.

Stage 1 – Program Details

In this stage specify the program to be tested. You will reach this display using option 7 from the TestBench Main Menu or by executing the Adhoc_IT command.

Entries:

Program A current program must be specified which exists in the Library.

Library A valid OS/400 Library name must be specified or key ‘*LIBL’ to indicate that Adhoc_IT should search for the specified program in the user portion of the current library list.

Function Keys:

F4 – Prompt Will show a list of all program objects in the named library or the user portion of the library list when ‘*LIBL’ is specified.

F6 – Logged Programs Will show a list of the programs tested through Adhoc_IT by the current user.

Stage 2 – Parameter Definition

This stage allows you to specify the parameter definitions for the program to be tested. If the program is not already logged, TestBench will attempt to retrieve the parameter definitions from the program source.

See the section on Parameters in Setting up Test Cases for details about this display.

Once Enter has been pressed on the Parameter List Definition the following screen is displayed.

Function Keys:

F7 – Reset This will issue the OS/400 Reclaim Resources (RCLRSC) command taking the command parameters at default values. It will therefore close down any programs that were under test that did not set on Last Record (LR). It is an essential facility if you are testing memory management or program performance.

F8 – Reset & Clear In addition to the facilities provided by F7, this will clear all the parameter values from the list including those which have an extended definition.

Stage 3 – Parameter Values

In this stage specify the parameter values to be used when the program under test is executed. These values are remembered by TestBench ready for easy re-call.

The only entry at this stage is the At Start (optional) value. Numeric parameters should have a numeric value only, and if not required, zero should be entered. Values will automatically be right-adjusted by TestBench, so it is not necessary to key in any leading zeros to fill up the parameter length. Date data types and Timestamps are treated as alpha fields and any separators should be entered. Also, quotes are not reuired around alphabetic values.

Function Keys:

F4 – Prompt For long parameters it may not be possible to key all the required characters on the line. This facility will access the Extended Parameter Display.

Stage 4 – Library List and Local Data Area

Option 1 against Library List allows you to specify the initial state of the user portion of the library list for every execution of the program under test. Once set the description of this key will be highlighted.
Similarly the initial state of the Local Data Area (‘LDA’) for every execution of the program under test can be specified. Once set the description of this key will also be highlighted.