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.
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.
Geralmente, você pode aceitar os valores padrão e clicar em Ações e Menus para avançar.
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.
HATSRCP=HCmvs211Parms hatsgv_userid hatsgv_password hatsgv_var1=value1 hatsgv_var2=value2 hatsgv_var3=value3No 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.
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.
http://hostURL/myapp?tabs1=structures hatsgv_userid hatsgv_password var1=value1 var2=value2 var3=value3No 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.
http://hostURL/myapp?tabs1=structures&hatsgv_userid=userid&hatsgv_password=password&var1=value1&var2=value2&var3=value3Para 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=value3E 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
A Tabela 1 mostra a lista de variáveis de substituição definidas que podem ser utilizadas para construir um comando.
| 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.
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.