Rational Developer para System z


Lição 1.1: Customizar o RAM PDS Incluindo uma Ação Customizada e Parâmetros no Modelo

Essa lição fornecerá resumidamente orientação sobre as etapas para incluir a ação customizada das Instruções e seus quatro parâmetros: value, string1, string2, e option, para o RAM PDS.
Esses parâmetros e ações serão incluídos no RAM PDS ao fornecer as informações apropriadas no arquivo CRA0VDEF. Para obter informações adicionais sobre as etapas nessa lição, consulte o Guia do Desenvolvedor do CARMA, Capítulo 4. Customizando uma API do RAM usando o CAF.
  1. Comece listando a(s) ação(ões) que você deseja estender para a API do RAM. Para essa amostra, inclua uma ação customizada, Instruções, com os seguintes atributos:
    • Nome: Instruções
    • Descrição: Fornece um exemplo de como implementar projetos de plug-in com pontos de extensão
    • ID da Ação: 100
    • ID do RAM: 00
    • Lista de parâmetros: value, string1, string2, option
    • Lista de valor de retorno:
    Dica: Se estiver sendo usado o PDS de Amostra enviado sem customização, os valores a seguir para o id de ação e o id do RAM devem estar corretos; entretanto, se você tiver incluído ou removido RAMs, ações customizadas ou parâmetros, certifique-se de que o id da ação é o próximo id de ação disponível e que o id do RAM corresponde ao RAM do PDS de Amostra. .
  2. Na descrição da ação customizada Instruções acima há parâmetros e valores de retorno listados. Cada um deles deve ser definido também no RAM. As descrições de cada um são:
    • Nome: value
    • Descrição: um valor numérico de um dígito
    • ID do Parâmetro: 000
    • ID do RAM: 00
    • Tipo: cadeia
    • Comprimento: 1
    • Constante: não
    • Valor-padrão: nenhum
    • Prompt: Insira um valor de um dígito:
    • Nome: string1
    • Descrição: uma cadeia de texto
    • ID do Parâmetro: 001
    • ID do RAM: 00
    • Tipo: cadeia
    • Comprimento: 10
    • Constante: não
    • Valor-padrão: nenhum
    • Prompt: Insira uma cadeia de texto curta:
    • Nome: string2
    • Descrição: uma cadeia de texto
    • ID do Parâmetro: 002
    • ID do RAM: 00
    • Tipo: cadeia
    • Comprimento: 10
    • Constante: não
    • Valor-padrão: nenhum
    • Prompt: Insira uma cadeia de texto curta:
    • Nome:option
    • Descrição: opção de sim ou não
    • ID do Parâmetro: 003
    • ID do RAM: 00
    • Tipo: cadeia
    • Comprimento: 1
    • Constante: não
    • Valor-padrão: nenhum
    • Prompt: Sim ou Não?
  3. Conhecer as ações, parâmetros e descrições de cada um ajudará a criar as declarações a serem incluídas no arquivos de configuração. Cada ação e parâmetro será definido em sua própria linha e seus metadados específicos serão especificados em um comprimento de byte predefinido.
    Dica: É possível também definir as ações e parâmetros sem usar os tamanhos de byte predefinidos para os metadados usando as guias como um delimitador. Certifique-se de consultar o Guia do Desenvolvedor do CARMA, Capítulo 4. Customizando um API do RAM usando o CAF para obter detalhes sobre esse formato alternativo.

    Para essa amostra, ao usar os tamanhos de byte predefinidos, a ação customizada Instruções é declarada como:

    A00100  000,001,002,003|

    Para cada um dos respectivos parâmetros, a declaração é:

    P00000  STRING          1               N
    P00001  STRING          10              N
    P00002  STRING          10              N
    P00003  STRING          1               N
    Nota: Para ações e parâmetros, os primeiros oito bytes do registro são chamados de chave de registro.
  4. Certifique-se de que não há conexões ativas entre o RAM do PDS de Amostra, o CARMA e o sistema host antes de continuar.
  5. É necessário incluir essas informações no FEK.SFEKVSM2(CRA0DEF) e garantir que todas as chaves de registro estejam na ordem alfanumérica. Use o script JCL localizado em FEK.#CUST.JCL(CRA$VDEF) para REPRO FEK.SFEKVSM2(CRA0DEF).
  6. Em seguida, para cada ação e parâmetro que serão definidos no arquivo CRA0VDEF, será necessário determinar uma definição correspondente no arquivo CRA0VSTR que contém qualquer informação dependente do idioma sobre a ação ou o parâmetro.
    Para essa amostra, a ação customizada seria definida no CRA0VSTR da seguinte maneira:
    EN_US   00037A00100  HowTo           For demonstration. Does nothing.
    Para cada parâmetro respectivo na amostra, as definições são:
    EN_US   00037P00000  value                           Enter a one-digit numerical value.
    EN_US   00037P00001  string1                         Enter a short string of text.
    EN_US   00037P00002  string2 	                       Enter a short string of text.
    EN_US   00037P00003  option                          Y/N?
    Nota: Para ações e parâmetros, os primeiros 21 bytes do registro são chamados de chave de registro.
  7. É necessário incluir essas informações no arquivo FEK.SFEKVSM2(CRA0VSTR) e garantir que todos os registros estejam na ordem alfanumérica. Use o script JCL localizado em FEK.#CUST.JCL(CRA$VSTR) para REPRO FEK.SFEKVSM2(CRA0VSTR).

Referências


Termos de Uso | Feedback



Este centro de informações foi desenvolvido com a tecnologia Eclipse. (http://www.eclipse.org)