Notas de Uso do Utilitário HOSTENT
Considere os seguintes pontos antes de usar o utilitário HOSTENT:¨ O PowerExchange usa o resolvedor TCP/IP para converter o nome do host da pilha TCP/IP em um endereço IP. O PowerExchange usa esse endereço para validar a licença.
¨ No z/OS e OS/390, o resolvedor consulta a tabela de hosts locais. No i5/OS, Linux e UNIX, o resolvedor consulta o servidor de nomes antes de consultar a tabela de hosts locais.
¨ No i5/OS, z/OS e OS/390, o PowerExchange usa o endereço primário da interface da pilha TCP/IP para verificar a licença, quando o resolvedor não consegue encontrar o nome do host.
¨ Os sistemas operacionais podem executar mais de uma pilha TCP/IP. Assegure-se de que o HOSTENT seja executado na pilha TCP/IP usada pelo PowerExchange. Você não pode especificar um nome de pilha nos parâmetros HOSTENT.
Detalhes do Resolvedor do Utilitário HOSTENT
O resolvedor usa as tabelas de sites locais para consultar o nome e endereço oficiais do host. O resolvedor não usa servidores de nomes.
No z/OS 1.2 ou posterior, você pode adicionar a seguinte instrução DD à JCL HOSTENT para obter um rastro do resolvedor para auxiliar no diagnóstico:
//SYSTCPT DD SYSOUT=*
Isso reporta os conjuntos de dados de configuração e os métodos de consulta usados pelo resolvedor.
Saída do Utilitário HOSTENT
A tabela a seguir descreve as mensagens de saída geradas pelo HOSTENT:
Sistema Operacional Mensagem Descrição
i5/OS, Linux, UNIX, z/OS gethostname() oferece host name Exibe o nome do host da pilha TCP/IP. Nos sistemas z/OS e OS/390, você encontra detalhes do gethostname( ) no arquivo TCPIP.DATA especificado na pilha TCP/IP.
No i5/OS, Linux e UNIX, você encontra detalhes do gethostname() no arquivo TCPIP.DATA usado pelo PowerExchange
i5/OS, Linux, UNIX, z/OS nome do host oficial host
name.domain name
Exibe o nome do host retornado pelo resolvedor. O resolvedor consulta o nome do host especificado para localizar o nome completo, o que inclui o nome do domínio.
Isso também exibe:
- Nomes alternativos (alias) encontrados pelo resolvedor.
- Endereço TCP/IP conforme retornado pelo resolvedor. O PowerExchange usa esse endereço para validar a licença.
i5/OS, Linux, UNIX, z/OS reportando o nome do host host name Exibe o nome do host. O resolvedor TCP/IP usa os seguintes métodos para encontrar o nome do host: - Consulta o nome do host em um arquivo de hosts
locais.
- Usa a chamada do sistema gethostbyname() para consultar nomes de hosts em um servidor de nomes.
Sistema Operacional Mensagem Descrição
O PowerExchange usa esses detalhes para validar a licença.
i5/OS, z/OS gethostid() oferece: nnn.nnn.nnn.nnn Exibe o endereço primário da interface da pilha TCP/ IP. Se o resolvedor TCP/IP não puder encontrar o nome do host, o PowerExchange usará esse endereço para validar a licença.
No sistema z/OS ou OS/390, os detalhes do gethostid() são especificados na pilha TCP/IP, no parâmetro PRIMARYINTERFACEADDRESS do conjunto de dados PROFILE.
z/OS o resolvedor especifica o nome de domínio: domain name
Exibe o nome de domínio conforme determinado pelo conjunto de dados de configuração do resolvedor local. O PowerExchange não usa esse endereço para validar a licença.
z/OS o resolvedor especifica o nome do host: host name
Exibe o nome do host conforme determinado pelo conjunto de dados de configuração do resolvedor local. O PowerExchange não usa esse endereço para validar a licença.
Exemplo do Utilitário HOSTENT no i5/OS
O comando a seguir exibe o endereço e o nome do host TCP/IP do sistema em que ele foi executado: CALL HOSTENT
A saída resultante é:
gethostid() gives: nnn.nnn.nnn.nnn gethostname() gives host name reporting on hostname host name official hostname: host name address: nnn.nnn.nnn.nnn
Exemplo do Utilitário HOSTENT no Linux e UNIX
O comando a seguir exibe o endereço e o nome do host TCP/IP do sistema em que ele foi executado:hostent
A saída resultante é:
gethostname() gives host name reporting on hostname host name official hostname: host name address: nnn.nnn.nnn.nnn
Exemplo do Utilitário HOSTENT no z/OS
A instrução a seguir exibe o endereço e o nome do host TCP/IP do sistema em que ela foi executada: //STEP1 EXEC PGM=HOSTENT,
// PARM='/'
//STEPLIB DD DSN=&SCERUN,DISP=SHR // DD DSN=&HLQ..LOADLIB,DISP=SHR
//SYSOUT DD SYSOUT=* //SYSPRINT DD SYSOUT=* A saída resultante é:
HOSTENT:
gethostid() gives: nnn.nnn.nnn.nnn resolver gives hostname : host name resolver gives domainname: domain name gethostname() gives host name
reporting on hostname host name
official hostname: host name.domain name alias: host name
address: nnn.nnn.nnn.nnn
CA P Í T U L O
1 7
PWXUCDCT - Utilitário do Agente
de Log do PowerExchange para
Linux, UNIX e Windows
Este capítulo inclui os seguintes tópicos: ¨ Visão Geral do Utilitário PWXUCDCT, 122
¨ Sistemas Operacionais Suportados para o Utilitário PWXUCDCT, 123 ¨ Sintaxe das Instruções de Controle para Comandos PWXUCDCT, 123 ¨ Comandos e Parâmetros PWXUCDCT, 123
¨ Executando o Utilitário PWXUCDCT, 128 ¨ Notas de Uso do Utilitário PWXUCDCT, 128
¨ Exemplos de Comandos do Utilitário PWXUCDCT, 128
Visão Geral do Utilitário PWXUCDCT
Use o utilitário PWXUCDCT para gerenciar arquivos e imprimir relatórios do Agente de Log do PowerExchange para Linux, UNIX e Windows.
Com o utilitário, você pode executar as seguintes tarefas:
¨ Gere novamente o arquivo CDCT com base nos arquivos de log do Agente de Log do PowerExchange se o arquivo CDCT e seu backup forem danificados ou excluídos.
¨ Faça backup do arquivo CDCT.
¨ Restaure o arquivo CDCT de um backup.
¨ Exclua os registros CDCT expirados e todos os arquivos de log do Agente de Log do PowerExchange associados a esses registros.
¨ Exclua os arquivos de log do Agente de Log do PowerExchange que não são referidos por nenhum registro CDCT.
¨ Imprima relatórios do arquivo de configuração pwxccl.cfg do Agente de Log do PowerExchange, bem como dos arquivos de ponto de verificação, CDCT e log.
Para obter mais informações sobre o Agente de Log do PowerExchange, consulte o Guia do CDC do
PowerExchange para Linux, UNIX e Windows.
Sistemas Operacionais Suportados para o Utilitário
PWXUCDCT
O utilitário PWXUCDCT é executado em computadores com os seguintes sistemas operacionais: ¨ Linux
¨ UNIX ¨ Windows
Sintaxe das Instruções de Controle para Comandos
PWXUCDCT
Use a seguinte sintaxe geral para especificar instruções de controle do utilitário PWXUCDCT: PWXUCDCT CMD=command_name [CONFIG=override_dbmover.cfg] [CS=override_pwxccl.cfg] [LICENSE=override_license.key] command-specific parameters Aplicam-se as seguintes regras de sintaxe:
¨ Você pode especificar os parâmetros opcionais CONFIG, CS e LICENSE em qualquer comando. ¨ Os demais parâmetros são específicos do comando que está sendo emitido. Você pode inserir esses
parâmetros de comando específico em qualquer ordem.
¨ Não é possível definir os parâmetros em um arquivo distinto e depois mencionar esse arquivo na sintaxe de comando.
T
ÓPICOSR
ELACIONADOS:
¨ “Comandos e Parâmetros PWXUCDCT” na página 123 ¨ “Notas de Uso do Utilitário PWXUCDCT” na página 128
¨ “Exemplos de Comandos do Utilitário PWXUCDCT” na página 128
Comandos e Parâmetros PWXUCDCT
Esta seção descreve os comandos que você pode informar na instrução CMD da sintaxe PWXUCDCT e os parâmetros específicos do comando.
Além disso, descreve os parâmetros CONFIG, CS, LICENSE que você especifica para qualquer comando.
Resumo de Comandos
Este tópico resume os comandos que você pode emitir no utilitário PWXUCDCT, incluindo qualquer parâmetro específico do comando.
A tabela a seguir descreve cada comando:
Nota: Os parâmetros opcionais estão entre colchetes.
Comando Descrição Parâmetros Específicos do Comando Comandos de backup e restauração:
CREATE_CDCT_BACKUP Faz backup de todos os registros CDCT para a instância de origem especificada no parâmetro DBID do arquivo de
configuração pwxccl.cfg.
BACKUPFILE [BACKUPWIDTH] [FIXEDTOKENWIDTH] DERIVE_CDCT_BACKUP Cria um backup do arquivo CDCT com
base nos arquivos de log do Agente de Log do PowerExchange, se o arquivo de backup original for danificado ou excluído.
BACKUPFILE [BACKUPWIDTH] [FIXEDTOKENWIDTH] RESTORE_CDCT Restaura o arquivo CDCT de um backup,
se o arquivo CDCT for danificado ou excluído.
BACKUPFILE [NOUPDATE]
[PROGRESSFREQUENCY]
Comandos de exclusão:
DELETE_EXPIRED_CDCT Exclui registros CDCT cujo período de retenção expirou e todos os arquivos de log do Agente de Log do PowerExchange referidos por esses registros, apenas se você definir o parâmetro
LOGGER_DELETES_EXPIRED_CDCT_ RECORDS como N no arquivo pwxccl.cfg. Se você definir o parâmetro
LOGGER_DELETES_EXPIRED_CDCT_ RECORDS como Y, ou não tiver especificado esse parâmetro, não será possível usar o comando
DELETE_EXPIRED_CDCT.
Nenhum
DELETE_ORPHAN_FILES Exclui os arquivos de log do Agente de Log do PowerExchange que não são referidos por nenhum registro no arquivo CDCT.
Nenhum
Comandos de relatório:
REPORT_CDCT Reporta informações sobre o arquivo CDCT e seus registros. Para cada registro CDCT, o comando reporta as seguintes informações:
- Número do registro - Nome da marca de registro - Nome do arquivo de log - Número de registros de alteração
recebidos na tabela registrada - Horas de início e de término - Tokens de reinicialização de início e de
término
[report_file_name]
REPORT_CDCT_BY_TIME Lista os registros CDCT na ordem em que eles expiram, com base no período de retenção.
[report_file_name]
REPORT_CHECKPOINTS Lista os arquivos de ponto de verificação em ordem cronológica, do mais antigo ao mais recente, com base em quando eles foram gravados. Para cada arquivo de ponto de verificação, o comando reporta
[report_file_name]