Os programas fornecidos pelo warehouse podem ser usados para carregar dados num banco de dados DB2 Universal Database, DB2 para AS/400 e DB2 para OS/390.
Definindo valores para um programa de carga do DB2 Universal Database
Use o bloco de notas Propriedades da Etapa de Carga do DB2 Universal Database para criar uma etapa que carregue dados de um arquivo de origem ou de destino numa tabela do DB2 Universal Database.
A origem ou destino do warehouse podem ser usados como origem para este subtipo de etapa. Ligue uma origem ao subtipo da etapa na janela Modelo de Processo. Em seguida, ligue o subtipo da etapa a um destino do warehouse. A página Mapeamento da Coluna não está disponível nesta etapa.
Para definir valores para uma etapa que executa um programa do warehouse de carga do DB2 Universal Database:
1. Abra o bloco de notas da etapa.
2. Especifique as informações gerais sobre o programa warehouse. Para obter mais informações, consulte o manual “Fornecendo informações gerais sobre uma etapa” na página 151.
3. Opcional: Na página Parâmetros, proceda da seguinte forma:
v Selecione o modo de carregamento a partir da lista suspensa Modo de
carregamento. Os valores possíveis são:
– INSERT - carrega a tabela e anexa dados do arquivo à tabela existente. (Isso é o padrão.)
– REPLACE - carrega a tabela e substitui todos os dados na tabela existente.
– RESTART - reinicia um processo de carregamento que foi terminado de forma anormal.
– TERMINATE - termina um processo de carregamento atualmente em execução.
v Na caixa do grupo Delimitadores, altere os tipos de delimitadores clicando na seta para baixo para exibir uma lista de delimitadores válidos e selecione um:
– O delimitador de coluna indica o caractere que é utilizado para delimitar cada coluna no arquivo a ser carregado.
– O delimitador de caractere especifica o caractere que é utilizado para fechar as coluna baseadas em caracteres no arquivo a ser carregado. – O delimitador de decimal especifica o caractere que é utilizado como
um ponto decimal em colunas de número no arquivo a ser carregado. v Para especificar opções avançadas para a carga de carga, clique em
Avançado. Consulte o auxílio online desta janela para obter informações sobre como especificar estas opções.
4. Na página Opções de Processamento, forneça informações sobre como sua etapa é processada. Para obter mais informações, consulte o manual “Definindo as opções de processamento” na página 153.
5. Clique em OK para salvar as alterações e feche o bloco de notas etapa.
Definindo valores para um programa de Inserção e Carga de Dados do DB2 UDB para AS/400 (VWPLOADI)
Use o programa Carregar e Inserir Dados do DB2 UDB para AS/400
(VWPLOADI) para carregar dados de um arquivo simples para uma tabela do DB2 UDB para AS/400. A operação de carregamento anexa novos dados no final de dados existentes na tabela.
Antes de definir esta subtipo de etapa, você deve conectar a etapa a uma origem do warehouse e um destino do warehouse no Modelador de Processo. Os arquivo de origem aceitáveis para a implementação do AS/400 da
VWPLOADI são AS/400 membros do arquivo de origem QSYS ou dos
arquivos de fluxo no Sistema de Arquivos Integrados (Integrated File System - IFS), o sistema de arquivos da raiz.
Dica:Aprimore o desempenho e o uso da memória através dos membros do arquivo QSYS em vez dos arquivos de fluxo. CPYFRMIMPF faz uma cópia do arquivo de fluxo inteiro em QRESTORE e, em seguida, carrega a cópia em sua tabela. Consulte o auxílio online CPYFRMIMPF para obter maiores
informações.
As tabelas de destino residem somente no sistema de arquivos QSYS. Você pode fazer alterações na etapa somente quando ela estiver no modo de desenvolvimento.
Antes do programa carregar novos dados na tabela, ele exporta a tabela para um arquivo de backup, que pode ser utilizado em recuperações.
A página Mapeamento da Coluna não está disponível nesta etapa.
Pré-requisitos: Para usar este programa, os seguintes PTFs devem estar aplicados no local do agente do AS/400:
Comando PTF: 5769SS100 VRM420 SF46911 Código PTF: 5769SS100 VRM420 SF46976 Manutenção PTF: 5769SS100 VRM420 SF49466
Estes PTFs fornecem os comandos CPYFRMIMPF e CPYTOIMPF do AS/400 (LOAD e EXPORT), que são necessários para executar o programa
VWPLOADI. Estes PTFs também instalam o auxílio online para estes comandos.
Segurança: O perfil do usuário sob o qual este programa e o agente do warehouse são executados deve ter no mínimo autoridade de leitura/gravação na tabela que será carregada.
Requisitos: Os seguintes requisitos aplicam-se ao programa VWPLOADI. Para obter informações sobre as limitações do comando CPYFRMIMPF, consulte a seção de restrições do auxílio online do comando CPYFRMIMPF. Para exibir o auxílio online deste comando, digite CPYFRMIMPF no prompt de comandos do AS/400 e pressione F1.
1. A definição do Centro de Data Warehouse para o local do agente que está executando o programa deve incluir uma ID de usuário e uma senha. Não é necessário que o servidor de banco de dados esteja no local do agente. No entanto, o arquivo de origem deverá estar no servidor de banco de dados. Especifique o nome completo dos arquivos de origem, conforme definido no sistema do servidor do DB2.
2. Se o programa detectar uma falha durante o processamento, a tabela será esvaziada. Se o processo de carga gerar avisos, o programa retorna como concluído com sucesso.
3. O comportamento padrão de VWPLOADI é tolerar todos os erros dos dados recuperáveis durante LOAD (ERRLVL(*NOMAX)).
Para substituir este comportamento, inclua a palavra-chave ERRLVL(n) no parâmetro da cadeia fileMod, em que n = o número de erros recuperáveis permitidos.
Você pode encontrar mais informações sobre a palavra-chave ERRLVL no auxílio online do comando CPYFRMIMPF.
Para definir valores para uma etapa que utilize este programa:
1. Abra o bloco de notas da etapa.
2. Especifique as informações gerais sobre o programa. Para obter mais informações, consulte o manual “Fornecendo informações gerais sobre uma etapa” na página 151.
4. Opcional: Para especificar os delimitadores do programa de carga, clique em Especificar somente os delimitadores de MODSTRING. Do contrário, serão usadas entradas padrão nos campos Registro, Coluna, Cadeias de
caracteres e vírgula de Decimal.
Especifique os delimitadores para seu programa load:
v Na lista Registro, especifique como deseja indicar o final do registro. v Na lista Coluna, especifique o caractere que deseja usar como um
delimitador de coluna.
v No campo Cadeia de caracteres, especifique o caractere que deseja usar para indicar as cadeias de caracteres.
v No campo Ponto decimal, clique no caractere que deseja usar para indicar um ponto decimal.
5. Opcional: Para incluir parâmetros no programa, clique em Digitar
parâmetros de Modstring. Digite os parâmetros no campo sob o botão de opção.
Este campo é usado para modificar as características do arquivo que o comando CPYFRMIMPF espera que o arquivo de entrada tenham. Se este parâmetro for omitido, todos os valores padrão que o comando
CPYFRMIMPF esperar serão tidos como corretos.
Algumas características padrão do arquivo de entrada são: v O arquivo é delimitado por vírgulas.
v As cadeias e os valores de data/hora são colocados entre aspas. v Os valores de data e hora estão no formato ISO.
v O ponto decimal é representado por um caractere de pausa. Para obter maiores informações sobre os valores padrão do comando CPYFRMIMPF, consulte o auxílio online do AS/400 para o comando CPYFRMIMPF.
O formato da cadeia FileMod é:
a. A cadeia deve conter palavras-chave válidas do comando CPYFRMIMPF. Todas as palavras-chave válidas do comando CPYFRMIMPF estão descritas no auxílio online do comando.
b. Cada palavra-chave deve ser seguida imediatamente de seu valor. O valor deve ser colocado entre parênteses.
c. As palavras-chave devem ser separadas por um espaço.
Requisito: Certos parâmetros exigem os valores colocados entre aspas. Por exemplo, o comando FLDDLM deve ter os valores entre duas aspas. O Centro de Data Warehouse gera a instrução CALL do AS/400 para a VWPLOADI no formato:
Duas aspas juntas informam ao processador do prompt de comandos do AS/400 que seu valor de parâmetro contém uma aspa. Isto impede que o processador da linha de comandos confunda uma aspa com o marcador de final de parâmetro normal.
6. Na página Opções de Processamento, forneça informações sobre como sua etapa é processada. Para obter mais informações, consulte o manual “Definindo as opções de processamento” na página 153.
7. Clique em OK para salvar as alterações e feche o bloco de notas etapa.
Informações de rastreamento e diagnóstico: O programa VWPLOADI fornece dois tipos de informações de diagnóstico:
v O código de retorno, como documentado no auxílio online de Conceitos do Centro de Data Warehouse
v O rastreamento de VWPLOADI
Importante:A conclusão bem-sucedida deste programa não garante que os dados foram transferidos corretamente. Para tratamento de erros mais rígido, use o parâmetro ERRLVL.
Lendo o arquivo de rastreamento VWPLOADI: Os arquivos de rastreamento
VWPLOADI estão localizados no Sistema de Arquivos Integrados no diretório /QIBM/UserData/IWH.
O arquivo de rastreamento VWPLOADI possui o seguinte formato de nome: VWxxxxxxxx.VWPLOADI
em que xxxxxxxx indica a ID do processo da execução do VWPLOADI que produziu o arquivo.
Para exibir arquivos de rastreamento a partir de uma estação de trabalho:
1. Use o Client Access/400 para mapear o sistema de arquivos raiz do AS/400 para uma unidade lógica ou use o FTP para copiar o arquivo na estação de trabalho.
2. Abra o arquivo de rastreamento com um editor de texto para exibir as informações.
Exibindo o rastreamento VWPLOADI com o Client Access/400: Para que o Client
Access/400 mapeie um sistema AS/400 para uma unidade lógica numa estação de trabalho NT:
1. Configure a conexão do Client Access/400 para seu sistema AS/400 em TCP/IP.
2. Abra o Windows NT File Explorer.
3. A partir do menu Explorer, clique em Ferramentas —Ê Mapear Unidade
4. Digite o nome do caminho: \\nome_do_host\.
em que nome_do_host indica o nome completo do host TCP/IP do sistema AS/400.
5. Dê um clique em OK.
Requisito:Se você usar o Client Access/400 para acessar o arquivo de rastreamento, deverá definir a extensão do arquivo .VWPLOADI para Client Access/400. A definição desta extensão permite que o Client Access/400 converta o conteúdo dos arquivos com esta extensão de EBCDIC para ASCII. Para definir uma extensão de arquivo para o Client Access/400:
1. No Windows NT, selecione Iniciar —Ê Programas —Ê IBM AS400 Client
Access —Ê Propriedades do Client Access. O bloco de notas Client Access é aberto.
2. Clique na guia Unidades de rede.
3. No campo Extensão de arquivo:, digite .VWPLOADR.
4. Clique em Incluir.
5. Clique em Aplicar.
6. Dê um clique em OK.
Agora você conseguirá carregar o arquivo em qualquer editor de textos ou processador de textos ASCII.
Exceções do AS/400: Se ocorreu falha em algum comando do sistema emitido
pelo VWPLOADI, haverá um código de exceção registrado no arquivo de rastreamento VWPLOADI. Para obter uma explicação da exceção:
1. Num prompt de comandos do AS/400, digite DSPMSGD RANGE(xxxxxxx), em que xxxxxxx indica o código de exceção. Por exemplo, você pode digitar DSPMSGD RANGE(CPF2817).
O painel Exibir Texto da Mensagem Formatada é aberto.
2. Selecione a opção 30 para exibir todas as informações. Uma mensagem semelhante à seguinte é exibida:
ID da Mensagem . . . : CPF2817 Arquivo da mensagem . . . . : QCPFMSG Biblioteca . . . : QSYS
Mensagem . . . : O comando copy foi encerrado devido a erro. Causa . . . : Ocorreu um erro durante a cópia
do arquivo.
Recuperação . . : Consulte as mensagens relacionadas anteriormente. Corrija os erros e, em seguida, repita
A segunda linha no arquivo de rastreamento VWPLOADR contém as informações que são necessárias para emissão do comando WRKJOB. Para exibir o arquivo em spool, você pode cortar e colar o nome do arquivo da mensagem num prompt de comandos do AS/400 depois do comando WRKJOB e pressionar Enter. Exiba o arquivo em spool para o job para obter informações adicionais sobre quaisquer erros que possam ser encontrados.
Definindo valores para um programa Substituição da Carga de Dados do DB2 UDB para AS/400 (VWPLOADR)
Use o programa Substituição da Carga de Dados do DB2 UDB para AS/400 (VWPLOADR) para carregar dados de um arquivo simples para uma tabela do DB2 UDB para AS/400. A operação de carregamento substitui
completamente os dados existentes na tabela.
Antes de definir esta subtipo de etapa, você deve conectar a etapa a uma origem do warehouse e um destino do warehouse no Modelador de Processo. Os arquivo de origem aceitáveis para a implementação do AS/400 do
programa VWPLOADR são membros do arquivo de origem QSYS do AS/400 ou os arquivos de fluxo no Sistema de Arquivos Integrados (Integrated File System - IFS), o sistema de arquivos da raiz.
Dica:Aprimore o desempenho e o uso da memória através dos membros do arquivo QSYS em vez dos arquivos de fluxo. O CPYFRMIMPF copia o
arquivo de fluxo inteiro em QRESTORE e, em seguida, carrega a cópia em sua tabela. Consulte o auxílio online CPYFRMIMPF para obter maiores
informações.
As tabelas de destino residem somente no sistema de arquivos QSYS. Você pode fazer alterações na etapa somente quando ela estiver no modo de desenvolvimento.
A página Mapeamento da Coluna não está disponível nesta etapa.
Pré-requisitos: Para usar este programa, os seguintes PTFs devem estar aplicados no local do agente do AS/400:
Comando PTF: 5769SS100 VRM420 SF46911 Código PTF: 5769SS100 VRM420 SF46976 Manutenção PTF: 5769SS100 VRM420 SF49466
Estes PTFs fornecem os comandos CPYFRMIMPF e CPYTOIMPF do AS/400 (LOAD e EXPORT). Tais comandos fazem o programa VWPLOADR operar. Estes PTFs também instalam o auxílio online para estes comandos.
Segurança: O perfil do usuário sob o qual este programa e o agente do warehouse são executados deve ter no mínimo autoridade de leitura/gravação na tabela que será carregada.
Requisitos: Os seguintes requisitos aplicam-se ao programa VWPLOADR. Para obter informações sobre as limitações do comando CPYFRMIMPF, consulte a seção de restrições do auxílio online do comando CPYFRMIMPF. Para exibir o auxílio online deste comando, digite CPYFRMIMPF no prompt de comandos do AS/400 e pressione F1.
v A definição do Centro de Data Warehouse para o local do agente que está executando o programa deve incluir uma ID de usuário e uma senha. Não é necessário que o servidor de banco de dados esteja no local do agente. No entanto, o arquivo de origem deverá estar no servidor de banco de dados. Especifique o nome completamente qualificado dos arquivos de origem, conforme definido no servidor do DB2.
v Se o programa detectar uma falha durante o processamento, a tabela será esvaziada. Se o carregamento gerar avisos, o programa apresentará uma conclusão com êxito.
v Esta implementação do programa VWPLOADR difere do VWPLOADR nas outras plataformas. Especificamente, não excluirá todos os registros
carregados se a operação de carga falhar por algum motivo.
Normalmente, este programa substitui tudo na tabela de destino sempre que é executado e elimina automaticamente os registros de uma execução que tenha falhado. Contudo, se a operação de carga falhar, evito o uso de dados na tabela de destino. Se houver dados na tabela de destino, eles não estarão completos.
v O comportamento padrão de VWPLOADR é tolerar todos os erros dos dados recuperáveis durante LOAD (ERRLVL(*NOMAX)).
Para substituir este comportamento, inclua a palavra-chave ERRLVL(n) no parâmetro da cadeia fileMod, em que n = o número de erros recuperáveis permitidos.
Você pode encontrar mais informações sobre a palavra-chave ERRLVL no auxílio online do comando CPYFRMIMPF.
Para definir valores para uma etapa que utilize este programa:
1. Abra o bloco de notas da etapa.
2. Especifique as informações gerais sobre o programa. Para obter mais informações, consulte o manual “Fornecendo informações gerais sobre uma etapa” na página 151.
3. Clique na guia Parâmetros.
4. Opcional: Se deseja especificar os delimitadores do programa de carregamento, clique em Especificar somente os delimitadores de
MODSTRING. Se você não clicar neste botão de opção, as entradas padrão nos campos Registro, Coluna, Cadeia de caracteres e Ponto decimal serão tidas como corretas.
5. Se você clicou em Especificar somente delimitadores de MODSTRING, especifique os delimitadores do programa de carregamento:
v Na lista Registro, especifique como deseja indicar o final do registro. v Na lista Coluna, especifique o caractere que deseja usar como um
delimitador de coluna.
v No campo Cadeia de caracteres, especifique o caractere que deseja usar para indicar as cadeias de caracteres.
v No campo Ponto decimal, clique no caractere que deseja usar para indicar um ponto decimal.
6. Opcional: Para incluir outros parâmetros no programa, clique em Digitar
parâmetros de Modstring. Digite os parâmetros no campo sob o botão de opção.
Este campo é usado para modificar as características do arquivo que o comando CPYFRMIMPF espera que o arquivo de entrada tenham. Se este parâmetro for omitido, todos os valores padrão que o comando
CPYFRMIMPF esperar serão tidos como corretos.
Algumas características padrão do arquivo de entrada são: v O arquivo é delimitado por vírgulas.
v As cadeias e os valores de data/hora são colocados entre aspas. v Os valores de data e hora estão no formato ISO.
v O ponto decimal é representado por um caractere de pausa. Para obter maiores informações sobre os valores padrão do comando CPYFRMIMPF, consulte o auxílio online do AS/400 para o comando CPYFRMIMPF.
O formato da cadeia FileMod é:
a. A cadeia deve conter palavras-chave válidas do comando CPYFRMIMPF. Todas as palavras-chave válidas do comando CPYFRMIMPF estão descritas no auxílio online do comando.
b. Cada palavra-chave deve ser seguida imediatamente de seu valor. O valor deve ser colocado entre parênteses.
c. As palavras-chave devem ser separadas por um espaço.
Atenção: Certos parâmetros exigem os valores colocados entre aspas. Por exemplo, o comando FLDDLM deve ter os valores entre duas aspas. Isto deve ser feito porque o Centro de Data Warehouse gera a instrução CALL do AS/400 para VWPLOADI no formato:
Duas aspas juntas informam ao processador do prompt de comandos do AS/400 que seu valor de parâmetro contém uma aspa simples. Isto impede que o processador da linha de comandos confunda a aspa com o marcador de final de parâmetro normal.
7. Na página Opções de Processamento, forneça informações sobre como sua etapa é processada. Para obter mais informações, consulte o manual “Definindo as opções de processamento” na página 153.
8. Clique em OK para salvar as alterações e feche o bloco de notas etapa.
Informações de rastreamento e diagnóstico: O programa VWPLOADR fornece dois tipos de informações de diagnóstico:
v O código de retorno, como documentado no auxílio online de Conceitos do Centro de Data Warehouse
v O rastreamento VWPLOADR
Importante:A conclusão bem-sucedida deste programa não garante que os dados foram transferidos corretamente. Para tratamento de erros mais rígido, use o parâmetro ERRLVL.
Lendo o arquivo de rastreamento VWPLOADR: Os arquivos de rastreamento
VWPLOADR estão localizados no Sistema de Arquivos Integrados no diretório /QIBM/UserData/IWH.
O arquivo de rastreamento VWPLOADR possui o seguinte formato de nome: VWxxxxxxxx.VWPLOADR
em que xxxxxxxx indica a ID do processo da execução do VWPLOADR que produziu o arquivo.
Para exibir arquivos de rastreamento a partir de uma estação de trabalho:
1. Use o Client Access/400 para mapear o sistema de arquivos raiz do AS/400 para uma unidade lógica ou use o FTP para copiar o arquivo na estação de trabalho.
Para obter informações sobre como usar o Client Access/400, consulte “Exibindo o rastreamento VWPLOADR através do Client Access/400”.
2. Abra o arquivo de rastreamento com um editor de texto para exibir as informações.
Exibindo o rastreamento VWPLOADR através do Client Access/400: Para que o
Client Access/400 mapeie um sistema AS/400 para uma unidade lógica numa estação de trabalho NT:
1. Configure a conexão do Client Access/400 para seu sistema AS/400 em TCP/IP.
3. A partir do menu Explorer, selecione Ferramentas —Ê Mapear Unidade de
Rede.