Use the following procedures to run PTV.
Do the following before you start PTV in phase 3 mode or STV mode.
- Use the system test compiler (STC) to create a test unit tape (TUT) that
contains the test units that you want run. See System Test Compiler for more information about the STC.
- If you are running PTV in PH3 mode, mount and make ready the
online disk packs as specified in the TPF System
Installation Support Reference.
- Mount and ready one scratch tape for the real-time log tape
(RTL) and one scratch tape for the real-time tape (RTA).
- Mount the get file storage (GFS) directories, if requested.
- Mount and make ready a pilot system tape (SDF), if
requested. This tape must be write protected.
- Mount and make ready any additional tapes that are required for
testing (general tapes).
- Ready any consoles that will be used for live input during the PTV
run.
- If you are performing a package test (phase 3 mode), mount and
make ready a nonblocked database restore (DBR) output tape.
To run PTV in phase 3 mode, do the following:
- Enter ZSTVS TEST RESET to reset PTV. The TPF system
prompts you to perform an initial program load (IPL).
- Enter the ZRIPL command to perform an IPL.
- When PTV requests during restart that you specify the test mode for PTV
run, enter ZSTVS TEST YES.
- Mount the appropriate tapes as requested by the TPF system.
- The TPF system automatically cycles to the appropriate state as specified
in the RUNID card for the test unit.
- Note:
- If you are testing in a specific subsystem, the basic subsystem cycles to
NORM state and the subsystem in which you are testing cycles to the
appropriate state, as specified in the RUNID card for the test unit.
- If you expect output from the test units to exceed the capacity of one
tape reel, mount a standby tape. When you mount a standby tape, tape
switching occurs automatically.
You can mount a standby tape at any time.
- PTV runs the first test unit on the first TUT tape. If you
specified live input on the RUNID card for the test unit, the following
message is displayed to indicate that you can enter live input at any time
during the test run:
PTVP0001I LIVE TEST ACTIVATE LINES
- After PTV has entered all the messages in the test unit, the following
message is displayed to indicate that the test unit is completed and you can
now enter more live input before continuing to the next test unit:
TO TERMINATE TEST UNIT DEACTIVATE LINES AND ENTER:
ZSTVS TEST END LIVE
- When you are finished entering live input, enter ZSTVS TEST END
LIVE to end the live input and start the next test unit.
- When you reach the end of the TUT tape, the following message is
displayed:
PTVC0002I TO INITIATE NEXT RUN ENTER ZRIPL
- If you want to continue PTV testing from the next TUT tape, do the
following:
- Dismount the current TUT tape.
- Mount and make ready the next TUT tape on the same tape device.
- Enter the ZRIPL command to perform an IPL.
- Enter the appropriate ZSTVS TEST command when PTV requests during restart
that you specify the test mode for PTV run.
- If you want to end PTV at this time, do the following:
- Enter the ZRIPL command to perform an IPL.
- Enter ZSTVS TEST LIVE when PTV requests during restart that you
specify the test mode for the PTV run.
PTV automatically dismounts the current TUT tape and restores all the
programs and data records that were changed by the test run to their original
condition before the test run. PTV also dismounts the DBR tape.
- Enter ZTOFF ALL to dismount the RTL tape, the RTA tape, and any
other tapes you were using.
To run PTV in STV mode, do the following:
- Enter ZCYCL NORM to cycle the TPF system to NORM state.
- Enter ZSTVS TEST RESET to reset PTV. The TPF system
prompts you to perform an IPL.
- Enter the ZRIPL command to perform an IPL.
- When PTV requests during restart that you specify the test mode for the
PTV run, enter ZSTVS TEST STV.
- Mount the appropriate tapes, as requested by the TPF system.
- The TPF system automatically cycles to NORM state.
- If you expect output from the test runs to exceed the capacity of one tape
reel, mount a standby tape. When you mount a standby tape, tape
switching occurs automatically.
You can mount a standby tape at any time.
- Enter the ZSTVS START command to start the PTV in STV mode. PTV
runs the test unit on the TUT tape. You can enter live input at any
time during the test run.
To stop PTV, do the following:
- Enter ZSTVS STOPT to stop PTV.
- Enter ZSTVS TEST RESET to reset PTV. The TPF system
prompts you to perform an IPL and to dismount all active and standby
tapes.
- Enter ZTOFF ALL to dismount all the active and standby
tapes.
- Enter the ZRIPL command to perform an IPL.
- When PTV requests during restart that you specify the test mode for the
PTV run, enter ZSTVS TEST LIVE.
PTV automatically dismounts the current TUT tape and restores all the
programs and data records that were changed by the test run to their original
condition before the test run. PTV also dismounts the DBR tape if it
was running in phase 3 mode.
- The TPF system ends PTV and continues to cycle to the appropriate
state.
Do the following to change the PTV mode at any time:
- Enter ZSTVS TEST RESET to reset PTV. The TPF system
prompts you to perform an IPL and to dismount all active and standby
tapes.
- Note:
- If you are changing from phase 3 mode to another mode, PTV automatically
restores all the programs and data records that were changed during phase 3
testing to their original condition. It also dismounts the DBR
tape.
- Enter ZTOFF ALL to dismount all the active and standby
tapes.
- Enter the ZRIPL command to perform an IPL.
- Enter the appropriate ZSTVS TEST command when PTV asks you during restart
to specify the test mode for the PTV run.
- If a catastrophic error occurs during a test, such as a system-detected
hardware or software error, the TPF system issues a dump to the RTL tape, an
alarm sounds, and the control program error recovery performs an IPL.
- If PTV is unable to control the tracing of a test unit, the following
message is displayed:
PTV UNABLE TO TRACE
The TPF system takes a main storage dump and goes into wait state.
Enter the ZRIPL command to continue testing.
- If the control program error recovery cannot perform an IPL, you must
manually perform an IPL for the prime module.
If it is not possible to recover using this procedure, enter the ZTWTM
command to write 2 tape marks on the RTL tape and then dismount it for
postprocessing.
If the following message is displayed at any time, reload the TPF system as
it was before testing began and rerun the test unit:
PTV ABORT RELOAD SYSTEM
- Note:
- This message is usually displayed when PTV cannot retrieve the PTV keypoint
record.
Data from a PTV test run is written to the real-time log tape (RTL)
that you mounted and made ready during the setup procedure. This PTV
output is formatted and printed by the offline diagnostic output formatter
(DOF).
An EOJ record must be the last record on the RTL tape in order for DOF to
process the PTV output. This EOJ record is written to the RTL tape when
one of the following conditions occurs:
- You enter the ZSTVS STOPT command
- A catastrophic error occurs during an STV run.
See Diagnostic Output Formatter for more information about DOF.