Information Center

Editando Telas de Macro: Ações

Lista as ações a serem executadas quando uma tela em uma macro for reconhecida.

A guia Ações fornece todas as ações a serem executadas na tela selecionada quando é identificado pela macro. Para modificar uma ação, escolha a ação na lista Ação. O nome de cada ação é criado automaticamente, com base no tipo de ação e em seu conteúdo. Para criar uma nova ação, escolha o tipo de ação apropriado que deseja criar (por exemplo, <nova ação de entrada>).

Para qualquer campo, exceto Nome da Tela, é possível utilizar um nome de variável ou uma expressão aritmética como o valor do campo. É possível digitar esses nomes de variáveis e expressões diretamente nas áreas do texto ou incluí-los em listas, selecionando <Expressão> a partir da lista. Se você selecionar <Expressão> a partir da lista e apenas as outras opções forem verdadeiras ou falsas, a expressão deverá retornar True ou False.

Um nome de variável deve ter o seguinte formato: $var_name$, onde var_name pode ser alfanumérico, travessão e sublinhado. Os nomes de variáveis devem ser colocados entre sinais de dólar. Os nomes de variáveis são sensíveis a maiúsculas e minúsculas.

Se uma ação requer valores de linhas e colunas, você poderá clicar na janela da sessão, na posição desejada e os valores aparecerão no campo da linha e da coluna. Clique uma vez, para destacar a janela da sessão e clique novamente, para obter os valores da posição que você selecionou, para que apareçam no campo da linha e da coluna.

Para obter mais informações, consulte Ações de Macros no Guia de Programação de Macros.

Nas descrições a seguir, o tempo de execução da macro é o módulo do programa Host On-Demand que reproduz macros. Quando o usuário clica no ícone Reproduzir Macro, o tempo de execução da macro lê o conteúdo do script da macro especificada e gera a reprodução da macro.

Para excluir uma ação definida, selecione-a e clique em Excluir.

Clique em Ordem, para alterar a ordem em que as ações devem ser executadas na tela.

Para obter mais informações sobre a sintaxe de script de macro, consulte o Guia de Programação de Macros.

Entrada

A ação de Entrada envia uma seqüência de pressionamentos de teclas para a janela da sessão. A seqüência pode incluir teclas que exibem um caractere (como a, b, c, #, & e assim por diante) e também teclas de ação (como [enter] [enterreset], [copy], [paste] e outras). Para obter informações detalhadas, consulte Ação de Entrada no Guia de Programação de Macro.

Essa ação simula entrada do teclado de um usuário real.

Linha e Coluna
Utilize os campos Linha e Coluna para especificar o local da linha e da coluna na janela da sessão na qual você deseja que a seqüência de pressionamentos de teclas comece.

Cadeia
Utilize o campo Entrada de Cadeia para especificar a seqüência de teclas que deseja que a ação de Entrada execute.

Converter Teclas de Ação do Host
O campo Converter Teclas de Ação do Host indica se o tempo de execução da macro deve interpretar nomes de teclas de ação (como [copy], [enterreset], [tab], etc.) na seqüência de teclas de entrada como teclas de ação ou como seqüências literais de caracteres. O padrão é true (interpretar os nomes de teclas de ação como teclas de ação).

Mover Cursor para Final da Entrada
Quando o valor dessa caixa de listagem for true (o padrão), o tempo de execução da macro moverá o cursor de texto da mesma maneira como ele seria movido se um usuário real estivesse digitando entradas no teclado.

Por exemplo, se a tecla for um caractere de texto, como 'a' o tempo de execução da macro digitará o caractere na janela da sessão e moverá o cursor de texto para a posição do primeiro caractere depois de 'a'. De maneira semelhante, se a tecla for [tab], o tempo de execução da macro moverá o cursor de texto para o próximo local tabulado.

Ao contrário, se o valor da caixa de listagem Mover o Cursor para o Final da Entrada for false, o tempo de execução da macro não moverá o cursor de texto de maneira alguma. O cursor de texto permanecerá na mesma posição que ocupava antes do tempo de execução da macro executar a ação de Entrada.

Senha
Selecionar a caixa de opções Senha criptografa a seqüência de teclas de entrada contida no campo de entrada Cadeia. A criptografia permite incluir dados confidenciais (como uma senha) na seqüência de teclas de entrada sem expor os dados confidenciais à exibição acidental de alguém que esteja olhando para o script da macro.

Antes de utilizar esse recurso, você deve ler e compreender a descrição desse recurso na seção Senha do Guia de Programação de Macros.

Siga essas etapas para criptografar a seqüência de tecla de entrada no campo Cadeia: Antes de iniciar, a caixa de opções Senha deve estar limpa (não selecionada).

  1. Se a seqüência de teclas de entrada que você deseja não estiver presente no campo Cadeia, digite a seqüência de teclas de entrada no campo Cadeia.
    • A seqüência de teclas de entrada aparece normalmente no campo Cadeia (por exemplo, 'myPassWord').
    • Se você estiver utilizando um formato avançado de macro, lembre-se de inserir a seqüência de teclas de entrada entre aspas simples ('myPassWord').
  2. Selecione a caixa de opções Senha.
    • O Editor de Macros criptografa a seqüência de teclas de entrada e a exibe no campo Cadeia, utilizando asteriscos (***********************).

Se desejar rever a seqüência de teclas de entrada criptografada ou se decidir que não quer que ela seja criptografada, limpe a caixa de opções Senha. O Editor de Macros descarta a cadeia criptografada e limpa o campo Cadeia. Agora é possível criptografar uma seqüência de teclas de entrada utilizando o método descrito acima ou utilizar uma seqüência de teclas de entrada não criptografada.

Não tente alterar uma seqüência de teclas de entrada criptografada digitando sobre ela ou inserindo caracteres na cadeia de asteriscos no campo Cadeia (*******)! Se o fizer, você danificará a seqüência de teclas de entrada criptografada com suas alterações não criptografadas.

ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.

Extrair

A ação extrair permite capturar texto que o aplicativo está exibindo na tela ou capturar outras informações da tela (dependendo do plano selecionado). Você pode definir opções que salvarão estes dados extraídos para uma variável para utilização posterior ou imprimir os dados. Para obter informações mais detalhadas, consulte Ação Extrair no Guia de Programação de Macros.

Para criar uma nova ação extrair, utilize qualquer um dos métodos a seguir:

Linha de Início e Coluna de Início
Posição do lado esquerdo superior do retângulo de extração limite.
Linha Final e Coluna Final
Posição do lado direito inferior do retângulo de extração limite.
Nome de Extração
Nome da extração. Utilize um nome para identificar o que está sendo extraído da tela de sessão. Este nome é passado para a MacroExtractEvent.
Plano de Dados
Selecione um ou mais dos seguintes planos para a extração. Você deve selecionar pelo menos um plano.
TEXT_PLANE
O plano de texto contém o texto na tela. Quando você inclui uma nova ação de extração, TEXT_PLANE é o plano de dados padrão.
COLOR_PLANE
O plano de cor contém informações sobre as cores de cada caractere do espaço de apresentação.
FIELD_PLANE
O plano de campo representa as posições dos campos e seus atributos no espaço de apresentação.
EXFIELD_PLANE
O plano de campo estendido contém dados de atributos de caracteres estendidos.
DBCS_PLANE
O plano DBCS contém dados de atributos de conjuntos de caracteres de byte duplo para cada atributo de caractere e de campo no espaço de apresentação. Você só poderá selecionar DBCS_PLANE, quando estiver executando uma sessão DBCS.
GRID_PLANE
O plano de grade que contém informações para a exibição da grade.
Desdobrar Texto
Desdobrar texto em um campo que se estende em várias linhas na tela.
Atribuir Plano de Texto a uma Variável
Atribui textos extraídos em uma variável especificada.
ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.
Podem ser digitados números negativos para linhas e colunas. Números negativos são posições virtuais a partir da linha de baixo.

Prompt

Solicita informações ao usuário durante a reprodução da macro. Para obter informações detalhadas, consulte Ação de Prompt no Guia de Programação de Macro.

A janela pop-up de prompt contém texto, um campo de entrada e três botões (OK, Cancelar, Ajuda). O texto solicita informações do usuário (por exemplo, "Digite um ID do usuário:"). Normalmente, o usuário digita caracteres no campo de entrada (como "myuserid") e clica em OK. O tempo de execução da macro lê o texto do campo de entrada, remove a janela pop-up e insere o mesmo texto na janela de sessão iniciando em uma linha específica e localização de coluna que você especificar. Desta forma, essa ação permite que uma macro solicite entrada de texto do usuário e digita esse texto como pressionamentos de teclas em um local específico na janela da sessão.

Linha e Coluna
A linha e a coluna na janela da sessão onde o tempo de execução da macro começa a digitar o texto que foi digitado pelo usuário. Por exemplo, se a Linha for 4 e a Coluna for 12, o tempo de execução da macro digitará o texto na janela da sessão a partir da linha 4, coluna 12.
Nome do Prompt
O texto que você deseja que apareça à esquerda do campo de entrada na janela pop-up. Tipicamente, esse texto indica o tipo de informações solicitadas. Por exemplo, se você desejar que o usuário digite um ID de usuário, o texto do prompt poderá ser Digite seu ID de Usuário:.

Lembre-se de que se a caixa de opções Utilizar Variáveis e Expressões Aritméticas em Macros estiver selecionada, o texto deverá ser inserido entre aspas simples (por exemplo: 'Digite seu ID de usuário:').

Título do Prompt
O texto que você deseja que apareça como o título da janela do prompt. Se esse campo for deixado em branco ou se houver vários prompts na macro e a macro estiver configurada para mostrar todos os prompts no início da macro, o título será "Prompt".
Limpar Campo de Host
Determina se o tempo de execução da macro, antes de digitar o texto na janela da sessão começando no local da Linha e Coluna especificado, limpa o campo na janela da sessão que contém esse local de Linha e Coluna.
Texto do Prompt
Uma descrição do prompt. Esta descrição é apenas informativa. Ela não é exibida.
Resposta Padrão
Texto que o tempo de execução da macro exibe inicialmente no campo de entrada da janela pop-up como uma resposta padrão do usuário. O usuário pode manter essa resposta padrão ou digitar uma resposta diferente. Por exemplo, se o campo de entrada for para um nome de arquivo, o texto padrão poderá ser MyFile. O usuário poderá manter esse texto ou digitar um nome de arquivo diferente.

Se não desejar fornecer um valor padrão, deixe o campo em branco.

Resposta de Senha
Determina se o tempo de execução da macro tratará o texto que o usuário digitar no campo de entrada como informações confidenciais, como uma senha.

Comprimento da Resposta
O comprimento máximo do valor da resposta (número de caracteres).

Converter Teclas de Ação do Host
Aceita mnemônicos de teclas do host, por exemplo [enter], como entrada para um campo na tela de sessão. O padrão é true.

Exigir Resposta
Determina se o tempo de execução da macro desativará o botão OK da janela pop-up até que o campo de entrada da janela pop-up contenha texto. O campo de entrada poderá conter texto porque você especificou uma resposta padrão ou porque o usuário digitou texto no campo de entrada.

Se várias ações de prompt na macro possuírem o campo Resposta Obrigatória definido como true e se o campo Mostrar Todos os Prompts no Início da Macro também estiver definido como true na guia da Macro, no início da reprodução da macro, quando o tempo de execução da macro exibir todos os campos de entrada prompt em uma única janela pop-up, o tempo de execução da macro:

Mover Cursor para Final da Entrada
Coloca o cursor no final do valor de entrada na tela de sessão para ações de entrada subseqüentes. Se as teclas de ação, tais como [tab], [para cima] ou [para baixo], forem incluídas no campo Cadeia, a opção Mover Cursor para Final da Entrada será ignorada pela macro. Isso ocorre porque as teclas de ação requerem que o cursor se mova para um local específico na tela.
Atribuir para uma Variável
Atribui uma entrada de usuário a uma variável especificada. Se a variável for um número inteiro, duplo, booleano ou um campo, a entrada de usuário ou resposta deverá coincidir, caso contrário, ocorrerá um erro ou resultado inesperado. Para obter mais informações sobre os tipos de variáveis, consulte a ajuda on-line de Variáveis.
Não Gravar na Tela
Ativada apenas se você selecionar Atribuir para uma Variável. Se esta opção for marcada, a entrada de usuário será atribuída para uma variável, mas não aparecerá na tela. O padrão é false.
ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.

Mensagem

Exibe uma mensagem ao usuário. Para obter informações mais detalhadas, consulte Ação de Mensagem no Guia de Programação de Macros.

Título da Mensagem
Título que aparece na barra de título na janela de mensagem. O padrão é utilizar o nome da macro.
Texto da Mensagem
Mensagem exibida na janela de mensagem.

Pausar

Pausa a macro pelo período de tempo especificado. Para obter informações detalhadas, consulte Ação de Pause no Guia de Programação de Macros.

Duração
Tempo, em milissegundos, para pausar a macro quando em execução.

Transferir

Transfere um arquivo para/de um host. Clique em Avançado para obter mais opções. Para obter informações mais detalhadas, consulte Ação de Xfer no Guia de Programação de Macros.

Enviar/Receber
Selecione se você estiver enviando ou recebendo arquivos do host.
Nome do Arquivo do Host
Digite o nome do arquivo que você está enviando ou recebendo. O nome do arquivo deve estar no formato de arquivo do host.
Nome do Arquivo Local
Digite o caminho e o arquivo que você está enviando ou recebendo. O nome do arquivo deve estar no formato de arquivo de local. Clique em Navegar para localizar o arquivo em seu sistema.
ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.
Opções Avançadas
Limpar antes de Transferir
Limpa a tela do host antes de transferir o arquivo. Você não deve alterar esta definição porque em quase todo caso, o CMS e o CICS requerem que este comando seja enviado, o que não ocorre com o TSO e o i5/OS e o OS/400.
Tempo Limite
Especifique o tempo (em milissegundos) de espera de transferência de um arquivo. Se a transferência não for concluída neste momento, a macro terminará e exibirá uma mensagem. O padrão é 10000 milissegundos ou 10 segundos.
Opções
Digite as opções específicas do host para a transferência de arquivos. As opções são diferentes para cada tipo de sistema host.
Página de Códigos Local
Selecione a página de códigos local para a transferência. Essa página de códigos deve corresponder à página de códigos definida nas propriedades de configuração da sessão. A página de códigos é uma tabela que converte códigos EBCDIC em códigos locais de 1 byte ou vice-versa, quando os arquivos são transferidos. Apenas as páginas de código válidas para a sua localidade do computador estão incluídas nesta lista.
Orientação do Arquivo do Host
Especifique se os arquivos de host serão salvos no formato da esquerda para a direita ou da direita para a esquerda. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é da esquerda para a direita.
Orientação de Arquivo Local
Especifique se os arquivos locais serão salvos no formato da esquerda para a direita ou da direita para a esquerda. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é da esquerda para a direita.
Tipo de Arquivo Local
Especifique se os arquivos locais transferidos serão salvos no formato em que estão salvos (implícito) ou no formato em que devem ser exibidos. O padrão é implícito. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico.
Expansão de Lam-Alef
Especifique se os arquivos que contêm o caractere Lam_alef devem ser expandidos em dois caracteres, Lam seguido por Alef, quando recebidos do host. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe.
Compactação de Lam-Alef
Especifique se os arquivos que contêm os caracteres Lam seguidos por Alef devem ser compactados em um caractere, Lam_alef, quando enviados para o host. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe.
Troca Simétrica
Especifique se os colchetes devem ser invertidos da origem para o destino. Se a troca simétrica estiver ativada, os colchetes serão revertidos da origem para o destino. Por exemplo, ( é substituído por ) e ) é substituído por ( quando a orientação do arquivo do host for da direita para a esquerda. Se a troca simétrica não estiver ativada, os colchetes não serão revertidos. Utilize essa opção, se a sessão estiver configurada para utilizar uma página de códigos de host em árabe ou hebraico e afetar os colchetes durante a transferência de arquivos.
Formato de Numerais
Especifique como os numerais devem aparece ao enviar arquivos para o host. O Formato de Numerais indica um dos seguintes:
  • Nominal: todos os numerais são arábicos
  • Nacional: todos numerais são hindi.
  • Contextual: numerais são exibidos em arábico depois de texto em inglês ou são exibidos em hindi depois de texto em árabe.
Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe.
Round Trip
Especifique que se os numerais forem precedidos por caracteres árabes, os numerais trocam de lugar com os caracteres árabes ao transferir arquivos. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe.

Espera de Comunicação

Aguarda um status de comunicação do host enquanto a macro está em execução. Para obter informações detalhadas, consulte Ação de Comm wait no Guia de Programação de Macros.

Status da Conexão
O tipo de status de comunicação, conforme definido pela classe ECLConnection, a aguardar.
Tempo Limite
Tempo limite, em milissegundos, para a espera de comunicação. Se um status não for recebido pelo tempo especificado, essa macro será encerrada.
ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.

Mais informações sobre a classe ECLConnection podem ser encontradas no documento Host Access Class Library for Java incluído com o Host On-Demand Toolkit.

Rastreio

Grava um registro de rastreio. Para obter informações mais detalhadas, consulte Ação de Rastreio no Guia de Programação de Macros.

Rotina de Tratamento do Rastreio
Para onde o texto de rastreio é enviado.
Texto do Rastreio
Texto enviado para a rotina de tratamento de rastreio.

Clique do mouse

Define o cursor utilizando um clique do mouse na linha e coluna especificadas. Para obter informações mais detalhadas, consulte Ação de Clique do Mouse no Guia de Programação de Macros.

Linha e coluna
A posição da linha e coluna da tela do host para o clique do mouse.
ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.

Seleção da caixa

Marca uma área na tela, substituindo uma seleção anterior. Para obter informações mais detalhadas, consulte Ação de Seleção de Caixa no Guia de Programação de Macros.

Linha (superior) e Coluna (superior)
Linha superior esquerda do retângulo marcado. Estes valores devem ser números dentro do sistema de coordenadas da tela do host, por exemplo, 24 linhas por 80 colunas. Números negativos são posições virtuais da última linha.
Linha (inferior) e Coluna (inferior)
Linha inferior direita do retângulo marcado. Estes valores devem ser números dentro do sistema de coordenadas da tela do host, por exemplo, 24 linhas por 80 colunas. Números negativos são posições virtuais da última linha.
ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.

Executar programa

Executa um programa, enquanto reproduz a macro. Para obter informações mais detalhadas, consulte Executar Ação de Programas no Guia de Programação de Macros.

Programa
O nome do programa.
Parâmetros
Os parâmetros do programa.
Aguardar Programa
Se esta opção for selecionada, a macro ficará em pausa até a conclusão do programa. O padrão é false.
Atribuir Código de Saída para Variável
Ativado apenas se a opção Aguardar um Programa for verdadeira. Selecione uma variável da lista.

Atualizar Variável

Atualiza uma variável com um novo valor. Para obter informações mais detalhadas, consulte Ação de Atualização de Variáveis no Guia de Programação de Macros.

Nome
Seleciona o nome da variável a ser atualizada.
Tipo
Exibe o tipo de macro selecionada atualmente. Se a variável não estiver definida na macro atual, não aparecerá nenhum tipo.
Valor
Qualquer expressão válida, por exemplo, 'hello', 5 ou $var$ + 1.
Atual
Clique em Atual para atribuir o conteúdo da tela na posição atual do cursor para uma variável. Ao executar a macro, o conteúdo da tela na posição do cursor que você especificou se tornará o valor da variável. Atual é ativado apenas para variáveis de campo.

Reproduzir Macro

Pára a macro atualmente em execução e inicia a reprodução da macro especificada. Você só pode selecionar macros disponíveis na sessão atual. Para obter informações mais detalhadas, consulte Ação PlayMacro no Guia de Programação de Macros.

Nome da Macro
Lista as macros disponíveis por nome.Os nomes de macros têm distinção entre maiúsculas e minúsculas! Portanto, mymacro é um nome diferente de MyMacro, MyMacrO, myMacro e assim por diante.
Descrição da Macro
A descrição dada a macro ao criá-la.
Nome da Tela Inicial
Lista todas as telas para a macro selecionada, assim como a *DEFAULT*.Se você selecionar uma tela específica da lista, a macro encadeada será iniciada na tela especificada. Se você selecionar *DEFAULT*, a macro será iniciada na tela que você definiu como a tela de início ao criar a macro.
Transferência de Variável
Se a opção Transferir for selecionada, todas as variáveis atuais serão transferidas para a próxima macro em execução. O padrão é Não Transferir.

Executar

Chama um método em uma instância de uma classe. O tipo que representa a classe importada deve ser declarado na guia Variáveis, a menos que a variável que contém a instância seja herdada de outra macro. Para obter informações mais detalhadas, consulte Ação de Execução no Guia de Programação de Macros.

Ação a Ser Executada
A chamada para o método ou construtor.
Exemplo Comentários
$fis.close()$ Chama o método close() da classe Java (tal como, java.io.FileInputStream) que suporta o tipo importado ao qual a variável fis pertence.
$zis.createZipEntry( $name$ )$ Chama o método createZipEntry() da classe Java (tal como, java.util.zip.ZipInputStream) que suporta o tipo importado ao qual a variável zis pertence.
$userVar.update( 5, 'Application', $str$)$ Chama o método update() da classe Java (tal como, mypackage.MyClass) que suporta o tipo importado ao qual a variável userVar pertence.

Condicional

Permite que você coloque condições nas ações. Se desejar utilizar a ação Condicional, selecione Utilizar Variáveis e Expressões Aritméticas na Macro na guia Macro do Editor de Macros. Caso contrário, sua macro poderá não funcionar conforme o esperado. Para obter informações mais detalhadas, consulte Ação Condicional no Guia de Programação de Macros.

Condição
Digite uma condição válida, por exemplo, ($varA$ == 'abc') && ($varB$ != 1). Se você não digitar uma condição, o padrão será true. A tabela a seguir mostra a sintaxe das condições:
Símbolo Definição
== igual a
!= diferente de
< menor que
> maior que
<= menor que ou igual a
>= maior que ou igual a
|| ou
&& e
! não

Você pode utilizar parênteses para mostrar a ordem de operações e pode incluir expressões aritméticas como termos em expressões condicionais. Por exemplo, a expressão a seguir é avaliada como true:
(((5+2)*3) == 21)

A condição é verdadeira
Se a condição for verdadeira, as ações que aparecem na lista Ações serão executadas na tela. Para cada ação condicional criada, é possível especificar uma condição, junto com um conjunto de ações a serem executadas, se a condição for verdadeira e um conjunto diferente de ações a serem executadas, se a condição for falsa.
Ação
É possível criar qualquer ação para uma ação condicional, exceto para outra ação condicional.
A condição é falsa
Se a condição for falsa, as ações que aparecem na lista Ações serão executadas na tela.

O campo Condição ficará inativo. Para cada ação condicional criada, é possível especificar uma condição, junto com um conjunto de ações a serem executadas, se a condição for verdadeira e um conjunto diferente de ações a serem executadas, se a condição for falsa.

Ação
É possível criar qualquer ação para uma ação condicional, exceto para outra ação condicional.

Exemplo de uma ação condicional

Nesse exemplo, sua macro tem uma ação do programa de execução que atribui um código de saída para a variável $exit$ (0 se o programa for executado com êxito e qualquer número diferente de 0, se ele não for executado com êxito). É possível utilizar a ação condicional para exibir uma mensagem, se o código de saída for 0 (êxito) e outra mensagem, se o código de saída for diferente de zero (falha). Conclua as seguintes etapas, para criar a ação condicional:

  1. No Editor de Macros, abra a sua macro que executa o programa.
  2. Na guia Telas, selecione a tela com a ação do programa de execução. Na guia Ações, selecione <nova ação condicional> da lista Ação.
  3. No campo Condição, digite a condição $exit$ == 0.
  4. Na guia Condição é Verdadeira, selecione <nova ação da mensagem> da lista Ação.
  5. No campo Texto da Mensagem, digite 'Program executed successfully'.

    Se a condição for verdadeira, por exemplo, se o código de saída para o seu programa for 0, aparecerá uma mensagem informando que o programa foi executado com êxito. Você pode especificar mais ações nessa guia. A macro executará essas ações se o código de saída for 0.

  6. Na guia Condição é Falsa, selecione <nova ação da mensagem> da lista Ação.

    Nota: O campo Condição ficará inativo. Para cada ação condicional criada, é possível especificar uma condição, junto com um conjunto de ações a serem executadas, se a condição for verdadeira e um conjunto diferente de ações a serem executadas, se a condição for falsa. Atualmente, não deve haver ações definidas na guia Condição é Falsa.

  7. No campo Texto da Mensagem, digite 'Program exited abnormally with an exit code of: ' + $exit$

    Se a condição for falsa, por exemplo, se o código de saída para o seu programa não for 0, aparecerá uma mensagem informando que o programa foi encerrado com erro e o código de saída será exibido. Você pode especificar mais ações nessa guia. A macro executará essas ações apenas se o código de saída não for 0.

Agora sua macro está pronta. Se você selecionar a janela Editar Código no Editor de Macros, deverá visualizar o seguinte código:


        <actions>
           ...
            <if condition="$exit$ == 0" >
                  <message title="" value="'Program executed successfully'" />
            </if>
            <else>
                  <message title="" value="'Program exited abnormally with an exit code of: '+$exit$" />
            </else>
           ...
        </actions>
        

Nota: A comutação entre a guia Condição é Verdadeira e a guia Condição é Falsa que ocupa a lista Ação com as ações do bloco <if> e as ações do bloco <else>, respectivamente.

Iniciar Impressão

Inicia uma sessão de impressão para esta macro. Se uma sessão de impressão já estiver iniciada para esta macro, essa sessão será finalizada e uma nova sessão de impressão será iniciada utilizando a configuração da impressora e configuração da página especificadas para esta ação Iniciar Impressão. Para obter informações mais detalhadas, consulte Ações de Impressão no Guia de Programação de Macros.

Nota Print Start is supported for 3270 Display sessions only.
Configuração da Impressora
Exibe uma janela de configuração da impressora que permite fazer a configuração da impressora para esta sessão de impressão. Essa janela de configuração da impressora é semelhante à janela Impressora que é exibida para uma Sessão de Impressora 3270.
Configuração de Página
Exibe uma janela de configuração da página que permite fazer a configuração da página para esta sessão de impressão. Essa janela de configuração da página é semelhante à janela Configuração da Página que é exibida para uma Sessão de Impressora 3270.
Atribuir Código de Retorno a uma Variável
Permite atribuir a uma variável o código de retorno a partir da tentativa de iniciar uma sessão de impressão. Para escolher uma variável, clique no nome de uma variável existente ou clique em <Nova Variável> para criar uma nova variável.
Nota O código de retorno será 0 para êxito ou -1 para falha. Além disso, há alguns erros da impressora que podem fazer com que a macro seja finalizada com erros.

Extrair Impressão

Copia dados de uma área retangular da tela e envia-os para o destino de impressão atual. Se uma ação Iniciar Impressão não tiver sido executada, uma ação Iniciar Impressão com uma configuração da impressora padrão e uma configuração da página padrão será enviada para o destino de impressão antes da execução desta ação Extrair Impressão. Para obter informações mais detalhadas, consulte Ações de Impressão no Guia de Programação de Macros.

Nota Extrair Impressão é suportado apenas em Sessões de Exibição 3270.

Você deve utilizar a ação Extrair Impressão com as ações Iniciar Impressão e Finalizar Impressão da seguinte forma:

  1. Execute uma ação Iniciar Impressão para iniciar uma sessão de impressão.
  2. Execute ações Extrair Impressão para enviar dados para o destino de impressão.
  3. Execute uma ação Finalizar Impressão para finalizar a sessão de impressão.
Linha de Início e Coluna de Início
Canto superior esquerdo do retângulo de extração delimitado.
Linha Final e Coluna Final
Canto inferior direito do retângulo de extração delimitado.
Atribuir Código de Retorno a uma Variável
Permite atribuir a uma variável o código de retorno a partir da tentativa de enviar os dados extraídos para o destino de impressão. Para escolher uma variável, clique no nome de uma variável existente ou clique em <Nova Variável> para criar uma nova variável.
Nota O código de retorno será 0 para êxito ou -1 para falha. Além disso, há alguns erros da impressora que podem fazer com que a macro seja finalizada com erros.
ID do Host
A sessão a qual esta ação é aplicável. Deixe o campo ID do Host em branco para aplicar a ação à sessão que ativa a macro. Consulte Especificando um ID de Host.

Finalizar Impressão

Permite finalizar uma sessão de impressão. Para obter informações mais detalhadas, consulte Ações de Impressão no Guia de Programação de Macros.

Nota Finalizar Impressão é suportado apenas em Sessões de Exibição 3270.
Atribuir Código de Retorno a uma Variável
Permite atribuir a uma variável o código de retorno a partir da tentativa de enviar os dados extraídos para a impressão Para escolher uma variável, clique no nome de uma variável existente ou clique em <Nova Variável> para criar uma nova variável.
Nota O código de retorno será 0 para êxito ou -1 para falha. Além disso, há alguns erros da impressora que podem fazer com que a macro seja finalizada com erros.

SQLQuery

Envia uma instrução SQL para um servidor remoto de banco de dados, recupera os dados resultantes da instrução e exibe os dados, grava os dados em uma variável global ou grava os dados em um arquivo. Para obter detalhes adicionais, consulte Ação SQLQuery no Guia de Programação de Macros.

A ação SQLQuery suporta apenas instruções SQL do tipo Select. Ela não suporta instruções SQL do tipo Insert, Update ou Delete.

A ação SQLQuery possui duas seções principais: uma seção de instrução e uma seção de resultado.

A seção de instrução ocupa a área superior da janela e inclui os seguintes campos: URL do Banco de Dados, Identificador do Driver, Classe do Driver, ID do Usuário, Senha e Instrução. É possível modificar as informações nesta seção de três maneiras:

É possível editar qualquer um dos campos a qualquer hora, digitando no campo.

A seção resultante ocupa a área inferior da janela e inclui os campos restantes: Resultado da Saída para, Nome do Arquivo, Mostrar no Navegador da Web, Tipo de Arquivo, Manter na Janela de Saída, Sobrescrever e Anexar. É possível utilizar os campos desta seção para direcionar os dados resultantes de uma instrução SQL em uma de três maneiras:

Assistente para SQL
Clique em Assistente para SQL para chamar o Assistente para SQL:
  1. Com o Assistente para SQL é possível criar uma instrução SQL, testá-la e exibir os resultados.
  2. Quando tiver criado a instrução SQL que deseja utilizar na macro, execute uma das seguintes ações para salvar a instrução SQL e suas informações associadas na janela Ação SQLQuery do Editor de Macros:
    • Se você estiver executando um navegador Java 1:
      • Na guia SQL, clique em Salvar SQL; ou
      • Na guia Resultados, clique em Salvar SQL.
    • Se estiver executando um navegador ativado para Java 2:
      • Na guia Rever, clique em Salvar; ou
      • Na guia Resultados, clique em Salvar SQL.
  3. O Assistente para SQL grava a instrução SQL e suas informações associadas nos campos apropriados da janela Ação SQLQuery no Editor de Macros. Para obter uma descrição dos campos atualizados, consulte Utilizando o Assistente para SQL no Guia de Programação de Macros.
  4. Quando tiver concluído o Assistente para SQL, clique em Cancelar para fechá-lo.
Importar Consulta
Clique em Importar Consulta para importar uma instrução SQL. É possível importar uma instrução SQL na sessão atual ou em uma Biblioteca Pessoal.
URL do Banco de Dados
Digite uma URL de banco de dados (consulte Especificando uma URL de banco de dados).
Identificador do Driver
A caixa de listagem inclui os nomes de todos os drivers JDBC que foram registrados com o Host On-Demand. Expanda a caixa de listagem e clique no nome do driver JDBC registrado que você deseja utilizar ou clique em Outros para especificar outros drivers.

Para obter informações gerais sobre a utilização de um driver JDBC, consulte Registrando um Driver JDBC.

Classe do Driver
O nome completo da classe Java do driver JDBC.
ID do Usuário
ID do usuário necessário para acessar o banco de dados (se necessário.)
Senha
Senha necessária para acessar o banco de dados (se necessário.)
Instrução
A instrução SQL que você deseja enviar ao servidor do banco de dados. Se o campo Instrução já contiver uma instrução SQL, você poderá editá-la (mesmo que a instrução SQL tenha sido importada ou tenha sido criada utilizando o Assistente para SQL).
Resultado da Saída para:
Seleciona o destino da saída dos dados resultantes de uma instrução SQL:
Nome do Arquivo
Quando o campo Resultado da Saída para for Arquivo, digite o caminho do arquivo de saída nesse campo. Nota: É necessário especificar um caminho e nome de arquivo completos, incluindo a letra da unidade, se houver (por exemplo, c:\Documents and Settings\user1\output.txt).
Mostrar no Navegador da Web
Quando o campo Resultado da Saída para for Arquivo, selecione essa caixa de opções para exibir o conteúdo do arquivo no navegador padrão. O navegador deve possuir o plug-in requerido.

Para alguns navegadores, é necessário estabelecer as configurações de segurança do navegador, para permitir que um applet ou aplicativo Java ative uma instância do navegador para exibir um arquivo local (consulte Configurando um Navegador para Exibir um Arquivo Local ).

Tipo de Arquivo
Quando o campo Resultado da Saída Para for Arquivo, clique no formato (como Texto ASCII, valores separados por vírgula e assim por diante) que você deseja que o Host On-Demand utilize para o arquivo de saída.
Janela Suspender Saída
Quando o campo Resultado da Saída Para for Exibir, selecione essa caixa de opções para fazer com que o tempo de execução da macro aguarde para processar a próxima ação, até que o usuário clique em Continuar na janela de exibição.
Sobrescrever, Anexar
Quando o Resultado da Saída para for Arquivo, clique em Sobrescrever para sobrescrever o conteúdo de um arquivo existente ou clique em Anexar para anexar os dados a um arquivo existente. Se o arquivo não existir, qualquer uma das opções Sobrescrever ou Anexar criará o novo arquivo.
Opções Avançadas
Tipo de Arquivo Local
Essa opção especifica se os arquivos locais estão em formato Lógico ou Visual. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é Lógico.
Orientação de Arquivo Local
Essa opção especifica se os arquivos locais estão no formato da esquerda para a direita ou da direita para a esquerda. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é da Esquerda para a Direita.
Tipo de Arquivo do Host
Essa opção especifica se o arquivo do Host deve ser salvo em formato lógico ou visual. Essa opção deve ser visual para host zSeries. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é Visual. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Orientação de Arquivo do Host
Essa opção especifica se o arquivo do Host deve ser salvo em formato da esquerda para a direita ou da direita para a esquerda. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é da Esquerda para a Direita.(Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Expansão de Lam-Alef
Essa opção especifica o comportamento dos caracteres Lam-Alef. Ao receber dados em árabe do host através da instrução do Assistente para SQL, o caractere Lam-Alef é expandido em dois caracteres, Lam seguido de Alef, se houver espaço após o caractere Lam-Alef. Essa opção é ativada apenas para uma sessão configurada para utilizar uma página de códigos no host em árabe. O padrão é ativado.
Compactação de Lam-Alef
Essa opção especifica o comportamento dos caracteres Lam-Alef. Ao enviar dados em árabe para o host através da instrução de Upload de Arquivos, os caracteres Lam seguido por Alef são compactados em um caractere e é incluído espaço após o caractere Lam-Alef. Essa opção é ativada apenas para uma sessão configurada para utilizar uma página de códigos no host em árabe. O padrão é ativado. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Troca Simétrica
Essa opção especifica o comportamento dos caracteres simétricos, como colchetes. A inversão da tela faz com que os caracteres bidirecionais sejam substituídos por seus equivalentes. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é ativado. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Round Trip
Essa opção especifica o comportamento dos numerais, em que a reversão dos numerais será desativada se estiverem precedidos por caracteres árabes/hebraicos. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é ativado.
Formato de Numeral
Essa opção especifica o formato do numeral no arquivo do Host na instrução de Upload de Arquivos. O formato do numeral poderia ser NOMINAL, NATIONAL e CONTEXTUAL. Essa opção é ativada apenas para uma sessão configurada para utilizar uma página de códigos no host em árabe. O padrão é NOMINAL. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)

FileUpload

Permite criar, substituir, anexar dados ou atualizar uma tabela em um banco de dados remoto. Para obter informações mais detalhadas, consulte Ação de FileUpload no Guia de Programação de Macros.

URL do Banco de Dados
Digite uma URL de banco de dados (consulte Especificando uma URL de banco de dados).
Identificador do Driver
A caixa de listagem inclui os nomes de todos os drivers JDBC que foram registrados com o Host On-Demand. Expanda a caixa de listagem e clique no nome do driver JDBC registrado que você deseja utilizar ou clique em Outros para especificar outros drivers.

Para obter informações gerais sobre a utilização de um driver JDBC, consulte Registrando um Driver JDBC.

Classe do Driver
O nome completo da classe Java do driver JDBC.
ID do Usuário
ID do usuário necessário para acessar o banco de dados (se necessário.)
Senha
Senha necessária para acessar o banco de dados (se necessário.)
Nome do Arquivo
O caminho do arquivo local que contém os dados que você deseja incluir na tabela no banco de dados do host. NOTA: É necessário especificar um caminho e nome de arquivo completos nesse campo, incluindo a letra da unidade, se houver (por exemplo, c:\Documents and Settings\user1\input.txt).
Tipo de Arquivo
O formato (como por exemplo Texto ASCII, Valores separados por vírgula e assim por diante) do arquivo local contendo os dados que você deseja incluir na tabela no banco de dados do host.
Tipo de Upload
A operação de Upload de Arquivos que você deseja executar:
Nome da Tabela
O nome (como hodtest01) ou o esquema e o nome (como hod.hodtest01) da tabela do banco de dados do host a qual você deseja anexar, atualizar, substituir ou criar.
Tabela de Descrições de Campos
Para uma operação create, digite o nome da tabela no banco de dados do host da qual você deseja que o servidor de banco de dados leia os nomes das colunas e as larguras das colunas para a nova tabela.
Colunas-Chave
Para uma operação update, digite o nome ou nomes da coluna ou colunas que deseja atualizar.
Opções Avançadas
Tipo de Arquivo Local
Essa opção especifica se os arquivos locais estão em formato Lógico ou Visual. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é Lógico.
Orientação de Arquivo Local
Essa opção especifica se os arquivos locais estão no formato da esquerda para a direita ou da direita para a esquerda. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é da Esquerda para a Direita.
Tipo de Arquivo do Host
Essa opção especifica se o arquivo do Host deve ser salvo em formato lógico ou visual. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é Visual. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Orientação de Arquivo do Host
Essa opção especifica se o arquivo do Host deve ser salvo em formato da esquerda para a direita ou da direita para a esquerda. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é da Esquerda para a Direita.(Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Expansão de Lam-Alef
Essa opção especifica o comportamento dos caracteres Lam-Alef. Ao receber dados em árabe do host através da instrução do Assistente para SQL, o caractere Lam-Alef é expandido em dois caracteres, Lam seguido de Alef, se houver espaço após o caractere Lam-Alef. Essa opção é ativada apenas para uma sessão configurada para utilizar uma página de códigos no host em árabe. O padrão é ativado.
Compactação de Lam-Alef
Essa opção especifica o comportamento dos caracteres Lam-Alef. Ao enviar dados em árabe para o host através da instrução de Upload de Arquivos, os caracteres Lam seguido por Alef são compactados em um caractere e é incluído espaço após o caractere Lam-Alef. Essa opção é ativada apenas para uma sessão configurada para utilizar uma página de códigos no host em árabe. O padrão é ativado. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Troca Simétrica
Essa opção especifica o comportamento dos caracteres simétricos, como colchetes. A inversão da tela faz com que os caracteres bidirecionais sejam substituídos por seus equivalentes. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é ativado. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Round Trip
Essa opção especifica o comportamento dos numerais, em que a reversão dos numerais será desativada se estiverem precedidos por caracteres árabes/hebraicos. Utilize esta opção se a sessão for configurada para utilizar uma página de códigos em árabe ou em hebraico. O padrão é ativado.
Formato de Numeral
Essa opção especifica o formato do numeral no arquivo do Host na instrução de Upload de Arquivos. O formato do numeral poderia ser NOMINAL, NATIONAL e CONTEXTUAL. Essa opção é ativada apenas para uma sessão configurada para utilizar uma página de códigos no host em árabe. O padrão é NOMINAL. (Essa opção não é ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)

Para excluir uma ação definida, selecione-a e clique em Excluir.

Clique em Ordem, para alterar a ordem em que as ações devem ser executadas na tela.

Tópicos Relacionados

  • Suporte ao idioma bidirecional
  • Transferindo arquivos
  • Variáveis
  • Guia de Programação de Macro