Sumário

Search

  1. Prefácio
  2. Introdução ao Navegador do PowerExchange
  3. Mapas de Dados
  4. Mapas de Dados para Fontes de Dados Específicas
  5. Copybooks
  6. Grupos de Registro e Registros de Captura
  7. Grupos de Extração e Mapas de Extração
  8. Metadados Pessoais
  9. Teste de Linha de Banco de Dados
  10. Exemplos do Navegador do PowerExchange
  11. Apêndice A: Funções do PowerExchange para Campos Definidos pelo Usuário
  12. Apêndice B: Programas de Método de Acesso do Usuário
  13. Apêndice C: Grupos de Aplicativos e Aplicativos
  14. Apêndice D: Propriedades do Mapa de Dados
  15. Apêndice E: Propriedades do Registro, Campo e Tabela
  16. Apêndice F: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  17. Apêndice G: Rastreamento para criar um mapa de memória ao importar um copybook COBOL

Guia do Usuário do Navegador

Guia do Usuário do Navegador

Caixa de Diálogo Teste de Linha de Banco de Dados

Caixa de Diálogo Teste de Linha de Banco de Dados

Na caixa de diálogo Teste de Linha de Banco de Dados, você pode definir as opções de um teste de linha de banco de dados.
A caixa de diálogo inclui as seguintes opções:
Tipo de DB
O tipo de fonte de dados ou método de acesso. Para mapas de extração, o padrão é
CAPXRT
.
Selecione uma opção e insira as informações nos campos relacionados que dependem do tipo de opção:
Opção
Descrição
Campos Relacionados
AS4_META - Use essa opção somente sob orientação do Suporte Global a Clientes da Informatica.
-
-
CAPX
Um método de acesso que lê as alterações dos arquivos condensados do PowerExchange Condense ou dos arquivos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows em lote e depois é interrompido.
Opcionalmente, insira o nome de arquivo que substitui o nome de arquivo padrão no campo
Substituir Nome do Arquivo
.
CAPXRT
Um método de acesso que lê as alterações diretamente no fluxo de alteração, nos arquivos do PowerExchange Condense ou nos arquivos de log do Agente de Log do PowerExchange para Linux, UNIX e Windows em tempo real..
Opcionalmente, insira o nome do arquivo que substitui o nome do arquivo padrão no campo
Substituir Nome do Arquivo
.
DB2
DB2 para z/OS, DB2 para i5/OS e bancos de dados DB2 para Linux, UNIX e Windows
No campo
SSID ou DBName
, insira o nome do banco de dados do DB2 ou do DB2 para z/OS, insira o ID de subsistema ou o nome do grupo de compartilhamento de dados.
DB2390IMG
Cópia de imagem do DB2 para z/OS de espaços de tabela descompactados de um sistema remoto
Opcionalmente, insira o nome do arquivo que substitui o nome do arquivo padrão no campo
Substituir Nome do Arquivo
.
No campo
SSID
, insira o ID de subsistema do DB2 para z/OS.
DB2400C
Um método de acesso que usa as chamadas ODBC padrão para acessar os dados do DB2 para i5/OS
No campo
SSID ou DBName
, insira o nome do banco de dados do DB2.
DB2UDB
Banco de dados do DB2 para Linux, UNIX e Windows
No campo
SSID ou DBName
, insira o nome do banco de dados do DB2.
IMSUNLD
Arquivo de descarregamento do IMS
No campo
Nome do Arquivo
, insira o nome do arquivo de descarregamento do IMS.
MSSQL
Banco de dados do Microsoft SQL Server
No campo
DSN
, insira o nome da instância do SQL Server.
Opcionalmente, insira um nome de banco de dados que substitua o nome do banco de dados especificado para a conexão no campo
Banco de Dados
.
MYSQL
Servidor de banco de dados MySQL
No campo
Servidor
, digite o nome do servidor ou o endereço IP do servidor MySQL onde o banco de dados de origem está localizado.
NRDB
Fontes de dados não relacionais, como conjuntos de dados VSAM, bancos de dados do IMS ou arquivos simples.
Esse tipo de fonte de dados usa uma convenção de nomenclatura de três camadas na SQL gerada.
Opcionalmente, insira o nome de um arquivo que substitui o nome do arquivo padrão do mapa de dados no campo
Substituir Nome do Arquivo
.
No campo
Senha do Arquivo
, insira a senha do arquivo, se necessário.
NRDB2
Fontes de dados não relacionais
Esse tipo de fonte de dados usa uma convenção de nomenclatura de duas camadas na SQL gerada.
Opcionalmente, insira o nome de um arquivo que substitui o nome do arquivo padrão do mapa de dados no campo
Substituir Nome do Arquivo
.
No campo
Senha do Arquivo
, insira a senha do arquivo, se necessário.
ODBC
Fonte de dados ODBC
No campo
DSN
, insira o nome da fonte de dados do ODBC.
No campo
Nome do Banco de Dados
, insira o nome do banco de dados.
ORACLE
Banco de dados Oracle
Opcionalmente, insira um nome TNS para a instância Oracle no campo
Nome do SQL*Net
.
PGSQL
Servidor de banco de dados do PostgreSQL
Servidor
. O nome do servidor de banco de dados.
Simulador
Essa opção destina-se principalmente para uso interno da Informatica. Não a selecione.
Ignore o campo
DB Qual1
.
TASK_CTRL
Uma opção que permite que você emita um comando do Ouvinte do PowerExchange por meio do Navegador do PowerExchange.
-
Localização
Selecione o nome do nó do local da fonte de dados.
Este campo lista os locais que são definidos nas instruções NODE no arquivo de configuração DBMOVER no sistema do Navegador do PowerExchange. Um valor
local
indica que a fonte está no sistema do Navegador do PowerExchange.
Se você estiver testando um mapa de dados IMS com o método de acesso DL/1, insira o nome do nó do local em que o trabalho netport é executado. Se você estiver testando um mapa de dados IMS com o método de acesso ODBA, insira o nome do nó da localização na qual o Ouvinte do PowerExchange é executado.
ID do Usuário
Um ID do usuário que permite o acesso à origem. O tipo de ID do usuário depende do tipo de origem e das configurações de segurança do PowerExchange na instrução SECURITY do arquivo de configuração DBMOVER.
Para uma origem em um sistema Linux, UNIX ou Windows com suporte, se você tiver ativado a autenticação de usuário LDAP do PowerExchange e, se aplicável, desativado a autenticação de passagem relacional, a ID de usuário será o nome de usuário da empresa. Para obter mais informações, consulte o
Manual de Referência do PowerExchange
.
Para uma origem do Microsoft SQL Server para a qual você usa o Microsoft NTLM e a autenticação do Active Directory, digite o ID do usuário no formato
domínio
\
nome_usuário
. Em seguida, no campo
Senha
, insira a senha para esse ID de usuário.
Senha
Uma senha do ID do usuário, se especificada.
Se a origem estiver em um sistema i5/OS ou z/OS, você poderá inserir um código de acesso válido do PowerExchange em vez de uma senha. Um código de acesso do i5/OS pode ter 9 a 31 caracteres. Um código de acesso do z/OS pode ter 9 a 128 caracteres. Um código de acesso pode conter os seguintes caracteres:
  • Letras em maiúsculas e minúsculas
  • Os números de 0 a 9
  • Espaços
  • Os seguintes caracteres especiais:
    ’ - ; # \ , . / ! % & * ( ) _ + { } : @ | < > ?
    O primeiro caractere é um apóstrofo.
Códigos de acesso não podem incluir aspas simples ('), aspas duplas (") ou símbolos monetários.
No z/OS, os caracteres permitidos na saída IBM IRRPHREX não afetam os caracteres permitidos nos códigos de acesso do PowerExchange.
No z/OS, um código de acesso válido RACF pode ter até 100 caracteres. O PowerExchange trunca códigos de acesso com mais de 100 caracteres quando os transfere para o RACF para validação.
Para usar códigos de acesso, verifique se o Ouvinte do PowerExchange é executado com uma configuração de segurança SECURITY=(1,N) ou superior no membro DBMOVER. Para obter mais informações, consulte "Instrução SECURITY" no
Manual de Referência do PowerExchange
.
Busca
O tipo de informação que o teste de linha de banco de dados acessa e exibe. As opções disponíveis dependem do valor
Tipo de DB
. Para o tipo
TASK_CTRL
, esse campo lista o tipo de comando a ser emitido para um Ouvinte do PowerExchange.
Para perfis de metadados pessoais, a lista
Busca
não está disponível e o valor padrão é
Dados
.
A tabela a seguir descreve as opções na lista
Busca
:
Opção
Disponível para Tipos de Fonte de Dados
Descrição
Colunas
Tudo, exceto TASK_CTRL
Exibe metadados para colunas.
Dados
Tudo, exceto TASK_CTRL
Exibe linhas de dados.
Chaves externas
Tudo, exceto TASK_CTRL
Exibe metadados para chaves externas.
Chaves primárias
Tudo, exceto TASK_CTRL
Exibe metadados para chaves primárias.
Colunas de Procedimento
  • AS4_META
  • DB2
  • DB2400C
  • ODBC
  • Simulador
Exibe metadados para procedimentos armazenados específicos.
Procedimentos
  • AS4_META
  • DB2
  • DB2400C
  • ODBC
  • Simulador
Exibe metadados para os procedimentos armazenados disponíveis.
Registros
  • NRDB
  • NRDB2
Exibe metadados para os registros NRDB e NRDB2.
Esquemas
  • CAPX
  • CAPXRT
  • DB2
  • DB2390IMG
  • DB2400C
  • DB2UDB
  • IMSUNLD
  • MSSQL
  • MYS
  • NRDB
  • NRDB2
  • ODBC
  • ORACLE
  • PGSQL
Exibe metadados para os nomes de esquema do tipo de fonte de dados especificado.
Tabelas
Tudo, exceto TASK_CTRL
Exibe metadados para tabelas.
Listar Localizações
TASK_CTRL
Exibe informações sobre as instruções NODE definidas no arquivo de configuração DBMOVER no sistema no qual o Ouvinte do PowerExchange está em execução.
Listar Tarefa
TASK_CTRL
Exibe informações sobre cada tarefa ativa do Ouvinte do PowerExchange, incluindo o endereço TCP/IP, o número de porta, o nome do aplicativo, o tipo de acesso e o status.
Interromper Tarefa
TASK_CTRL
Interrompe uma tarefa individual do Ouvinte do PowerExchange com base no nome do aplicativo especificado.
O padrão é
Dados
. Use a opção
Dados
para visualizar dados.
Métodos de Acesso
A lista
Métodos de Acesso
estará disponível se você tiver selecionado as seguintes combinações de opções:
  • O valor de
    Tipo de DB
    é
    NRDB
    ou
    NRDB2
    , e o valor de
    Busca
    é
    Tabelas
    ou
    Colunas
  • O valor de
    Tipo de DB
    é
    CAPX
    ou
    CAPXRT
    , e o valor de
    Busca
    é
    Tabelas
    .
Selecione um ou mais métodos de acesso se você deseja recuperar informações de métodos de acesso específicos. O PowerExchange adiciona palavras-chave de filtragem à instrução DTLDESCRIBE na caixa
Instrução SQL
.
Se você não selecionar um método de acesso, a instrução DTLDESCRIBE retornará informações para todos os métodos de acesso.
A tabela a seguir descreve as opções na lista
Métodos de Acesso
:
Método de Acesso
Descrição
Palavra-chave DTLDESCRIBE
DM_ADABAS
Adabas
A
DM_CAPX
  • CAPX
  • CAPXRT
C
DM_DATACOM
Datacom
X
DM_DB2
  • DB2 para i5/OS
  • DB2 para z/OS
Z
DM_DB2390IMG
DB2390IMG
G
DM_DB2UNLD
Arquivo de descarregamento do DB2
W
DM_DL1
Lote IMS DL/1
D
DM_ESDS
VSAM ESDS
E
DM_IDMS
IDMS
I
DM_KSDS
VSAM KSDS
K
DM_MQ
MQSeries
Q
DM_ODBA
IMS ODBA
O
DM_RRDS
VSAM RRDS
N
DM_SEQ
Conjunto de dados sequenciais ou arquivo simples
S
DM_TAPE
Fita
T
DM_USER
Método de acesso do usuário
U
DM_XDB2
Mapa de extração do DB2 para i5/OS ou DB2 para z/OS. Exibido somente se o tipo de fonte de dados for CAPX ou CAPXRT,
B
DM_XDB2UDB
Mapa de extração do DB2 para Linux, UNIX e Windows . Exibido somente se o tipo de DB for CAPX ou CAPXRT,
V
DM_XMSSQL
Mapa de extração do Microsoft SQL Server. Exibido somente se o tipo de DB for CAPX ou CAPXRT,
L
DM_XORACLE
Mapa de extração Oracle. Exibido somente se o tipo de DB for CAPX ou CAPXRT,
P
Para limpar todas as seleções na lista
Métodos de Acesso
, clique com o botão direito do mouse na lista
Métodos de Acesso
e clique em
Tirar Seleção de Tudo
.
Arquivo SQL
Usa um arquivo que contém uma instrução SQL em vez de usar a SQL gerada na caixa
Instrução SQL
. Se você selecionar essa opção, digite o caminho e o nome de arquivo do arquivo SQL na caixa
Arquivo SQL
ou clique no botão Procurar para buscar o arquivo.
O padrão é limpo.
Editar
Ativado se a opção
Arquivo SQL
estiver selecionada.
Clique em
Editar
para editar o arquivo SQL especificado na caixa
Arquivo SQL
.
Tamanho de Registro SQL
Ativado se a opção
Arquivo SQL
estiver selecionada.
O tamanho do registro da SQL no arquivo SQL.
Instrução SQL
Exibe a SQL gerada, SQL DTLDESCRIBE, ou a instrução de comando do Ouvinte do PowerExchange para o tipo de fonte de dados especificado e as opções
Busca
.
Você pode editar a instrução na caixa
Instrução SQL
.
Se você selecionar a opção
Arquivo SQL
, a caixa
Instrução SQL
será desativada.
O PowerExchange gera as seguintes instruções na caixa
Instrução SQL
para as seguintes combinações de tipo de fonte de dados e opção
Busca
:
  • Qualquer tipo de fonte de dados, exceto
    TASK_CTRL
    e
    Dados
    na lista
    Busca
    Uma instrução SQL é gerada e exibida na caixa
    Instrução SQL
    . O PowerExchange gera a seguinte instrução SELECT para mapas de dados que usam uma convenção de nomenclatura de duas camadas:
    select * from schema.
    map_table
    O PowerExchange gera a seguinte instrução SELECT para mapas de dados que usam uma convenção de nomenclatura de três camadas:
    select * from
    schema
    .
    map
    .
    table
  • Qualquer tipo de fonte de dados, exceto
    TASK_CTRL
    e uma opção de metadados na lista
    Busca
    Uma instrução DTLDESCRIBE é gerada e exibida na caixa
    Instrução SQL
    . As opções de metadados incluem
    Colunas
    ,
    Chaves Externas
    ,
    Chaves Primárias
    ,
    Colunas de Procedimento
    ,
    Procedimentos
    ,
    Esquemas
    e
    Tabelas
    .
  • O tipo de fonte de dados
    TASK_CTRL
    e um comando do Ouvinte do PowerExchange na lista
    Busca
    Um comando do Ouvinte do PowerExchange é gerado e exibido na caixa
    Instrução SQL
    .
    Use o tipo de fonte de dados
    AS4_META
    sob orientação do Suporte Global a Clientes da Informatica.
Filtros de Metadados
Opcionalmente, dependendo das opções de
Tipo de DB
e de
Busca
selecionadas, insira critérios de filtro nos campos
Metadados
.
Nenhum dos campos de filtro estará disponível se você selecionar
Dados
na lista
Busca
.
Em qualquer campo de filtro, você pode usar os seguintes caracteres curinga:
  • Asterisco (*) representa um ou mais caracteres de correspondência.
  • Ponto de interrogação (?) representa um único caractere de correspondência.
A seguinte tabela identifica os campos de filtro disponíveis para diferentes combinações das opções de
Tipo de DB
e de
Busca
:
Tipo de DB
Opções de Busca
Campos de Filtro
AS4_META, Simulator
Colunas, Chaves Externas, Chaves Primárias, Tabelas
  • Tabela
CAPX, CAPXRT, DB2390IMG, IMSUNLD, NRDB2, MYSQL, Oracle, PGSQL
Colunas, Chaves Externas, Chaves Primárias, Tabelas
  • Esquema
  • Tabela
CAPX, CAPXRT, DB2390IMG, IMSUNLD, NRDB2, MYSQL, Oracle, PGSQL
Esquemas
  • Esquema
DB2, DB2400C, DB2UDB
Colunas, Chaves Externas, Chaves Primárias, Tabelas
  • Criador/Esquema
    Para DB2 para i5/OS, o tamanho máximo é de 10 caracteres. Para DB2 para z/OS, o tamanho máximo é de 128 caracteres
  • DBName/Definidor
  • Tabela
    Para DB2 para i5/OS, o tamanho máximo é de 32 caracteres. Para DB2 para z/OS, o tamanho máximo é de 128 caracteres.
DB2, DB2400C, DB2UDB
Esquemas
  • Criador/Esquema
DB2, DB2400C, ODBC
Chamadas de procedimento, Procedimentos
  • Catálogo
  • Esquema
  • Nome do Procedimento
MSSQL, ODBC
Colunas, Chaves Externas, Chaves Primárias, Tabelas
  • Proprietário
  • Tabela
Para ambos os campos, o tamanho máximo é de 128 caracteres.
MSSQL, ODBC
Esquemas
  • Proprietário
NRDB
Colunas, Chaves Externas, Chaves Primárias, Registros, Tabelas
  • Esquema
    O tamanho máximo é de 10 caracteres.
  • Nome do Mapa
    O nome de um mapa de dados do PowerExchange. O tamanho máximo é de 10 caracteres.
  • Tabela
    O tamanho máximo é de 128 caracteres.
NRDB
Esquemas
  • Esquema
Além disso, na caixa de grupo
Metadados
, marque qualquer uma das seguintes caixas de seleção, se estiverem disponíveis:
  • Manter capitalização
    . Por padrão, o texto inserido nos campos de filtro é convertido para a capitalização padrão da fonte de dados. Marque essa caixa de seleção dos campos de filtro cujo texto você
    não
    deseja que o PowerExchange converta para a capitalização padrão da fonte de dados. Por exemplo, para uma fonte do Oracle, maiúsculas são o padrão. Se essa opção estiver desmarcada, as entradas
    scott
    e
    SCOTT
    seriam convertidas para
    SCOTT
    . No entanto, se você tiver marcado essa caixa de seleção, a entrada
    scott
    seria mantida em minúsculas.
  • Comentários
    . Marque essa caixa de seleção para incluir todos os comentários nos metadados que o teste de linha buscar para os objetos de banco de dados.
  • Extensões
    . Marque essa caixa de seleção para retornar metadados estendidos, caso seja o adequado para o tipo de fonte de dados selecionado.
Avançado
Disponível para os tipos de fonte de dados
CAPX
,
CAPXRT
,
DB2390IMG
,
IMSUNLD
, IMS
NRDB
e
NRDB2
.
Clique em
Avançado
para exibir a caixa de diálogo
Parâmetros Avançados
. Nesta caixa de diálogo, você pode inserir valores de parâmetro que substituem determinadas configurações em arquivos de configuração, mapas de dados e mapas de extração do PowerExchange.
Aplicativo
Obrigatório para os tipos de fonte de dados
CAPX
e
CAPXRT
.
O nome do aplicativo. Insira uma cadeia de caracteres de 1 a 20 caracteres.
Caractere de escape
Digite o caractere de escape a ser usado para delimitar um asterisco (*) ou um ponto de interrogação (?) que é usado como um valor literal em vez de como um caractere curinga nas caixas de filtro
Metadados
.
Por exemplo, se você especificar um caractere de escape de
~
, um valor de filtro de
tab*
retornará todas as tabelas que começam com
tab
. Um valor de filtro de
tab~*
retorna a tabela denominada
tab*
.
Não use um caractere de escape com fontes de dados ativadas por multibyte.
Obter
n
Linhas
Indica o número de linhas a serem buscadas.
Os valores válidos variam de 1 a 99999. O padrão é 10.
Um valor grande pode aumentar o tempo de resposta do Navegador do PowerExchange e o uso da CPU.
Ignorar Primeiras
n
Linhas
Indica o número de linhas iniciais de dados a serem ignoradas quando o teste de linha busca dados para exibir. Se você executar um teste de linha em um arquivo grande, poderá usar essa opção para que o teste de linha ignore um ponto específico no arquivo antes de exibir os dados. Essa opção pode ajudar você a diagnosticar problemas nos arquivos grandes com mais rapidez, porque somente os dados de possível interesse são retornados para análise.
Essa opção estará disponível somente se você selecionar
CAPX
,
CAPXRT
,
NRDB
,
NRDB2
ou
IMSUNLD
na lista
Tipo de DB
e selecionar
Dados
na lista
Buscar
.
Os valores válidos variam de 0 a 99999. O padrão é 0, o que faz com que nenhuma linha seja ignorada.
Um valor grande pode aumentar o tempo de resposta do Navegador do PowerExchange e o uso da CPU.
Se você estiver testando um mapa de dados SEQ que tem a propriedade
Variável
definida como
VS
para indicar um arquivo de dados de fluxo de tamanho variável, o teste de linha de banco de dados retornará mensagens de aviso PWX-03042 e a opção
Ignorar Primeiras
n
Linhas
será ignorada. O Navegador do PowerExchange não pode ignorar linhas de um arquivo de dados de tamanho variável.