gtpp1m0eProgram Development Support Reference

Test Activation Procedures

Following creation of the online modules, the system is IPLed from the prime module. The PTV utility tests for the number of I-streams active in the TPF system. If more than one I-stream is found to be active, the following message is displayed on the terminal: NOT IN UNIPROCESSOR MODE - PTV IGNORED

Processing continues with PTV inactive. You must redefine the number of I-streams active (by entering the ZCNIS command) and reactivate the PTV utility by entering ZSTVS TEST RESET. When the system is IPLed the initializer and restart sequence are initiated, and control is passed to the PTV utility. If the PTV utility is operative in normal mode (CPMOPM bit 4=0), the following message is output:

     IDENTIFY TEST RUN.  PH3, ZSTVS TEST YES
                         STV  ----- ZSTVS TEST STV
                         LIVE ----- ZSTVS TEST LIVE

Then, enter one of the following responses:

If the PTV utility is operating in STV only mode (CPMOPM bit 4=1), the previous procedure is bypassed and the PTV utility automatically sets itself up in STV mode.

Package Tests

The PTV utility verifies that the TPF system is in test mode. If live output is specified, the PTV utility sets up the required intercepts. If a pilot system is required, the SDF tape is searched for the required PILOT and loaded. Data from the test unit is then loaded and the input messages are stored. The dump option tables required for real-time trace are established. In a package test, control is passed to application programs through commands. At the completion of a test unit, if live was specified, the system continues to operate until a command is received indicating the end of live message input. See TPF Operations for more information about the PTV utility. When this message is received, or if live was not specified, IPL simulation is initiated. When control returns to the PTV utility, the operational system is restored. Output from the test goes to the console or to tape (RTL or RTA).

Error Recovery

Individual test units are treated as separate entries under the PTV utility. In the event of a catastrophic error in one test unit, the control program (CPSE) attempts to IPL the system. If this fails, a manual IPL of the prime module of the online system is required. This activates the PTV utility, which processes the next test unit (including database restore if requested and program restore).

System Test

After the TPF system is cycled as many as the desired system state, a command can be entered to initiate STV processing. System overlays are made to perform test functions and simulate output lines. The test unit tape, which only contains messages, is positioned. The messages used to control system tests are found in TPF Operations.

Live Test

After the system is cycled as many as the desired operating state, input from the live terminals can be entered. See TPF Operations for more information about PTV commands and how to change the PTV state from live to system test. No input from simulated terminals is allowed while running in a live state.

PTV Control Blocks

PTVA is the file-resident PTV keypoint record. See the TVDSA data macro for more information. It is modified during all testing phases to indicate type of test unit and options. Fields within PTVA indicate the status of the test unit tape, the status of the pilot tape, names of programs, requested test options, and test phases.