Auxílios do VisualAge Generator


Assistente de Script

O Assistente de Script permite-lhe compor rápida e facilmente scripts simples em uma linguagem orientada a objetos (fornecida como parte do ambiente de desenvolvimento) sem a necessidade de aprender uma nova linguagem de programação. Estes scripts podem ser chamados a partir de funções VAGen e concedem acesso a partes não-VisualAge Generator, como interfaces gráficas com o usuário ou Enterprise JavaBeans (EJBs), durante a execução de sua lógica 4GL.

Os métodos desenvolvidos com o Assistente de Script são chamados de scripts ou objetos de scripts VAGen e estão associados à instância da classe (a GUIcliente) na qual são desenvolvidos. Você pode acessar estes scripts incluindo a palavra reservada EZESCRPT em uma função VAGen e especificando o nome do script literal ou um item de dados que contenha o nome do script. Os scripts chamados desta forma não podem exigir argumentos. O EZESCRPT não pode ser usado para passar argumentos para seus scripts, porém é possível compartilhar informações entre sua GUIcliente e suas partes 4GL através do armazenamento de dados em um registro colocado na superfície de formato livre da GUIcliente na qual o script está sendo desenvolvido.

O Assistente de Script irá conduzi-lo no processo de atribuição de nome de um script, declarando variáveis locais, escolhendo padrões (ações a serem executadas ou mensagens a serem enviadas) e selecionando objetos para obtenção e passagem de dados. Por exemplo, se uma condição especificada em sua função VAGen não for satisfeita pelos dados de entrada recebidos de uma GUIcliente, você pode indicar qual campo está com erro utilizando um Script do Objeto para alterar a cor daquele campo.

Consulte tarefas do Assistente de Script, para obter instruções detalhadas sobre o uso deste recurso.

Áreas

O Assistente de Script possui cinco áreas em cada janela que fornecem informações ou que permitem que você forneça dados e efetue seleções:

Texto de ação
O texto de ação é exibido na parte superior de cada painel e o direciona a fazer uma seleção ou digitar o texto para a etapa atual.

Texto no modo assistido
O Texto no modo assistido fornece informações adicionais sobre o que fazer em cada etapa e, quando apropriado, apresenta exemplos. Quando você inicia o Assistente de Script, o Texto no modo assistido é exibido. Você pode ativá-lo e desativá-lo selecionando o botão Modo Assistido.

Área de trabalho
A área de trabalho exibe um conjunto de campos nos quais você especifica a lógica e os dados a serem usados em seu script. Dependendo da etapa na qual você está trabalhando, campos diferentes são exibidos e os campos se modificam a medida que o script é desenvolvido. Consulte a seção no painel com o qual está operando para obter mais informações específicas sobre esta área.

Área do script
A área do script exibe o estado atual de seu script. Esta área é apenas para exibição, mas caso você saiba a sintaxe para a instrução que deseja incluir, você pode selecionar Instrução de formato livre a partir da área de trabalho e digitar instruções diretamente em uma janela de edição.

Você também pode utilizar o botão Voltar para remover, seqüencialmente, alterações que você incluiu, alterar uma etapa e depois usar o botão Próximo para incluir as seleções de volta.

Área de status
A área de status localizada próxima a base da janela fornece informações valiosas sobre as seleções a medida que você as efetua. Por exemplo, se após você efetuar uma seleção o botão Próximo não fica disponível, a barra de status solicita outra ação.

Campos

As seleções efetuadas a partir dos campos mostrados em cada painel determinam a função do seu script. Os primeiros três painéis que você utiliza são iguais para qualquer script gerado, mas os painéis subseqüentes variam de acordo com o que o script faz. O Assistente de Script o conduz nos seguintes painéis onde você pode:

Ao terminar de definir uma instrução, você pode salvar seu script e fechar o Assistente de Script VAGen selecionando Terminar. Você também pode optar por continuar definindo instruções adicionais selecionando Próximo para exibir o painel de seleção de padrão. Você não pode selecionar Terminar enquanto estiver no meio da definição de uma instrução.

Nome do Script

Digite um nome válido no campo Nome do Script. O nome é exibido com a sintaxe correta no campo Compor script.

Uma boa convenção de nomenclatura a ser usada é fazer com que o primeiro caractere do nome do script seja em minúscula e a primeira letra de palavras subseqüentes no nome do script sejam em maiúscula. Considere as seguintes diretrizes:

Comentário

Digite um comentário na área de trabalho. Ele é exibido com a sintaxe correta no campo Compor script.

Compor script

Veja o campo Compor script para saber qual o estado atual do seu script. Este campo é somente para leitura, porém é possível fazer alterações no que está sendo exibido efetuando as mesmas na área de trabalho. Observe que a medida que você seleciona o botão Voltar, as linhas são removidas desta área. Você também pode selecionar o texto no campo Compor script e copiá-lo para área de transferência utilizando as teclas padrões aceleradoras da área de transferência.

Depois, você pode optar por colar o script diretamente no editor de script do VisualAge Smalltalk e modificá-lo conforme necessário antes de salvá-lo. Se você criar um script desta forma, selecione Cancelar para fechar o Assistente de Script sem salvar.

Variável Local

Digite um nome para a variável no campo Variável local e siga as instruções no texto do Modo assistido no topo da janela. As variável declaradas são listadas na área de trabalho e exibidas com a sintaxe correta no campo Script composto.

Seleções de padrões

Selecione um padrão na área de trabalho. Uma explicação sobre a função do padrão selecionado ou da opção específica sob aquele padrão é exibida na área de Status próxima à base da janela.

Instrução de formato livre
Selecione Instrução de formato livre para exibir um painel no qual você pode fornecer uma ou mais instruções em seu script digitando-as diretamente na área de trabalho.
Nota:Caso você escolha este padrão, a sintaxe não será verificada ou corrigida para você.

Obter
Selecione Obter para obter um objeto e armazená-lo em uma variável. Selecione o botão expandir ao lado do padrão Obter para exibir uma lista de atributos específicos que você pode obter e armazenar. Se o atributo do objeto que você deseja obter não está sendo mostrado na lista, selecione Obter. Depois, selecione Próximo para exibir um painel no qual você pode selecionar uma parte e especificar o atributo que você deseja obter. Você também pode enviar uma mensagem para um objeto e obter e armazenar o resultado.
Nota:Se você selecionar um Campo como uma variável de recepção, certifique-se de que é um que você mesmo tenha definido. Você não deve tentar substituir o valor de um dos campos existentes na classe.

Enviar mensagem
Selecione Enviar mensagem para enviar uma mensagem para um objeto. Selecione o botão expandir ao lado do padrão Enviar mensagem para exibir uma lista de mensagens específicas que você pode enviar. Caso você não veja a mensagem que deseja enviar, selecione Enviar mensagem. Depois, selecione Próximo para exibir um painel no qual você pode selecionar uma parte e especificar a mensagem que deseja enviar.

Definir atributo
Selecione Definir atributo para definir o atributo de um objeto .

Selecione o botão expandir ao lado do padrão Definir atributo para exibir uma lista de atributos específicos que você pode definir. Caso você não esteja vendo o atributo que deseja definir, selecione Definir atributo. Depois, selecione Próximo para exibir um painel no qual você pode selecionar uma parte e especifique o atributo que deseja enviar.

Lista de partes

Selecione uma parte, recurso de parte ou expressão de literal a partir da lista de partes. O assistente irá solicitar que você selecione partes adicionais conforme necessário para completar o padrão. A lista de partes pode ser filtrada para mostrar apenas as partes que são válidas para uma determinada etapa na especificação da instrução. Quando você tiver especificado todos os dados necessários para completar a instrução, você pode selecionar Terminar ou selecionar Próximo e especificar outra instrução.

Botões de comando

Selecione Retornar para retornar ao painel anterior.

Selecione Próximo para exibir o próximo painel.

Selecione Encerrar para salvar seu script e o assistente de script.

Selecione Cancelar para fechar o assistente de script sem salvar o seu script.

Nota:Se o botão de comando desejado não estiver disponível, certifique-se de que fez todas as seleções necessárias e confira se há erros na área de status.

Tarefas do Assistente de Script

Usando o Assistente de Script

O VisualAge Generator fornece um Assistente de Script que torna fácil desenvolver scripts Smalltalk simples. Apenas inicie o Assistente de Script e percorra as instruções. Para iniciar o Assistente de Script:

  1. Crie uma parte visual ou abra uma parte existente no Editor de Composição do VisualAge.
  2. Selecione o ícone Editor de Scripts.
    Editor de Scripts do VisualAge Smalltalk
  3. No Editor de Scripts, selecione o ícone Assistente de Script.
    Assistente do Script

    O Assistente de Script aparecerá.

Conforme segue os passos do Assistente, as instruções orientadas a objetos adequadas são exibidas na área Script Composto. Ao completar o script, selecione Finalizar para que o método seja gerado e armazenado no objeto ou classe adequada.

Chamando Script do Objetos a partir de partes VAGen

Uma das melhores maneiras de sinalizar eventos da GUI de partes VAGen é através de um Script do Objeto. Um Script do Objeto é um método de instância que não aceita argumentos e está associado à classe que você seleciona quando cria a mesma. Utilizando o EZESCRPT, você pode executar o código desenvolvido em Smalltalk. Para executar um Script do Objeto a partir de uma função VAGen:

  1. Crie uma nova parte visual ou abra uma já existente.
  2. Inclua uma parte da Função VAGen na Superfície de Formato Livre, defina-a e inclua uma instrução para executar seu Script do Objeto. Por exemplo:
    EZESCRPT("scriptName")
    

    ou

    EZESCRPT(dataItem)
    

    Aqui, "scriptName" é o nome literal da cadeia do Script do Objeto e dataItem é o item de dados para o qual a cadeia de nome do script foi movida.

  3. Inclua e conecte a parte visual que executará a parte lógica. Por exemplo, se estiver usando um botão, conecte seu evento de clique à ação execute da parte lógica.
    Nota:Certifique-se de que selecionou a classe na qual deseja incluir um novo método antes de iniciar a geração de um Script do Objeto.
  4. Crie um Script do Objeto com o nome especificado em sua parte lógica. Você pode digitar um script diretamente no Editor de Script VisualAge Smalltalk ou utilize o Assistente de Script para ajudá-lo na composição de um.

Nova Parte Application

Use a janela Nova Parte Application para selecionar um aplicação de destino para a parte que você está criando.

Campos

Nome da parte

O campo Nome da parte está preenchido com o nome da parte que você está criando.

Nomes de Partes

Para exibir as regras e restrições aplicáveis a um nome, consulte as convenções de nomeação do nome da parte.

Nomes dos itens de dados

Use as seguintes convenções para dar nome a itens de dados:

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Características de Nome DBCS

VisualAge Generator Developer suporta nomes DBCS para qualquer parte com um nome que possa ter mais de 8 caracteres. Os nomes de DBCS válidos devem obedecer às seguintes condições:

Nota:Um caractere DBCS 42 restrito contém o hexadecimal 42 no primeiro byte quando convertido em EBCDIC.

A tabela abaixo mostra os nomes válidos e inválidos de DBCS:

NOMES DBCS VÁLIDOS NOMES DBCS INVÁLIDOS
.CDi.B .A.B.C
DiDjDk AB.C
Nota:Para evitar que sejam atribuídos aliases durante a geração do programa e para aumentar a legibilidade do programa gerado, siga estes padrões:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Itens de dados no nome de registros DL/I

Os nomes de itens de dados usados em registros DL/I ficam limitados a 8 caracteres. Não podem ser nomes DBCS nem ter hifens e sublinhados. Para usar nomes maiores em itens de dados de registro DL/I, defina um registro redefinido para o segmento do DL/I e use nomes grandes para os campos no registro redefinido. Só use a definição de segmento do DL/I como objeto de E/S e na definição de chamadas DL/I.

Nomes dos Mapas

Ao renomear um mapa, você deve preceder o nome do mapa com um nome grupo de mapa.

Use as seguintes convenções para dar nome a mapas:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Nota:As convenções de atribuição de nome de campos variáveis são as mesmas que para nomes de itens de dados.

Nomes do grupo de mapa

Use as seguintes convenções para dar nome a grupos de mapas:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Nota:As seguintes considerações sobre compatibilidade aplicam-se à atribuição de nomes a mapas e grupos de mapas:

IMS/VS
Todos os mapas de um grupo de mapas são gerados numa única descrição de entrada de mensagem (MID) ou descrição de saída de mensagem (MOD) MFS por dispositivo. Quando se tem um grupo grande de mapas, ele pode exceder o limite de tamanho de 32K para blocos de controle MFS. Para saber mais detalhes sobre estimativa de tamanho, consulte o documento Design Guide.

IMS BMP
Se forem especificadas as opções de geração MSP(MFS) ou MSP(ALL), as considerações sobre compatibilidade IMS/VS serão aplicáveis. Se não forem, não existirão considerações a respeito de compatibilidade.

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Nomes dos itens de dados

Use as seguintes convenções para dar nome a itens de dados:

Caracteres Nacionais  Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Características de Nome DBCS 

VisualAge Generator Developer suporta nomes DBCS para qualquer parte com um nome que possa ter mais de 8 caracteres. Os nomes de DBCS válidos devem obedecer às seguintes condições:

Nota:Um caractere DBCS 42 restrito contém o hexadecimal 42 no primeiro byte quando convertido em EBCDIC.

A tabela abaixo mostra os nomes válidos e inválidos de DBCS:

NOMES DBCS VÁLIDOS NOMES DBCS INVÁLIDOS
.CDi.B .A.B.C
DiDjDk AB.C
Nota:Para evitar que sejam atribuídos aliases durante a geração do programa e para aumentar a legibilidade do programa gerado, siga estes padrões:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Itens de dados no nome de registros DL/I

Os nomes de itens de dados usados em registros DL/I ficam limitados a 8 caracteres. Não podem ser nomes DBCS nem ter hifens e sublinhados. Para usar nomes maiores em itens de dados de registro DL/I, defina um registro redefinido para o segmento do DL/I e use nomes grandes para os campos no registro redefinido. Só use a definição de segmento do DL/I como objeto de E/S e na definição de chamadas DL/I.

Nomes do grupo de mapa

Use as seguintes convenções para dar nome a grupos de mapas:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Nota:As seguintes considerações sobre compatibilidade aplicam-se à atribuição de nomes a mapas e grupos de mapas:

IMS/VS
Todos os mapas de um grupo de mapas são gerados numa única descrição de entrada de mensagem (MID) ou descrição de saída de mensagem (MOD) MFS por dispositivo. Quando se tem um grupo grande de mapas, ele pode exceder o limite de tamanho de 32K para blocos de controle MFS. Para saber mais detalhes sobre estimativa de tamanho, consulte o documento Design Guide.

IMS BMP
Se forem especificadas as opções de geração MSP(MFS) ou MSP(ALL), as considerações sobre compatibilidade IMS/VS serão aplicáveis. Se não forem, não existirão considerações a respeito de compatibilidade.

Nomes de função

Use as seguintes convenções para dar nome a funções:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Para evitar que sejam atribuídos aliases durante a geração do COBOL e para aumentar a legibilidade do programa COBOL gerado, use um nome que satisfaça às seguintes convenções de nomenclatura do COBOL:

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Características de Nome DBCS

VisualAge Generator Developer suporta nomes DBCS para qualquer parte com um nome que possa ter mais de 8 caracteres. Os nomes de DBCS válidos devem obedecer às seguintes condições:

Nota:Um caractere DBCS 42 restrito contém o hexadecimal 42 no primeiro byte quando convertido em EBCDIC.

A tabela abaixo mostra os nomes válidos e inválidos de DBCS:

NOMES DBCS VÁLIDOS NOMES DBCS INVÁLIDOS
.CDi.B .A.B.C
DiDjDk AB.C
Nota:Para evitar que sejam atribuídos aliases durante a geração do programa e para aumentar a legibilidade do programa gerado, siga estes padrões:

Nomes do programa

Use as seguintes convenções para dar nome a programas:

As seguintes convenções de nomenclatura aplicam-se a todos os tipos de parte:

Nomes PSB

Use as seguintes convenções para dar nome a PSBs:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Para evitar que sejam atribuídos aliases durante a geração do COBOL e para aumentar a legibilidade do programa COBOL gerado, use um nome que satisfaça às seguintes convenções de nomenclatura do COBOL:

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Nomes de registro

Use as seguintes convenções para dar nome a registros:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Para evitar que sejam atribuídos aliases durante a geração do COBOL e para aumentar a legibilidade do programa COBOL gerado, use um nome que satisfaça às seguintes convenções de nomenclatura do COBOL:

Nome dos registros de DL/I

Os nomes de registro de DL/I ficam limitados a 8 caracteres. Não podem ser nomes DBCS nem ter hifens e sublinhados. Para usar nomes maiores em registro DL/I, defina um registro redefinido para o registro DL/I usando nomes grandes no registro redefinido. O nome de registro redefinido pode ser usado em qualquer lugar do programa, exceto como nome de objeto de E/S.

Registros de linha SQL

Você não pode utilizar os itens de dados do filtro em um registro de linha SQL. Qualquer item de dado nomeado com um asterisco (*) é um item satisfatório.

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Características de Nome DBCS

VisualAge Generator Developer suporta nomes DBCS para qualquer parte com um nome que possa ter mais de 8 caracteres. Os nomes de DBCS válidos devem obedecer às seguintes condições:

Nota:Um caractere DBCS 42 restrito contém o hexadecimal 42 no primeiro byte quando convertido em EBCDIC.

A tabela abaixo mostra os nomes válidos e inválidos de DBCS:

NOMES DBCS VÁLIDOS NOMES DBCS INVÁLIDOS
.CDi.B .A.B.C
DiDjDk AB.C
Nota:Para evitar que sejam atribuídos aliases durante a geração do programa e para aumentar a legibilidade do programa gerado, siga estes padrões:

Nomes de função

Use as seguintes convenções para dar nome a funções:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Para evitar que sejam atribuídos aliases durante a geração do COBOL e para aumentar a legibilidade do programa COBOL gerado, use um nome que satisfaça às seguintes convenções de nomenclatura do COBOL:

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Características de Nome DBCS

VisualAge Generator Developer suporta nomes DBCS para qualquer parte com um nome que possa ter mais de 8 caracteres. Os nomes de DBCS válidos devem obedecer às seguintes condições:

Nota:Um caractere DBCS 42 restrito contém o hexadecimal 42 no primeiro byte quando convertido em EBCDIC.

A tabela abaixo mostra os nomes válidos e inválidos de DBCS:

NOMES DBCS VÁLIDOS NOMES DBCS INVÁLIDOS
.CDi.B .A.B.C
DiDjDk AB.C
Nota:Para evitar que sejam atribuídos aliases durante a geração do programa e para aumentar a legibilidade do programa gerado, siga estes padrões:

Nomes de tabelas

Use as seguintes convenções para dar nome a tabelas:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Leia as regras relativas ao prefixo de tabelas de mensagens.

Prefixos da tabela de mensagem

Use as seguintes convenções para dar nome a prefixos das tabelas de mensagens:

O prefixo da tabela de mensagens é especificado na janela Propriedades no Editor de Programa.

Um sufixo é anexado ao prefixo da tabela de mensagens para que seja gerado o nome da tabela de mensagens do usuário. Os sufixos dos idiomas nacionais suportados pelo VisualAge Generator são:

Código
Idioma
CHS
Chinês Simplificado
DES
Alemão Suíço
DEU
Alemão
ENP
Inglês em letra maiúscula
ENU
Inglês dos Estados Unidos
ESP
Espanhol
JPN
Japonês
KOR
Coreano
PTB
Português do Brasil

Nota:Maiúscula em Inglês não é suportado pelo AIX, OS/2, Windows NT, HP-UX, e Solaris.

Nomes de opções de geração

Use as seguintes convenções para dar nome a opções de geração:

Nomes de tabela de ligação

Use as seguintes convenções para dar nome a tabelas de ligação:

Nomes da Associação de recursos

Use as seguintes convenções para dar nome a associações de recursos:

Nomes do controle de bind

Utilize as seguintes convenções para dar nome a controles de bind:

Nomes da edição de ligação

Use as seguintes convenções para dar nome a edições por ligação:

Outros Nomes do VisualAge Generator

Para ver as regras e restrições de um nome, selecione um dos itens a seguir:

Prefixos da tabela de mensagem

Use as seguintes convenções para dar nome a prefixos das tabelas de mensagens:

O prefixo da tabela de mensagens é especificado na janela Propriedades no Editor de Programa.

Um sufixo é anexado ao prefixo da tabela de mensagens para que seja gerado o nome da tabela de mensagens do usuário. Os sufixos dos idiomas nacionais suportados pelo VisualAge Generator são:

Código
Idioma
CHS
Chinês Simplificado
DES
Alemão Suíço
DEU
Alemão
ENP
Inglês em letra maiúscula
ENU
Inglês dos Estados Unidos
ESP
Espanhol
JPN
Japonês
KOR
Coreano
PTB
Português do Brasil

Nota:Maiúscula em Inglês não é suportado pelo AIX, OS/2, Windows NT, HP-UX, e Solaris.

Nomes de arquivos de registro

Utilize as seguintes convenções para dar nome a arquivos de registro:

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Características de Nome DBCS

VisualAge Generator Developer suporta nomes DBCS para qualquer parte com um nome que possa ter mais de 8 caracteres. Os nomes de DBCS válidos devem obedecer às seguintes condições:

Nota:Um caractere DBCS 42 restrito contém o hexadecimal 42 no primeiro byte quando convertido em EBCDIC.

A tabela abaixo mostra os nomes válidos e inválidos de DBCS:

NOMES DBCS VÁLIDOS NOMES DBCS INVÁLIDOS
.CDi.B .A.B.C
DiDjDk AB.C
Nota:Para evitar que sejam atribuídos aliases durante a geração do programa e para aumentar a legibilidade do programa gerado, siga estes padrões:

As seguintes convenções de nomenclatura se aplicam a todos os tipos de partes:

Nomes da tabela de mensagem do usuário
Nota:Os nomes de tabela não podem terminar com 0 (zero)

Os nomes das tabelas de mensagem de usuário são atribuídos de modo que um só programa seja capaz de suportar vários idiomas nacionais. Quando um programa que está sendo executado precisa de uma mensagem, é anexado um sufixo ao caractere 3 ou 4 do prefixo da tabela de mensagenspara gerar o nome da tabela de mensagens de usuário. Os sufixos dos idiomas nacionais suportados pelo VisualAge Generator Developer são:

Código
Idioma
CHS
Chinês Simplificado
DES
Alemão Suíço
DEU
Alemão
ENP
Inglês em letra maiúscula
ENU
Inglês dos Estados Unidos
ESP
Espanhol
JPN
Japonês
KOR
Coreano
PTB
Português do Brasil

Nota:Maiúscula em Inglês não é suportado pelo AIX, OS/2, Windows NT, HP-UX, e Solaris.

Prefixos da tabela de mensagem

Use as seguintes convenções para dar nome a prefixos das tabelas de mensagens:

O prefixo da tabela de mensagens é especificado na janela Propriedades no Editor de Programa.

Um sufixo é anexado ao prefixo da tabela de mensagens para que seja gerado o nome da tabela de mensagens do usuário. Os sufixos dos idiomas nacionais suportados pelo VisualAge Generator são:

Código
Idioma
CHS
Chinês Simplificado
DES
Alemão Suíço
DEU
Alemão
ENP
Inglês em letra maiúscula
ENU
Inglês dos Estados Unidos
ESP
Espanhol
JPN
Japonês
KOR
Coreano
PTB
Português do Brasil

Nota:Maiúscula em Inglês não é suportado pelo AIX, OS/2, Windows NT, HP-UX, e Solaris.

Nomes do banco de dados SQL

Caracteres Nacionais

Por padrão, a versão do idioma inglês de VisualAge Generator Developer reconhece estes três pontos de código como caracteres nacionais válidos em nomes de partes:

Ponto de código
Símbolo

Hex 24
Símbolo de dólar ($)

Hex 23
Número ou sinal de sustenido (#)

Hex 40
Sinal de arroba (@)

O conjunto dos caracteres nacionais que podem ser usados pode ser diferente da lista abaixo, dependendo de:

Nota:Evite utilizar estes caracteres se o programa que está sendo desenvolvido será exportado ou gerado para outra página de código.

Consulte o documento VisualAge Generator Installation Guide para saber mais detalhes sobre os caracteres nacionais válidos.

Nomes de tabelas SQL

Um nome de tabela SQL pode ser especificado diretamente (como um literal) ou indiretamente (como uma variável do computador central).

Direto

O valor informado para nome da tabela deve obedecer às convenções de atribuição de nomes SQL. O VisualAge Generator Developer não valida nomes SQL.

O nome é alinhado à esquerda e preenchido com espaços em branco, não sendo mudado para letra maiúscula. Ele é inserido nas instruções SQL e passado para o gerenciador de banco de dados exatamente como foi digitado.

Variável do computador central

Ao usar formato de variável do computador central, digite o nome do item de dados precedido pelo indicador de variável do computador central SQL. O programa deve transferir o nome da tabela do SQL para o item de dados no runtime. Os nomes de tabela SQL em formato de variável do computador central podem ser definidos utilizando o item VAGen do SQL na janela Preferências do VisualAge. Utilize um nome de item de dados válido precedido por um ponto de interrogação (?) quando deseja especificar um nome de tabela em formato de variável do computador central SQL no arquivo de formato de origem externo.

O nome do item de dados pode ser qualificado, subscrito ou ambos. O subscrito pode ser um item de dados numérico ou um literal. O nome de tabela possui comprimento máximo de 60 caracteres, incluindo o indicador de variável do computador central SQL.

No runtime, o programa deve transferir o nome da tabela real para a variável do sistema central antes que o registro (SQL) seja acessado. As instruções SQL de funções que obtêm acesso ao registro como objeto de E/S são preparadas e executadas dinamicamente quando o programa é executado. O atual conteúdo do item de dados correspondente à variável do computador central é substituído sempre que ele aparece na instrução SQL.

O valor passado para a variável de computador central do nome de tabela deve obedecer às convenções de atribuição de nomes SQL. O programa gerado não valida o valor.

Para obter mais informações sobre os caracteres nacionais válidos para sua estação de trabalho, consulte a seção Línguas Nacionais Suportadas do documento VisualAge Generator Installation Guide.

Tipo da parte

O campo Tipo da parte é preenchido com o tipo da parte que você está criando.

Criar parte no aplicação

O campo Criar parte no aplicação exibe uma lista de applications onde você pode escolher para criar a parte.

Botões de comando

Selecione OK para aceitar os valores e fechar a janela.

Selecione Cancelar para fechar a janela sem aceitar os valores.


[ Início da Página | Página Anterior | Próxima Página | Índice ]