Rational Developer para System z, Versão 7.5

Integração de Menus com o Gerenciador de Menus

Muitas das funções fornecidas pelos comandos TSO precisam ser integradas à experiência do usuário do Rational Developer para System z. Isso é fornecido pelo Gerenciador de Menus. O gerenciador de menus fornece um conjunto de painéis onde é possível definir ações e pares de nome, incluídos em um menu suspenso quando você clica com o botão direito do mouse. Quando as definições são estabelecidas, você pode selecionar um Nome (conforme definido nas preferências do gerenciador de menus) e a ação a qual ele está associado é executada. Essas preferências do gerenciador de menus são gravadas em um documento XML que pode ser compartilhado ou estar disponível em um lugar central (por exemplo, em um host) para ser importado pelos outros usuários.

Introdução ao Gerenciador de Menus

Os itens de menu são configurados pela página Preferências do Gerenciador de Menus. Para acessar a página Preferências do Gerenciador de Menus, selecione Janela -> Preferências -> Gerenciador de Menus. A página de preferências do Gerenciador de Menus é exibida.

Página Preferências

Geralmente, você pode aceitar os valores padrão e clicar em Ações e Menus para avançar.

Na primeira vez em que você acessar o painel Ações e Menus, terá de definir um novo arquivo XML para armazenar as configurações e detalhes das ações definidas. Haverá duas opções para o arquivo: iniciar com um arquivo novo ou importar de um arquivo de outra origem. Em ambos os casos, o arquivo novo ou importado poderá residir na máquina local, no servidor de rede ou no mainframe, nos Arquivos do z/OS UNIX. Se o arquivo for iniciado no MVS do mainframe, ele poderá ser transferido por download para o cliente Windows (por exemplo, com RSE) e importado em seguida. Você pode ter vários arquivos XML, mas somente um ficará ativo por vez.
Nota: Se o arquivo XML for importado, modifique-o e importe uma versão atualizada; suas modificações originais serão perdidas.

Especificando Programação e Interfaces com o Usuário

Para criar uma nova ação, execute as seguintes etapas:
  1. Clique no botão Nova Ação Local/Remota.
  2. Na Página Nova Ação, especifique um Nome. Este será exibido no menu suspenso, portanto, precisa ser exclusivo em relação às demais ações que possam ter sido definidas. Opcionalmente, é possível incluir um comentário para ser exibido na área de comentário, na parte inferior da tela de seleção de nome no menu.
  3. Selecione uma ação que emitirá o comando que você está definindo.
    • com.ibm.ftt.ui.menumanager.tsoaction - Cria um item de menu que será associado a um comando TSO.
    • com.ibm.ftt.ui.menumanager.mfiaction - Cria um item de menu que será associado a um aplicativo da Web HATS ou a qualquer outra solicitação de HTTP.
    • com.ibm.ftt.ui.menumanager.mfiaction - Cria um item de menu que será associado a uma janela do emulador de tela inteira. Isso não deve ser necessário porque o acesso ao emulador está integrado ao projeto z/OS e o menu RSE é parte do produto Rational Developer para System z básico.

Definindo uma Ação de Comando TSO

O campo mais importante da janela de definição Detalhes da Ação é Comando. Esse é o comando TSO emitido quando o item de menu é chamado. Variáveis de substituição predefinidas do formulário $variable ou ${variable} podem ser usadas como parte do comando. O valor da variável de substituição depende da seleção atual. A Tabela 1 mostra uma lista de variáveis reconhecidas. O menu deve estar associado a uma ou mais extensões de arquivo. Extensões de arquivo adicionais podem ser definidas utilizando o botão Tipos de Arquivo.

Definindo um Detalhe da Ação de Comando de Aplicativo Rich Client HATS

Para definir uma ação que chame um aplicativo rich client HATS específico, o formato do comando deve ser determinado levando em consideração se o aplicativo rich client HATS está ou não designado para executar uma conexão única:
  • Se o aplicativo não desempenhar uma conexão automática, o formato do comando será a URL do aplicativo HATS. Por exemplo: HATSRCP=appname onde appname é o nome do aplicativo rich client HATS. Ou, se o aplicativo tiver parâmetros, o comando poderá ser semelhante ao que segue se o aplicativo solicitar parâmetros: HATSPCP=appname hatsgv_userid hatsgv_password
  • Se o aplicativo efetuar o sign on automatizado, o Rational Developer para System z substituirá o ID do usuário e senha, contanto que você especifique o nome das variáveis para o ID do usuário e senha que devem ser incluídos no comando HATS. Para HATS, as variáveis globais são especificadas no formato a seguir no comando HATS: HATSPCP=appname hatsgv_userid hatsgv_password
    Além dos parâmetros ID do usuário e senha, é possível especificar parâmetros adicionais a serem transmitidos ao HATS. Por exemplo:
    HATSRCP=HCmvs211Parms hatsgv_userid hatsgv_password hatsgv_var1=value1 hatsgv_var2=value2 hatsgv_var3=value3
    No exemplo acima, o aplicativo da Web HATS é chamado e o ID do usuário e senha são transmitidos. Adicionalmente, três outros parâmetros (hatsgv_var1, hatsgv_var2 e hatsgv_var3) são transmitidos, juntamente com seus valores correspondentes. Observe que mais de três parâmetros podem ser transmitidos.
  • Se o aplicativo efetuar o sign on automatizado, o Rational Developer para System z substituirá o ID do usuário e senha, contanto que você especifique o nome das variáveis para o ID do usuário e senha que devem ser incluídos no comando HATS. Para o HATS, as variáveis locais são especificadas no seguinte formato no comando do HATS:
    http://hostname/appname/?parameter1=one hatsgv_userid hatsgv_password 

    Deve haver um espaço entre a HATSRCP=appname e hatsgv_userid e entre hatsgv_userid e hatsgv_password. As regras de substituição usadas pelo Rational Developer para System z são mostradas em Substituição de Variável. Os nomes das variáveis globais para o id de usuário e senha não são importantes (exceto se o HATS solicitar o prefixo hatsgv_ para saber se um parâmetro especificado é uma variável global). O que é importante é que hastgv_userid será interpretado como o ID e hatsgv_password será interpretado como a senha.

    Além dos parâmetros ID do usuário e senha, é possível especificar parâmetros adicionais a serem transmitidos ao HATS. Por exemplo:
    http://hostURL/myapp?tabs1=structures hatsgv_userid hatsgv_password var1=value1 var2=value2 var3=value3
    No exemplo acima, o aplicativo da Web HATS é chamado e o ID do usuário e senha são transmitidos. Adicionalmente, três outros parâmetros (hatsgv_var1, hatsgv_var2 e hatsgv_var3) são transmitidos, juntamente com seus valores correspondentes. Observe que mais de três parâmetros podem ser transmitidos.
    A URL resultante, quando chamada, será a seguinte:
    http://hostURL/myapp?tabs1=structures&hatsgv_userid=userid&hatsgv_password=password&var1=value1&var2=value2&var3=value3
    Para a interface da Web, a URL especificada no comando pode ser com ou sem parâmetros na própria URL. A Conexão de Host detecta corretamente isso e faz o ajuste adequado. Por exemplo, sem nenhum parâmetro na própria URL, fica da seguinte maneira:
    http://hostURL/myapp hatsgv_userid hatsgv_password var1=value1 var2=value2 var3=value3
    E com os parâmetros na URL, fica da seguinte maneira:
    http://hostURL/myapp?tabs1=structures&oneparm=good  hatsgv_userid hatsgv_password var1=value1 var2=value2 var3=value3

Substituição de Variável

A Tabela 1 mostra a lista de variáveis de substituição definidas que podem ser utilizadas para construir um comando.

Tabela 1. Substituição de Variável
Variável Descrição (Description)
$clientaddress  
$userid ID do usuário conectado ao sistema associado ao recurso selecionado
$systemhostname Nome do host ou endereço IP do sistema associado ao recurso selecionado
$systemname Nome da conexão associada ao recurso selecionado (ou sejam o nome "abreviado" do sistema)
$datasetname Nome do conjunto de dados que contém o recurso selecionado
$systemhostname Nome do host do endereço IP do sistema associado ao recurso selecionado
$fullname Nome completo do recurso selecionado no formato DATATSETNAME(MEMBERNAME).
$name nome do recurso selecionado
$projectname Nome do projeto associado ao recurso selecionado

Para mostrar o item no menu de contexto, selecione Mostrar no Menu Genérico ao definir o item de menu.

Selecione os tipos de arquivo aos quais esse comando deve ser associado. É possível selecionar todos eles clicando no botão Selecionar Todos ou selecionar tipos de arquivo individuais marcando a caixa de seleção ao lado do tipo de arquivo apropriado. Se um tipo de arquivo estiver ausente, poderá ser incluído com o botão Tipos de Arquivo.

O item de menu deverá ser incluído em um menu. Menus podem ser definidos e itens de menu (ações) podem ser associados a ele utilizando a página Menus na página de preferências Ações e Menus. Para acessar a página de preferências Ações e Menus, selecione Janela -> Preferências -> Gerenciador de Menus ->Ações e Menus.

Quando o item de menu for incluído no menu, o menu deverá ser selecionado como o arquivo básico, o menu de arquivos padrão, ou ambos. Isso é feito usando a página de preferências Seleção de Menu. Para acessar a página de preferências Seleção de Menu, selecione Janela -> Preferências -> Gerenciador de Menus -> Seleção de Menu

Os itens de menu definidos com a opção Mostrar no Menu Genérico ou que foram incluídos em um menu que está ativo para a visualização atual serão mostrados no menu de contexto. Clicar com o botão direito do mouse no objeto apropriado na visualização dos projetos z/OS exibe o menu de contexto.

A saída da ação (se houver) será exibida no console do TPF Toolkit. Isso está consistente com a saída de ações locais.

Alterando uma Definição de Ação Existente

Para alterar uma definição de ação existente, selecione a ação que você deseja alterar, clique com o botão direito do mouse e selecione Editar.

Na janela Editar Informações sobre a Ação, é possível alterar as propriedades associadas ao comando, incluindo os tipos de arquivo associados.


Termos de Uso | Feedback

Este centro de informações foi desenvolvido com a tecnologia Eclipse. (http://www.eclipse.org)