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.
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.
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:
- Real-time trace (RTT), selective file dump and trace (SFDT), and
communication control program (CCP) trace
- PTV input/output message stream
- All simulators active
- Print simulated input/output messages
- Process all PTV package test units (GO option)
- Process all system error dumps (print minidumps)
- Process all snapshot dumps.
- 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.
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:
- Prints all trace output, which includes output from the real-time
trace (RTT), the selective file dump and trace (SFDT), and the communication
control program (CCP) trace
- Prints PTV input/output message streams
- Sorts input/output messages by the LNIATA/LEID field
- Prints sorted simulated PTV input/output messages
- Prints all system error dumps (minidumps)
- Prints all snapshot dumps
- Activates all simulators.
- SI=(ALL)
- Activate all simulators.
- SI=(xxxx)
- Activate the specified simulator, where xxxx can be one of the
following simulators:
- CRTS
- 1977
- 1980
- (1980-21)
- 1984 (1980-24)
- 3270
- TTYS.
- 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:
- The ALL option can be specified only by itself or with the NOPR
option.
- The SM option must be specified with an SI option, where the SI option
actually specifies the type of messages to be sorted.
- Only one SI option is allowed for each response but can include more than
one type of terminal device.
- Only one DP option is allowed for each response. If no DP option is
specified, the DP=ALL option is assumed.
- Only one SNAP option is allowed for each response.
- The only option that has a default value is the DP option.
Therefore, if you do not specify a particular option, no data is printed for
that option.
- Separate each option with a comma (,) and end the last option with a
period (.).
- If the TPF system does not support PTV, you cannot specify the IO, SM,
NOPR, or SI options. In addition, the associated defaults in the ALL
option are not generated when PTV is not supported.
- If you do not specify an option correctly, the entire response is
rejected.
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.
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.