Menu principal                 [Fechar]
Introdução
Divisões
Identification Division
Environment Division
Data Division
Procedure Division
Comandos CICS
VSAM - File Status
Quadros importantes
SQL - Structured Query Language
Outros programas
Rotinas prontas
Palavras reservadas
Introdução ao Oracle
Sites de busca
Sites interessantes
Meu e-mail

CICS Manual do Usuário - TRACE


Volta a página anterior

Volta ao Menu Principal


Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

TRACE

Controls the CICS trace facility.

Sintaxe: 

SET TRACE
 
>>-TRACE--+-ON--+--+--------+--+----+--+------+--+--------+----><
          '-OFF-'  '-SYSTEM-'  '-EI-'  '-USER-'  '-SINGLE-'

Descrição:

TRACE controls the CICS trace facility by turning on and off the various trace flags.
See the TXSeries for Multiplatforms Application Programming Guide for details of the trace flags and the trace destinations.

A TRACE ON or TRACE OFF command without options controls the whole CICS trace facility (by switching the Master Trace flag ON or OFF), but leaves the established pattern of trace activity undisturbed. Other options establish the trace pattern by causing specific traces to be enabled or disabled in accordance with the ON or OFF option that is given on the TRACE command; however, no trace whatsoever is output unless the Master Trace flag is independently switched ON (which can be done by using the CEMT transaction as an alternative to the EXEC CICS TRACE ON command).

The SYSTEM option controls the Master System Trace flag, which must be ON before any system trace entries are produced.

The EI option controls the EXEC Interface System Trace flag.
If system tracing is active (that is, both Master Trace and Master System Trace flags are ON), the tracing of CICS commands through the EXEC interface occurs if the EXEC Interface System Trace flag is also ON, in which case no other system trace entries are produced.

The USER option controls the Master User Trace flag, which must be ON before any user trace entries are produced.

The SINGLE option controls the Individual User Trace flag for the task that is issuing the TRACE command.
User trace entries for a task are produced only if user tracing is active (that is, both Master Trace and Master User Trace flags are ON), and the Individual User Trace flag is also ON.

The following example shows how to switch ON the Master System and EXEC Interface System Trace flags to start tracing of CICS commands.

Nota:
No tracing occurs unless the Master Trace flag is also ON. 
     EXEC CICS 
          TRACE ON SYSTEM EI 
     END-EXEC

Opções:

    EI
  • Specifies that tracing of CICS commands through the EXEC interface is to be enabled or disabled in accordance with the ON or OFF option that is given.
  • These trace entries are produced only if system tracing is active.
    • Nota:
      • The EI option causes the EXEC interface calls to be traced instead of the CICS internal functions that would otherwise be traced (see the SYSTEM option).
    OFF
  • Specifies, in the absence of any other options, that the whole CICS trace facility is to be disabled; when the Master Trace flag is OFF, no trace entries are produced irrespective of the settings of the other trace flags.
  • If other options are specified on the TRACE command, OFF applies to the setting of the corresponding trace flags only.
    ON
  • Specifies, in the absence of any other options, that the whole CICS trace facility is to be enabled; when the Master Trace flag is ON, trace entries are produced in accordance with the pattern of trace activity that is established by the other trace flags.
  • If other options are specified on the TRACE command, ON applies to the setting of the corresponding trace flags only.
    SINGLE
  • Specifies that the TRACE ON or TRACE OFF command applies to user trace entries of the (single) task that is issuing the request, for the duration of that task.
  • User trace entries for the task are produced only if user tracing is active (see the USER option).
    SYSTEM
  • Specifies that the Master System Trace flag is to be set in accordance with the ON or OFF option that is given.
  • When this flag is ON (and the whole trace facility is also enabled), CICS internal trace entries are produced unless the EXEC Interface System Trace flag is also ON, in which case only the EXEC interface tracing occurs.
    USER
  • Specifies that the Master User Trace flag is to be set in accordance with the ON or OFF option that is given.
  • When this flag is ON (and the whole trace facility is also enabled), user trace entries are produced only for those tasks for which the Individual User Trace flag is also ON.

Informações relacionadas:

© Copyright IBM Corp.