Modifying options with VARY commands

After starting an OSAENTA trace, you can change the trace using the VARY command. For example, if you want to change the trace to abbreviate the data being traced, use the following command:

V TCPIP,tcpipproc,OSAENTA,ON,ABBREV=480

You can display the results of the VARY command using Netstat:

netstat -p TCPCS -d
  DEVNAME: OSAQDIO4          DEVTYPE: MPCIPA                          
    DEVSTATUS: READY                                                  
    LNKNAME: LOSAFE            LNKTYPE: IPAQENET   LNKSTATUS: READY   
.
.
.
OSA-Express Network Traffic Analyzer Information:
  OSA PortName: QDIO4101          OSA DevStatus:     Ready
    OSA IntfName: EZANTAQDIO4101  OSA IntfStatus:    Ready
    OSA Speed:    1000            OSA Authorization: Logical Partition
    OSAENTA Cumulative Trace Statistics:
      DataMegs:   0                     Frames:          8
      DataBytes:  760                   FramesDiscarded: 4
      FramesLost: 0
    OSAENTA Active Trace Statistics:
      DataMegs:   0                     Frames:          8
      DataBytes:  760                   FramesDiscarded: 4
      FramesLost: 0                     TimeActive:      8
    OSAENTA Trace Settings:           Status: On
      DataMegsLimit: 1024               FramesLimit:     2147483647
      Abbrev:        480                TimeLimit:       10080
      Discard:       ALL
    OSAENTA Trace Filters:            Nofilter: ALL
      DeviceID: *
      Mac:      *
      VLANid:   *
      ETHType:  *
      IPAddr:   *
      Protocol: *
      PortNum:  *

If you are a TSO user, use the NETSTAT DEVlinks option.

You can use the VARY TCPIP,tcpproc,OBEYFILE command to make temporary dynamic changes to system operation and network configuration without stopping and restarting the TCP/IP address space. For example, if you started the address space TCPIPA and created a sequential data set USER99.TCPIP.OBEYFIL2 containing OSAENTA statements, issue the following command:

VARY TCPIP,TCPIPA,CMD=OBEYFILE,DSN=USER99.TCPIP.OBEYFIL2

The VARY TCPIP,,OSAENTA command is cumulative. You can trace all packets for specified IP addresses by entering multiple OSAENTA commands. In the following example, the five commands disable the current trace, clear any previous trace filters, trace all the frames received and all the frames sent for the specified IP addresses, and activate the OSAENTA trace facility.

VARY TCPIP,,OSAENTA,OFF,PORTNAME=OSA4
VARY TCPIP,,OSAENTA,CLEAR,PORTNAME=OSA4,ABBREV=200,FRAMES=8000
VARY TCPIP,,OSAENTA,PORTNAME=OSA4,IPADDR=10.27.142.44
VARY TCPIP,,OSAENTA,PORTNAME=OSA4,IPADDR=10.27.142.45
VARY TCPIP,,OSAENTA,ON,PORTNAME=OSA4