Help for Service Point Packet Trace Summary
This help page explains how to start, stop, or cancel a delayed packet trace. It also explains how to specify trace options, external writer, duration, etc. for an immediate or delay trace start. For convenience, all defined device links are listed with default values. An enhanced view is provided to update or add a link device.
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 TCPIP address space. This is defined in the configuration file.
Domain
The NetView domain where the service point resides.
Delay Start Until/Trace Started At/Trace 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 packet 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
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 packet 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 packet trace has been started, this field cannot be changed.
Timer Task ID
The operator task on which a delayed trace timer for this request is scheduled. This is only displayed for delayed traces.
Link Device
The device on the service point for which to trace. Device links are defined by selecting the Add Device button.
Length
Specifies that a truncated portion of the IP packet is to be traced. You can specify a length in the range 1-65535 or use the default "FULL" which captures the whole packet.
Protocol
Specifies the protocol type to be traced. This can be one of the literals TCP=6, UDP=17, ICMP=1, and RAW=255, or as a number in the range 0-255. If the PROT parameter is omitted or an asterisk (*) is specified, packets of any protocol will be traced. The default value is *.
IP Address
Specifies an IP address that will be compared with both the source and destination addresses of inbound and outbound packets. If either the source or destination address of a packet matches the specified IP address, the packet will be traced. The IP address must be specified in dotted decimal notation. If the IP option is omitted or an asterisk (*) is specified, all IP addresses will be traced. The default value is *.
SubNet Mask
Specifies a subnet mask that applies to the host and network portions of the IP address specified on the accompanying IP parameter. The subnet mask must be specified in dotted decimal notation and must be specified in conjunction with the IP parameter. The default value is 255.255.255.255.
Source Port
Specifies a port number that will be compared with the source port of inbound and outbound packets. The port number is an integer in the range 1-65535. If the source port of a packet is the same as the specified port number, the packet will be traced. This comparison is only performed for packets using either the TCP or UDP protocol; packets using other protocols are not traced. If the Source Port parameter is omitted, there is no checking of the source port of packets. If an asterisk (*) is specified, packets of any protocol and any source port will be traced. The default value is *.
Dest Ports
Specifies a port number that will be compared with the destination port of inbound and outbound packets. The port number is an integer in the range 1-65535. If the destination port of a packet is the same as the specified port number, the packet will be traced. This comparison is only performed for packets using either the TCP or UDP protocol; packets using other protocols are not traced. If the Dest Port parameter is omitted, there is no checking of the destination port of packets. If an asterisk (*) is specified, packets of any protocol and any source port will be traced. The default value is *.
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 the updated status.
Start | To start a packet 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 packet 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. |
Update Device
To update trace options for a link device,select the link device you want to update by selecting the corresponding radio button. Then click on the Update Device button. A new page will be displayed from which you can update the link device settings. If the trace is active or delayed, this button will not display.
Delete Device
To delete a device, click on the Delete Device button. If the trace is active or delayed this button will not display.
Add Device
To add a new device, click on the Add Device button. If the trace is active or delayed, this button will not display.
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.
Note: Refer to z/OS Comm Server IP: Diagnosis for further information
on the trace options.
Note: Select the Back button to return to
the previous panel.