Stop a buffer contents trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--BUF-------------> .-,--IDTYPE--=--RESOURCE-----. >--,--ID--=--node_name--+----------------------------+----------> '-,--IDTYPE--=--+-CP-------+-' +-SSCP-----+ '-RESOURCE-' .-,--SCOPE--=--ONLY-----. >--+-----------------------+----------------------------------->< '-,--SCOPE--=--+-ONLY-+-' '-ALL--'
Stop a communication network management trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--CNM-------------> >--,--ID--=--+-PDPIUBUF-+-------------------------------------->< '-SAWBUF---'
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------'
>>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--EXIT------------> >--,--ID--=--ISTEXCCS-------------------------------------------> >--,--OPTION--=--+-ALL--------------------+-------------------->< +-option-----------------+ +-(--option--)-----------+ | .-,------------. | | V | | '-(----+-BEGIN----+-+--)-' +-CONNSTAT-+ +-DYNA_XID-+ +-PRED_XID-+ '-END------'
>>-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------'
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--'
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-'
Stop a module trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--MODULE----------> >--,--OPTION--=--+-ALL----------------------+------------------>< +-option-------------------+ +-(--option--)-------------+ | .-,--------------. | | V | | '-(----+-COMMAND----+-+--)-' +-CONNECTION-+ +-DEFINITION-+ +-INTERFACES-+ +-MANAGEMENT-+ +-NOEXIT-----+ '-SESSION----'
Stop an NCP line trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--LINE------------> >--,--ID--=--line_name-----------------------------------------><
Stop a 3710 Network Controller line trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--NETCTLR---------> >--,--ID--=--pu_name--,--LINE--=--line_name---------------------> >--,--PU--=--3710_pu_name--------------------------------------><
Stop OSA-Express2 diagnostic data synchronization for an OSA-Express2 adapter: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--QDIOSYNC--------> .-,--ID--=--*-------------. >--+-------------------------+--------------------------------->< '-,--ID--=--+-*---------+-' '-trle_name-'
Stop the APPN route selection trace in a network node: (1) >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--ROUTE-----------> .-,--FREE--=--NO------. >--+---------------------+------------------------------------->< '-,--FREE--=--+-NO--+-' '-YES-'
Stop a scanner interface trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--SIT-------------> >--,--ID--=--line_name-----------------------------------------><
Stop an SMS (buffer use) trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--SMS-------------> .-,--ID--=--VTAMBUF-. >--+-------------------+---------------------------------------><
Stop a resource state trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--STATE----------><
>>-+-,--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----'
Stop a transmission group trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--TG--------------> >--,--ID--=--line_name-----------------------------------------><
Stop a TSO user ID trace: >>-MODIFY-- --procname--,--NOTRACE--,--TYPE--=--TSO-------------> >--,--ID--=--tso_user_id---------------------------------------><
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--'
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.
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.
If procname in the START command was startname, startname must be specified for procname.
The LU can be traced over multiple connections. To turn off tracing for multiple connections, enter a separate command for each connection.
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.
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 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.
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.
MODE=EXT is not valid when OPTION=FORCE is specified.
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.
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=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.
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.
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.