O comando SET_CONTROL_VALUE global configura valores de parâmetros globais que se aplicam a comandos de registro subsequentes. Use esse comando se você executar conjuntos de comandos que contêm vários comandos e deseja definir valores de parâmetros comuns uma vez para um conjunto de comandos. Você pode substituir qualquer valor global em um comando subsequente.
É possível especificar um ou mais parâmetros globais em um comando SET_CONTROL_VALUE. Todos os parâmetros globais são opcionais, mas você deve especificar pelo menos um em um comando SET_CONTROL_VALUE. Os parâmetros globais se aplicam aos comandos específicos de registro subsequentes, a menos que sejam substituídos.
Você pode especificar os seguintes tipos de parâmetros:
Parâmetros de conectividade que especificam o local do arquivo CCT e as credenciais a serem usadas ao acessar esse arquivo
Parâmetros de destino de relatório que direcionam a saída da mensagem
Parâmetros de conteúdo do relatório que controlam o conteúdo do relatório para um destino específico
Outros parâmetros que controlam se o status do registro deve ser validado ou alterado
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.
Parâmetros de conectividade
GLOBAL_REGISTRATION_LOCATION={
listener_node_name
|
local
}
Especifica a localização do arquivo CCT do VSAM que contém os registros de captura. O valor padrão é "local".
Você pode substituir esse valor para um comando específico de registro ao incluir o parâmetro REGISTRATION_LOCATION no comando.
Se você estiver processando um arquivo CCT em um sistema remoto como o IBM i em que um Ouvinte do PowerExchange é executado, especifique o nome NODE para esse Ouvinte do PowerExchange.
Embora você possa executar o PWXUCREG no z/OS para processar o arquivo CCT localmente, pode ser vantajoso executar PWUXREG em um sistema Linux, UNIX ou Windows remoto e canalizar os relatórios para um arquivo local usando a sintaxe de canal stdout.
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.
Se a instrução SECURITY no arquivo de configuração DBMOVER do Ouvinte do PowerExchange estiver definida como "2", os seguintes requisitos se aplicarão:
Se você não estiver acessando o arquivo CCT localmente, uma senha ou frase secreta deverá ser fornecida para ativar a conexão com o ouvinte.
No z/OS, o ID do usuário deve ter autoridade SAF para acessar certos recursos CAPX.
Consulte o administrador de segurança do sistema para determinar os requisitos de segurança para o ID do usuário e a senha ou a 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.
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 para determinar os requisitos de segurança para o ID do usuário e a senha ou a senha criptografada com base na segurança do sistema e na instrução SECURITY no membro de configuração DBMOVER.
Para garantir que as senhas não sejam armazenadas em um formato legível, a Informatica recomenda que você use o parâmetro EWPD em vez do parâmetro PWD. Não especifique os parâmetros EPWD e PWD ao mesmo tempo.
Você pode usar o Navegador do PowerExchange para criar uma senha criptografada. Clique em
Arquivo
Criptografar
.
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. Substitui o parâmetro GLOBAL_PWD em um comando SET_CONTROL_VALUE anterior, se especificado.
Consulte o administrador de segurança do sistema para determinar os requisitos de segurança para o ID do usuário e a senha ou a senha criptografada com base na segurança do sistema e na instrução SECURITY no membro de configuração DBMOVER.
Para garantir que as senhas não sejam armazenadas em um formato legível, a Informatica recomenda que você use o parâmetro EWPD em vez do parâmetro PWD. Não especifique os parâmetros EPWD e PWD ao mesmo tempo.
Você pode substituir esse valor para um comando específico de registro ao incluir o parâmetro PWD no comando.
OVERRIDE_CCT_FILE_NAME={
file_name
]
Especifique esse parâmetro para usar um arquivo CCT não padrão. O padrão é usar o arquivo CCT padrão.
Parâmetros de destino do relatório
NO_MESSAGES_TO_DETAIL_LOG={
N
|Y}
Controla se as mensagens são gravadas no arquivo de log de detalhes. As opções são:
N
. Grava mensagens no arquivo de log de detalhes.
Y
. Não grava mensagens no arquivo de log de detalhes.
O padrão é N.
No Linux, UNIX e Windows, geralmente é útil canalizar os resultados de stdout para um arquivo e suprimir a gravação de mensagens em detail.log.
SYSTEM_CONSOLE_MESSAGES_COMMAND={
N
|Y}
Controla se o utilitário encaminha a saída da mensagem de comandos específicos de registro que alteram o status do registro para o console do sistema z/OS e para o log DTLLOG, ou não encaminha a saída da mensagem para nenhum local.
N
. Quando o utilitário é executado no z/OS, ele não encaminha a saída da mensagem de comandos específicos de registro para o console do sistema z/OS e o log DTLLOG.
Y
. Quando o utilitário é executado no z/OS, ele encaminha a saída da mensagem de comandos específicos de registro para o console do sistema z/OS e o log DTLLOG.
O padrão é N.
SYSTEM_CONSOLE_MESSAGES_DISPLAY={
N
|Y}
Controla se o utilitário encaminha a saída da mensagem de uma solicitação de registro de exibição explícita ou automática ao console do sistema
z/OS
e ao log DTLLOG ou apenas ao log DTLLOG. As opções são:
N
. Envia as mensagens ao log DTLLOG.
Y
. Envia as mensagens ao console do sistema e ao log DTLLOG.
Se você especificar Y, quando PWXUCREG for executado no z/OS, o utilitário encaminhará a saída da mensagem que relata os atributos de registro ao console do sistema z/OS e ao log DTLLOG. As mensagens são resultantes da execução de um dos seguintes comandos:
Um comando DISPLAY_REGISTRATION
Um comando SET_CONTROL_VALUE com o parâmetro DISPLAY_REGISTRATION_AFTER_COMMAND ou DISPLAY_REGISTRATION_BEFORE_COMMAND.
O padrão é N.
Parâmetros de Conteúdo do Relatório
DISPLAY_REGISTRATION_AFTER_COMMAND={N|
Y
}
Exibe informações sobre o registro ou registros de captura que foram processados por um comando específico de registro anterior que alterou o status do registro. Essas informações incluem a configuração de status atual de registro e os registros 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 de captura ou registros a serem processados por um comando específico de registro subsequente que altera o status do registro. Essas informações incluem a configuração de status atual de registro e os registros de data/hora de ativação e suspensão. Você pode usar essas informações para verificar se o comando altera corretamente o status. 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, ainda poderá especificar o comando DISPLAY_REGISTRATION no JCL do PWXUCREG para exibir informações do status de registro antes de um determinado comando.
Talvez você queira especificar DISPLAY_REGISTRATION_BEFORE_COMMAND=N antes de excluir os registros para verificar se eles não estão mais ativos.
Você pode usar esse parâmetro com o parâmetro DISPLAY_REGISTRATION_AFTER_COMMAND para exibir informações de status de registro antes e depois de um comando.
DISPLAY_REGISTRATION_DETAIL={
N
|Y}
Controla como os atributos do registro são relatados. As opções são:
N
. Os atributos do registro são relatados em uma única linha.
Y
. Os atributos do registro são relatados em várias linhas.
Esse parâmetro é aplicável quando os seguintes comandos são usados:
Comando DISPLAY_REGISTRATION
Comandos Ativar, Excluir e Suspender com os parâmetros DISPLAY_REGISTRATION_BEFORE_COMMAND ou DISPLAY_REGISTRATION_AFTER_COMMAND
O padrão é N.
SHOW_EXPANDED_STATEMENT={
N
|Y}
Controla se as instruções de comando de entrada devem ser exibidas em um formato expandido que inclui os parâmetros que você especificou e os outros parâmetros válidos que você não especificou, mas que estão em vigor com seus valores padrão ou uma entrada de curinga asterisco (*). As opções são:
N
. Não relata as instruções de comando em um formato expandido.
Y
. As instruções de comando são relatadas em um formato expandido.
O padrão é N.
Outros Parâmetros
GENÉRICO={
N
|Y}
Indica se os comandos específicos de registro processam apenas um registro ou vários deles. Esse parâmetro não tem suporte para os comandos DELETE_INACTIVE_REGISTRATION e DISPLAY_REGISTRATION, que agem genericamente em vários registros por padrão.
N
. Os comandos processam apenas um registro.
Y
. Os comandos processam mais de um registro. Se você precisar de um comando para processar mais de um registro, especifique GENERIC=Y globalmente no comando SET_CONTROL_VALUE ou no comando específico do registro. Ao especificar GENERIC=Y, você também deve especificar máscaras que contenham o curinga asterisco (*) em determinados parâmetros dos comandos específicos de registro, como REGISTRATION_NAME.
Você pode substituir essa configuração global para um determinado comando específico de registro ao incluir o parâmetro GENERIC no comando.
O padrão é N.
GLOBAL_VALIDATE={
N
|Y}
Controla se os registros devem ser validados. As opções são:
N
. Executa o processamento do comando e atualiza os registros no arquivo CCT.
Y
. Valida os registros. Executa o processamento para o comando, exceto para modificar o registro. O processamento pode ser realizado por um usuário que tenha permissão de leitura para o arquivo CCT.
Por exemplo, se GLOBAL_VALIDATE=Y ao suspender um registro, as seguintes ações serão executadas:
O registro ou registros selecionados são lidos e relatados quando DISPLAY_REGISTRATION_BEFORE_COMMAND=Y.
O registro ou registros selecionados são lidos e adicionados à lista de processos.
O registro ou registros selecionados recebem validações de última hora de acordo com o comando, e os erros são relatados. Por exemplo, somente registros ativos podem ser suspensos e somente registros suspensos podem ser ativados.
A etapa de modificação não é executada.
A Informatica recomenda que você execute uma execução inicial de PWXUCREG com GLOBAL_VALIDATE=Y para validar os resultados. Verifique os resultados e execute novamente o PWXUCREG com GLOBAL_VALIDATE=N.