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.
- 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. .
- 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?
- 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.
- 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.
- É 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).
- 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.
- É 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).