Sumário

Search

  1. Prefácio
  2. Introdução ao PowerExchange
  3. Arquivo de Configuração DBMOVER
  4. Trabalhos Netport
  5. Logs de Mensagens do PowerExchange e Substituições de Destinos
  6. Log de estatísticas do SMF e Relatórios
  7. Segurança do PowerExchange
  8. Suporte a Secure Sockets Layer
  9. Segurança de Rede Alternativa do PowerExchange
  10. SQL Não Relacional do PowerExchange
  11. Globalização do PowerExchange
  12. Usando os Drivers ODBC do PowerExchange
  13. Tipos de Dados e Matriz de Conversão do PowerExchange
  14. Apêndice A: Carimbos de Data/Hora DTL__CAPXTIMESTAMP
  15. Apêndice B: Glossário do PowerExchange

Manual de Referência

Manual de Referência

Instrução DB2CODEPAGE

Instrução DB2CODEPAGE

A instrução DB2CODEPAGE define CCSIDs de byte único, gráficos e mistos que são usados pelo PowerExchange para processar dados das colunas CHAR e VARCHAR em um subsistema do DB2 for z/OS que esteja envolvido na movimentação de dados em massa.
z/OS
DB2 for z/OS
Não
DB2CODEPAGE=(
db2_subsystem
[,DB2TRANS={
P
|N|R}]   [,MIXED={
N
|Y}]  [,EBCDIC_CCSID=({
sbcs_ccsid
|
037
} ,{
graphic_ccsid
|
037
} ,{
mixed_ccsid
|
037
})]  [,ASCII_CCSID=({
sbcs_ccsid
|
850
} ,{
graphic_ccsid
|
65534
} ,{
mixed_ccsid
|
65534
})]   [,UNICODE_CCSID=({
sbcs_ccsid
|
367
} ,{
graphic_ccsid
|
1200
} ,{
mixed_ccsid
|
1208
})]  [,PLAN_CCSID=({
sbcs_ccsid
|
037
} ,{
graphic_ccsid
|
037
} ,{
mixed_ccsid
|
037
})] [,REMAP
n
=(
current_data_ccsid
),(
remapped_data_ccsid
) )
db2_subsystem
Obrigatório. O identificador de subsistema do DB2 (SSID) de um subsistema de origem ou destino.
DB2TRANS={
P
|N|R}
Indica se o DB2 converte a codificação de dados que transmite para ou recebe do PowerExchange. As opções são:
  • P
    . O DB2 converte as páginas de código nas quais os dados de coluna estão armazenados nas páginas de código definidas no plano do DB2 que foi associado ao PowerExchange. Você também deve especificar o parâmetro EBCDIC_CCSID e, opcionalmente, o parâmetro PLAN_CCSID. Se você especificar ambos, o parâmetro PLAN_CCSID terá precedência. Se você tiver dados ASCII e Unicode, poderá também especificar os parâmetros ASCII_CCSID e UNICODE_CCSID para mapear para as páginas de código EBCDIC.
    Para usar qualquer um dos parâmetros *_CCSID, será necessário definir DB2TRANS como P.
  • N
    . O DB2 não converte as páginas de código dos dados de coluna em páginas de código EBCDIC equivalentes. O PowerExchange utiliza a página de código nativa na qual os dados estão armazenados. Não é necessário definir os parâmetros EBCDIC_CCSID, ASCII_CCSID, UNICODE_CCSID ou PLAN_CCSID.
  • R
    . O DB2 converte determinadas páginas de código de dados especificados pelo usuário em outras páginas de código, conforme definido em um ou mais parâmetros REMAP
    n
    . Em cada parâmetro REMAP
    n
    , o primeiro parâmetro posicional identifica uma página de código de dados a ser remapeada e o segundo parâmetro posicional identifica a página de código a ser usada. Use uma página de código diferente da página de código à qual o plano do DB2 do PowerExchange está associado.
O padrão é P.
MIXED={
N
|Y}
Indica se as colunas do DB2 contêm strings de caracteres ASCII e EBCDIC com dados mistos e gráficos. Dados mistos consistem em caracteres de byte único e byte duplo, enquanto dados gráficos consistem em caracteres de byte duplo.
As opções são:
  • N.
    Colunas com strings de caracteres ASCII e EBCDIC contêm somente dados de byte único (SBCS). Não ocorrem dados mistos e gráficos.
  • Y.
    Colunas com strings de caracteres ASCII e EBCDIC contêm dados mistos e gráficos.
O padrão é N.
EBCDIC_CCSID=({
sbcs_ccsid
|
037
},{
graphic_ccsid
|
037
},{
mixed_ccsid
|
037
})
Obrigatório se DB2TRANS=P (padrão). Os CCSIDs a serem usados em dados EBCDIC de byte único, gráficos de byte duplo e mistos (byte único e byte duplo).
Os valores válidos variam de 1 a 65534 para cada subparâmetro posicional. Um valor de 65534 indica que não existe um CCSID.
Os valores padrão de 037,037,037 serão usados se você não especificar a instrução DB2CODEPAGE ou se aceitar os valores do Assistente de Instalação do z/OS sem modificação. Se você tiver alterado esses valores durante a instalação, o Assistente de Instalação personalizará a instrução DB2CODEPAGE no arquivo DBMOVER com os valores inseridos.
Se uma página de código EBCDIC não tiver uma tabela de conversão ICU, ou se a página de código EBCDIC for diferente daquela na qual o plano do DB2 para PowerExchange está associado, você poderá usar o parâmetro PLAN_CCSID de forma a mapear para outra página de código EBCDIC que tenha uma tabela de conversão ICU ou que reflita o plano do DB2.
O DB2 envia dados para o PowerExchange em uma página de código EBCDIC, mesmo quando os dados estão armazenados fisicamente em uma página de código ASCII ou Unicode. As tabelas de catálogo do DB2 são armazenadas em UTF-8, que corresponde ao CCSID 1208. Esse CCSID é remapeado do valor da página de código UNICODE_CCSID
mixed_ccsid
para o valor da página de código EBCDIC_CCSID
mixed_ccsid
.
Em sistemas de byte único, repita a página de código SBCS três vezes ou use 65534 com o parâmetro MIXED=N. Por exemplo:
EBCDIC_CCSID=(1047,1047,1047)
ou
DB2CODEPAGE=(D91G,EBCDIC_CCSID=(1047,65534,65534),MIXED=N)
O PowerExchange usa a página de código EBCDIC de byte único.
ASCII_CCSID=({
sbcs_ccsid
|
850
},{
graphic_ccsid
|
65534
},{
mixed_ccsid
|
65534
})
Opcional. Os CCSIDs a serem usados em dados ASCII de byte único, gráficos e mistos. Especifique esse parâmetro somente se o subsistema contiver dados codificados em ASCII que estão envolvidos na movimentação de dados em massa. O PowerExchange mapeia essas páginas de código ASCII para as páginas de código EBCDIC equivalentes que estão definidas no parâmetro EBCDIC_CCSID. Inclua também o parâmetro EBCDIC_CCSID.
Os valores válidos variam de 1 a 65534 para cada subparâmetro. Um valor de 65534 indica que não existe um CCSID.
O Assistente de Instalação do z/OS insere os valores 850,65534,65534, a menos que você os altere durante a instalação.
UNICODE_CCSID=({
sbcs_ccsid
|
367
},{
graphic_ccsid
|
1200
},{
mixed_ccsid
|
1208
})
Opcional. Os CCSIDs para dados Unicode de byte único, gráficos e mistos. O PowerExchange mapeia essas páginas de código Unicode para as páginas de código EBCDIC equivalentes que estão definidas no parâmetro EBCDIC_CCSID. Inclua também o parâmetro EBCDIC_CCSID.
Os valores válidos variam de 1 a 65534 para cada subparâmetro. Um valor de 65534 indica que não existe um CCSID.
Os valores padrão de 367,1208,1200 serão usados se você não especificar a instrução DB2CODEPAGE ou se tiver aceito os valores do Assistente de Instalação do z/OS sem nenhuma modificação. Normalmente, esses valores padrão são adequados.
No DB2 Versão 8.1 e posteriores, as tabelas de catálogo do DB2 são armazenadas em UTF-8, que corresponde ao CCSID 1208.
PLAN_CCSID=({
sbcs_ccsid
|
037
},{
graphic_ccsid
|
037
},{
mixed_ccsid
|
037
})
Opcional. Os CCSIDs a serem usados nos dados de byte único, gráficos e mistos de EBCDIC em vez dos que estão no parâmetro EBCDIC_CCSID. Use esse parâmetro quando você precisar redirecionar as páginas de código EBCDIC para outras páginas de código EBCDIC.
Por exemplo, use esse parâmetro nas seguintes situações:
  • As páginas de código EBCDIC_CCSID não têm uma tabela de conversão ICU que o PowerExchange possa usar na conversão de página de código baseada em ICU.
  • As páginas de código EBCDIC_CCSID correspondem às páginas de código padrão que foram definidas no subsistema do DB2, mas são diferentes das páginas de código EBCDIC de uma determinada tabela de origem ou destino.
O padrão é 037,037,037.
REMAP
n
=(
current_data_ccsid
,
remapped_data_ccsid
)
Opcional. Se você especificou DB2TRANS=R, poderá usar esse parâmetro para que o DB2 remapeie a página de código na qual os dados estão armazenados para outra página de código que você especificar. Por exemplo, se você tiver dados ASCII que não são mapeados para a página de código à qual o plano do DB2 é associado e que não têm um conversor ICU, use esse parâmetro para remapear a página de código ASCII para uma página de código EBCDIC com suporte.
Como alternativa, se você especificou DB2TRANS=N, o DB2 não converterá ou remapeará os dados. No entanto, PowerExchange pode usar a instrução REMAP
n
para substituir a página de código correta pela incorreta. Por exemplo, o DB2 pode relatar uma página de código de dados que não corresponde à página de código definida no catálogo do DB2, provavelmente porque os dados foram carregados incorretamente. Nesse caso, você pode especificar a página de código correta no parâmetro REMAP
n
.
Você pode especificar até seis parâmetros REMAP
n
em uma instrução DB2CODEPAGE, um para cada tabela do DB2 diferente. Incremente o número
n
ao final dos nomes de parâmetro para que todos os nomes sejam exclusivos.
  • Se um Ouvinte do PowerExchange estabelecer conexão com um subsistema do DB2 cuja instrução DB2CODEPAGE não existe, o PowerExchange usará a página de código do Ouvinte do PowerExchange.
  • Durante a instalação do PowerExchange, um trabalho de associação vincula o plano do DB2 para o PowerExchange como EBCDIC, sem especificar os CCSIDs. Como resultado, o PowerExchange usa os CCSIDs padrão de programação de aplicativo que foram definido para o subsistema do DB2 quando este foi criado. O PowerExchange recupera esses CCSIDs das tabelas de catálogo do DB2 e os utiliza junto com os parâmetros DB2CODEPAGE para determinar a página de código a ser usada.
  • Os valores que você define para a instrução DB2CODEPAGE devem corresponder aos valores especificados para o subsistema do DB2 no painel de padrões de programação de aplicativo, DSNTIPF. Se você não tiver especificado um valor para os CCSIDs gráficos ou mistos no DB2, especifique 65534 para os parâmetros
    graphic_ccsid
    e
    mixed_ccsid
    na instrução DB2CODEPAGE.
    Se os CCSIDs que você especificou para o subsistema do DB2 forem diferentes dos CCSIDs padrão DB2CODEPAGE, você deverá editar a instrução DB2CODEPAGE para corresponder aos CCSIDs do DB2.
    A seguinte tabela mostra as opções de configuração do DB2 no painel DSNTIPF e no módulo de carregamento DSNHDECP que correspondem aos parâmetros DB2CODEPAGE:
    Parâmetro DB2CODEPAGE
    Campo DSNTIPF
    Parâmetro DSNHDECP
    EBCDIC_CCSID
    EBCDIC CCSID
    SCCSID (byte único), MCCSID (combinado), GCCSID (gráfico)
    ASCII_CCSID
    ASCII CCSID
    ASCCSID (byte único), AMCCSID (combinado) AGCCSID (gráfico)
    UNICODE_CCSID
    UNICODE CCSID
    USCCSID (byte único), UMCCSID (combinado), UGCCSID (gráfico)
    MIXED
    MIXED DATA
    MIXED
    Para obter mais informações sobre valores do CCSID e seus significados, consulte o IBM
    DB2 for z/OS Installation Guide
    conforme a versão do DB2.
  • Se você clicar em
    Parâmetros Avançados
    na página
    Parâmetros do DB2
    do Assistente de Instalação do z/OS, poderá inserir valores de CCSID para os seguintes parâmetros:
    • DB2CODEPAGE_ASCII_DBCS_CCSID
    • DB2CODEPAGE_ASCII_MIXED_CCSID
    • DB2CODEPAGE_ASCII_SBCS_CCSID
    • DB2CODEPAGE_EBCDIC_DBCS_CCSID
    • DB2CODEPAGE_EBCDIC_MIXED_CCSID
    • DB2CODEPAGE_EBCDIC_SBCS_CCSID
    • DB2CODEPAGE_MIXED
    • DB2CODEPAGE_UNICODE_DBCS_CCSID
    • DB2CODEPAGE_UNICODE_MIXED_CCSID
    • DB2CODEPAGE_UNICODE_SBCS_CCSID
    Esses parâmetros de instalação preenchem os parâmetros EBCDIC_CCSID, ASCII_CCSID, e UNICODE_CCSID na instrução DB2CODEPAGE do arquivo DBMOVER. Você poderá editá-los no arquivo DBMOVER, se necessário.
  • O PowerExchange gera automaticamente uma especificação DB2CODEPAGE mínimo que incluirá os parâmetros UNICODE_CCSID e EBCDIC_CCSID se nenhum parâmetro DB2CODEPAGE for definido. O parâmetro UNICODE_CCSID é incluído porque tabelas de catálogo do DB2 usam a codificação Unicode.
  • A instrução DB2CODEPAGE se aplica somente a operações de movimentação de dados em massa. Para o CDC do DB2, o PowerExchange sempre usa a página de código nativa dos dados do DB2.
  • A instrução DB2CODEPAGE não afeta a instrução CODEPAGE. Se você usar a instrução DB2DEF_ENCODING, em determinados casos, talvez seja necessário editar a instrução DB2CODEPAGE para definir o valor de
    mixed_ccsid
    como 037 nos parâmetros ASCII_CCSID, EBCDIC_CCSID e UNICODE_CCSID que correspondem à opção DB2DEF_ENCODING.
  • Se o PowerExchange tentar ler colunas que contenham dados VARGRAPHIC ou LOB em uma tabela de um subsistema de byte único e a configuração DB2CODEPAGE padrão de DB2TRANS=P estiver em vigor, o seguinte erro SQL poderá ser exibido:
    -332
    CHARACTER CONVERSION BETWEEN CCSID
    from_ccsid
    TO
    to_ccsid
    REQUESTED BY
    reason_code
    IS NOT SUPPORTED
    Se essa situação ocorrer, especifique DB2TRANS=N na instrução DB2CODEPAGE.