id
| Идентификатор или имя объекта. Идентификатор объекта
связанного окна диалога или заголовка списка вариантов может использоваться
как команда быстрого доступа к этому или к другим объектам окон диалога в
данном окне. Значение поля id - строка длиной до 64
символов. Для всех объектов одного и того же окна диалога необходимо
указать одинаковый идентификатор. Идентификатор должен быть уникален
как в приложении, так и в базе данных SMIT, в которой он используется.
|
id_seq_num
| Расположение данного элемента по отношению к остальным элементам в окне
диалога; строка, задаваемая в данном поле, определяет, в каком порядке
объекты sm_cmd_opt располагаются по отношению к другим элементам
окна диалога. Значение поля id_seq_num представляет собой
строку длиной до 16 символов. Если объект - это компонент окна диалога,
то в данном поле нельзя указывать строку "0". Если объект -
это элемент окна списка вариантов, то в дескрипторе id_seq_num
должно быть задано нулевое значение.
|
disc_field_name
| Строка, которая должна совпадать с одним из полей имен в выводе команды
cmd_to_discover в заголовке связанного окна диалога.
Значение поля disc_field_name - строка длиной до 64
символов.
Значение дескриптора disc_field_name можно определять не только
с помощью команды cmd_to_discover в связанном объекте заголовка, но
и с помощью исходного или измененного имени, которое будет выбираться из
предложенного списка вариантов. Если имя будет выбираться путем выбора
из списка вариантов, то в дескрипторе нужно указать значение
"_rawname", "_cookedname", или же соответствующее имя
sm_name_hdr.cooked_field_name либо
sm_name_hdr.raw_field_name, если оно переопределяет имя по
умолчанию.
|
name
| Строка, которая будет показана в окне диалога или в списке вариантов как
имя поля. Это часть объекта, содержащая вопрос или приглашение, который
будет показан на экране. Эта строка описывает на естественном языке
флаг, опцию или параметр команды, указанной в поле cmd_to_exec
связанного объекта заголовка окна диалога. Значение поля
name - строка длиной не более 1024 символов.
|
name_msg_file
| Неполное имя файла для каталога Средств работы с сообщениями,
применяемого для строки name. Значение поля
name_msg_file - строка длиной не более 1024 символов.
Средства работы с сообщениями можно применять для создания каталогов сообщений
прикладных программ. Если вы не планируете использовать Средства работы
с сообщениями, укажите в этом поле пустую строку ("" ).
|
name_msg_set
| Идентификатор набора Средств работы с сообщениями для строки
name. Поле name_msg_set - целого типа.
Если Средства работы с сообщениями применяться не будут, задайте в этом поле
нулевое значение (0).
|
name_msg_id
| Идентификатор сообщения из Средств работы с сообщениями для строки
name. Поле name_msg_id - целого типа. Если
Средства работы с сообщениями применяться не будут, задайте в этом поле
нулевое значение (0).
|
op_type
| Тип вспомогательной операции, поддерживаемой для данного поля.
Значение op_type - строчная константа. Допустимы следующие
значения:
"" или "n" - это значение по умолчанию. Для
данного поля не предусмотрено вспомогательных операций (выбора из списка или
из кольцевого списка).
"l" - Поддерживается операция выбора из списка. При
нажатии клавиши F4=Список на экране появляется всплывающее меню со
списком элементов, созданным командой, указанной в поле cmd_to_list
данного объекта.
"r" - Поддерживается операция выбора из кольцевого
списка. Строка, заданная в поле disp_values или
aix_values, интерпретируется как разделенный запятыми набор
допустимых записей. Пользователь может передвигаться по списку, нажимая
клавишу Tab или Backtab. В этом случае клавиша меню SMIT
F4=Список остается допустимой, поскольку при необходимости SMIT
преобразует кольцевой список в обычный.
При задании значения в поле op_type можно использовать как
прописные символы ( "N", "L" и "R"), так и
строчные символы ("n", "l" и "r").
Если значения указаны в верхнем регистре, а при выполнении команды
cmd_to_exec возвращается значение 0, то соответствующие
поля ввода будут очищены, а их значения заменены пустыми строками.
|
entry_type
| Тип значения, задаваемого в поле ввода. Значение в поле
entry_type - строка. Допустимы следующие значения:
"" или "n" - ввод запрещен; текущее значение
нельзя изменить с помощью клавиатуры. Это поле служит только для
просмотра информации.
"t" - текстовое поле; можно вводить буквенно-цифровые
символы.
"#" - числовое поле; значение в данном поле должно состоять
только из цифр (0, 1, 2, 3,
4, 5, 6, 7, 8 или
9). Первым символом может быть знак - (минус) или
+ (плюс).
"x" - шестнадцатеричное поле; можно вводить только
шестнадцатеричные числа.
"f" - имя файла; необходимо ввести имя файла.
"r" - исходный текст; можно вводить буквенно-цифровые
символы. Начальные и конечные пробелы учитываются и не удаляются при
считывании значения поля.
|
entry_size
| Ограничение на число символов, указываемых в поле ввода. Поле
entry_size - целого типа. Значение по умолчанию -
0 - соответствует максимальной допустимой длине для указываемого
типа.
|
required
| Указывает, должно ли значение поля передаваться команде
cmd_to_exec, указанной в объекте заголовка окна диалога.
Значение поля required - строка. Если объект - элемент окна
списка вариантов, то в поле required обычно указывается пустая
строка (""). Если объект - элемент окна диалога, то
допустимы следующие значения:
"" или "n" - нет; опция добавляется к тексту
команды в дескрипторе cmd_to_exec только в том случае, если
показанное на экране начальное значение было изменено пользователем.
Это значение по умолчанию.
"y" - да; значения поля prefix и поля ввода
всегда передаются в команду cmd_to_exec.
"+" - значения поля prefix и поля ввода всегда
передаются в команду cmd_to_exec. Поле ввода должно
содержать хотя бы один отличный от пробела символ, в противном случае SMIT не
разрешит пользователю запустить задачу.
"?" - значения поля prefix и поля ввода передаются в
команду cmd_to_exec только в том случае, если в поле ввода задано
непустое значение.
|
prefix
| В простейшем случае определяет флаг, передаваемый вместе со значением
поля ввода команде cmd_to_exec, которая была указана в объекте
заголовка окна диалога. Значение поля prefix - строка длиной
до 1024 символов.
Смысл этого поля зависит от того,
какие значения указаны в полях required, prefix и в
связанном поле entry.
Примечание: Если в поле prefix задано значение
--, то содержимое соответствующего поля ввода добавляется в
конец команды cmd_to_exec. Если в поле prefix
указано значение --' (двойной дефис и одинарная кавычка),
то в конец команды cmd_to_exec добавляется содержимое
соответствующего поля ввода, заключенное в одинарные кавычки.
|
cmd_to_list_mode
| Определяет, какая часть элемента списка должна использоваться.
Список создается командой, которая указана в поле cmd_to_list
данного объекта. Значение cmd_to_list_mode - строка,
состоящая из одного символа. Допустимы следующие значения:
"" или "a" - загружать все поля. Это значение
по умолчанию.
"1" - загружать первое поле.
"2" - загружать второе поле.
"r" - диапазон; команда, указанная в поле
cmd_to_list, вместо списка создает диапазон (например,
1..99). Диапазоны предназначены только для
просмотра информационных данных; они показаны в неизмеряемом всплывающем
списке.
|
cmd_to_list
| Текст команды, которая используется для получения списка допустимых
значений поля ввода. Значение поля cmd_to_list - строка
длиной до 1024 символов. Значения в списке, выдаваемом этой командой,
должны отделяться друг от друга символом новой строки (\n).
|
cmd_to_list_postfix
| Постфикс, который анализируется и добавляется к тексту команды, заданной
в поле cmd_to_list объекта окна диалога. Значение поля
cmd_to_list_postfix - строка длиной до 1024 символов. Если
первая строка начинается с пробела и следующего за ним символа #
(знака фунта), то эту запись нельзя будет выбрать из списка. Такие
строки применяются для заголовков столбцов. Последующие строки,
начинающиеся со знака #, перед которым может стоять пробел,
рассматриваются как комментарии и строки продолжения.
|
multi_select
| Указывает, может ли пользователь выбирать сразу несколько вариантов из
списка возможных значений, создаваемого командой, которая указана в поле
cmd_to_list объекта окна диалога. Значение
multi_select - строка. Допустимы следующие значения:
"" - нет; пользователь может выбрать из списка только одно
значение. Это значение по умолчанию.
"," - да; пользователь может выбрать несколько элементов из
списка. При формировании команды элементы разделяются запятыми.
"y" - да; пользователь может выбрать несколько элементов из
списка. При формировании команды перед списком выбранных элементов
вставляется префикс опции.
"m" - да; пользователь может выбрать несколько элементов из
списка. При формировании команды перед каждым выбранным элементом
вставляется префикс опции.
|
value_index
| Отсчитываемый от нуля индекс массива полей disp_value для
кольцевого списка опций. Номер value_index указывает на
значение, которое будет показано в пользовательском поле ввода как значение по
умолчанию. Поле entry_size - целого типа.
|
disp_values
| Массив значений в кольцевом списке опций, показываемом
пользователю. Значение disp_values - строка длиной до 1024
символов. Значения полей указываются через запятую (,), без
пробелов.
|
values_msg_file
| Имя файла каталога Средства работы с сообщениями, применяемого для
значений disp_values, если они задаются на стадии
разработки. Значение поля values_msg_file - строка длиной не
более 1024 символов. Средства работы с сообщениями можно применять для
создания каталогов сообщений прикладных программ.
|
values_msg_set
| Идентификатор набора Средств работы с сообщениями для значений полей
disp_values. Если Средства работы с сообщениями применяться
не будут, укажите нулевое значение.
|
values_msg_id
| Идентификатор сообщения из Средств работы с сообщениями для значений
полей disp_values. Если Средства работы с сообщениями
применяться не будут, укажите нулевое значение.
|
aix_values
| Этот дескриптор используется в том случае, если каждый элемент массива
значений кольцевого списка опций соответствует элементу массива
disp_values в той же позиции, а значения, заданные на естественном
языке в disp_values, отличаются от фактических опций, используемых
для данной команды. Значение поля aix_values - строка длиной
не более 1024 символов.
|
help_msg_id
| Поле, в котором задается номер набора сообщений Средства работы с
сообщениями и (через запятую) идентификатор сообщения, либо строка цифр,
совпадающая с тегом идентификатора SMIT.
|
help_msg_loc
| Имя файла, передаваемого в качестве параметра команде man для
поиска текста справки, либо имя файла, содержащего текст справки.
Значение help_msg_loc - строка длиной до 1024 символов.
|
help_msg_base
| Полное имя библиотеки, в которой SMIT ищет имена файлов, связанные с
нужным томом справки.
|
help_msg_book
| Содержит строку с именем файла из библиотеки, указанной в
help_msg_base.
|