Changes tracing options.

Sintaxe:

SET TRACEDEST
 
>>-SET TRACEDEST--+-----------------+--+-----------------+------>
                  +-AUXSTATUS(cvda)-+  +-GTFSTATUS(cvda)-+
                  +-AUXPAUSE--------+  +-GTFSTART--------+
                  +-AUXSTART--------+  '-GTFSTOP---------'
                  '-AUXSTOP---------'
 
>--+-----------------+--+--------------------+------------------>
   +-INTSTATUS(cvda)-+  +-SWITCHACTION(cvda)-+
   +-INTSTART--------+  '-SWITCH-------------'
   '-INTSTOP---------'
 
>--+--------------------+--+-----------------------+-----------><
   +-SWITCHSTATUS(cvda)-+  '-TABLESIZE(data-value)-'
   +-NOSWITCH-----------+
   +-SWITCHALL----------+
   '-SWITCHNEXT---------'
 
 

For more information about the use of CICS-value data areas (CVDAs), see Appendix F, CVDAs recognized by the translator.

Descrição:

CICS can write trace entries to two possible destinations: the CICS internal trace table and the auxiliary trace file.
The SET TRACEDEST command allows you to specify which destination is to receive the trace entries.

Opção:

AUXSTATUS(cvda)
• Specifies whether trace entries are to be written to the CICS auxiliary trace file.
• This is referred to as auxiliary tracing.
• The CVDA values are:
  • AUXPAUSE
    • CICS is to stop writing entries, but is to leave the file open at its current position.
    • A subsequent AUXSTART request resumes writing entries immediately after those that preceded the AUXPAUSE request.
    • You can specify AUXPAUSE only when auxiliary tracing is currently active.
      • Nota:
        • The functions for the AUXPAUSE option are not enabled on the CICS for Open Systems or the CICS for Windows products.
        • When the AUXPAUSE option is used with these CICS products, a syntax check is performed and a check is made to ensure that the auxiliary trace function is enabled, but no change in status is implemented.
  • AUXSTART
    • Entries are to be written. If the file is currently closed, it is to be opened first.
  • AUXSTOP
    • Entries are not to be written. If the file is currently open, it is to be closed.
    • A subsequent AUXSTART request causes new entries to be written at the start of the file, overwriting the previous contents.

GTFSTATUS(cvda)
• Specifies whether trace entries are to be sent to the Multiple Virtual Storage (MVS) Generalized Tracing Facility (GTF).
• The CVDA values are:
  • GTFSTART
    • Entries are to be sent to MVS GTF.
  • GTFSTOP
    • Entries are not to be sent to MVS GTF.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores this option.

INTSTATUS(cvda)
• Specifies whether internal tracing is to occur; that is, whether trace entries that are not for exceptions are to be recorded in the internal trace table.
• Exception entries are always recorded.
• The CVDA values are:
  • INTSTART
    • Entries are to be recorded.
  • INTSTOP
    • Entries are not to be recorded.

SWITCHACTION(cvda)
• Specifies that the auxiliary trace files are to be switched.
• The CVDA value is:
  • SWITCH
    • CICS is to perform a switch.
• Nota:
  • The functions for the SWITCHACTION option is not enabled on the CICS for Open Systems or the CICS for Windows products.
  • When the SWITCHACTION option is used with these CICS products, a syntax check is performed and a check is made to ensure that the auxiliary trace function is enabled, but no change in file usage is implemented.

SWITCHSTATUS(cvda)
• Specifies the action that CICS is to take when the current active auxiliary trace file fills.
• The CVDA values are:
  • NOSWITCH
    • CICS is to take no action.
  • SWITCHALL
    • CICS is to switch every time the active file fills.
  • SWITCHNEXT
    • CICS is to switch when the current file is full, but only once; thereafter, the NOSWITCH value is to be in effect.

TABLESIZE(data-value)
• Specifies, as a 32-bit binary value, the size of the internal trace table in KB.
• TXSeries for Multiplatforms checks this option only for validity; otherwise, it ignores this option.

Condições:

INVREQ
• RESP2 values:
  • INTSTATUS has an invalid CVDA value (RESP2=1).
  • A TABLESIZE value of less than zero has been specified (RESP=2).
  • AUXSTATUS has an invalid CVDA value (RESP2=3).
  • SWITCHSTATUS has an invalid CVDA value (RESP2=4).
  • GTFSTATUS has an invalid CVDA value (RESP2=5).
  • AUXPAUSE was specified, but auxiliary tracing is not active (RESP2=6).
  • SWITCHACTION has an invalid CVDA value (RESP2=11).