id |
The ID or name of the object. The id of the associated dialog or selector header object can be
used as a fast path to this and other dialog objects in the dialog. The value of id is a string with a
maximum length of 64 characters. All dialog objects that appear in one dialog must have the same ID. Also, IDs
should be unique to your application and unique within the particular SMIT database used. |
id_seq_num |
The position of this item in relation to other items on the dialog; sm_cmd_opt objects in a
dialog are sorted on this string field. The value of id_seq_num is a string with a maximum length of 16
characters. When this object is part of a dialog screen, the string "0" is not a valid value for
this field. When this object is part of a selector screen, the id_seq_num descriptor must be set to
0. |
disc_field_name |
A string that should match one of the name fields in the output of the cmd_to_discover command
in the associated dialog header. The value of disc_field_name is a string with a maximum length of 64
characters.
The value of the disc_field_name descriptor can be defined using the raw or cooked name from a
preceding selector instead of the cmd_to_discover command in the associated header object. If the
descriptor is defined with input from a preceding selector, it must be set to either "_rawname" or
"_cookedname", or to the corresponding sm_name_hdr.cooked_field_name value or
sm_name_hdr.raw_field_name value if this was used to redefine the default name. |
name |
The string that appears on the dialog or selector screen as the field name. It is the visual
questioning or prompting part of the object, a natural language description of a flag, option or parameter of
the command specified in the cmd_to_exec field of the associated dialog header object. The value of
name is a string with a maximum length of 1024 characters. |
name_msg_file |
The file name (not the full path name) that is the Message Facility catalog for the string,
name. The value of name_msg_file is a string with a maximum length of 1024 characters. Message
catalogs required by an application program can be developed with the Message Facility. Set to ""
(empty string) if not used. |
name_msg_set |
The Message Facility set ID for the string, name. The value of name_msg_set is an
integer. Set to 0 if not used. |
name_msg_id |
The Message Facility message ID for the string, name. The value of name_msg_id is an
integer. Set to 0 if not used. |
op_type |
The type of auxiliary operation supported for this field. The value of op_type is a string.
Valid values are:
"" or "n" - This is the default case. No auxiliary operations (list or ring selection) are
supported for this field.
"l" - List selection operation provided. A pop-up window displays a list of items produced by running
the command in the cmd_to_list field of this object when the user selects the F4=List
function of the SMIT interface.
"r" - Ring selection operation provided. The string in the disp_values or
aix_values field is interpreted as a comma-delimited set of valid entries. The user can tab or
backtab through these values to make a selection. Also, the F4=List interface function can be used in
this case, since SMIT will transform the ring into a list as needed.
The values "N", "L", and "R" can be used as op_type values just
as the lowercase values "n", "l", and "r". However, with the uppercase
values, if the cmd_to_exec command is run and returns with an exit value of 0, then the
corresponding entry field will be cleared to an empty string. |
entry_type |
The type of value required by the entry field. The value of entry_type is a string. Valid
values are:
"" or "n" - No entry; the current value cannot be modified via direct type-in. The field is
informational only.
"t" - Text entry; alphanumeric input can be entered.
"#" - Numeric entry; only the numeric characters 0, 1, 2,
3, 4, 5, 6, 7, 8, or
9 can be entered. A - (minus sign) or + (plus sign) can be entered as the
first character.
"x" - Hex entry; hexadecimal input only can be entered.
"f" - File entry; a file name should be entered.
"r" - Raw text entry; alphanumeric input can be entered. Leading and trailing spaces are considered
significant and are not stripped off the field. |
entry_size |
Limits the number of characters the user can type in the entry field. The value of entry_size
is an integer. A value of 0 defaults to the maximum allowed value size. |
required |
Defines if a command field must be sent to the cmd_to_exec command defined in the associated
dialog header object. The value of required is a string. If the object is part of a selector screen, the
required field should normally be set to "" (empty string). If the object is part of a
dialog screen, valid values are:
"" or "n" - No; the option is added to the command string in the cmd_to_exec command
only if the user changes the initially-displayed value. This is the default case.
"y" - Yes; the value of the prefix field and the value of the entry field are always sent
to the cmd_to_exec command.
"+" - The value of the prefix field and the value of the entry field are always sent to
the cmd_to_exec command. The entry field must contain at least one non-blank character. SMIT will not
allow the user to run the task until this condition is satisfied.
"?" - Except when empty; the value of the prefix field and the value of the entry field
are sent to the cmd_to_exec field unless the entry field is empty. |
prefix |
In the simplest case, defines the flag to send with the entry field value to the cmd_to_exec
command defined in the associated dialog header object. The value of prefix is a string with a maximum
length of 1024 characters.
The use of this field depends on the setting of the required field, the contents of the
prefix field, and the contents of the associated entry field.
Note: If the prefix field is set to --
(dash dash), the content of the associated entry field is appended to the end of the cmd_to_exec command.
If the prefix field is set to --' (dash dash single quotation mark), the contents of
the associated entry field is appended to the end of the cmd_to_exec command in single quotes. |
cmd_to_list_mode |
Defines how much of an item from a list should be used. The list is produced by the command specified
in this object's cmd_to_list field. The value of cmd_to_list_mode is a string with a maximum
length of 1 character. Valid values are:
"" or "a" - Get all fields. This is the default case.
"1" - Get the first field.
"2" - Get the second field.
"r" - Range; running the command string in the cmd_to_list field returns a range (such as
1..99) instead of a list. Ranges are for information only; they are displayed in a list pop-up, but do
not change the associated entry field. |
cmd_to_list |
The command string used to get a list of valid values for the value field. The value of
cmd_to_list is a string with a maximum length of 1024 characters. This command should output values that
are separated by \n (new line) characters. |
cmd_to_list_postfix |
The postfix to interpret and add to the command string specified in the cmd_to_list
field of the dialog object. The value of cmd_to_list_postfix is a string with a maximum length of 1024
characters. If the first line starts with # (pound sign) following a space, that entry will be made
non-selectable. This is useful for column headings. Subsequent lines that start with a #,
optionally preceded by spaces, are treated as a comment and as a continuation of the preceding entry. |
multi_select |
Defines if the user can make multiple selections from a list of valid values produced by the command
in the cmd_to_list field of the dialog object. The value of multi_select is a string. Valid
values are:
"" - No; a user can select only one value from a list. This is the default case.
"," - Yes; a user can select multiple items from the list. When the command is built, a comma is
inserted between each item.
"y" - Yes; a user can select multiple values from the list. When the command is built, the option
prefix is inserted once before the string of selected items.
"m" - Yes; a user can select multiple items from the list. When the command is built, the option
prefix is inserted before each selected item. |
value_index |
For an option ring, the zero-origin index to the array of disp_value fields. The
value_index number indicates the value that is displayed as the default in the entry field to the user.
The value of entry_size is an integer. |
disp_values |
The array of valid values in an option ring to be presented to the user. The value of the
disp_values fields is a string with a maximum length of 1024 characters. The field values are
separated by , (commas) with no spaces preceding or following the commas. |
values_msg_file |
The file name (not the full path name) that is the Message Facility catalog for the values in the
disp_values fields, if the values are initialized at development time. The value of the
values_msg_file field is a string with a maximum length of 1024 characters. Message catalogs
required by an application program can be developed with the Message Facility. |
values_msg_set |
The Message Facility set ID for the values in the disp_values fields. Set to 0 if not
used. |
values_msg_id |
The Message Facility message ID for the values in the disp_values fields. Set to 0 if
not used. |
aix_values |
If for an option ring, an array of values specified so that each element corresponds to the element
in the disp_values array in the same position; use if the natural language values in disp_values
are not the actual options to be used for the command. The value of the aix_values field is a
string with a maximum length of 1024 characters. |
help_msg_id |
Specifies a Message Facility message set number and message ID number with a comma as the separator
or a numeric string equal to a SMIT identifier tag. |
help_msg_loc |
The file name sent as a parameter to the man command for retrieval of help text, or the file
name of a file containing help text. The value of help_msg_loc is a string with a maximum length of 1024
characters. |
help_msg_base |
The fully qualified path name of a library that SMIT reads for the file names associated with the
correct book. |
help_msg_book |
Contains the string with the value of the name file contained in the file library indicated by
help_msg_base. |