TRACING=(PFX=
prefix
       [,APPEND={N|
Y}]
       [,BUFFERS={
number_of_buffers|
100}]
       [,FILENUM={
number_of_files|
5}]
       [,FLUSH={
flush_interval|
99}]
       [,RECLEN={
record_length|
80}]
       [,SIZE={
log_size|
100}]
       [,VIEW={
N|Y}]
)

PFX=

prefix

Obrigatório. Especifica o prefixo para nomes de arquivo de log alternativo.

O PowerExchange usa as seguintes regras baseadas no sistema para criar os nomes de arquivo de log alternativo:

i5/OS

O PowerExchange usa o valor PFX para criar os nomes de membro dos arquivos de log na biblioteca de dados do PowerExchange. Os nomes de arquivo de log gerados dependem de quem cria os arquivos: o Ouvinte ou o Condensador do PowerExchange, ou outros trabalhos do PowerExchange.

O Ouvinte do PowerExchange usa a seguinte convenção de nomenclatura de arquivo:

datalib/P
listener_port(
prefixnnn)

O Condensador do PowerExchange e outros trabalhos do PowerExchange usam a seguinte convenção de nomenclatura de arquivo:

datalib/JOB
job_number(
prefixnnn)

Essas convenções de nomenclatura incluem as seguintes variáveis:

datalib
é o nome da biblioteca de dados do PowerExchange especificado durante a instalação do PowerExchange.
listener_port
é o número da porta do Ouvinte do PowerExchange.
job_number
é o número do trabalho do
i5/OS
para a subtarefa de rastreamento, DTLTRTSK, que é executada no Condensador do PowerExchange ou em outros trabalhos do PowerExchange.
prefixnnn
é o valor do parâmetro PFX anexado com um número sequencial de 001 a 999.

Por exemplo, um Ouvinte do PowerExchange com um número de porta ouvinte 2480, um valor PFX PWXLOG e um valor FILENUM 3 cria os seguintes arquivos de log:

datalib/P02480(PWXLOG001) 
datalib/P02480(PWXLOG002) 
datalib/P02480(PWXLOG003)

O tamanho máximo para o valor PFX é de sete caracteres.

Linux, UNIX e Windows

O PowerExchange usa o valor PFX como nome do subdiretório no qual colocar os arquivos de log. O PowerExchange usa a instrução LOGPATH do arquivo dbmover.cfg para determinar o diretório no qual colocar esse subdiretório de log.

Os nomes de arquivo de log gerados dependem de quem cria os arquivos: o Ouvinte ou o Condensador do PowerExchange, ou outras tarefas do PowerExchange.

O Ouvinte do PowerExchange usa a seguinte convenção de nomenclatura de arquivo:

Linux e UNIX:

logpath/
prefix/DTLLST1.p
listener_port.n
nnn.log

Serviço do Ouvinte do Windows:

logpath\
prefix\DTLLSTNT.p
listener_port.n
nnn.log

Ouvinte do Windows:

logpath\
prefix\DTLLST1.p
listener_port.n
nnn.log

O Agente de Log do PowerExchange para Linux, UNIX e Windows usa a seguinte convenção de nomenclatura de arquivo:

Linux e UNIX:

logpath/
prefix/PWXCCL.t
yyyymmddhhmmss.p
pid.n
nnn.log

Windows:

logpath\
prefix\PWXCCL.t
yyyymmddhhmmss.p
pid.n
nnn.log

Para outras tarefas, o PowerExchange usa a seguinte convenção de nomenclatura de arquivo:

Linux e UNIX:

logpath/
prefix/
module.t
yyyymmddhhmmss.p
pid.n
nnn.log

Windows:

logpath\
prefix\
module.t
yyyymmddhhmmss.p
pid.n
nnn.log

As variáveis representam os seguintes valores:

logpath
é o valor da instrução LOGPATH no arquivo dbmover.cfg.
prefix
é o valor do parâmetro PFX.
module
é o nome do módulo do PowerExchange que está sendo executado, como DTLURDMO para esse utilitário ou DTLODBCDRVR para operações do PowerCenter.
listener_port
é o número da porta do Ouvinte do PowerExchange.
yyyymmddhhmmss
é o carimbo de data/hora de quando o arquivo foi criado.
pid
é o ID do processo da tarefa do PowerExchange.
nnn
é um número sequencial de 001 a 999.

Por exemplo, um Ouvinte do PowerExchange executado no UNIX com um número de porta 2480, um valor PFX PWXLOG e um valor FILENUM 3 cria os seguintes arquivos de log:

logpath/PWXLOG/DTLLST1.p02480.n001.log 
logpath/PWXLOG/DTLLST1.p02480.n002.log 
logpath/PWXLOG/DTLLST1.p02480.n003.log

O tamanho máximo para o valor PFX é de 210 caracteres.

z/OS

O PowerExchange usa o valor PFX como o qualificador de alto nível ou (HLQ) para conjuntos de dados de log alternativos alocados dinamicamente. Esses conjuntos de dados são conjuntos de dados sequenciais. Como alternativa, você pode especificar as instruções DTLLOG

nn

DD na JCL para uma tarefa do PowerExchange para alocar os conjuntos de dados de log alternativos. Por padrão, o PowerExchange usa conjuntos de dados de log alternativos alocados dinamicamente.

Se você usar uma instrução DTLLOG

nn

DD que aloca um conjunto de dados sequenciais estendidos, o PowerExchange gravará apenas uma mensagem em cada rastreamento. Se a instrução DD alocar um conjunto de dados sequenciais normal, o PowerExchange gravará uma mensagem para cada bloco de dados.

Não use a compactação DFSMS para conjuntos de dados de log alternativo.

Para conjuntos de dados de log alocados dinamicamente, os nomes de conjunto de dados gerados dependem da criação de dados pelo Ouvinte do PowerExchange ou por outros trabalhos em lotes ou tarefas iniciadas do PowerExchange.

O Ouvinte do PowerExchange usa a seguinte convenção de nomenclatura de arquivo:

prefix.
sysid.P
listener_port.N
nnn

Todos os demais trabalhos em lotes e tarefas iniciadas do PowerExchange usam a seguinte convenção de nomenclatura de arquivo:

prefix.
job_name.
job_number.
sysid.N
nnn

As variáveis representam os seguintes valores:

prefix
é o qualificador de alto nível que você especifica no parâmetro PFX. O tamanho máximo de todo o prefixo é de 16 caracteres.
sysid
é o ID do sistema
z/OS
no qual o trabalho é executado em lotes ou a tarefa iniciada.
listener_port
é o número da porta do Ouvinte do PowerExchange.
job_name
é o nome do trabalho em lotes ou da tarefa iniciada.
job_number
é o número do trabalho JES, que começa com JOB para trabalhos em lotes e STC para tarefas iniciadas.
nnn
é um número sequencial gerado de 001 a 999.

Por exemplo, um Ouvinte do PowerExchange executado no sistema MVS1 com um número de porta 2480, um valor PFX PWXLOG e um valor FILENUM 3 cria os seguintes arquivos de log:

PWXLOG.MVS1.P02480.N001
PWXLOG.MVS1.P02480.N002
PWXLOG.MVS1.P02480.N003

APPEND={N|

Y

}

Opcional. Controla como o PowerExchange usa os arquivos de log de mensagens quando o componente do PowerExchange que emite mensagens é reiniciado.

As opções são:

N
. O PowerExchange abre um novo arquivo de log ou substitui o arquivo de log mais antigo como o arquivo de log.
Por exemplo, se você definir
FILENUM=3
para usar três arquivos de log dinamicamente alocados, quando o Ouvinte do PowerExchange for iniciado, ele tentará abrir o arquivo de log 1, 2 e 3, nessa ordem. Em seguida, o PowerExchange executa uma das seguintes ações:
Se um ou mais dos arquivos de log alocados dinamicamente não existir, o PowerExchange usará o primeiro arquivo de log inexistente como o arquivo de log inicial. Por exemplo, se os arquivos de log 1 e 2 existirem, mas o 3 não, o PowerExchange usará o arquivo de log 3 como inicial. Se nenhum arquivo de log existir, o PowerExchange usará o arquivo de log 1 como inicial.
Se os três arquivos de log existirem, o PowerExchange usará o mais antigo como arquivo de log inicial, sobrescrevendo-o completamente.
Se você usar um GDG no
z/OS
para log alternativo, o PowerExchange criará uma nova geração quando o Ouvinte do PowerExchange for iniciado.
Y
. O PowerExchange abre o arquivo de log mais recente, se existir um, e anexa as mensagens de log ao final. Se nenhum arquivo de log existir, o PowerExchange abrirá um novo.
Por exemplo, se você definir
FILENUM=3
para usar três arquivos de log, quando o Ouvinte do PowerExchange for iniciado, ele tentará abrir o arquivo de log 1, 2 e 3, nessa ordem. Em seguida, o PowerExchange executa uma das seguintes ações:
Se um ou mais arquivos de log existirem, o PowerExchange abrirá o mais recente e anexará as mensagens de log ao final.
Se você usar um GDG para log alternativo no z/OS e especificar
GDG(0)
na instrução DTLLOG
nn
DD da JCL do Ouvinte do PowerExchange, o PowerExchange anexará mensagens ao final da geração atual. Se você não usar GDG(0), o PowerExchange ignorará esse parâmetro.
Se nenhum arquivo de log existir, o PowerExchange abrirá um novo, o arquivo 1, e o usará como arquivo de log.

O padrão é Y.

BUFFERS={

number_of_buffers

|

100

}

Opcional. Especifica o número de buffers que o PowerExchange aloca para receber mensagens e informações de rastreamento das subtarefas do PowerExchange. Se o espaço de buffer estiver cheio, as subtarefas do PowerExchange que geram mensagens e informações de rastreamento aguardarão até que haja espaço de buffer disponível. Os programas do PowerExchange usam esse espaço de buffer internamente.

Os valores válidos vão de 5 a 9999. O padrão é 100.

Especifique esse parâmetro apenas sob a orientação do Suporte Global a Clientes da Informatica.

FILENUM={

number_of_files

|

5

}

Opcional. Especifica o número de arquivos de log alternativos que o PowerExchange cria e usa quando os arquivos de log são alocados dinamicamente. Quando um arquivo de log fica cheio, o PowerExchange alterna para o arquivo de log alternativo mais antigo e o substitui.

Os valores válidos vão de 1 a 99. O padrão é 5.

No z/OS, o parâmetro FILENUM será ignorado se você usar um GDG para log alternativo ou se você especificar instruções DTLLOG

nn

DD na JCL para um componente do PowerExchange que envia mensagens DTLLOG. Para um GDG, o parâmetro será ignorado, independentemente se você especificar

GDG(0)

ou

GDG(+1)

na instrução DTLLOG

nn

DD na JCL.

FLUSH={

flush_interval

|

99

}

Opcional. Especifica o número de registros de log que o PowerExchange coleta antes de liberá-los para o arquivo de log em disco. O PowerExchange deve liberar periodicamente registros de log para permitir que o PowerExchange se recupere de condições de falta de espaço. Valores de liberação baixos resultam em mais atividade de

E/S

no arquivo de log.

Os valores válidos vão de 1 a 99. O padrão é 99.

RECLEN={

record_length

|

80

}

Opcional. Especifica o tamanho do registro que o PowerExchange usa para gravar registros de log no arquivo de log. O PowerExchange gravará o registro de log em várias linhas se o tamanho da mensagem ultrapassar o tamanho do registro.

Os valores válidos vão de 80 a 255. O padrão é 80.

Se você não especificar o parâmetro RECLEN e digitar um valor maior do que 80 na instrução LOG_LINE_LIMIT, o PowerExchange usará o valor LOG_LINE_LIMIT como o valor RECLEN.

SIZE={

log_size

|

100

}

Opcional. Especifica a quantidade aproximada de dados do log, em megabytes, que o PowerExchange grava em um arquivo de log alternativo. Depois que o PowerExchange atinge esse valor, ele fecha o arquivo de log atual e abre o próximo para continuar gravando registros de log.

Os valores válidos vão de 1 a 2048. O padrão é 100.

No z/OS, se um conjunto de dados alocados manualmente for maior do que o valor de SIZE, o PowerExchange limitará a quantidade de dados de log que grava no conjunto de dados para o valor de SIZE. Se o conjunto de dados for menor que o valor de SIZE, o tamanho do conjunto de dados limitará a quantidade de dados de log que o PowerExchange poderá gravar nele. Quando uma condição de falta de espaço ocorre, o PowerExchange alterna para o próximo conjunto de dados de mensagem alocados manualmente.

VIEW={

N

|Y}

Opcional. Controla se o PowerExchange fecha e reabre periodicamente o arquivo de log atual quando o intervalo FLUSH expira. Você pode especificar esse parâmetro em todos os sistemas operacionais, mas ele é mais útil no

z/OS

. No

z/OS

, você não poderá exibir os registros de log de mensagem alternativa até que o conjunto de dados seja fechado. Em sistemas operacionais diferentes do z/OS, você poderá exibir os registros de log depois que o PowerExchange liberá-los no disco com base no intervalo FLUSH. O arquivo de log atual não precisa ser fechado para exibir os registros de log.

As opções são:

N
. O PowerExchange não fecha e reabre periodicamente o arquivo de log atual.
Y
. O PowerExchange fecha e reabre periodicamente o arquivo de log atual.
No z/OS, a Informatica recomenda que você especifique VIEW=Y para fechar e reabrir periodicamente o conjunto de dados de log alternativo, para que possa exibir os registros de log.
Se você especificar VIEW=Y no z/OS, as seguintes considerações serão aplicáveis:
Se você usar um GDG para log alternativo no
z/OS
, deverá especificar
GDG(0)
e DISP=SHR em uma única instrução DTLLOG
nn
DD na JCL do Ouvinte do PowerExchange. Além disso, aloque e crie pelo menos uma geração do conjunto de dados GDG antes de iniciar o Ouvinte do PowerExchange.
Se você usar produtos de terceiros que manipulam alocações de conjunto de dados, esses produtos poderão interferir no processamento
VIEW=Y
. Por exemplo, os produtos poderão alterar o modo SYSDSN ENQ para EXCLUSIVE, impedindo que você exiba o conjunto de dados.
O desempenho do trabalho do PowerExchange que grava dados no conjunto de dados de log alternativo poderá ser reduzido por causa das frequentes solicitações de abertura e fechamento do conjunto de dados. Use o valor padrão 99 para o parâmetro FLUSH a fim de minimizar a redução do desempenho.

O padrão é N.

Use log alternativo para melhorar o desempenho de log e personalizar a quantidade de dados registrados para trabalhos de execução longa, como um processo do Agente de Log do PowerExchange para Linux, UNIX e Windows que é executado no modo contínuo.
Quando o log alternativo dinâmico é habilitado, o PowerExchange cria um conjunto de arquivos de log alternativo para cada processo do PowerExchange em um diretório distinto.
Você pode especificar a localização, o número de arquivos de log, bem como o tamanho deles em MB. Quando um arquivo de log atinge o tamanho especificado, o PowerExchange alterna para o próximo e começa a sobrescrever todos os dados desse arquivo.
Se você definir a instrução TRACING, defina também a instrução LOGPATH para especificar um diretório para os arquivos de log alternativo em um sistema Linux, UNIX ou Windows.
O PowerExchange aloca dinamicamente os conjuntos de dados de log alternativo, a menos que você defina instruções DTLLOG
nn
DD na JCL para um trabalho ou uma tarefa iniciada do PowerExchange.
No z/OS, a Informatica recomenda especificar SYSOUT=* em uma instrução DTLLOG01 DD que você use na JCL para todos os trabalhos e tarefas iniciadas do PowerExchange que emitem mensagens, por exemplo:
//DTLLOG01 DD SYSOUT=*
Essa estratégia simplifica a configuração porque você define apenas uma instrução DTLLOG01 DD com uma única opção SYSOUT. Além disso, essa estratégia permite a localização de saída de mensagem para uma determinada execução de um trabalho ou tarefa mais fácil porque o PowerExchange grava todas as mensagens de saída em um único conjunto de dados SYSOUT, que está disponível com a outra saída do trabalho.
Se você usar um GDG no
z/OS
para log alternativo, especifique
GDG(0)
na instrução DD DTLLOG
nn
da JCL do Ouvinte do PowerExchange. Por exemplo:
 DTLLOG01 DD   DSN=USER1.V901.TRCGDG(0),DISP=SHR
Usando
GDG(0)
, você poderá usar
APPEND=Y
para continuar registrando mensagens de log na geração atual. Além disso, pode usar
VIEW=Y
para exibir registros de log no GDG enquanto a tarefa do Ouvinte do PowerExchange está ativa. Se você especificar
APPEND=N
, o PowerExchange criará uma nova geração quando o Ouvinte do PowerExchange for iniciado.
Se, em vez disso, você usar
GDG(+1)
, o PowerExchange ignorará os parâmetros APPEND e FILENUM da instrução TRACING e criará uma nova geração sempre que o Ouvinte do PowerExchange for iniciado.
Além disso, ao usar um GDG, aloque e crie pelo menos uma geração do GDG antes de iniciar o Ouvinte do PowerExchange.
No z/OS, se você usar um GDG para log alternativo ou especificar uma instrução DTLLOG01 DD na JCL para um trabalho ou uma tarefa iniciada do PowerExchange, o parâmetro FILENUM será ignorado.