id
| The ID or name of the object. The value of id is a
string with a maximum length of 64 characters. The id field
can be used as a fast path ID unless there is a selector associated with the
dialog. IDs should be unique to your application and unique within your
system.
|
option_id
| The id of the sm_cmd_opt objects (the dialog
fields) to which this header refers. The value of option_id
is a string with a maximum length of 64 characters.
|
has_name_select
| Specifies whether this screen must be preceded by a selector screen or a
menu screen. Valid values are:
- "" or "n"
- No; this is the default case.
- "y"
- Yes; a selector precedes this object. This setting prevents
the id of this object from being used as a fast path to the
corresponding dialog screen.
|
name
| The text displayed as the title of the dialog screen. The value of
name is a string with a maximum length of 1024 characters.
The text describes the task performed by the dialog. The string can be
formatted with embedded \n (newline) 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.
|
name_msg_set
| The Message Facility set ID for the string, name. Set
IDs can be used to indicate subsets of a single catalog. The value of
name_msg_set is an integer.
|
name_msg_id
| The Message Facility ID for the string, name. Message
IDs can be created by the message extractor tools owned by the Message
Facility. The value of name_msg_id is an integer.
|
cmd_to_exec
| The initial part of the command string, which can be the command or the
command and any fixed options that execute the task of the dialog.
Other options are automatically appended through user interaction with the
command option objects (sm_cmd_opt) associated with the dialog
screen. The value of cmd_to_exec is a string with a maximum
length of 1024 characters.
|
ask
| Defines whether or not the user is prompted to reconsider the choice to
execute the task. Valid values are:
- "" or "n"
- No; the user is not prompted for confirmation; the task is
performed when the dialog is committed. This is the default setting for
the ask descriptor.
- "y"
- Yes; the user is prompted to confirm that the task be performed;
the task is performed only after user confirmation.
Prompting the user for execution confirmation is especially useful prior to
performance of deletion tasks, where the deleted resource is either difficult
or impossible to recover, or when there is no displayable dialog associated
with the task (when the ghost field is set to
"y").
|
exec_mode
| Defines the handling of standard input, standard output, and the
stderr file during task execution. The value of
exec_mode is a string. Valid values are:
- "" or "p"
- Pipe mode; the default setting for the exec_mode
descriptor. The command executes with standard output and the
stderr file redirected through pipes to SMIT. SMIT manages
output from the command. The output is saved and is scrollable by the
user after the task finishes running. While the task runs, output is
scrolled as needed.
- "n"
- No scroll pipe mode; works like the "p" mode, except that
the output is not scrolled while the task runs. The first screen of
output will be shown as it is generated and then remains there while the task
runs. The output is saved and is scrollable by the user after the task
finishes running.
- "i"
- Inherit mode; the command executes with standard input, standard
output, and the stderr file inherited by the child process in which
the task runs. This mode gives input and output control to the executed
command. This value is intended for commands that need to write to the
/dev/tty file, perform cursor addressing, or use libcur
or libcurses library operations.
- "e"
- Exit/exec mode; causes SMIT to run (do an execl subroutine
call on) the specified command string in the current process, which
effectively terminates SMIT. This is intended for running commands that
are incompatible with SMIT (which change display modes or font sizes, for
instance). A warning is given that SMIT will exit before running the
command.
- "E"
- Same as "e", but no warning is given before exiting
SMIT.
- "P" , "N"
or "I"
- Backup modes; work like the corresponding "p",
"n", and "i" modes, except that if the
cmd_to_exec command is run and returns with an exit value of
0, SMIT backs up to the nearest preceding menu (if any), or to the
nearest preceding selector (if any), or to the command line.
|
ghost
| Indicates if the normally displayed dialog should not be shown.
The value of ghost is a string. Valid values are:
- "" or "n"
- No; the dialog associated with the task is displayed. This is
the default setting.
- "y"
- Yes; the dialog associated with the task is not displayed because no
further information is required from the user. The command specified in
the cmd_to_exec descriptor is executed as soon as the user selects
the task.
|
cmd_to_discover
| The command string used to discover the default or current values of the
object being manipulated. The value of cmd_to_discover is a
string with a maximum length of 1024 characters. The command is
executed before the dialog is displayed, and its output is retrieved.
Output of the command must be in colon format.
|
cmd_to_discover_postfix
| The postfix to interpret and add to the command string in the
cmd_to_discover field. The value of
cmd_to_discover_postfix 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.
|