Retrieves information about the tracing destination.

Sintaxe:

INQUIRE TRACEDEST
 
                      .--------------------------.
                      V                          |
>>-INQUIRE TRACEDEST----+----------------------+-+-------------><
                        +-AUXSTATUS(cvda)------+
                        +-CURAUXDS(data-area)--+
                        +-GTFSTATUS(cvda)------+
                        +-INTSTATUS(cvda)------+
                        +-SWITCHSTATUS(cvda)---+
                        '-TABLESIZE(data-area)-'
 
 

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

Descrição:

The INQUIRE TRACEDEST command tells you where CICS trace entries are currently being written.
Two destinations are possible: the CICS internal trace table and the auxiliary trace file.

Opções:

AUXSTATUS(cvda)
• Returns a CVDA value that indicates whether auxiliary tracing is active, that is, whether trace entries are being written to the auxiliary trace file.
• The CVDA values are:
  • AUXPAUSE
    • Auxiliary tracing is not currently active.
    • However, it was active earlier in the current execution of CICS, and it was suspended with a SET TRACEDEST AUXPAUSE command (or the CEMT equivalent command).
    • The auxiliary trace file remains open, and a subsequent SET TRACEDEST AUXSTART command causes trace entries to be written immediately following those that were written before the AUXPAUSE request.

  • AUXSTART

    • Auxiliary tracing is active.

    AUXSTOP

    • Auxiliary tracing is not active (the trace file is closed).

CURAUXDS(data-area)
• Returns the one-character identifier of the current auxiliary trace file, which can be an "A", a "B" or a null character.

GTFSTATUS(cvda)
• Returns a CVDA value that indicates whether Multiple Virtual Storage (MVS^(TM)) Generalized Trace Facility (GTF) tracing is active; that is, whether CICS is directing trace entries to the MVS GTF.
• The CVDA values are:
  • GTFSTART
    • GTF tracing is active.
  • GTFSTOP
    • GTF tracing is not active. This value is always returned.

INTSTATUS(cvda)
• Returns a CVDA value that indicates whether internal tracing is active; that is, whether trace entries are being written in the internal trace table.
• The CVDA values are:
  • INTSTART
    • Internal tracing is on.
  • INTSTOP
    • Internal tracing is off.
• Note:
  Exception trace entries are always written to the internal trace table, regardless of the INTSTATUS value.

SWITCHSTATUS(cvda)
• Returns a CVDA value that indicates the action that CICS is to take when the active auxiliary trace file fills.
• The CVDA values are:
  • NOSWITCH
    • CICS takes no action. This value is always returned.
  • SWITCHALL
    • CICS is to switch files every time the current one is full.
  • SWITCHNEXT
    • CICS is to switch files when the current one is full, but only once; thereafter, NOSWITCH is in effect.

TABLESIZE(data-area)
• Returns a 32-bit binary field that gives the size of the internal trace table in KB.