3. Para origens Adabas apenas, execute uma alternância de PLOG.
Essa etapa garante que todas as alterações até o momento da alternância de PLOG sejam capturadas para o registro ativo.
4. Digite o comando REFRESH do ECCR usando o comando MODIFY (F) do MVS: F eccr_task_name,REFRESH
O ECCR torna-se consciente da alteração do status de registro e carimbo de data/hora de suspensão. Quando o ECCR encontra o primeiro registro de alteração a ser descartado, a mensagem PWX-07752 é emitida. O ECCR descarta os registros de alteração que têm um carimbo de data/hora posterior ao carimbo de data/hora de suspensão.
5. Execute os trabalhos ou processos que geram as alterações que você não deseja capturar para a origem ou origens que estão associadas aos registros suspensos.
6. Para reativar os registros de captura, use o utilitário PWXUCREG para emitir o comando ACTIVATE_REGISTRATION.
A janela de suspensão é fechada. O utilitário define o carimbo de data/hora de ativação para a hora atual do sistema sem quaisquer ajustes para a hora local. Além disso, o utilitário emite a mensagem PWX-03716 para o log DTLLOG para relatar a alteração do status de registro.
Para cada registro reativado, o Inspetor de Recursos do Navegador do PowerExchange exibe Ativo no campo Status e o carimbo de data/hora de ativação no campo Tempo de Atividade. O valor Tempo de
Atividade não é ajustado para a hora local.
7. Para origens Adabas apenas, execute uma alternância de PLOG.
Essa etapa garante que todas as alterações que ocorrem durante a janela de suspensão até a alternância de PLOG sejam descartadas para o registro suspenso.
8. Digite o comando REFRESH do ECCR com o comando MODIFY (F) do MVS novamente.
O ECCR torna-se consciente da alteração do status de registro e carimbo de data/hora de ativação. 9. Ativar a atividade de banco de dados para continuar na fonte ou fontes registradas.
O ECCR inicia a captura de registros de alteração que têm carimbos de data/hora posterior ao carimbo de data/hora de ativação. O ECCR emite a mensagem PWX-07753 quando encontra o primeiro registro de alteração no fluxo de mudança após o fim da janela de suspensão.
Nota: Você pode automatizar esse processamento, se adequado para o seu ambiente.
Sintaxe Geral para Comandos PWXUCREG
Use a seguinte sintaxe geral para inserir comandos globais e específicos de registro na entrada PWXSYSIN para um trabalho PWXUCREG: //PWXSYSIN DD * SET_CONTROL_VALUE,global_parameter1=value1; global parameter2=value, global parameter3 ;
Registration-specific command primary keyword, parameter1=value,
parameter2=value, paraemter3=value ;
<additional registration-specific commands> ;
SET_CONTROL_VALUE,global_parameter1=value2; Registration-specific command primary keyword, parameter1=value,
parameter4=value ;
<additional registration commands> ;
/*
Aplicam-se as seguintes regras de sintaxe:
¨ Um comando consiste em uma palavra-chave primária seguida por um ou mais parâmetros válidos. ¨ Um comando é encerrado com um ponto e vírgula (;).
¨ Use uma vírgula (,) para separar uma palavra-chave primária de um parâmetro. Além disso, use uma vírgula entre os parâmetros. Não use uma vírgula após o último parâmetro em um comando, antes do ponto e vírgula final.
¨ Em um comando SET_CONTROL_VALUE, você pode especificar um ou mais parâmetros globais. Parâmetros globais são opcionais, mas você deve incluir pelo menos um parâmetro global no comando. Como alternativa, você pode especificar uma instrução SET_CONTROL_VALUE separada para cada parâmetro.
¨ Em um comando específico de registro, você pode inserir vários parâmetros. Alguns parâmetros são necessários para identificar os registros a serem processados, e outros parâmetros são opcionais. ¨ O utilitário analisa e executa comandos no fluxo de entrada, um de cada vez, de cima para baixo. ¨ Você pode repetir o comando SET_CONTROL_VALUE no fluxo de entrada com diferentes parâmetros ou
com os mesmos parâmetros mas diferentes valores para um conjunto subsequente de comandos específicos de registro.
¨ Você pode incluir parâmetros em um comando específico de registro que substitui os parâmetros globais correspondentes na instrução SET_CONTROL_VALUE anterior. Por exemplo, inclua o parâmetro REGISTRATION_LOCATION em um comando específico de registro para substituir o parâmetro GLOBAL_REGISTRATION_LOCATION no comando SET_CONTROL_VALUE anterior.
Resumo dos Comandos PWXUCREG
Use o resumo dos comandos de utilitário PWXUCREG para determinar qual palavra-chave de comando e parâmetros deseja usar.
A palavra-chave SET_CONTROL_VALUE define os valores do parâmetro global como a ID de usuário e a senha para os comandos subsequentes no fluxo de entrada PWXSYSIN para o trabalho PWXUCREG. Os comandos específicos de registro se aplicam aos registros que correspondem aos critérios de seleção inseridos em parâmetros, tais como aqueles da instância do banco de dados e o nome de registro.
A tabela a seguir descreve cada comando, incluindo a palavra-chave primária e os parâmetros associados:
Palavra-chave de Comando Descrição Parâmetros1
Comando global:
SET_CONTROL_VALUE Define os valores dos parâmetros globais que se aplicam a comandos específicos de registro subsequentes na entrada PWXSYSIN do JCL do PWXUCREG. Use esse comando se você executar trabalhos PWXUCREG que contêm comandos múltiplos e desejar definir valores de parâmetro comuns para um conjunto de comandos. Você pode substituir qualquer valor global em um comando específico de registro subsequente ou especificar um outro comando
SET_CONTROL_VALUE posteriormente no fluxo de entrada.
É necessário especificar pelo menos um parâmetro para esse comando.
- [DISPLAY_REGISTRATION_AFTER_COMMAND] - [DISPLAY_REGISTRATION_BEFORE_COMMAND] - [GENÉRICO] - [GLOBAL_REGISTRATION_LOCATION] - [GLOBAL_USER] - [GLOBAL_EPWD] - [GLOBAL_PWD] - [SYSTEM_CONSOLE_MESSAGES_COMMAND] - [SYSTEM_CONSOLE_MESSAGES_DISPLAY] - [SHOW_EXPANDED_STATEMENT]
Comandos específicos de registro:
Palavra-chave de Comando Descrição Parâmetros1
ACTIVATE_REGISTRATION Reativa um registro de captura que tem um status de Suspenso para que o ECCR continue a captura de alterações para a fonte registrada. Também define um carimbo de data/hora de ativação na hora atual do sistema, não ajustada para a hora local, para indicar o término da janela de suspensão. Você pode emitir esse comando somente para registros que foram suspendidos anteriormente com o comando SUSPEND_REGISTRATION. Esse comando pode ser aplicado a vários registros se você especificar GENERIC=Y e inserir o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga no parâmetro REGISTRATION_NAME ou DATABASE_INSTANCE. - REGISTRATION_NAME - DATABASE_INSTANCE - [DATABASE_TYPE] - Recomendado - [EPWD] - [GENÉRICO ] - [PWD] - [REGISTRATION_LOCATION] - [USUÁRIO ] - [VALIDAR]
CANCEL_ACTIVATE_REGISTRATION Cancela uma solicitação
ACTIVATE_REGISTRATION anterior antes de atualizar o ECCR para a ativação. Também define o status do registro de volta para Suspenso. Esse comando pode ser aplicado a vários registros se você especificar GENERIC=Y e inserir o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga no parâmetro REGISTRATION_NAME ou
DATABASE_INSTANCE.
Sugestão: Para cancelar a ação de reativação para
todos os registros que foram especificados no comando ACTIVATE_REGISTRATION anterior, especifique os mesmos valores de parâmetro do comando ACTIVATE_REGISTRATION. - REGISTRATION_NAME - DATABASE_INSTANCE - [DATABASE_TYPE] - Recomendado - [EPWD] - [GENÉRICO ] - [PWD] - [REGISTRATION_LOCATION] - [USUÁRIO ] - [VALIDAR]
CANCEL_SUSPEND_REGISTRATION Cancela um comando SUSPEND_REGISTRATION anterior antes de atualizar o ECCR. Além disso, redefine o status de registro para Ativo e redefine as horas de início e de término para a janela de suspensão.
Esse comando pode ser aplicado a vários registros se você especificar GENERIC=Y e inserir o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga no parâmetro REGISTRATION_NAME ou
DATABASE_INSTANCE.
Sugestão: Para cancelar a ação de suspensão para
todos os registros que foram especificados no comando ACTIVATE_REGISTRATION anterior, especifique os mesmos valores de parâmetro do comando SUSPEND_REGISTRATION. - REGISTRATION_NAME - DATABASE_INSTANCE - [DATABASE_TYPE] - Recomendado - [EPWD] - [GENÉRICO ] - [PWD] - [REGISTRATION_LOCATION] - [USUÁRIO ] - [VALIDAR]
DISPLAY_REGISTRATION Exibe as informações do status de registro antes ou depois de outro comando que altera o status do registro, de forma que você possa verificar a alteração do status. Essa informação inclui a configuração de status de registro atual e os carimbos de data/hora de ativação e suspensão. Os carimbos de data/hora estão na hora atual do sistema e não são ajustados à hora local. Esse comando não suporta o parâmetro GENERIC ou o parâmetro GENERIC global do comando SET_CONTROL_VALUE. Esse comando pode exibir informações de status para vários registros sem o parâmetro GENERIC.
Sugestão: Em vez de especificar esse comando no
fluxo de entrada do JVC várias vezes, você pode
- REGISTRATION_NAME - DATABASE_INSTANCE - [DATABASE_TYPE] - Recomendado - [EPWD] - [PWD] - [REGISTRATION_LOCATION] - [USUÁRIO ] - [VALIDAR]
Palavra-chave de Comando Descrição Parâmetros1
especificar a palavra-chave
SET_CONTROL_VALUE global com os parâmetros DISPLAY_REGISTRATION_BEFORE_COMMAND e
DISPLAY_REGISTRATION_AFTER_COMMAND. Esses parâmetros globais exibem automaticamente as informações de status de registro antes e depois de cada comando que altera o status do registro. DROP_OLD_REGISTRATION_DATA Define uma janela de suspensão especial que
permite que você inicie a captura de alterações para um registro da hora atual do sistema. A janela de suspensão estende do ponto disponível mais antigo no fluxo de mudança para a hora atual do sistema. O ECCR descarta os registros de alteração que têm um carimbo de data/hora dentro da janela de suspensão. Geralmente, esse comando é usado para novos registros que foram ativados recentemente pela primeira vez no Navegador do PowerExchange.
Esse comando pode ser aplicado a vários registros se você especificar GENERIC=Y e inserir o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga no parâmetro REGISTRATION_NAME ou DATABASE_INSTANCE. - REGISTRATION_NAME - DATABASE_INSTANCE - [DATABASE_TYPE] - Recomendado - [EPWD] - [GENÉRICO ] - [PWD] - [REGISTRATION_LOCATION] - [USUÁRIO ] - [VALIDAR]
RESET_SUSPENSION_WINDOW Limpa quaisquer carimbos de data/hora de ativação e suspensão que definem a janela de suspensão atual e redefine o status de registro para Ativo. Esse comando pode ser aplicado a vários registros se você especificar GENERIC=Y e inserir o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga no parâmetro REGISTRATION_NAME ou DATABASE_INSTANCE. - REGISTRATION_NAME - DATABASE_INSTANCE - [DATABASE_TYPE] - Recomendado - [EPWD] - [GENÉRICO ] - [PWD] - [REGISTRATION_LOCATION] - [USUÁRIO ] - [VALIDAR] SUSPEND_REGISTRATION Suspende um registro de captura que tem um status
de Ativo para que o ECCR interrompa a captura de alterações para a origem registrada. Também define um carimbo de data/hora de suspensão na hora atual do sistema, não ajustada para a hora local, para indicar o início da janela de suspensão. Esse comando pode ser aplicado a vários registros se você especificar GENERIC=Y e inserir o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga no parâmetro REGISTRATION_NAME ou DATABASE_INSTANCE. - REGISTRATION_NAME - DATABASE_INSTANCE - [DATABASE_TYPE] - Recomendado - [EPWD] - [GENÉRICO ] - [PWD] - [REGISTRATION_LOCATION] - [USUÁRIO ] - [VALIDAR]
1. Os parâmetros colocados entre colchetes [ ] são opcionais.
Parâmetros SET_CONTROL_VALUE Globais
Você pode especificar um ou mais parâmetros globais em um comando SET_CONTROL_VALUE que você inclui na entrada PWXSYSIN para um trabalhoPWXUCREG.
Os parâmetros globais se aplicam aos comandos específicos de registro subsequentes na entrada PWXSYSIN, a menos que você substitua o valor do parâmetro global em uma das seguintes maneiras:
¨ Especifique um comando específico de registro subsequente com o parâmetro correspondente, se disponível.
¨ Especifique outro comando SET_CONTROL_VALUE com um valor de parâmetro global diferente posteriormente no fluxo de entrada.
Todos os parâmetros globais são opcionais, mas você deve especificar pelo menos um em um comando SET_CONTROL_VALUE.
Nas seguintes descrições de parâmetros, as chaves indicam que uma das opções deve ser inserida, e o sublinhado indica o valor padrão.
Descrições de Parâmetros
DISPLAY_REGISTRATION_AFTER_COMMAND={N|Y}
Exibe informações sobre o registro ou registros de captura que foram processados pelo comando específico de registro anterior que alterou o status do registro. Essa informação inclui a configuração de status atual de registro e os carimbos de data/hora de ativação e suspensão. Você pode usar essas informações para verificar se o comando anterior alterou corretamente o status. As opções são:
¨ N. Não exibir informações de registro após cada comando que altera o status do registro. ¨ Y. Exibir informações de registro após cada comando que altera o status do registro. O padrão é Y. Se você aceitar o valor padrão, você não precisa especificar o comando
DISPLAY_REGISTRATION no JCL do PWXUCREG para exibir informações do status de registro depois de um comando, a menos que você deseje substituir essa configuração de parâmetro global.
Você pode usar esse parâmetro com o parâmetro DISPLAY_REGISTRATION_BEFORE_COMMAND para exibir informações do status de registro antes e depois de um comando que altera o status.
DISPLAY_REGISTRATION_BEFORE_COMMAND={N|Y}
Exibe informações sobre o registro ou registros de captura que serão processados por um comando específico de registro subsequente que alterará o status do registro. Essa informação inclui a configuração de status atual de registro e os carimbos de data/hora de ativação e suspensão. Você pode usar essas informações para verificar se o comando altera corretamente o status do valor original para o valor de destino. As opções são:
¨ N. Não exibir informações de registro antes de cada comando que altera o status do registro. ¨ Y. Exibir informações de registro antes de cada comando que altera o status do registro. O padrão é N. Se você aceitar o valor padrão, você ainda pode especificar o comando
DISPLAY_REGISTRATION no JCL do PWXUCREG para exibir informações do status de registro antes de um determinado comando.
Você pode usar esse parâmetro com o parâmetro DISPLAY_REGISTRATION_AFTER_COMMAND para exibir informações do status de registro antes e depois de um comando que altera o status.
GENÉRICO={N|Y}
Permite que você emita comandos específicos de registro que alteram o status de registro para vários registros. Você também deve especificar máscaras que contenham o caractere curinga de asterisco (*) em alguns parâmetros dos comandos específicos de registro, como o REGISTRATION_NAME e o
DATABASE_INSTANCE.
Esse parâmetro não é necessário ou suportado para o comando DISPLAY_REGISTRATION, que é genérico por padrão.
Você pode substituir essa configuração global para um determinado comando específico de registro ao incluir o parâmetro GENERIC no comando.
GLOBAL_EPWD=encrypted_password
Especifica uma senha criptografada a ser usada com a ID de usuário que está especificada no parâmetroGLOBAL_USER associado.
Consulte o administrador de segurança do sistema sobre a determinação dos requisitos de uma ID de usuário e uma senha ou senha criptografada, com base na segurança do sistema e na instrução SECURITY no membro de configuração DBMOVER.
Sugestão: Você pode usar o Navegador do PowerExchange para criar uma senha criptografada. Clique em Arquivo > Criptografar.
Se você especificar esse parâmetro, não especifique o parâmetro GLOBAL_PWD. Se você especificar ambos, o parâmetro GLOBAL_EPWD terá precedência. Use o parâmetro GLOBAL_EPWD se não lhe for permitido armazenar senhas em formato legível.
Você pode substituir esse valor para um comando específico de registro ao incluir o parâmetro EPWD no comando.
GLOBAL_PWD=senha
Especifica uma senha não criptografada a ser usada com a ID de usuário que está especificada no parâmetro GLOBAL_USER associado. Esse valor diferencia letras maiúsculas de minúsculas. Consulte o administrador de segurança do sistema sobre a determinação dos requisitos de uma ID de usuário e uma senha ou senha criptografada, com base na segurança do sistema e na instrução SECURITY no membro de configuração DBMOVER.
Se você especificar esse parâmetro, não especifique o parâmetro GLOBAL_EPWD. Se você especificar ambos, o parâmetro GLOBAL_EPWD terá precedência.
Você pode substituir esse valor para um comando específico de registro ao incluir o parâmetro PWD no comando.
GLOBAL_REGISTRATION_LOCATION={hlq.data_set_name|local}
Especifica a localização do conjunto de dados CCT do VSAM que contém os registros de captura. O valor padrão é "local".
Normalmente, o valor padrão "local" é aceitável porque os registros de captura devem residir no sistema de origem z/OS no qual o utilitário PWXUCREG é executado.
Você pode substituir esse valor para um comando específico de registro ao incluir o parâmetro REGISTRATION_LOCATION no comando.
GLOBAL_USER=user_id
Especifica uma ID de usuário que tem a autoridade para acessar os registros de captura no conjunto de dados CCT no sistema de origem. Esse valor diferencia letras maiúsculas de minúsculas.
Consulte o administrador de segurança do sistema sobre a determinação dos requisitos de uma ID de usuário e uma senha ou senha criptografada, com base na segurança do sistema e na instrução SECURITY no membro de configuração DBMOVER.
Se você especificar esse parâmetro, especifique também o parâmetro GLOBAL_EPWD ou GLOBAL_PWD.
Você pode substituir a ID de usuário global para um determinado comando específico de registro ao incluir o parâmetro USER no comando.
SHOW_EXPANDED_STATEMENT={N|Y}
Exibe as instruções de comando de entrada em um formato expandido que inclui os parâmetros
especificados no trabalho PWXUCREG e os outros parâmetros válidos não especificados, mas que estão em vigor com os valores padrão ou com uma entrada de caractere curinga de asterisco (*).
SYSTEM_CONSOLE_MESSAGES_COMMAND={N|Y}
Controla se o utilitário roteia saídas de mensagem a partir de comandos específicos de registro que alteram o status de registro para o console do sistema z/OS, bem como para o log DTLLOG. Se você digitar Y, as mensagens serão enviadas ao console do sistema e ao log DTLLOG. Se você aceitar o valor padrão N, as mensagens serão enviadas somente para o log DTLLOG.
SYSTEM_CONSOLE_MESSAGES_DISPLAY={N|Y}
Controla se o utilitário roteia saídas de mensagem a partir de uma solicitação de registro de exibição automática ou explícita para o console do sistema z/OS, bem como para o log DTLLOG. Essas solicitações resultam de um comando DISPLAY_REGISTRATION ou de um comando SET_CONTROL_VALUE que inclui os parâmetros DISPLAY_REGISTRATION_AFTER_COMMAND ou
DISPLAY_REGISTRATION_BEFORE_COMMAND globais. Se você digitar Y, as mensagens serão enviadas ao console do sistema e ao log DTLLOG. Se você aceitar o valor padrão N, as mensagens serão enviadas somente para o log DTLLOG.
Parâmetros de Comando Específicos de Registro
Você pode especificar vários parâmetros para qualquer comando específico de registro que você incluir na entrada PWXSYSIN para um trabalho PWXUCREG.Os parâmetros DATABASE_INSTANCE e REGISTRATION_NAME são necessários.
Parâmetros de comando específicos de registro substituem quaisquer parâmetros globais correspondentes. Nas seguintes descrições de parâmetros, as chaves indicam que uma das opções deve ser inserida, e o sublinhado indica o valor padrão.
Descrições de Parâmetros
DATABASE_TYPE=tipoRecomendado. Especifica o tipo de banco de dados de origem e o CDC que está associado ao registro ou registros que o comando PWXUCREG processa. As opções são:
¨ ADA. Para Adabas.
¨ DCM. Para Datacom baseado em tabelas ¨ IDL. Para IDMS baseado em log
¨ IMS. Para IMS baseado em log. Se você tentar processar registros para origens síncronas de IMS, o utilitário PWXUCREG rejeitará os registros e será encerrado com a mensagem de erro PWX-03723. Nesse parâmetro, você pode usar o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga, tal como em B08*.
DATABASE_INSTANCE=instance_id
Obrigatório. Especifica um dos seguintes valores que é definido para o grupo de registro no Navegador do PowerExchange:
¨ Para Adabas, o identificador de coleta. ¨ Para Datacom, o nome do MUF. ¨ Para IDMS, o identificador LOGSID. ¨ Para IMS, o identificador de RECON.
Esse valor diferencia letras maiúsculas de minúsculas. Nesse parâmetro, você pode usar o caractere curinga de asterisco (*) ou uma string seguida pelo caractere curinga.
EPWD=encrypted_password
Especifica uma senha criptografada a ser usada com a ID de usuário que está especificada no parâmetro USER associado.
Consulte o administrador de segurança do sistema sobre a determinação dos requisitos de uma ID de usuário e uma senha ou senha criptografada, com base na segurança do sistema e na instrução SECURITY no membro de configuração DBMOVER.
Sugestão: Você pode usar o Navegador do PowerExchange para criar uma senha criptografada. Clique em