Utilize o Editor de Funções para definir e atualizar uma função em seu programa.
Para atualizar instruções, há tarefas de edição padronizadas.
A lista suspensa Opção E/S mostra a Opção E/S para esta função. Pode-se selecionar na lista suspensa outra opção de E/S.
A opção E/S especifica o tipo de E/S que ocorre para esta função.
Códigos de retorno de E/S são baseados no tipo de organização de registro utilizado. Os estados dos códigos de retorno de E/S variam de acordo com a opção de E/S.
Você pode especificar apenas uma opção E/S para cada função. A opção de E/S de EXECUTE é o padrão.
Pode-se escolher dentre as seguintes opções:
A opção de E/S de ADD coloca um registro novo num arquivo ou banco de dados. O programa deve inicializar todos os campos no registro antes de processar a opção ADD.
ADD é válida para segmento DL/I serial, relativo, indexado e registros de linha SQL.
Itens
Botões de comando
Selecione OK para aceitar os valores e fechar a janela.
Selecione Validar para validar a sintaxe da comando SQL.
Selecione Padrões para usar os valores-padrão da instrução SQL.
Eis as ações que a opção de E/S de CLOSE pode realizar:
CLOSE é válido para registros de linha seriais, relativos, indexados ou SQL e para mapas de impressora.
A opção E/S de CONVERSE exibe um mapa e aguarada pela entrada do usuário do programa ou enviar um registro da UI para o servidor Web.
Uma função CONVERSE ignora a validação de edição se o usuário do programa pressionar uma tecla de atenção ou uma tecla de função como uma tecla de edição bypass.
CONVERSE é válido somente para mapas de terminais ou registros UI.
A opção de E/S de DELETE remove um registro de um arquivo ou banco de dados. Você deve primeiro obter o registro por uma função UPDATE ou SCAN para uma função de update para a DL/I ou os bancos de dados relacionais.
DELETE é válido para segmento DL/I relativo, indexado e registros de linha SQL.
A opção de E/S de DISPLAY envia um mapa para uma impressora ou buffer de saída do terminal. Se o mapa for enviado ao buffer de saída do terminal, o conteúdo do buffer será enviado à tela quando ocorrer a próxima opção de E/S de CONVERSE do mapa.
A opção DISPLAY serve aos dois propósitos que se seguem:
DISPLAY é válido para ambos, mapas de terminal e de impressora.
A opção de E/S de EXECUTE não está associada à operação de E/S. Ela não possui objeto de E/S (mapa ou registro).
Utilize EXECUTE para processamento especial, como o controle do fluxo entre funções, inicialização, processamento para não ser repetido em uma função de E/S, identificação de erros e processamento que encerre o programa.
A opção de E/S de INQUIRY lê um registro individualmente de um arquivo ou banco de dados.
O valor atual na chave identifica o registro a ser lido.
INQUIRY é válido para segmento DL/I indexado, relativo ou registros de linha SQL.
A opção de E/S de REPLACE coloca um registro alterado de volta num arquivo ou banco de dados. Você deve primeiro obter o registro por uma função UPDATE ou SCAN para uma função de update para a DL/I ou os bancos de dados relacionais.
REPLACE é válido para segmento DL/I indexado, relativo ou registros de linha SQL.
A opção de E/S de SCAN lê o registro seguinte de um arquivo ou banco de dados.
A opção de E/S de SCAN é válida para registros seriais, relativos, indexados, de segmento de DL/I e de linha SQL.
Informações de referência
Considere um arquivo onde as chaves são como a seguir:
1, 2a, 2b, 2c, 3, 4
Onde a, b e c são usados para indicar registros de chave duplicados para chave 2 e a ordem na qual eles foram incluídos no arquivo.
Os exemplos a seguir ilustram a ordem na qual os registros são recuperados.
Exemplo 1
Tabela 2. Resultados para o registro 1
Opção de E/S | Tecla | Recupera | Define |
INQUIRY | 2 | 2a | DUP |
SCAN (Procurar Adiante) | 3 |
Exemplo 2
Tabela 3. Resultados para o registro 2
Opção de E/S | Tecla | Recupera | Define |
SET record SCAN | 2 | ||
SCAN (Procurar Adiante) | 2a | DUP | |
SCAN (Procurar Adiante) | 2b | DUP | |
SCAN (Procurar Adiante) | 2c | ||
SCAN (Procurar Adiante) | 3 |
A opção de E/S de SCANBACK lê o registro anterior de um arquivo indexado.
A opção de E/S de SCANBACK só é válida para registros indexados.
Informações de referência
Considere um arquivo onde as chaves são como a seguir:
1, 2a, 2b, 2c, 3, 4
onde a, b e c são usados para indicar registros de chave duplicados para chave 2 e a ordem na qual eles foram incluídos no arquivo.
Os exemplos a seguir ilustram a ordem na qual os registros são recuperados.
Exemplo 1
Opção de E/S | Tecla | Recupera | Define |
INQUIRY | 3 | 3 | |
SCANBACK (Localizar Antes) | 2a | DUP | |
SCANBACK (Localizar Antes) | 2b | DUP | |
SCANBACK (Localizar Antes) | 2c | ||
SCANBACK (Localizar Antes) | 3 |
Exemplo 2
Opção de E/S | Tecla | Recupera | Define |
SET record SCAN | 2 | ||
SCAN (Procurar Adiante) | 2a | DUP | |
SCAN (Procurar Adiante) | 2b | DUP | |
SCANBACK (Localizar Antes) | 1 |
Exemplo 3
Opção de E/S | Tecla | Recupera | Define |
SET record SCAN | 1 | ||
SCANBACK (Localizar Antes) | nada | EOF |
A opção de E/S de SETINQ seleciona um conjunto de linhas num banco de dados relacional para serem recuperadas posteriormente com a opção E/S de SCAN. O objeto deve ser um registro de linha SQL.
A opção de E/S de SETUPD seleciona um conjunto de registros num banco de dados relacional para serem processados posteriormente com a opção de E/S de SCAN. Os registros selecionados podem ser substituídos ou excluídos. O objeto deve ser um registro de linha SQL.
A opção de E/S de SQLEXEC possibilita a definição de sua própria instrução SQL, para ser executada como opção de E/S.
A opção de E/S de SQLEXEC só é válida para registros SQL. Contudo, o uso do objeto de E/S do registro de linha SQL é opcional.
A opção de E/S de UPDATE lê um registro de um arquivo ou banco de dados com a intenção implícita de substituí-lo ou excluí-lo. A opção de E/S de UPDATE bloqueia o registro, protegendo-o de atualizações por parte de outros usuários, até que outra operação se complete para o arquivo ou banco de dados.
UPDATE é válido para segmento DL/I indexado, relativo ou registros de linha SQL.
A lista pendente Objeto de E/S mostra o nome do registro ou mapa que você deseja processar. O que aparece em suspenso depende da opção selecionada.
Você pode utilizar a lista pendente para selecionar um objeto ou pode digitar uma ou mais letras do alfabeto no campo de entrada e nos Objetos da Função que começam com essa(s) letra(s) na parte superior da lista.
A área de instruções fornece uma área para inserir, incluir, atualizar e excluir instruções.
Você pode utilizar funções do editorpadrão para atualizar as instruções.
Para inserir uma instrução de processamento a partir de Gabaritos de Instrução faça o seguinte:
Você pode atualizar a instrução fazendo o seguinte:
Para excluir uma linha da instrução de processamento, faça o seguinte:
Note que ao selecionar o texto na área de instrução, esse texto será excluido quando você Colar uma instrução no Editor de Instrução a partir de Gabaritos de Instrução.
Ao editar um texto, podem ser efetuadas as seguintes tarefas:
Nota: Pressionar qualquer tecla de caractere quando o texto está selecionado fará com que ele seja substituído por esse caractere.
Selecione Arquivo para operar com partes, , opções de imagens ou impressora.
Selecione Novo para criar uma nova parte VisualAge Generator.
Selecione Abrir para abrir uma parte VisualAge Generator carregada.
Selecione Salvar para salvar a parte na biblioteca. Você pode salvar partes no an application que seja uma edição aberta ou uma edição aberta, para o qual uma edição de trabalho pode ser criada.
Selecione Salvar Como para criar uma nova parte com um nome diferente que herde todas as características da parte aberta, sem alterar a parte original.
A seleção de Salvar Como abre a janela Salvar Como.
Selecione Reverter para fazer com que todos os campos voltem a assumir as últimas definições salvas.
Selecione Imprimir para imprimir a parte que foi aberta.
A primeira vez que você imprime uma parte VisualAge Generator, as janelas Configurar Impressão serão exibidas. Você pode aceitar ou alterar as definições da impressora padrão para todos os editores VisualAge Generator utilizando estas janelas.
Selecione Configurar Impressão para selecionar uma impressora e especificar opções de configuração da impressora.
Selecione Salvar Imagem para conservar um instantâneo da imagem do VisualAge que está localizado na memória, gravando-o no arquivo abt.icx armazenado em seu disco rígido.
Selecione Salvar Imagem Como para abrir a janela Nome do Arquivo para Imagem, onde você pode especificar um nome de arquivo, um diretório e uma unidade em que deseja salvar sua imagem.
O arquivo padrão é abt.ics.
Selecione Sair do VisualAge para fechar o VisualAge. É perguntado se você deseja salvar sua imagem, fechar o programa sem salvar a sua imagem ou cancelar seu pedido para fechar o programa.
Selecione Editar para trabalhar com texto em uma parte.
Selecione Desfazer para inverter sua última ação de edição.
Nota: | Para desfazer um corte, posicione o cursor no local apropriado no editor do qual cortou e selecione Colar. |
Selecione Refazer para efetuar a última ação que foi revertida ou desfeita. No Editor de Mapas várias ações podem ser refeitas.
Se não tiver sido feita nenhuma ação ou se a última ação feita não puder ser desfeita, a opção Refazer não ficará disponível.
Selecione Cortar para remover o texto selecionado ou objetos e colocá-los na área de transferência.
Selecione Copiar para copiar as informações selecionadas para a área de transferência sem excluí-las da janela ativa.
Selecione Colar para copiar texto da área de transferência para a janela ativa. Todo o texto selecionado é substituído pelo texto da área de transferência. Se não houver texto selecionado, o texto na área de transferência será inserido na posição do cursor.
Nota: | Colar serve somente para texto. |
Selecione Excluir para remover as informações selecionadas sem armazená-las na área de transferência.
Selecione Colar Nome da Parte para exibir uma lista de partes do VAGen que você pode colar em uma instrução.
Selecionando o submenu apropriado, você pode exibir uma lista de partes para os seguintes tipos de parte do VAGen:
Para navegar na lista, você pode digitar a primeira letra de um nome da parte.
Selecione Comentar/Não Comentar para comentar a linha onde o cursor está posicionado.
Para retirar um comentário, posicione o cursor em uma linha e selecione Comentar/Não Comentar.
Para comentar ou retirar o comentário de várias linhas, selecione-as e Comentar/Não Comentar.
Se você selecionou várias linhas que incluem comentários (linhas começando com /*) e linhas não comentadas, Comentar/Não comentar muda o status do comentário com base na primeira linha de sua seleção. Se a primeira linha de sua seleção não estiver comentada, a seleção de Comentar/Não comentar coloca em comentário a primeira linha e as linhas seguintes de sua seleção. Se a primeira linha estiver comentada, a seleção de Comentar/Não comentar tira o comentário da primeira linha e das linhas seguintes de sua seleção.
Nota: | Linhas protegidas não podem ser comentadas. |
Selecione Incluir Bloco de Comentário para inserir um bloco de comentário na linha acima da instrução em que o cursor está posicionado.
Selecione Parênteses para colocar o texto selecionado entre parênteses.
Se não houver texto selecionado, a opção Parênteses não ficará disponível.
Selecione Localizar/Substituir para exibir a janela Localizar/Substituir, que permite:
Campos
Botões de comando
Selecione Localizar Seguinte para localizar a cadeia. Se não houver cadeia correspondente no texto restante, será dada a mensagem Cadeia não encontrada no campo Status.
Se tiver sido especificada cadeia no campo Substituir por, será possível selecionar:
Selecione Fechar para fechar a janela.
Escolha Selecionar Todos para selecionar o texto inteiro no editor.
Selecione Desmarcar Tudo para limpar qualquer seleção.
Selecione Exibir para trabalhar com fontes.
Selecione Fonte para abrir a janela Seleção da Fonte e mudar a fonte de todos os tipos de partes que podem ser editados no editor em que a fonte é alterada.
Campos
Botões de comando
Selecione OK para aceitar quaisquer alterações e fechar a janela Seleção de Fonte.
Selecione Padrão para restaurar as definições de fonte padrão e fechar a janela Seleção de Fonte.
Selecione Cancelar para fechar a janela Seleção de Fonte sem aceitar nenhuma alteração.
Tarefas
Para alterar a fonte de uma parte, selecione Fonte no menu Exibir e faça o seguinte:
O canto inferior esquerdo da janela indica se a fonte selecionada é bitmap ou escalável.
Uma amostra da fonte selecionada é exibida na área de texto. Digite mais texto se quiser ver outros caracteres.
Selecione Definir para trabalhar com a função.
Selecione Objeto de E/S para definir o mapa ou registro especificado como objeto de E/S para a função.
A opção Objeto de E/S só fica disponível quando se especifica um objeto de E/S no Editor de Funções.
Selecione Rotina de erro para definir a função ou grupo de instruções como rotina de erro da função.
A opção Rotina de erro só fica disponível quando se especifica uma rotina de erro no Editor de Funções.
Rotina de erro não está disponível com as palavras EZE.
Selecione Instrução SQL para definir a instrução SQL relativa a essa função.
A Instrução SQL estará disponível somente se a opção de E/S especificada for válida para uma instrução SQL, se um objeto de E/S estiver especificado e se a opção for SQLEXEC. Note que a opção SQLEXEC não precisa de objeto de E/S.
Selecione Definição DL/I para definir a chamada DL/I relativa à função.
A opção Definição DL/I só fica disponível se a opção de E/S especificada for válida para DL/I e se for especificado objeto de E/S.
Selecione Valor de Retorno/Parâmetros para definir um valor de retorno e parâmetros para sua função. A seleção de Valor de Retorno/Parâmetros abre o Valor de Retorno/Editor de Parâmetros.
Selecione Armazenamento Local para definir um registro ou item de memória de trabalho que defina uma área de memória temporária que seja reservada exclusivamente para a função. A seleção de Armazenamento Local abre o Editor de Armazenamento Local