sm_cmd_opt (opção de comando do SMIT dialog/seletor) classe de objeto

Editar online

Cada objeto em um diálogo, exceto o objeto de cabeçalho de diálogo, normalmente corresponde a uma sinalização, opção ou atributo do comando que o diálogo executa.

Um ou mais desses objetos é criado para cada diálogo SMIT; um diálogo fantasma pode não ter objetos de opção de comando de diálogo associado. Cada tela do seletor é composta por um objeto de cabeçalho do seletor e um objeto de opção de comando seletor.

Nota: Ao codificar um objeto nesta classe de objetos, configure strings vazias não usadas para""(marcas de aspas duplas) e campos inteiros não utilizados para0.

O objeto de opção de comando de diálogo e o objeto de opção de comando do seletor são ambos os objetos sm_cmd_opt . Os descritores para a classe de objeto sm_cmd_opt e suas funções são:

Descritor Função
id O ID ou o nome do objeto. O id do objeto de diálogo associado ou do cabeçalho do seletor pode ser usado como um caminho rápido para este e outros objetos de diálogo no diálogo. O valor de id é uma string com um comprimento máximo de 64 caracteres. Todos os objetos de diálogo que aparecem em um diálogo devem ter o mesmo ID. Também, IDs devem ser exclusivos de sua aplicação e exclusivos dentro do banco de dados SMIT em particular utilizado.
id_seq_num A posição deste item em relação a outros itens no diálogo; sm_cmd_opt objetos em um diálogo são classificados neste campo string. O valor de id_seq_num é uma string com um comprimento máximo de 16 caracteres. Quando este objeto faz parte de uma tela de diálogo, a string"0"não é um valor válido para este campo. Quando este objeto faz parte de uma tela seletora, o descritor id_seq_num deve ser configurado como 0.
nome_do_campo_do_disco Uma string que deve corresponder a um dos campos de nome na saída do comando cmd_to_discover no cabeçalho de diálogo associado. O valor de disc_field_name é uma string com um comprimento máximo de 64 caracteres.

O valor do descritor disc_field_name pode ser definido usando o nome bruto ou cozido de um seletor anterior em vez do comando cmd_to_discover no objeto de cabeçalho associado. Se o descritor for definido com entrada de um seletor anterior, ele deverá ser configurado como"_rawname"ou"_cookedname", ou para o correspondentesm_name_hdr.cooked_field_namevalor ousm_name_hdr.raw_field_namevalor se este foi usado para redefinir o nome padrão.
nome A string que aparece na tela de diálogo ou seletor como o nome do campo. É o questionamento visual ou a solicitação de parte do objeto, uma descrição de linguagem natural de uma bandeira, opção ou parâmetro do comando especificado nocmd_to_execcampo do objeto de cabeçalho de diálogo associado. O valor de name é uma string com um comprimento máximo de 1024 caracteres.
nome_msg_arquivo O nome do arquivo (não o nome completo do caminho) que é o catálogo do Message Facility para a string, name. O valor de nome_msg_file é uma string com um comprimento máximo de 1024 caracteres. Os catálogos de mensagens requeridos por um programa de aplicativos podem ser desenvolvidos com o Message Facility. Configure para""(string vazia) se não for usada.
nome_msg_set O ID do conjunto de Message Facility para a string, name. O valor de name_msg_set é um inteiro. Configure para0se não usado.
nome_msg_id O ID de mensagem do Message Facility para a string, name. O valor de name_msg_id é um inteiro. Configure para0se não usado.
tipo de operação O tipo de operação auxiliar suportado para este campo. O valor de op_type é uma string. Os valores válidos são:

"" ou "n" -Este é o caso padrão. Nenhuma operação auxiliar (lista ou seleção de anel) são suportadas para este campo.

"l" -Lista de seleção de lista fornecida. Uma janela pop-up exibe uma lista de itens produzidos pela execução do comando nocmd_to_listcampo deste objeto quando o usuário seleciona a função F4=List da interface SMIT.

"r" -Operação de seleção de anel fornecida. A sequência nodisp_valuesouaix_valuescampo é interpretado como um conjunto delimitado por vírgula de entradas válidas. O usuário pode guia ou backtab através desses valores para fazer uma seleção. Além disso, a função de interface F4=List pode ser usada neste caso, uma vez que o SMIT transformará o anel em uma lista conforme a necessidade.

Os valores"N","L"e"R"podem ser usados como valores op_type apenas como os valores minúseros"n","l"e"r". No entanto, com os valores de uppercase, se o comando cmd_to_exec for executado e retornar com um valor de saída de0, em seguida, o campo de entrada correspondente será liberado para uma sequência vazia.
entry_type O tipo de valor exigido pelo campo de entrada. O valor de entry_type é uma string. Os valores válidos são:

"" ou "n" -Nenhuma entrada; o valor atual não pode ser modificado via direct type-in. O campo é apenas informativo.

"t" -Entrada de texto; entrada alfanumérica pode ser digitada.

" #" -Entrada numérica; apenas os caracteres numéricos0,1,2,3,4,5,6,7,8ou9pode ser inserido. A-(sinal de menos) ou+(mais sinal) pode ser inserido como o primeiro caractere.

"x" -entrada Hex; entrada hexadecimal somente pode ser digitada.

"f" -Entrada de arquivo; um nome de arquivo deve ser inserido.

"r" -Entrada de texto Raw; entrada alfanumérica pode ser digitada. Espaços de liderança e trilhas são considerados significativos e não são despojados fora de campo.
tamanho_da_entrada Limita o número de caracteres que o usuário pode digitar no campo de entrada. O valor de entry_size é um inteiro. Um valor de0padronizado para o tamanho máximo de valor permitido.
requerido Define se um campo de comando deve ser enviado para o comando cmd_to_exec definido no objeto de cabeçalho de diálogo associado. O valor de requerido é uma string. Se o objeto for parte de uma tela seletora, orequiredcampo deve normalmente ser configurado como""(cadeia vazia). Se o objeto for parte de uma tela de diálogo, os valores válidos são:

"" ou "n" -Não; a opção é adicionada à cadeia de comandos no comando cmd_to_exec apenas se o usuário alterar o valor inicialmente exibido. Este é o caso padrão.

"y" -Sim; o valor doprefixcampo e o valor do campo de entrada são sempre enviados para o comando cmd_to_exec .

"+" -O valor doprefixcampo e o valor do campo de entrada são sempre enviados para o comando cmd_to_exec . O campo de entrada deve conter pelo menos um caractere não em branco. O SMIT não permitirá que o usuário execute a tarefa até que esta condição seja satisfeita.

"?" -Exceto quando vazio; o valor doprefixcampo e o valor do campo de entrada são enviados para ocmd_to_execcampo a menos que o campo de entrada esteja vazio.
prefixo No caso mais simples, define-se o flag para enviar com o valor de campo de entrada para o comando cmd_to_exec definido no objeto de cabeçalho de diálogo associado. O valor de prefixo é uma string com um comprimento máximo de 1024 caracteres.

O uso deste campo depende da configuração dorequiredcampo, o conteúdo doprefixcampo, e o conteúdo do associadoentry.

Nota: Se oprefixcampo é configurado como—(dash dash), o conteúdo do campo de entrada associado é anexado ao final do comando cmd_to_exec . Caso o comandoprefixcampo é configurado como—'(dash dash single quotation mark), o conteúdo do campo de entrada associado é anexado até o final do comando cmd_to_exec em citações simples.
cmd_to_list_mode Define o quanto de um item de uma lista deve ser usado. A lista é produzida pelo comando especificado no presente objetocmd_to_list. O valor de cmd_to_list_mode é uma string com um comprimento máximo de 1 caracteres. Os valores válidos são:

"" ou "a" -Consiga todos os campos. Este é o caso padrão.

"1" -Obtenha o primeiro campo.

"2" -Obtenha o segundo campo.

"r" -Range; executando a cadeia de comandos nocmd_to_listcampo retorna um intervalo (tais como 1 .. 99) em vez de uma lista. Intervalos são apenas para informações; eles são exibidos em um pop-up de lista, mas não alteram o campo de entrada associado.
cmd_to_list A sequência de comandos utilizada para obter uma lista de valores válidos para o campo de valor. O valor de cmd_to_list é uma string com um comprimento máximo de 1024 caracteres. Este comando deve saída de valores que são separados por\n(nova linha) caracteres.
cmd_to_list_postfix O postfix para interpretar e adicionar à cadeia de comandos especificada nocmd_to_listcampo do objeto de diálogo. O valor de cmd_to_list_postfix é uma string com um comprimento máximo de 1024 caracteres. Se a primeira linha começar com#(sinal de libra) seguindo um espaço, essa entrada será feita não selecionável. Isto é útil para títulos de coluna. Linhas subsequentes que começam com um#, opcionalmente precedidos por espaços, são tratados como um comentário e como continuação da entrada anterior.
multi_select Define se o usuário pode fazer várias seleções a partir de uma lista de valores válidos produzidos pelo comando nocmd_to_listcampo do objeto de diálogo. O valor de multi_select é uma string. Os valores válidos são:

"" -Não; um usuário pode selecionar apenas um valor de uma lista. Este é o caso padrão.

"," -Sim; um usuário pode selecionar vários itens da lista. Quando o comando é construído, uma vírgula é inserida entre cada item.

"y" -Sim; um usuário pode selecionar vários valores da lista. Quando o comando é construído, o prefixo da opção é inserido uma vez antes da sequência de itens selecionados.

"m" -Sim; um usuário pode selecionar vários itens da lista. Quando o comando é construído, o prefixo da opção é inserido antes de cada item selecionado.
índice_valor Para um anel de opção, o índice de origem zero para a matriz dedisp_valueCampos. O número value_index indica o valor que é exibido como padrão no campo de entrada para o usuário. O valor de entry_size é um inteiro.
disp_valores A matriz de valores válidos em um anel de opção a ser apresentado ao usuário. O valor dodisp_valuescampos é uma sequência com comprimento máximo de 1024 caracteres. Os valores de campo são separados por , (vírgulas) sem espaços anteriores ou seguindo as vírgulas.
values_msg_file O nome do arquivo (não o nome completo do caminho) que é o catálogo do Message Facility para os valores nodisp_valuescampos, se os valores forem inicializados no momento do desenvolvimento. O valor dovalues_msg_filecampo é uma sequência com comprimento máximo de 1024 caracteres. Os catálogos de mensagens requeridos por um programa de aplicativos podem ser desenvolvidos com o Message Facility.
values_msg_set O ID do conjunto de Message Facility para os valores nodisp_valuesCampos. Configure para 0 se não for usado.
values_msg_id O ID de mensagem do Message Facility para os valores nodisp_valuesCampos. Configure para 0 se não for usado.
aix_valores Se para um anel de opção, uma matriz de valores especificada de modo que cada elemento corresponda ao elemento na matriz disp_values na mesma posição; use se os valores de linguagem natural em disp_values não são as opções reais a serem usadas para o comando. O valor doaix_valuescampo é uma sequência com comprimento máximo de 1024 caracteres.
help_msg_id Especifica um número do conjunto de mensagens do Message Facility e número de ID da mensagem com uma vírgula como o separador ou uma sequência numérica igual a uma tag de identificador SMIT.
help_msg_loc O nome do arquivo enviado como parâmetro para o comando man para recuperação de texto de ajuda, ou o nome do arquivo de um arquivo contendo texto de ajuda. O valor de help_msg_loc é uma string com um comprimento máximo de 1024 caracteres.
help_msg_base O nome de caminho completo de uma biblioteca que o SMIT lê para os nomes de arquivo associados ao livro correto.
help_msg_book Contém a string com o valor do arquivo de nome contido na biblioteca de arquivos indicada por help_msg_base.