gtpo1mhdOperations

Specifying DOF Options by Responding to Console Messages

You can specify the DOF options by responding to 3 messages that are displayed on the console.

See Specifying DOF Options in the JCL EXEC Statement for information about specifying the DOF options in the JCL EXEC statement.

First Message for DOF Options

The following message is displayed to request information about the type of PTV run that was used to generate the RTL tape:

IDENTIFY RTL OUTPUT-LIVE OR PTV/STV = TV,
PTV/III = RS

Enter one of the following responses:

TV
The RTL tape was generated by PTV in STV mode or from a TPF system without PTV (live input).

RS
The RTL tape was generated by PTV in package test mode.
Note:
This message is not displayed if the TPF system was generated without PTV support or if the TPF system was generated with PTV support but without unit or package test support. In these cases, the TV response is assumed.

Second Message for DOF Options

The following message is displayed to determine whether you want to use the default DOF options or specify your own options:

STPP OPTIONS WANTED?
YES=Y, NO=N

Enter one of the following responses:

N
The RTL tape is processed with the following default options:

Note:
You can change these default options by using the system initialization program (SIP). PTV output, including simulation, is not processed if the SIP SYGLB/SYSET indicates no PTV support.

Y
A third message is displayed to request the DOF options.

If you entered TV in response to the first message (or if the TV response was assumed), see Third Message for DOF Options (TV Mode) for more information about the DOF options.

If you entered RS in response to the first message, see Third Message for DOF Options (RS Mode) for more information about the DOF options.

Third Message for DOF Options (TV Mode)

The following message is displayed to prompt you to enter the DOF options you want to use:

SPECIFY OPTIONS

You can specify the following DOF options:

CT
Print all communication control program (CCP) trace output.

TR
Print all trace output, which includes output from the real-time trace (RTT) and the selective file dump and trace (SFDT)

IO
Print PTV input/output message streams.

SM
Sort PTV input/output messages by the LNIATA/LEID field. This is not available in RS mode. See First Message for DOF Options for more information about RS mode.

NOPR
Suppress printing of sorted, simulated PTV input/output messages.

ALL
Does the following:

SI=(ALL)
Activate all simulators.

SI=(xxxx)
Activate the specified simulator, where xxxx can be one of the following simulators:

SI=(xxxx,yyyy,zzzz...)
Activate the specified simulators, which can be any combination of the previously listed simulators.
Note:
If the TPF system does not support local 3270 terminals, you cannot specify the SI=(3270) option.

DP=ALLF
Print, in full, all system error dumps.

DP=ALL
Print, in minidump format, all system error dumps.

DP=ALLF-ssss
Print, in full, all system error dumps produced from the specified subsystem, where ssss is a 1- to 4-character subsystem name.

DP=ALL-ssss
Print, in minidump format, all dumps produced from the specified subsystem, where ssss is a 1- to 4-character subsystem name.

DP=GOTOF(xxxx)
Go to the first system error dump with dump number xxxx and print, in full, all system error dumps from that point on, regardless of the subsystem that produced them. The variable xxxx is a 1- to 6-digit system error dump number. Leading zeros are not necessary.

DP=GOTOF(xxxx-ssss)
Go to the first system error dump with dump number xxxx from subsystem ssss and print, in full, all system error dumps from that point on. The variable xxxx is a 1- to 6-digit system error dump number. Leading zeros are not necessary. The variable ssss is a 1- to 4-character subsystem name.

DP=GOTO(xxxx)
Go to the first system error dump with dump number xxxx and print minidumps of all system error dumps from that point on, regardless of which subsystem produced them. The variable xxxx is a 1- to 6-digit system error dump number. Leading zeros are not necessary.

DP=GOTO(xxxx-ssss)
Go to system error number xxxx that was produced from subsystem ssss. Print minidumps of all system error dumps that were produced by this subsystem from that point on. The variable xxxx is a 1- to 6-digit system error dump number. Leading zeros are not necessary. The variable ssss is a 1- to 4-character subsystem name.

DP=PRINT(xxxxF,yyyy,zzzz...)
Print only system error dumps numbered xxxx (for full dumps), yyyy, and zzzz (for minidumps), regardless of the subsystem that produced them. The variables xxxx, yyyy, and zzzz are 1- to 6-digit system error dump numbers.

DP=PRINT(xxxxF-ssss,yyyy-tttt,zzzz-uuuu...)
Print only system error number xxxx from subsystem ssss (full dump), system error number yyyy from subsystem tttt, and so on (minidumps). The variables xxxx, yyyy, and zzzz are 1- to 6-digit system error dump numbers. The variables ssss, tttt, and uuuu are 1- to 4-character subsystem names.

You can specify as many as 10 dump number and subsystem name pairs.

Note:
The last subsystem name that you specify is used as the default subsystem for any subsequent dump numbers that you specified without a subsystem name. For example, if you specified DP=PRINT(XXXX-SSSS,YYYY,ZZZZ-UUUU), dump XXXX of subsystem SSSS, dump YYYY of subsystem SSSS, and dump ZZZZ of subsystem UUUU are printed. If dump number YYYY also exists for another subsystem on the RTL tape, it is not printed.

DP=SKIPF(xxxx,yyyy,zzzz...)
Print, in full, all system error dumps with the exception of system error dump numbers xxxx, yyyy, zzzz... regardless of the subsystem that produced them. The variables xxxx, yyyy, and zzzz are 1- to 6-digit system error dump numbers.

You can specify as many as 10 dump numbers.

DP=SKIP(xxxx,yyyy,zzzz...)
Print minidumps of all system error dumps with the exception of system error dump numbers xxxx, yyyy, zzzz... regardless of the subsystem that produced them. The variables xxxx, yyyy, and zzzz are 1- to 6-digit system error dump numbers.

You can specify as many as 10 dump numbers.

DP=SKIPF(xxxx-ssss,yyyy-tttt,zzzz-uuuu...)
Print, in full, all system error numbers with the exception of dump number xxxx for subsystem ssss, dump number yyyy for subsystem tttt, dump number zzzz for subsystem uuuu, and so on.

The variables xxxx, yyyy, and zzzz are 1- to 6-digit system error dump numbers. The variables ssss, tttt, and uuuu are 1- to 4-character subsystem names.

You can specify as many as 10 dump number and subsystem name pairs.

Note:
The last subsystem name that you specify is used as the default subsystem for any subsequent dump numbers that you specified without a subsystem name. For example, if you specified DP=SKIPF(XXXX-SSSS,YYYY,ZZZZ-UUUU), dump XXXX of subsystem SSSS, dump YYYY of subsystem SSSS, and dump ZZZZ of subsystem UUUU are not printed. If dump number YYYY also exists for another subsystem on the RTL tape, the dump for that subsystem is printed.

DP=SKIP(xxxx-ssss,yyyy-tttt,zzzz-uuuu...)
Print, in minidump format, all system error numbers with the exception of dump number xxxx for subsystem ssss, dump number yyyy for subsystem tttt, dump number zzzz for subsystem uuuu, and so on.

The variables xxxx, yyyy, and zzzz are 1- to 6-digit system error dump numbers. The variables ssss, tttt, and uuuu are 1- to 4-character subsystem names.

You can specify as many as 10 dump number and subsystem name pairs.

Note:
The last subsystem name that you specify is used as the default subsystem for any subsequent dump numbers that you specified without a subsystem name. For example, if you specified DP=SKIP(XXXX-SSSS,YYYY,ZZZZ-UUUU), dump XXXX of subsystem SSSS, dump YYYY of subsystem SSSS, and dump ZZZZ of subsystem UUUU are not printed. If dump number YYYY also exists for another subsystem on the RTL tape, the dump for that subsystem is printed.

DP=NO
Do not print any system error dumps.

SNAP=ALL
Process all snapshot dumps.

SNAP=ALL-ssss
Process all snapshot dumps from subsystem ssss, where ssss is a 1- to 4-character subsystem.

SNAP=TIME(hh.mm.ss-hh.mm.ss,....)
Process all snapshot dumps between the specified starting time and ending time, where hh.mm.ss is the timestamp in hours, minutes, and seconds. If you do not specify an ending time, all the snapshot dumps after the starting time are processed.

You can specify as many as 3 pairs of time ranges.

Note:
Ensure that the ending time is greater than the starting time. STPP does not handle time specified across a day boundary.

SNAP=PREFIX(w,x,y,z)
Process all snapshot dumps with the specified prefix, where w, x, y, and z are prefixes.

You can specify as many as 4 prefixes.

SNAP=CODE(xxxxxxxx,yyyyyyyy,...)
Process all snapshot dumps with the specified snapshot error codes, where xxxxxxxx and yyyyyyyy are snapshot error codes.

You can specify as many as 10 snapshot error codes.

You can specify combinations of the previous options with the following exceptions:

Examples of DOF Options (TV Mode)

The following shows examples of the DOF options.

DP=PRINT(19,57,104,175),TR,IO,SI=(ALL).
Print only system error dump numbers 19, 57, 104, and 175. Print all RTT, SFD, and SFT output. Print all of the PTV input/output message stream. Simulate all of the input/output messages.

DP=SKIP(2,4,6,8),CT,SM,SI=(CRTS,1977).
Print all system error dumps except dump numbers 2, 4, 6, and 8. Print all CCP trace output. Sort and print only CRTS and 1977 input/output messages in simulated format.

DP=GOTO(175),SM,NOPR,SI=(1980).
Print system error dump number 175 and all system error dumps following it. Sort, but do not print, the 1980-21 input/output messages. Messages are sorted (LNIATA/LEID sequence) on the device specified by the //SORTOUT DD card of the JCL that is running.

Third Message for DOF Options (RS Mode)

If you entered RS in response to the first message, RUNID is displayed with the second message each time the PTV RUNID record is found.

All of the DOF options available in TV mode are also available in RS mode. However, one additional option is available in RS mode:

GO
Allows you to start processing the RTL/RTA tape again from the point where the option was entered. The remainder of the unprocessed PTV RUNIDs (test units) are processed with the same options that were specified when you specified the GO option.

This feature allows you to process each PTV RUNID (test unit) with different options and output. In addition, the GO option allows you to process the remaining RTL/RTA tape (all test units) with the same options.

Note:
The N response to the second message includes the GO option, as does the ALL option for the third message in TV mode.