Usando SQLJ integrados com o DB2 for z/OS Legacy driver

O Structured Query Language in Java™ (SQLJ) é um conjunto de extensões de programação que permitem que um programador, usando a linguagem de programação Java, integre instruções que fornecem solicitações de banco de dados do Structured Query Language (SQL). É possível usar o driver herdado do DB2 para z/OS com seus aplicativos de acesso a dados.

Sobre Esta Tarefa

Notes:
  1. Para usar o SQLJ com o WebSphere Application Server for z/OS e o DB2 for z/OS Legacy Driver, instale o DB2 APAR PQ76442.
  2. Beans CMP (Container Managed Persistence) gerados usando SQLJ não são suportados pelo driver herdado do DB2 para z/OS. Use o DB2 Universal Driver para CMPs gerados usando SQLJ.

A seguir, as etapas necessárias para desenvolver aplicativos com SQLJ que executam no WebSphere Application Server para z/OS v6.0 usando o driver herdado do DB2 para z/OS.

Procedimento

  1. Projete seu aplicativo no Rational Application Developer de acordo com seus requisitos usando o SQLJ quando necessário. Por exemplo, se você desenvolver um bean denominado Test que utiliza o BMP, codifique TestBean.sqlj (em vez de TestBean.java).
    1. A partir da instalação do seu DB2 for z/OS, copie o arquivo db2sqljclasses.zip para um diretório na sua estação de trabalho e, em seguida, modifique Java Build Path do seu projeto Java archive (JAR) EJB para incluir o arquivo db2sqljclasses.zip.
    2. Converta seu código SQLJ de acordo com as seguintes etapas:
      1. Localize seu arquivo SQLJ, depois use a transferência de modo ASCII para colocá-lo em FTP em um HFS de seu ambiente z/OS.
      2. Use o comando sqlj para converter o código SQLJ em código Java. Dois arquivos são produzidos, um com uma extensão .java e outro com uma extensão .ser.
        sqlj -compile=false SQLJ_FILE_NAME
      3. Use o modo ASCII para transferir para o arquivo e .java e a transferência de modo BINARY para o arquivo .ser para mover estes arquivos de volta para o diretório na sua estação de trabalho onde o arquivo SQLJ reside.
      4. Atualize o projeto.
    3. Gere o código de implementação para o aplicativo.
    4. Exporte o arquivo EAR.
  2. Instale o aplicativo
    1. Crie uma origem de dados com o DB2 for zOS Local JDBC Provider (RRS). Quando definir seu Provedor JDBC e origem de dados, os valores padrão são suficientes para fornecer suporte para o SQLJ.
    2. Instale seu aplicativo no WebSphere Application Server.

      Utilize a origem de dados criada na Etapa 1 para resolver as referências de recursos.

  3. Personalize os perfis serializados Ao gerar o código de implementação, os perfis serializados, ou arquivos com uma extensão .ser, especificados para o aplicativo, são criados. Esses perfis devem ser customizados em um ambiente z/OS antes de serem usados.
    1. Use a transferência binária para os perfis serializados para o ambiente z/OS no qual você instalou seu aplicativo. Como alternativa, use o comando jar Java para extrair os perfis serializados do arquivo JAR EJB em seu diretório EAR instalado.
    2. Utilize o comando db2profc para personalizar os perfis serializados. É possível obter informações sobre as várias opções associadas a este comando a partir da documentação do DB2, entretanto, a seguir há os requisitos mínimos para customizar seu perfil:
      db2profc -pgmname=PROGRAM_NAME PROFILE_NAME
      • Em que:
        • PROGRAM_NAME deve ser um nome de membro MVS PDS válido e pode ter até sete caracteres.
        • PROFILE_NAME é o nome do perfil serializado que deseja personalizar. Você deve executar db2profc uma vez para cada perfil.
      • O customizador de perfil cria quatro conjuntos de dados DBRM no PDS USERNAME.DBRMLIB.DATA. Os nomes de membros de DBRMs iniciam com o que foi especificado como PROGRAM_NAME.
      • Assegure-se de que a variável de ambiente CLASSPATH inclui:
        • O local do perfil serializado
        • O arquivo JAR EJB no seu diretório EAR instalado
      • Aloque um PDS para conter os DBRMs criados. Nomeie este PDS USERNAME.DBRMLIB.DATA, em que USERNAME é o usuário que implementa o comando db2profc.
        Os campos a seguir são exemplos:
        Space units=TRACK
        Primary quantity=15
        Secondary quantity=5
        Directory blocks=10
        Record format=FB
        Record length=80
        Block size=27920
        Data set name type=PDS
    3. Coloque os perfis serializados existentes, que estão agora customizados, em um local que faça parte do caminho de classe do aplicativo e que estejam à frente dos perfis serializados que existirem no seu arquivo JAR EJB.

      A saída do customizador de perfil do DB2 e o arquivo de entrada têm o mesmo nome. Mova o arquivo de saída à frente do perfil serializado original no caminho de classe. Como alternativa, é possível mover o perfil customizado no arquivo JAR EJB, substituindo o original. É recomendado substituir o arquivo original.

      IMPORTANTE: Se o comando db2profc for executado a partir do diretório em que o perfil serializado existe, o personalizador de perfis sobrescreve o perfil serializado. Como é necessária apenas a versão personalizada após a execução do personalizador de perfis, isso não é um problema.

    4. Ligue os DBRMs em um pacote.
      Nota: Você deve criar as tabelas de bancos de dados antes de ligar os DBRMs. Se não fizer isso, a tarefa de ligação falhará.

      O comando de personalização db2profc cria uma série de DBRMs que devem estar ligados nos pacotes. Para cada perfil personalizado, são criados quatro DBRMs.

      Esses DBRMs:
      • Estão localizados em USERNAME.DBRMLIB.DATA
      • Todos possuem nomes que iniciam com o que foi especificado como PROGRAM_NAME
      • São numerados de 1 a 4

        Por exemplo, se efetuar login como IBMUSER e especificar -pgmname=TESTBMP e, em seguida, execute o comando db2profc, para que os quatro conjuntos de dados, TESTBMP1, TESTBMP2, TESTBMP3 e TESTBMP4 sejam criados e colocados no PDS IBMUSER.DBRMLIB.DATA.

        Esses conjuntos de dados devem ser incluídos em pacotes com isolamento de UR, CS, RS e RR. Você deve executar uma ligação para cada perfil serializado personalizado.

    5. Após ligar todos os DBRMs nos pacotes, ligue os pacotes em um plano. Nomeie o plano como desejar.

      IMPORTANTE: Você deve também incluir os pacotes JDBC na lista de pacotes (PKLIST) do novo plano. Os nomes padrão para pacotes JDBC para inclusão são DSNJDBC.DSNJDBC1, ..., DSNJDBC.DSNJDBC4. Se sua instalação não usou os nomes padrão para os pacotes JDBC, entre em contato com o administrador do DB2 para determinar os nomes dos pacotes JDBC que você precisa incluir.

      A seguir, há um job de amostra utilizado para ligar uma novo plano.
      • Um perfil serializado foi criado ao efetuar logon como IBMUSER.
      • -pgmname=TESTBMP foi especificado para executar db2profc.
      • O novo plano é denominado SQLJPLAN.
      //BBOOLS  JOB (516B,1025),'IBMUSER',MSGCLASS=H,CLASS=A,PRTY=14,
      //         NOTIFY=&SYSUID,TIME=1440,USER=IBMUSER,PASSWORD=IBMUSER,
      //         MSGLEVEL=(1,1)
      //********************************************************************
      //BINDOLS  EXEC PGM=IKJEFT01,DYNAMNBR=20
      //DBRMLIB  DD  DSN=IBMUSER.DBRMLIB.DATA,DISP=SHR
      //*        DD  DSN=MVSDSOM.DB2710.SDSNDBRM,DISP=SHR
      //SYSTSPRT   DD SYSOUT=*
      //SYSPRINT DD SYSOUT=*
      //SYSUDUMP DD  SYSOUT=*
      //SYSTSIN    DD *
      
       DSN SYSTEM(DB2)
      
       BIND -
           PACKAGE(TESTBMP) -
           QUALIFIER(IBMUSER)                 -
           MEMBER(TESTBMP1) -
           VALIDATE(BIND) -
           ISOLATION(UR) -
           SQLERROR(NOPACKAGE) -
      
       BIND -
           PACKAGE(TESTBMP) -
           QUALIFIER(IBMUSER)                 -
           MEMBER(TESTBMP2) -
           VALIDATE(BIND) -
           ISOLATION(CS) -
           SQLERROR(NOPACKAGE) -
      
       BIND -
           PACKAGE(TESTBMP) -
           QUALIFIER(IBMUSER)                 -
           MEMBER(TESTBMP3) -
           VALIDATE(BIND) -
           ISOLATION(RS) -
           SQLERROR(NOPACKAGE) -
      
       BIND -
           PACKAGE(TESTBMP) -
           QUALIFIER(IBMUSER)                 -
           MEMBER(TESTBMP4) -
           VALIDATE(BIND) -
           ISOLATION(RR) -
           SQLERROR(NOPACKAGE) -
      
      
       BIND PLAN(SQLJPLAN)                 -
        QUALIFIER(IBMUSER)                 -
        PKLIST(TESTBMP.*                   -
               DSNJDBC.*                 ) -
        ACTION(REPLACE) RETAIN             -
        VALIDATE(BIND)
      
      END
      /*
    6. Conceda autoridade apropriada para seu novo plano. Use uma interface para DB2, como SPUFI, para conceder autoridade. Emita este comando:
      GRANT EXECUTE ON PLAN PLANNAME TO APPSERVERID 
      Em que:
      • PLANNAME é o nome do plano ligado.
      • APPSERVERID é o ID no qual o WebSphere Application Server executa; por exemplo, CBSYMSR1.
  4. Configure sua origem de dados para usar o novo plano
    1. No Console Administrativo do WebSphere Application Server para z/OS, navegue até Origem de Dados e selecione Propriedades Customizadas.
    2. Selecione a Propriedade Customizada planName.
    3. Atualize o valor de planName com o nome dado ao plano quando ligado.
    4. Defina enableSQLJ como true.
  5. Pare e reinicie o servidor.
  6. Execute o aplicativo.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_sqljdb2zos
Nome do arquivo: tdat_sqljdb2zos.html