Usando a Página de Construtores

Você utiliza a página de construtores para definir o que é construído quando esta especificação de construção é usada. Um único construtor pode ser usado para criar um objeto ou vários objetos do mesmo tipo a partir da origem.

O Layout da Página Construtores

A página Construtores consiste em duas áreas principais. Do lado esquerdo, há uma visualização em árvore exibindo todos os construtores e seus vários componentes. É possível usar os botões ao lado da visualização em árvore para incluir, duplicar e remover componentes da visualização. Do lado direito, há uma área usada para editar os vários atributos do componente que é selecionado à esquerda.

Os componentes de um construtor são entradas, dependências de recurso, construtores de pré-requisito e conjuntos de comandos. Tipicamente, você os definiria nessa ordem.

Propriedades do Construtor

Os próprios construtores têm propriedades que podem ser editadas. Ao selecionar um construtor, você verá três seções que fornecem essas propriedades.

Use a seção Detalhes do Construtor para fornecer o nome do construtor. Esse nome é o identificador do construtor e é obrigatório. O nome do construtor pode conter quaisquer caracteres, exceto espaços e vírgulas e pode ter até 50 caracteres. Ele é usado ao fazer referência a esse construtor como uma dependência. Também é possível inserir uma descrição para o construtor. A descrição é opcional.

A seção Objetos de Saída descreve os objetos criados por esse construtor. O tempo de execução da construção verificará esses objetos quanto à existência e o tempo de existência e selecionará a seção adequada de conjunto de comandos a ser executada. Se o construtor criar objeto a partir da origem, você poderá usar a variável predefinida &N para nomear o objeto de saída. Se o construtor for usado para configuração, na realidade, ele não poderá criar ou alterar nenhum objeto e esta seção poderá ser deixada em branco.

As Variáveis do Construtor podem ser usadas para fornecer valores para variáveis em conjuntos de comandos e em objetos de saída. Você pode definir quaisquer variáveis de substituição desejadas nesta seção. Essas variáveis podem ser referenciadas a partir dos conjuntos de comandos usados por esse construtor. Se você usar mais de um conjunto de comandos nesse construtor, poderá definir variáveis aqui que serão usadas em conjuntos de comandos.

Trabalhando com Listas de Entrada

Uma lista de entrada fornece valores para os conjuntos de comandos mencionados por este construtor. Conjuntos de comandos usados pelo construtor podem ter variáveis especificadas em suas definições. Você utiliza esta lista de entrada para fornecer valores para estas variáveis.

Cada lista de entrada possui um nome que pode ser usado na tabela de variáveis do conjunto de comandos. A entrada especifica uma lista de recursos definindo o que incluir na lista e possivelmente o que excluir dela. Por exemplo, é possível especificar que uma entrada seja uma lista de todos os membros do QRPGLESRC, exceto para o membro ABC.

Algumas entradas devem ser processadas uma de cada vez pelo construtor, por exemplo, uma lista de membros de origem fornecidos para um conjunto de comandos de compilação. Outras entradas devem ser processadas como um grupo, por exemplo, aqueles objetos do módulo que devem ser combinados em um programa de serviços. Você especifica o tipo de entrada quando fornece suas propriedades. É pouco provável que você tenha dois tipos de entrada no mesmo construtor, no entanto, o editor não desaprova isso.

Repetindo Tarefas para cada Elemento de uma Lista de Entrada

Se for preciso processar uma lista de entrada de cada vez, os conjuntos de comandos nesse construtor serão executados para cada elemento dessa lista. O elemento da lista fornece os valores para as variáveis predefinidas &N, &X, &L e &F. Os conjuntos de comandos são executados na ordem especificada no construtor.

Substituindo uma Lista de Entrada Inteira para uma Variável

Se for necessário processar a lista de entrada como um grupo, o construtor combinará todos os elementos da lista em um único valor, separando cada um dos elementos por um espaço em branco e formatando-os de acordo com o formato selecionado na tabela de variável de conjunto de comandos. É possível usar essa lista para fornecer parâmetros para comandos que usam listas como valores. Um bom exemplo disso serão os módulos que devem ser combinados em um programa de serviços.

Especificando Dependências de Recursos

As dependências que este construtor poderia ter com os recursos são descritas de maneira muito similar a listas de entradas, exceto que elas não têm nomes. Por exemplo, é possível ter uma biblioteca de inclusão que seja fornecida por um fornecedor. É possível especificar essa biblioteca de inclusão como uma dependência de recurso. Se essa biblioteca for alterada, a construção fará com que este construtor seja executado.

Para trabalhar com as dependências de recursos, selecione o componente "Dependências de Recursos" do construtor especificado na visualização em árvore do lado esquerdo da página e use os formulários do lado direito da página para incluir ou editar dependências. A forma exata da dependência depende se ela é um membro ou um objeto.

Configurando Construtores de Pré-requisito

A seção Construtor de Pré-requisito é usada para especificar as dependências de um construtor com outro. A construção usa estas informações para determinar a ordem na qual executar os construtores. Por exemplo, é possível especificar que o construtor B depende do construtor A, fazendo referência ao construtor A a partir da definição do construtor B. Como A é exigido por B, a construção verificará se A precisa ser construído antes da construção de B. Caso precise, a construção irá construir A primeiro e, em seguida, como B depende do A recém-construído, B será construído.

Os construtores de pré-requisito geralmente não precisam ser usados. Garante-se que os construtores sejam executados na ordem em que estão especificados na lista de construtores. Os construtores de pré-requisito podem ser usados para ajuste fino dessa ordem.

Trabalhando com as Referências do Conjunto de Comandos

As referências de conjunto de comandos são usadas pelos construtores para definir que processamento é usado quando esse construtor é executado. As referências do conjunto de comandos são definidas usando o identificador designado para o conjunto de comandos. Para incluir uma referência de conjunto de comandos a um construtor, selecione a seção Conjuntos de Comandos do construtor na árvore do lado esquerdo da página e use os botões no formulário para incluir um novo conjunto de comandos ou duplicar o conjunto de comandos atualmente selecionado para modificação.

Seus conjuntos de comandos devem ser relativamente pequenos e cumprir uma coisa. Por exemplo, um conjunto de comandos poderia ter apenas um único comando de compilação e um comando CHGOBJOWN. Da forma semelhante, seus construtores devem ser limitados para construir um tipo de objeto IBM®. Por exemplo, é possível definir um construtor para compilar todos os membros de origem de RPG de um arquivo de origem particular em programas.

É possível fazer referência a mais de um conjunto de comandos em um construtor. A construção processa esses conjuntos de comandos na ordem em que são definidos no construtor. Se um conjunto de comandos for condicional, o objeto de saída será testado para ver se existe e, se existir, se ele está desatualizado. Estas verificações são, então usadas para selecionar a seção de processamento adequada do conjunto de comandos.

Os conjuntos de comandos podem ter variáveis de substituição definidas dentro deles. Você fornece valores para essas variáveis definindo os valores no nível do projeto na Página de Visão Geral, no nível do construtor nas propriedades do construtor ou localmente, usando a tabela de variáveis do conjunto de comandos. A tabela de variáveis para um conjunto de comandos será exibida quando você selecionar o comando na visualização em árvores do lado esquerdo da página de Construtores. Na página de variáveis, é possível corresponder uma variável a uma cadeia literal ou a uma lista de entrada. Um formato é determinado para as listas de entradas quando são usadas em uma tabela de variável. Esse formato descreve como seus valores são substituídos em um comando. Atualmente, o único formato suportado é um formato de nome qualificado que permite que as listas de entradas sejam usadas para fornecer valores aos comandos que usam esses nomes de objetos completos como parâmetros.

Consulte o Jazz.net para obter mais informações.


Feedback