Auxílios do VisualAge Generator

Seleção PSB

Selecione o PSB a ser usado na definição da chamada DL/I. A lista suspensa contém todos os PSBs que contêm o objeto da função.

Identificador de banco de dados

Especifique o Identificador de banco de dados para essa chamada DL/I selecionando-o na lista suspensa. A lista suspensa contém Identificadores de banco de dados válidos, baseados no objeto da função e no PSB especificados.

Procurar atualização

Selecione Procurar atualização quando você possui capacidade para substituir ou excluir o segmento DL/I após a opção de E/S SCAN. Se você não selecionar Procurar atualização, não poderá substituir ou excluir os segmentos.

Procurar ascendente

Selecione Procurar ascendente para limitar o intervalo de procura à cadeia ascendente atual na hierarquia do banco de dados.

Se você não especificar Procurar ascendente, o próximo segmento desse tipo no banco de dados será recuperado independentemente da cadeia ascendente.

Função

Exibe a função DL/I que é utilizada na chamada do DL/I para a opção de E/S especificada.

Argumentos de Pesquisa

Os campos Argumentos de Pesquisa mostram o nome do segmento e as informações de qualificação da chamada DL/I. Os campos Argumentos de Pesquisa são editáveis.

Campos

Nome do Segmento

Selecione o Nome do segmento a partir da lista suspensa a fim de selecionar o nome do segmento que será acessado pelo argumento de pesquisa do segmento que você está definindo. A lista contém nomes válidos definidos no PSB.

O segmento deve ser definido na cadeia ascendente que vai do segmento objeto de volta para o segmento raiz na hierarquia do banco de dados.

O segmento deve ser definido como um registro de segmento DL/I antes do programa poder ser gerado ou testado.

Códigos de Comando

Digite até 4 caracteres de códigos de comando DL/I no campo Códigos de comando. Os códigos de comando válidos são:

C
Use a chave concatenada para selecionar esse segmento. Quando C estiver especificado como um código de comando, os campos Campo de Segmento, Op Booleano e Op do SSA devem ser deixados em branco. O Item de Valor de Comparação nomeia um item de dados que contém a chave concatenada para o segmento.

D
Esse código permite a recuperação ou inserção de múltiplos segmentos em um caminho hierárquico. Este código não é requerido pelo segmento de nível mais baixo, visto que é sempre recuperado ou inserido. Especifique esse código para qualquer segmento de nível mais alto a ser recuperado em opções INQUIRY, UPDATE ou SCAN. Para uma opção ADD, especifique esse código somente para o segmento de nível mais alto que você deseja inserir, para incluir esse segmento e todos os segmentos em níveis mais baixos.

VisualAge Generator Developer manipula o buffering de E/S de segmentos recuperados ou gravados usando o código de comando D. Se você recuperar diversos segmentos para atualização utilizando o código D, uma opção de substituição com o segmento de nível mais baixo como objeto irá substituir todos os segmentos que foram recuperados com o código D.

A opção de E/S de chamada de caminho (P) deve ser especificada na geração da DL/I PSB se o código de comando D é utilizado.

F
Para a opção SCAN, inicie varrendo a partir da primeira ocorrência desse tipo de segmento, sob o pai dele. Para a opção ADD, esse código é efetivo somente para segmentos com campo não-exclusivo ou sem seqüência e o segmento é inserido na primeira posição, dentro do pai dele.

L
Para as opções INQUIRY, UPDATE e SCAN, recupere a última ocorrência desse tipo de segmento sob o pai dele. Se instruções de qualificação estiverem presentes, recupere o último segmento que satisfaz o critério de pesquisa. Na opção ADD, esse código é efetivo somente para segmentos com campo não exclusivo ou sem seqüência, e o segmento é inserido na última posição dentro do pai dele.

N
Não substitua esse segmento em uma chamada de substituição, embora ele tenha sido recuperado no get da chamada de atualização.

P
Defina posição de pai para obter o próximo pai (SCAN) no nível de hierarquia representado por esse segmento.

Q
Bloqueie os segmentos recuperados até o ponto de verificação ou terminação de PSB.
Nota:Se você usou o código de comando Q na codificação de chamadas DL/I para CICS em outras linguagens, você seguiu o código de comando Q com um A para compatibilidade IMS. Contudo, não entre o A aqui. VisualAge Generator Developer fornece o A quando ele cria a lista SSA final no momento de execução.

U
Não mova a posição de banco de dados desse segmento quando pesquisando seus dependentes hierárquicos.

V
Idêntico ao U, exceto que o código de comando é definido automaticamente em níveis mais altos na chamada.

Os códigos de comando a seguir são suportados somente nos ambientes IMS/VS, IMS BMP e MVS CICS. Utilize estes códigos para acessar subconjuntos de um tipo de banco de dados especial chamado de banco de dados de atalho de entrada de dados (DEDB). Para identificar o subconjunto que você está acessando, digite o código de comando seguido por um número inteiro de 1 a 8.

M
Move o indicador de subconjunto para a próxima ocorrência do segmento na cadeia de segmentos.

R
Recupera a primeira ocorrência do segmento no subconjunto

S
Define o indicador de subconjunto, incondicionalmente, para a posição atual.

W
Define o indicador de subconjunto, condicionalmente, para a posição atual.

Z
Define o indicador de subconjunto para 0.

Certos códigos de comando são aplicáveis somente para certas opções de I/O. A tabela a seguir identifica os códigos de comando aplicáveis:

Opção Códigos de Comando Código de Comando de Caminho Rápido
INQUIRY D, L, Q, U, V, C, P M, R, S, W, Z
UPDATE D, L, Q, U, V, C, P M, R, S, W, Z
ADD D, L, F, U, V, C M, R, S, W, Z
REPLACE N M, S, W, Z
DELETE Nenhum Z
SCAN D, L, F, Q, U, V, C, P M, R, S, W, Z

Os códigos de comando são opcionais. Se nenhum estiver especificado, não será utilizado nenhum. Os códigos de comando R e F, R e Q, L e F, ou U e V não podem ser ambos acessados no campo de código de comando para o mesmo SSA. Além disso, somente um dos códigos de comando M,S,W e Z pode ser utilizado no mesmo SSA.

Você pode ter apenas um código de comando C em um conjunto de SSAs. Em uma chamada INSERT, aplica-se o seguinte:

Operador Booleano

Na caixa Operador Booleano, selecione um dos seguintes operadores booleanos para ser usado no campo Qualificação SSA:

Nota:O campo Operador Boleano não ficará disponível até você inserir uma linha. A partir de então será possível fazer seleções na lista suspensa. O campo Nome do Segmento deve estar em branco para que o campo Operador Boleano seja válido.

AND (&)

Selecione AND (&) para tornar um argumento de pesquisa do segmento mais específico.

Se essa for a primeira linha de um SSA, esse campo não está disponível.

OR (|)

Selecione OR (|) para tornar um argumento de pesquisa do segmento menos específico.

Se essa for a primeira linha de um SSA, esse campo não está disponível.

Campo do Segmento

No Campo do segmento, selecione na lista suspensa o nome de um campo de segmento ou digite o nome com 1 a 8 caracteres do campo usado para fazer a seleção do segmento. Quando o código de comando C for especificado, esse campo deverá estar em branco.

Operador Relacional

Na lista suspensa Operador Relacional, selecione um dos seguintes operadores relacionais que deve ser usado para comparar os valores do Campo do Segmento e do Item de Valor de Comparação:

EQ (=)

Selecione EQ (=) para selecionar um campo de segmento cujo valor seja igual ao item do valor de comparação do argumento de pesquisa do segmento.

NE ( =^ )

Selecione NE (^=) para selecionar um campo de segmento cujo valor não seja igual ao item do valor de comparação do argumento de pesquisa do segmento.

Nota:O ^ não está no conjunto de caracteres sintáticos do Idioma Nacional e pode não ser representado por um ponto de código equivalente através das páginas de código. Se você planeja exportar ou gerar para máquinas com páginas de código diferentes (em particular, entre S/370 e estações de trabalho), use NE em vez dos caracteres ^=.

Para alterar o modo como o Operador Relacional é exibido na janela Argumento de Pesquisa de Segmento, selecione Definir no menu e depois selecione Chamada DL/I.

GT (>)

Selecione GT ( >) para selecionar um campo de segmento cujo valor seja maior do que o item do valor de comparação correspondente ao argumento de pesquisa do segmento.

GE (=>)

Selecione GE (>=) para selecionar um campo de segmento cujo valor seja maior ou igual ao item do valor de comparação correspondente ao argumento de pesquisa do segmento.

LT ( < )

Selecione LT (<) para selecionar um campo de segmento cujo valor seja menor do que o item do valor de comparação do argumento de pesquisa do segmento.

LE ( =< )

Selecione LE (<=) para selecionar um campo de segmento cujo valor seja menor ou igual ao item do valor de comparação do argumento de pesquisa do segmento.

Item do Valor de Comparação

No campo Item do Valor de Comparação, digite o nome de 1 a 85 caracteres do item de dados a ser comparado ao campo do segmento. Quando C for especificado como um código de comando, o item de dados conterá toda a chave concatenada do segmento. O item de dados será requerido quando C estiver especificado como código de comando.


Botões de comando

Selecione OK para aceitar os valores e fechar a janela.

Selecione Cancelar para fechar a janela.

Selecione Inserir Antes para inserir uma linha em branco na lista de argumentos da pesquisa.

Selecione Inserir Depois para inserir uma linha em branco na lista de argumentos da pesquisa.

Selecione Excluir para eliminar uma linha da lista de argumentos da pesquisa.

Selecione Padrões para redefinir os argumentos de pesquisa como o padrão.


Lista Argumentos de Pesquisa do Segmento (SSAs)

A lista Argumentos de Pesquisa do Segmento (SSAs) mostra os SSAs da chamada DL/I com a qual você está trabalhando. Você pode modificar os SSAs gerados por VisualAge Generator Developer.

Pode inserir um SSA na lista por meio da seleção de uma linha na lista e depois da seleção de Inserir antes ou Inserir depois com os botões abaixo da lista SSA.

Nota:Se você selecionar Inserir Depois sem selecionar anteriormente uma entrada na lista, o item é inserido no final da lista. Se você selecionar Inserir Antes sem selecionar anteriormente uma entrada na lista, o item é inserido no começo da lista. Mesmo quem não tem entrada na lista pode selecionar Inserir Antes ou Inserir Depois nom menu Editar.
Nota:Se não estiver claro se esse é um novo SSA ou uma qualificação, o sistema pedirá que você faça uma seleção.

Para atualizar um SSA:

  1. Selecione a linha do SSA que deseja atualizar.
  2. Digite um novo valor diretamente no campo ou selecione outro no menu associado ao campo.

Para excluir SSAs ou qualificações:

  1. Selecione a linha que deseja excluir.
  2. Selecione a tecla Delete abaixo da lista SSA.
Nota:Se você selecionar a primeira linha de um SSA, todas as qualificações dele também são excluídas.

Selecione OK para aceitar as alterações e fechar a janela.


SSA modificado

Mostra se o argumento de pesquisa do segmento (SSA) foi ou não modificado.


Tarefas

Definindo a Chamada DL/I para Opção de E/S Scan

  1. No Editor de Funções, selecione a opção de E/S SCAN no menu do campo opção de E/S.
  2. No campo do objeto de E/S, digite o objeto de E/S válido ou selecione outro no menu do campo.
  3. Selecione Definir>>Chamada DL/I na barra de menus da Janela Editor de Funções. A janela Editor de Chamadas DL/I aparecerá com ambos os campos, PSB: e Identificador de Banco de Dados:, pré-selecionados.
  4. Selecione Inserir Antes ou Inserir Depois, dependendo da ordem que preferir em relação a outros argumentos de pesquisa do segmento que possa já ter definido.
  5. Selecione o nome do segmento no menu do campo nome do segmento.
  6. Digite os outros valores associados ao segmento selecionado nos outros campos desta linha na lista SSA.
  7. Selecione OK para salvar as definições especificadas e fechar a janela.


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