Help for Service Point Component Trace Summary

This help page explains how to start, stop, or cancel a delayed component trace. It also explains how to specify trace options, external writer, duration of a trace, etc. for an immediate or delay trace start. Click the Display/Modify Filters button to specify IP addresses, IP ports, job names, and address space identifiers to be traced.

Service Point/Stack

The service point/stack to be traced. It is defined by the TCP390 definition statement in DSIPARM member FKXCFG01 configuration file. If the stack is not defined, a "LOCAL" TCP/IP stack is assumed.

Proc

The member name of the catalogued procedure used to start the TCP/IP address space. This is defined in the configuration file.

Domain

The NetView domain where the service point resides.

Delay Start Until/Trace Started At/Start Delayed Until

Delay Start Until This is only displayed if the trace is inactive. Specify the delay start time in this field if you want to start the trace at a later time. If this field is omitted, the trace is started immediately. The time format is YYYY-MM-DD-HH.MM.SS (Year-Month-Day-Hour.Minute.Second). If the input date and time is earlier than the current time, an error is returned. If the date portion YYYY-MM-DD is omitted and the input HH.MM.SS is earlier than the current time, the trace will be started on the next day at the input time. The time value used must conform to CHRON standards.
Trace Started At This is only displayed if the trace is active. This field displays the time that the trace was started at.
Start Delayed Until This is only displayed if the trace is delayed. This field displays the time that the trace is delayed until.

Trace Owner

The operator ID in which to start a component trace or schedule a delayed trace. For a delayed trace this option enables the user to specify the name of an ID which will be active at the designated time to allow for the successful execution of the timer. The owner of the trace is still the original requester. If a delayed timer is set for a time when the requesting operator ID is not logged into NetView, the timer will fail. Click in the Trace Owner field to specify the trace owner.

Note: The trace owner must match an Operator ID (OPID) defined in DSIPARM member DSIOPF on the target host. If the packet trace has been started or delayed this field cannot be changed.

Set Timer for/Timer Set for

The duration of the trace. If you want to run the trace for a period of time, specify the duration in this field in the format of HH.MM.SS (Hour.Minute.Second). The time value used must conform to CHRON standards. If the component trace has been started this field cannot be changed. If you leave the timer blank, the trace runs until it is manually stopped.

Writer

This is a required field. Specify a source JCL for an external writer in which trace data is to be stored. Refer to z/OS MVS Diagnosis Tools and Service Aids for more information about creating source JCL for an external writer. If the component trace has been started, this field cannot be changed.

Timer Task ID

The identifier of the timer used in a delayed start. This is only applicable in delay mode.

Select Options

Select the options to set for a component trace. Specify one or more options before starting a trace by clicking on the check box corresponding to the option. At least one option must be selected. Click on a selected check box to unselect the option. Click on the Set All button to select all the options or the Reset button to reset all the options. If the trace is active or delayed you cannot change the selected options. Note: You can never start the system from the minimum option, the minimum check box will be checked only when the system runs the component trace.

Start/Stop/Cancel Delayed Start Trace

When you start, stop or cancel a delayed start trace, the action can take several minutes to respond due to system processing. When the action takes place, you are returned to the Service Point IP Trace Summary page with status updated.

Start To start a component trace, click on the Start Trace button. If Delay Start Until is specified, the trace will start at that later time if the owner ID specified is active. This button will not display if the trace is active or delayed.
Stop To stop a component trace, click on the Stop Trace button. This button will not display if the trace is inactive or delayed.
Cancel Delayed Start Trace To cancel a delayed start trace, click on the Delayed Start Trace button. This button will not display if the trace is active or stopped.

Set All Options

Click on the Set All Options button to check all options shown except Serial, Storage, and Timer. Using these options will slow performance considerably, so use with caution. This button will not display if the trace is active or delayed.

Reset Options

Click the Reset Options button to reset all the checked options. This button will not display if the trace is active or delayed.

Display/Modify Filters

Click on the Display/Modify Filters to further set or view trace options. The trace options will include IP addresses/subnet masks, ports, job names, and address space ID. If the trace is active or delayed you can only display the filters. If the trace is inactive you can modify the filters.

Note: Refer to z/OS Comm Server IP: Diagnosis for further information about the trace options.
Note: Select the Back button to return to the previous panel.

Return to Trace Summary

Click to return to the Service Point IP Trace Summary page. Use this instead of using the back and forward buttons on your browser.