MODIFY NOTRACE command

Read syntax diagramSkip visual syntax diagram
Stop a buffer contents trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--BUF------------->

                        .-,--IDTYPE--=--RESOURCE-----.   
>--,--ID--=--node_name--+----------------------------+---------->
                        '-,--IDTYPE--=--+-CP-------+-'   
                                        +-SSCP-----+     
                                        '-RESOURCE-'     

   .-,--SCOPE--=--ONLY-----.   
>--+-----------------------+-----------------------------------><
   '-,--SCOPE--=--+-ONLY-+-'   
                  '-ALL--'     

Read syntax diagramSkip visual syntax diagram
Stop a communication network management trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--CNM------------->

>--,--ID--=--+-PDPIUBUF-+--------------------------------------><
             '-SAWBUF---'   

Read syntax diagramSkip visual syntax diagram
Stop a user Exit buffer trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--EXIT------------>

>--,--ID--=--ISTEXCAA------------------------------------------->

>--,--OPTION--=--+-ALL--------------------+--------------------><
                 +-option-----------------+   
                 +-(--option--)-----------+   
                 |    .-,------------.    |   
                 |    V              |    |   
                 '-(----+-ACCTING--+-+--)-'   
                        +-ADJSSCP--+          
                        +-ALIAS----+          
                        +-ALS------+          
                        +-BEGIN----+          
                        +-END------+          
                        +-GWPATH---+          
                        +-INITAUTH-+          
                        +-REPL-----+          
                        +-SECAUTH--+          
                        +-VRSEL----+          
                        '-XRF------'          

Read syntax diagramSkip visual syntax diagram
>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--EXIT------------>

>--,--ID--=--ISTEXCCS------------------------------------------->

>--,--OPTION--=--+-ALL--------------------+--------------------><
                 +-option-----------------+   
                 +-(--option--)-----------+   
                 |    .-,------------.    |   
                 |    V              |    |   
                 '-(----+-BEGIN----+-+--)-'   
                        +-CONNSTAT-+          
                        +-DYNA_XID-+          
                        +-PRED_XID-+          
                        '-END------'          

Read syntax diagramSkip visual syntax diagram
>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--EXIT------------>

>--,--ID--=--ISTEXCDM------------------------------------------->

>--,--OPTION--=--+-ALL--------------------+--------------------><
                 +-option-----------------+   
                 +-(--option--)-----------+   
                 |    .-,------------.    |   
                 |    V              |    |   
                 '-(----+-BEGIN----+-+--)-'   
                        +-INITAUTH-+          
                        +-ADS_SEL--+          
                        +-BN_SEL---+          
                        +-CDS_SEL--+          
                        +-CRR_SEL--+          
                        +-ICN_SEL--+          
                        +-REPL-----+          
                        '-END------'          

Read syntax diagramSkip visual syntax diagram
Stop a generalized PIU trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--GPT------------->

                        .-,--IDTYPE--=--RESOURCE-----.   
>--,--ID--=--node_name--+----------------------------+---------->
                        '-,--IDTYPE--=--+-CP-------+-'   
                                        +-SSCP-----+     
                                        '-RESOURCE-'     

>--+-------------------------------------------+---------------->
   '-,--ALSNAME--=--adjacent_link_station_name-'   

   .-,--SCOPE--=--ONLY-----.   
>--+-----------------------+-----------------------------------><
   '-,--SCOPE--=--+-ONLY-+-'   
                  '-ALL--'     

Read syntax diagramSkip visual syntax diagram
Stop an input/output trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--IO-------------->

                        .-,--IDTYPE--=--RESOURCE-----.   
>--,--ID--=--node_name--+----------------------------+---------->
                        '-,--IDTYPE--=--+-CP-------+-'   
                                        +-SSCP-----+     
                                        '-RESOURCE-'     

   .-,--SCOPE--=--ONLY-----.   
>--+-----------------------+------------------------------------>
   '-,--SCOPE--=--+-ONLY-+-'   
                  '-ALL--'     

>--+--------------------------------------+--------------------><
   '-,--DEVICE--=--+-ALL----------------+-'   
                   '-hex_device_address-'     

Read syntax diagramSkip visual syntax diagram
Stop a module trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--MODULE---------->

>--,--OPTION--=--+-ALL----------------------+------------------><
                 +-option-------------------+   
                 +-(--option--)-------------+   
                 |    .-,--------------.    |   
                 |    V                |    |   
                 '-(----+-COMMAND----+-+--)-'   
                        +-CONNECTION-+          
                        +-DEFINITION-+          
                        +-INTERFACES-+          
                        +-MANAGEMENT-+          
                        +-NOEXIT-----+          
                        '-SESSION----'          

Read syntax diagramSkip visual syntax diagram
Stop an NCP line trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--LINE------------>

>--,--ID--=--line_name-----------------------------------------><

Read syntax diagramSkip visual syntax diagram
Stop a 3710 Network Controller line trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--NETCTLR--------->

>--,--ID--=--pu_name--,--LINE--=--line_name--------------------->

>--,--PU--=--3710_pu_name--------------------------------------><

Read syntax diagramSkip visual syntax diagram
Stop OSA-Express2 diagnostic data synchronization for an OSA-Express2 adapter:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--QDIOSYNC-------->

   .-,--ID--=--*-------------.   
>--+-------------------------+---------------------------------><
   '-,--ID--=--+-*---------+-'   
               '-trle_name-'     

Read syntax diagramSkip visual syntax diagram
Stop the APPN route selection trace in a network node:

                                                      (1)   
>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--ROUTE----------->

   .-,--FREE--=--NO------.   
>--+---------------------+-------------------------------------><
   '-,--FREE--=--+-NO--+-'   
                 '-YES-'     

Notes:
  1. TYPE=ROUTE is allowed only in a network node.
Read syntax diagramSkip visual syntax diagram
Stop a scanner interface trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--SIT------------->

>--,--ID--=--line_name-----------------------------------------><

Read syntax diagramSkip visual syntax diagram
Stop an SMS (buffer use) trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--SMS------------->

   .-,--ID--=--VTAMBUF-.   
>--+-------------------+---------------------------------------><

Read syntax diagramSkip visual syntax diagram
Stop a resource state trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--STATE----------><

Read syntax diagramSkip visual syntax diagram
>>-+-,--ID--=--node_name--| Operands used with ID |-+----------><
   '-,--OPTION--=--+-ALL-----------------+----------'   
                   +-option--------------+              
                   +-(--option--)--------+              
                   |    .-,---------.    |              
                   |    V           |    |              
                   '-(----+-ADJCP-+-+--)-'              
                          +-APPL--+                     
                          +-CDRM--+                     
                          +-CDRSC-+                     
                          +-GROUP-+                     
                          +-LINE--+                     
                          +-LNKST-+                     
                          +-LU----+                     
                          +-NCP---+                     
                          '-PU----'                     

Operands used with ID

   .-,--IDTYPE--=--RESOURCE-----.   
|--+----------------------------+-------------------------------|
   '-,--IDTYPE--=--+-CP-------+-'   
                   +-SSCP-----+     
                   '-RESOURCE-'     

OPTION Operand

|--,--OPTION--=--+-ALL-------------+----------------------------|
                 +-option----------+   
                 +-(--option--)----+   
                 '-(--+-ADJCP-+--)-'   
                      +-APPL--+        
                      +-CDRM--+        
                      +-CDRSC-+        
                      +-GROUP-+        
                      +-LINE--+        
                      +-LNKST-+        
                      +-LU----+        
                      +-NCP---+        
                      '-PU----'        

Read syntax diagramSkip visual syntax diagram
Stop a transmission group trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--TG-------------->

>--,--ID--=--line_name-----------------------------------------><

Read syntax diagramSkip visual syntax diagram
Stop a TSO user ID trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--TSO------------->

>--,--ID--=--tso_user_id---------------------------------------><

Read syntax diagramSkip visual syntax diagram
Stop a VTAM internal trace:

>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--VTAM------------>

   .-,--MODE--=--INT-----.   
   |                 (1) |   
   +-,--MODE--=--EXT-----+   
>--+---------------------+-------------------------------------->
   '-,--MODE--=--+-INT-+-'   
                 '-EXT-'     

>--+--------------------------------------------------------------+-><
   |                                   (2)                        |   
   +-,--SUBTRACE=ARBP,OPTION--=--+-HPR---------------+------------+   
   |                             +-hprgrpopt---------+            |   
   |                             |             (3)   |            |   
   |                             +-(..,HPR,..)-------+            |   
   |                             '-(..,hprgrpopt,..)-'            |   
   |                                  (4)                         |   
   +-,--SUBTRACE=DIO,OPTION--=--+-CIA---------------+-------------+   
   |                            +-ciagrpopt---------+             |   
   |                            |             (5)   |             |   
   |                            +-(..,CIA,..)-------+             |   
   |                            '-(..,ciagrpopt,..)-'             |   
   |                                                (6)           |   
   +-,--SUBTRACE--=--+-TGVC-+--,--OPTION--=--+-SSCP-------------+-+   
   |                 '-TREE-'                +-groupopt---------+ |   
   |                                         |              (7) | |   
   |                                         +-(..,SSCP,..)-----+ |   
   |                                         '-(..,groupopt,..)-' |   
   '-,--OPTION--=--+-ALL--------------------+---------------------'   
                   |     (8)                |                         
                   +-END--------------------+                         
                   |       (9)              |                         
                   +-FORCE------------------+                         
                   +-option-----------------+                         
                   +-(--option--)-----------+                         
                   |    .-,------------.    |                         
                   |    V              |    |                         
                   '-(----+-API------+-+--)-'                         
                          +-APIOPTS--+                                
                          +-APPC-----+                                
                          +-APPCOPTS-+                                
                          +-CFS------+                                
                          +-CIA------+                                
                          +-CIO------+                                
                          +-CMIP-----+                                
                          +-CPCPOPTS-+                                
                          +-CSM------+                                
                          +-CSMOPTS--+                                
                          +-DLUROPTS-+                                
                          +-EEOPTS---+                                
                          +-ESC------+                                
                          +-HPDTOPTS-+                                
                          +-HPR------+                                
                          +-HPROPTS--+                                
                          +-LCS------+                                
                          +-LCSOPTS--+                                
                          +-LOCK-----+                                
                          +-MSG------+                                
                          +-NRM------+                                
                          +-PIU------+                                
                          +-PSS------+                                
                          +-QDIOOPTS-+                                
                          +-SMS------+                                
                          +-SSCP-----+                                
                          +-STDOPTS--+                                
                          +-TCP------+                                
                          +-TCPOPTS--+                                
                          +-VCNS-----+                                
                          +-XBUF-----+                                
                          +-XCF------+                                
                          '-XCFOPTS--'                                

Notes:
  1. If you do not specify the mode, both internal and external recording are stopped. However, any default options that you have stopped are immediately restarted by VTAM® and recorded on the internal trace table.
  2. When you specify SUBTRACE=ARBP and you code a single OPTION value, the OPTION value must be either HPR or one of the group options (hprgrpopt) that include HPR as an individual option equivalent. The applicable group options are DLUROPTS, EEOPTS, HPDTOPTS, HPROPTS, QDIOOPTS, and XCFOPTS.
  3. When you code SUBTRACE=ARBP and you code multiple trace options in parentheses, you must code either HPR or one of the group options (hprgrpopt) that include HPR as an individual option equivalent inside the parentheses.
  4. When you specify SUBTRACE=DIO and you code a single OPTION value, the OPTION value must be either CIA or one of the group options (ciagrpopt) that include CIA as an individual option equivalent. The applicable group options are EEOPTS, HPDTOPTS, HPROPTS, QDIOOPTS, TCPOPTS, and XCFOPTS.
  5. When you code SUBTRACE=DIO and you code multiple trace options in parentheses, you must code either CIA or one of the group options (ciagrpopt) that include CIA as an individual option equivalent inside the parentheses.
  6. When you code SUBTRACE=TGVC or SUBTRACE=TREE and you code a single OPTION value, the OPTION value must be either SSCP or one of the group options (groupopt), all of which include SSCP as an individual option equivalent. The group options are APIOPTS, APPCOPTS, CPCPOPTS, CSMOPTS, DLUROPTS, EEOPTS, HPDTOPTS, HPROPTS, LCSOPTS, QDIOOPTS, STDOPTS, TCPOPTS, and XCFOPTS.
  7. When you code SUBTRACE=TGVC or SUBTRACE=TREE and you code multiple trace options in parentheses, you must code either SSCP or one of the group options (groupopt) inside the parentheses.
  8. To stop external recording with OPTION=END, MODE=EXT must be explicitly specified.
  9. OPTION=FORCE is not valid when MODE=EXT is specified.

Abbreviations

Operand Abbreviation
MODIFY F
ALSNAME ALS
OPTION OPT
OPTION=COMMAND OPT=CMD
OPTION=CONNECTION OPT=CON
OPTION=DEFINITION OPT=DEF
OPTION=INTERFACES OPT=INT
OPTION=MANAGEMENT OPT=MGMT
OPTION=SESSION OPT=SES
SCOPE=ALL EVERY or E
SCOPE=ONLY NONE

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for SCOPE=ALL, code only EVERY or E. Do not code SCOPE=E.

Purpose

The MODIFY NOTRACE command stops a specified trace or deletes a trace command that was saved previously with MODIFY TRACE,SAVE=YES. See z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures for a more detailed description of the VTAM trace facilities. See also the z/OS Communications Server: SNA Resource Definition Reference and the MODIFY TRACE command.

Operands

procname
The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM start procedure and ident is the optional identifier, either startname.ident or ident can be specified for procname.

If procname in the START command was startname, startname must be specified for procname.

ALSNAME=adjacent_link_station_name
Applies only when TYPE=GPT. It specifies the name of the adjacent link station through which you want to turn off traces. The adjacent link station name must be a PU in an NCP major node or a switched PU connected by an NCP link.

The LU can be traced over multiple connections. To turn off tracing for multiple connections, enter a separate command for each connection.

You do not need to specify the ALSNAME operand if either of the following situations is true:
  • The ALS list has only one entry (and it is not ISTAPNPU). That entry is selected.
  • The ALS list has two entries, one of which is ISTAPNPU. The entry other than ISTAPNPU is selected.

The command fails if ISTAPNPU is specified, or if ISTAPNPU is used by default because it is the only entry in the ALS list.

If no ALS list exists for the resource, specify the adjacent link station on the ALSNAME operand.

Use the DISPLAY ID=lu_name,SCOPE=ALL command to display all sessions for an independent LU and which adjacent link station list is used for each session.

DEVICE
Applies only when the ID operand is a TRLE that has the DATAPATH operand coded. Use DEVICE to stop input/output trace on OSA-Express devices specified on the DATAPATH operand.
DEVICE=ALL
Specifies to turn off input/output trace on all devices in the DATAPATH list.
DEVICE=hex_device_address
Specifies to turn off input/output trace for a specific DATAPATH device.
FREE
Applies only when you specify TYPE=ROUTE. The FREE operand specifies whether the APPN route selection trace table storage should be freed.
FREE=YES
The storage allocated for the route selection trace table is freed.
Guidelines for using the FREE operand:
  1. Start the APPN route selection trace with the MODIFY TRACE,TYPE=ROUTE command.
  2. Recreate the problem (an incorrect APPN route was taken).
  3. Stop the APPN route selection trace with the MODIFY NOTRACE,TYPE=ROUTE command.
  4. Dump VTAM to capture the information in the APPN route selection trace.
  5. Free the route selection trace table storage with the MODIFY NOTRACE,TYPE=ROUTE, FREE=YES
FREE=NO
The storage allocated for the route selection trace table is not freed.
ID=name
Specifies one of the following values:
  • When TYPE is BUF, IO, GPT, LINE, SIT, STATE, or TG, the ID operand specifies the name of a node for which there is an active trace of the type specified by the TYPE operand.

    For TYPE=BUF, TYPE=IO, TYPE=GPT, or TYPE=STATE, the name can be a network-qualified name. If name is an ACB name, and the ACB name matches the name on the APPL definition statement, then you can use a network-qualified ACB name.

    For TYPE=BUF, TYPE=IO, or TYPE=STATE for a CDRM, you can specify a network-qualified name, but this does not remove the restriction that the non-network-qualified CDRM name must be unique across networks.

    For TYPE=BUF, you can specify the name of the internal or external CMIP application program. For the VTAM topology agent, node_name is ISTTOPAG. For notification services, node_name is ISTNOTIF

    For TYPE=IO, the name can be a TRLE name with OSA-Express.

    For TYPE=BUF, TYPE=IO, or TYPE=STATE, the name can be a model resource (APPL or CDRSC). If SCOPE=ALL is specified, the command also applies to the clone resources created from the model. If SCOPE=ONLY is specified, current clone resources are unaffected, but future clone resources are affected when they are created.

  • When TYPE is CNM, the ID operand specifies one of the following values:
    • PDPIUBUF, to stop the problem determination PIU buffer trace
    • SAWBUF, to stop the session awareness buffer trace.
  • When TYPE is EXIT, the ID operand is required and must be specified as ISTEXCAA, ISTEXCCS, or ISTEXCDM.
  • When TYPE is MODULE, the ID operand does not apply.
  • When TYPE is NETCTLR, the ID operand specifies the physical unit for which the trace is to be stopped. (VTAM is not required to own or know about the IBM® 3710 Network Controller). VTAM sends the name of the resource specified on the ID operand to the IBM 3710 Network Controller specified on the PU operand.
  • When TYPE is QDIOSYNC, the ID operand specifies the TRLE name of the OSA-Express2 adapter for which diagnostic data synchronization and filtering is to be stopped. Specify ID=* to stop QDIOSYNC for all OSA-Express2 adapters.

    When multiple QDIOSYNC NOTRACE or TRACE commands are specified, the last one that is applicable to a specific TRLE name takes precedence. For example, TRACE TYPE=QDIOSYNC,ID=TRLE1 requests synchronization for a single OSA-Express2 adapter but the request is canceled if it is followed by NOTRACE TYPE=QDIOSYNC,ID=*. TRACE TYPE=QDIOSYNC,ID=* requests synchronization of all OSA-Express2 adapters and, if it is followed by NOTRACE TYPE=QDIOSYNC,ID=TRLE1, results in the synchronization of all OSA-Express2 adapters except TRLE1.

  • When TYPE is SMS, the ID operand is optional and, if specified, is always VTAMBUF.
  • When TYPE is TSO, the ID operand specifies the name of a TSO user ID for which there is an active trace.
  • When TYPE is VTAM, the ID operand does not apply.
IDTYPE
Specifies the type of resource that the ID operand names. If several types of resources share the same name, IDTYPE identifies which resource the command should act on. IDTYPE applies when TYPE=BUF, TYPE=IO, TYPE=GPT, or TYPE=STATE.
IDTYPE=CP
Stops tracing for the CP with the name specified on the ID operand. The control point can be the host CP or a CDRSC representing an adjacent CP.
IDTYPE=SSCP
Stops tracing for the SSCP with the name specified on the ID operand.
IDTYPE=RESOURCE
Stops tracing for a CP, an SSCP, or another resource with the name specified on the ID operand. If both an SSCP and a CP are found, VTAM stops tracing for both of them.
LINE=line_name
Applies only when TYPE=NETCTLR. It specifies the name of a link whose trace is to be stopped. This link is attached to the IBM 3710 Network Controller specified on the PU operand. VTAM has no knowledge of this link. VTAM sends the name of the link specified on the LINE operand to the IBM 3710 Network Controller specified on the PU operand.
MODE
Applies only when TYPE=VTAM. It specifies whether to stop internal or external trace recording.

If you do not specify MODE, the requested options are stopped both internally and externally. However, if external tracing is active when the command is issued, external tracing is restarted with the same number of external buffers.

If you turn off tracing for the default trace options, they will be immediately restarted and recorded internally.

The default options are for internal tracing only. In effect, you cannot stop the default options from running internally.
MODE=INT
Stops internal trace recording for the specified options.
MODE=EXT
Stops external trace recording for the specified options.

MODE=EXT is not valid when OPTION=FORCE is specified.

OPTION
Applies to TYPE=EXIT, TYPE=MODULE, TYPE=STATE, and TYPE=VTAM.

For TYPE=EXIT, OPTION specifies the functions for which tracing is to be stopped.

If more than one option is selected, separate them with commas and enclose the list in parentheses; for example OPTION=(BEGIN,INITAUTH,ACCTING).

For TYPE=MODULE, OPTION specifies the modules for which tracing is to be stopped.

If more than one option is selected, separate them with commas and enclose the list in parentheses; for example OPTION=(COMMAND,SESSION).

For TYPE=STATE, OPTION specifies the types of resources for which resource state tracing is to be stopped.

If more than one option is selected, separate them with commas and enclose the list in parentheses; for example OPTION=(APPL,GROUP,NCP).

For TYPE=VTAM, OPTION indicates the types of VTAM internal traces to be stopped. For additional information about the OPTION operand, see the MODIFY TRACE command and the z/OS Communications Server: SNA Resource Definition Reference. For more information about VTAM internal trace options, see the z/OS Communications Server: SNA Diagnosis Vol 2, FFST Dumps and the VIT.

If TYPE=VTAM is specified and OPTION is omitted, VTAM issues messages identifying the components for which the internal trace is active, without stopping any active traces.

If more than one option is selected, separate them with commas and enclose the list in parentheses; for example, OPTION=(API,LOCK,SSCP).

The API, CIO, MSG, NRM, PIU, and SSCP VIT options are kept active by VTAM for internal recording (MODE=INT). If you stop them, VTAM immediately restarts them. For external recording (MODE=EXT), there are no default options. You can start or stop any options.

Note: Although the default options are always active, these options do not appear in DISPLAY TRACES output unless you have specified them on the MODIFY TRACE command or the TRACE,TYPE=VTAM start option.
OPTION=ALL
Applies to TYPE=MODULE, TYPE=STATE, and TYPE=VTAM.

For TYPE=MODULE, it stops the tracing of all modules.

For TYPE=STATE, it stops the tracing of all resource types except for those started for a specific resource.

For TYPE=VTAM, it stops all of the internal trace options. Exception trace entries continue to be recorded in the internal trace table. For MODE=INT, OPTION=ALL stops internal recording for all options; however, the default options are restarted immediately. For MODE=EXT, OPTION=ALL stops external trace recording for all options. If you do not specify the MODE, tracing is stopped both internally and externally, but the default options are restarted immediately for MODE=INT.

OPTION=END
Applies to TYPE=VTAM.
  • If MODE is not specified, OPTION=END stops both internal and external trace recording and frees the internal trace table (with consequent loss of existing trace data if external recording is not being used). VTAM immediately restarts the default trace options with MODE=INT and the default trace table size.
  • If MODE=INT is specified, OPTION=END stops internal trace recording only and frees the internal trace table (with consequent loss of existing trace data if external recording is not being used). VTAM immediately restarts the default trace options with MODE=INT and the default trace table size.
  • If MODE=EXT is specified, OPTION=END stops external trace recording only. To stop external recording with OPTION=END, MODE=EXT must be explicitly specified.
For TYPE=EXIT where ID=ISTEXCAA, you can also specify the following options:
OPTION=ALL
Stops the tracing of all functions of the session management exit (SME).
OPTION=ACCTING
Stops tracing the initial and final accounting function of the session management exit (SME).
OPTION=ADJSSCP
Stops tracing the adjacent SSCP selection function of the session management exit (SME).
OPTION=ALIAS
Stops tracing the alias translation function of the session management exit (SME).
OPTION=ALS
Stops tracing the adjacent link station function of the session management exit (SME).
OPTION=BEGIN
Stops tracing the begin function of the session management exit (SME).
OPTION=END
Stops the tracing of the END function of the session management exit (SME).
OPTION=GWPATH
Stops tracing the gateway path list function of the session management exit (SME).
OPTION=INITAUTH
Stops tracing the initial authorization function of the session management exit (SME).
OPTION=REPL
Stops tracing the exit replacement function of the session management exit (SME).
OPTION=SECAUTH
Stops tracing the secondary authorization function of the session management exit (SME).
OPTION=VRSEL
Stops tracing the virtual route selection function of the session management exit (SME).
OPTION=XRF
Stops tracing the XRF session switch function of the session management exit (SME).
For TYPE=EXIT where ID=ISTEXCCS, you can also specify the following options:
OPTION=ALL
Stops tracing of all functions.
OPTION=BEGIN
Stops tracing the begin function.
OPTION=CONNSTAT
Stops tracing the connection status.
OPTION=DYNA_XID
Stops tracing the XIDs for dynamic PUs function.
OPTION=END
Stops tracing the end function.
OPTION=PRED_XID
Stops tracing the XIDs for predefined PUs function.
For TYPE=EXIT where ID=ISTEXCDM, you can also specify the following options:
OPTION=ALL
Stops tracing of all the functions.
OPTION=ADS_SEL
Stops tracing the alternate central directory server selection function.
OPTION=BEGIN
Stops tracing the begin function.
OPTION=BN_SEL
Stops tracing the border node selection function.
OPTION=CDS_SEL
Stops tracing the central directory server selection function.
OPTION=CRR_SEL
Stops tracing the central resource registration selection function.
OPTION=END
Stops tracing the end function.
OPTION=ICN_SEL
Stops tracing the interchange node selection function.
OPTION=INITAUTH
Stops tracing the initial authorization function.
OPTION=REPL
Stops tracing the exit replacement function
For TYPE=MODULE, you can also specify the following options:
OPTION=COMMAND
Stops tracing modules involved in command processing.
OPTION=CONNECTION
Stops tracing modules involved in setting up connections between nodes.
OPTION=DEFINITION
Stops tracing modules involved in resource definition processing.
OPTION=INTERFACES
Stops tracing modules involved in the interface with the host SSCP or the host CP.
OPTION=MANAGEMENT
Stops tracing modules involved in network management.
OPTION=NOEXIT
Specifies that module exits are to be traced for the modules associated with all active OPTION values for TYPE=MODULE. Module exits are traced for all modules until a subsequent MODIFY TRACE,TYPE=MODULE,OPTION=NOEXIT command is issued.
Note: When a MODULE trace is started with OPTION=NOEXIT (either with the TRACE start option or a MODIFY TRACE command), module exits are not traced. Specifying OPTION=NOEXIT on the MODIFY NOTRACE command resumes the tracing of the module exits.
OPTION=SESSION
Stops tracing modules involved in session establishment.
For TYPE=STATE, you can also specify the following options:
OPTION=ADJCP
Stops tracing the states of all adjacent control points.
OPTION=APPL
Stops tracing the states of all application programs.
OPTION=CDRM
Stops tracing the states of all CDRMs.
OPTION=CDRSC
Stops tracing the states of all CDRSCs.
OPTION=GROUP
Stops tracing the states of all line groups.
OPTION=LINE
Stops tracing the states of all lines.
OPTION=LNKST
Stops tracing of link stations.
OPTION=LU
Stops tracing the states of all logical units.
OPTION=NCP
Stops tracing the states of all NCPs.
OPTION=PU
Stops tracing the states of all physical units.
For TYPE=VTAM, you can also specify the following options:
OPTION=API
Stops tracing the application programming interface.
OPTION=APIOPTS
Stops tracing events related to the application programming interface (API). Specifying this value is equivalent to specifying OPTION=(API,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=APPC
Stops tracing LU 6.2 communication.
OPTION=APPCOPTS
Stops tracing events related to LU 6.2 application programs. Specifying this value is equivalent to specifying OPTION=(API,APPC,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=CFS
Stops tracing coupling facility services.
OPTION=CIA
This option helps isolate problems related to channel I/O. CIA entries are the remaining trace records from the CIO option.
OPTION=CIO
Stops tracing channel I/O for channel-attached devices and for lines attached to a communication adapter.
OPTION=CMIP
Stops tracing internal events in CMIP services and the VTAM topology agent.
OPTION=CPCPOPTS
Stops tracing events related to CP-CP sessions. Specifying this value is equivalent to specifying OPTION=(API,APPC,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=CSM
Stops tracing the communications storage manager.
OPTION=CSMOPTS
Stops tracing events related to communications storage manager (CSM). Specifying this value is equivalent to specifying OPTION=(API,APPC,CIO,CSM,MSG,NRM,PIU,PSS,SMS,SSCP,XBUF).
OPTION=DLUROPTS
Stops tracing events related to dependent LU requester (DLUR). Specifying this value is equivalent to specifying OPTION=(API,APPC,HPR,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=EEOPTS
Stops tracing events related to Enterprise Extender (EE). Specifying this value is equivalent to specifying OPTION=(CIA,CIO,HPR,MSG,NRM,PIU,PSS,SMS,SSCP,TCP).
OPTION=ESC
Stops tracing the execution sequence control.
OPTION=HPDTOPTS
Stops tracing events related to high performance data transfer (HPDT). Specifying this value is equivalent to specifying OPTION=(CIA,CIO,HPR,MSG,PIU,PSS,SMS,SSCP).
OPTION=HPR
Stops tracing for HPR.
OPTION=HPROPTS
Stops tracing events related to high performance routing (HPR). Specifying this value is equivalent to specifying OPTION=(API,APPC,CIA,CIO,HPR,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=LCS
Stops tracing LAN channel stations.
OPTION=LCSOPTS
Stops tracing events related to LAN channel station (LCS). Specifying this value is equivalent to specifying OPTION=(CIO,LCS,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=LOCK
Stops tracing locks
OPTION=MSG
Stops tracing messages.
OPTION=NRM
Stops tracing network resource management.
OPTION=PIU
Stops tracing path information units.
OPTION=PSS
Stops tracing process scheduling services.
OPTION=QDIOOPTS
Stops tracing events related to queued direct I/O (QDIO). Specifying this value is equivalent to specifying OPTION=(CIA,CIO,HPR,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=SMS
Stops tracing Storage Management services.
OPTION=SSCP
Stops tracing the system services control point.
OPTION=STDOPTS
Stops tracing events related to the application programming interface, channel I/O, messages, network resource management, path information units, process scheduling services, Storage Management services, and the system services control point. Specifying this value is equivalent to specifying OPTION=(API,CIO,MSG,NRM,PIU,PSS,SMS,SSCP).
OPTION=TCP
Stops tracing the Enterprise Extender events.
OPTION=TCPOPTS
Stops tracing events related to TCP/IP. Specifying this value is equivalent to specifying OPTION=(CIA,CIO,MSG,NRM,PIU,PSS,SMS,SSCP,TCP).
OPTION=VCNS
Stops tracing VTAM common network services.
OPTION=XBUF
Stops tracing of extended buffer list information.
OPTION=XCF
Stops tracing XCF communication.
OPTION=XCFOPTS
Stops tracing events related to the cross-system coupling facility (XCF). Specifying this value is equivalent to specifying OPTION=(CIA,CIO,HPR,MSG,NRM,PIU,PSS,SMS,SSCP,XCF).
OPTION=FORCE
Stops trace recording if it appears that a previous MODIFY NOTRACE,OPT=ALL or END command did not complete. Use OPTION=FORCE only if your attempt to use OPTION=END appears to have failed. VTAM immediately restarts the default trace options with MODE=INT and the default trace table size.
Note: OPTION=FORCE may cause ABENDs for applications that are in a hung condition.

OPTION=FORCE is not valid when MODE=EXT is specified. If OPTION=FORCE is specified without the MODE operand, external tracing is stopped and all external buffers are freed.

PU=3710_pu_name
Applies only when TYPE=NETCTLR. It specifies the 3710 physical unit performing the trace to be stopped. VTAM rejects the command if the physical unit is not active to this VTAM (SSCP).
SCOPE
Specifies the scope of the trace. It applies when TYPE=BUF or TYPE=IO. You can also specify the SCOPE operand for TYPE=GPT, but it is meaningful only for the NCP node. SCOPE=ALL is assumed for a GPT trace of all other node types.
SCOPE=ALL
Stops traces for any nodes subordinate to the node specified. SCOPE=ALL is not valid for the host PU trace or for the host intermediate routing node trace (ID=ISTIRN). If SCOPE=ALL is specified, VTAM issues a message and uses SCOPE=ONLY instead.

If the specified node is a model application, SCOPE=ALL turns off the trace option for the model application and stops traces for all existing dynamic applications created using the model. Traces will not be started for future dynamic applications created using the model.

SCOPE=ONLY
Stops a trace only for the specified node.

If the specified node is a model application, SCOPE=ONLY turns off the trace option or the model application. Traces for all existing dynamic applications created using the model are unaffected. Traces will not be started for future dynamic applications created using the model.

SUBTRACE
Specifies that SUBTRACE can be used to turn off a subset of trace entries under a trace option. Currently, four SUBTRACE types are defined; subtrace TREE and TGVC are defined under the SSCP trace option, subtrace DIO is defined under the CIA trace option, and subtrace ARBP is defined under the HPR trace option.
SUBTRACE=ARBP
Specifies that OPTION is a required keyword when SUBTRACE is specified and HPR must be one of the trace options specified when SUBTRACE=ARBP is coded.
SUBTRACE=DIO
Specifies that OPTION is a required keyword when SUBTRACE is specified and CIA must be one of the trace options specified when SUBTRACE=DIO is coded.
SUBTRACE=TGVC
Specifies that OPTION is a required keyword when SUBTRACE is specified and SSCP must be one of the trace options specified when SUBTRACE=TGVC is coded.
SUBTRACE=TREE
Specifies that OPTION is a required keyword when SUBTRACE is specified and SSCP must be one of the trace options specified when SUBTRACE=TREE is coded.
TYPE
Specifies the kind of trace that is to be stopped. Each trace must be stopped with a separate MODIFY NOTRACE command.
TYPE=BUF
Stops the tracing of text that passes through VTAM buffers on the way to or from the node indicated by the ID operand. The SCOPE=ALL operand can be used to extend the scope of the trace to all nodes subordinate to the specified node.
TYPE=CNM
Stops a communication network management trace.
TYPE=EXIT
Stops the tracing of functions of the session management exit (SME).
TYPE=GPT
Stops an NCP generalized PIU trace for the resources specified by the ID operand.
Note: The ID operand of MODIFY NOTRACE cannot specify:
  • An NCP switched line that is a switched subarea connection
  • A dynamic CDRSC
TYPE=IO
Stops a trace of I/O activity associated with the node specified on the ID operand. The SCOPE=ALL operand can be used to extend the scope of the trace to all nodes subordinate to the specified node. Also, for an NCP major node with an active channel attachment, the SCOPE=ALL operand terminates any active channel I/O trace.
Note: The external VIT is now used to record the IO trace entries. The previously used IO trace is no longer available. PIU, NLPI, NLPO, LSNA, and MPTNFMT entries may be written for a specific IO trace invocation. When the last IO trace is terminated, the external VIT remains active. You must explicitly turn the VIT off.
TYPE=LINE
Stops an NCP line trace for the line specified by the ID operand. Note that specifying TYPE=LINE stops any transmission group trace that was started using the same line name.
TYPE=MODULE
Stops module tracing for the options specified on the OPTION operand.
TYPE=NETCTLR
Stops the IBM 3710 Network Controller line trace for the physical unit named on the PU operand.
TYPE=QDIOSYNC
Stops QDIOSYNC OSA-Express2 diagnostic data synchronization and filtering.
TYPE=ROUTE
Stops the APPN route selection trace.
TYPE=SIT
Stops a scanner interface trace (SIT) of the communication scanner processor in the IBM 3720 or 3745 Communication Controller.
TYPE=SMS
Stops a Storage Management services (SMS) trace that is recording VTAM buffer pool usage data.
TYPE=STATE
Stops resource state tracing. If the ID operand is specified, state tracing is stopped for that resource only. If the OPTION operand is specified, state tracing is stopped for those resource types specified.
TYPE=TG
Stops an NCP transmission group trace for the transmission group containing the line specified by the ID operand.
TYPE=TSO
Stops a TSO component trace for the user ID specified by the ID operand.
TYPE=VTAM
Stops the VTAM internal trace (VIT) for the components specified by the OPTION operand. If OPTION is omitted, no internal traces are stopped; rather, VTAM issues messages identifying the components for which the internal trace is currently active.