gtpo1mhnOperations

Running PTV

Use the following procedures to run PTV.

Setup Procedure

Do the following before you start PTV in phase 3 mode or STV mode.

  1. 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.
  2. 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.
  3. Mount and ready one scratch tape for the real-time log tape (RTL) and one scratch tape for the real-time tape (RTA).
  4. Mount the get file storage (GFS) directories, if requested.
  5. Mount and make ready a pilot system tape (SDF), if requested. This tape must be write protected.
  6. Mount and make ready any additional tapes that are required for testing (general tapes).
  7. Ready any consoles that will be used for live input during the PTV run.
  8. If you are performing a package test (phase 3 mode), mount and make ready a nonblocked database restore (DBR) output tape.

Running PTV in Phase 3 Mode

To run PTV in phase 3 mode, do the following:

  1. Enter ZSTVS TEST RESET to reset PTV. The TPF system prompts you to perform an initial program load (IPL).
  2. Enter the ZRIPL command to perform an IPL.
  3. When PTV requests during restart that you specify the test mode for PTV run, enter ZSTVS TEST YES.
  4. Mount the appropriate tapes as requested by the TPF system.
  5. 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.
  6. 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.

  7. 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
    
  8. 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
    
  9. When you are finished entering live input, enter ZSTVS TEST END LIVE to end the live input and start the next test unit.
  10. When you reach the end of the TUT tape, the following message is displayed:
    PTVC0002I TO INITIATE NEXT RUN ENTER ZRIPL
    
  11. If you want to continue PTV testing from the next TUT tape, do the following:
    1. Dismount the current TUT tape.
    2. Mount and make ready the next TUT tape on the same tape device.
    3. Enter the ZRIPL command to perform an IPL.
    4. Enter the appropriate ZSTVS TEST command when PTV requests during restart that you specify the test mode for PTV run.
  12. If you want to end PTV at this time, do the following:
    1. Enter the ZRIPL command to perform an IPL.
    2. 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.

    3. Enter ZTOFF ALL to dismount the RTL tape, the RTA tape, and any other tapes you were using.

Running PTV in STV Mode

To run PTV in STV mode, do the following:

  1. Enter ZCYCL NORM to cycle the TPF system to NORM state.
  2. Enter ZSTVS TEST RESET to reset PTV. The TPF system prompts you to perform an IPL.
  3. Enter the ZRIPL command to perform an IPL.
  4. When PTV requests during restart that you specify the test mode for the PTV run, enter ZSTVS TEST STV.
  5. Mount the appropriate tapes, as requested by the TPF system.
  6. The TPF system automatically cycles to NORM state.
  7. 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.

  8. 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.

Stopping PTV

To stop PTV, do the following:

  1. Enter ZSTVS STOPT to stop PTV.
  2. Enter ZSTVS TEST RESET to reset PTV. The TPF system prompts you to perform an IPL and to dismount all active and standby tapes.
  3. Enter ZTOFF ALL to dismount all the active and standby tapes.
  4. Enter the ZRIPL command to perform an IPL.
  5. 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.

  6. The TPF system ends PTV and continues to cycle to the appropriate state.

Changing From One Mode to Another

Do the following to change the PTV mode at any time:

  1. 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.
  2. Enter ZTOFF ALL to dismount all the active and standby tapes.
  3. Enter the ZRIPL command to perform an IPL.
  4. Enter the appropriate ZSTVS TEST command when PTV asks you during restart to specify the test mode for the PTV run.

Restarting the TPF System After a Catastrophic Error

  1. 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.
  2. 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.

  3. 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.

Irrecoverable Errors

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.

Diagnostic Output Formatter (DOF)

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:

See Diagnostic Output Formatter for more information about DOF.