[ Страница назад | Страница вперед | Содержание | Индекс | Библиотека | Юридическая информация | Поиск ]

Программирование: Разработка и отладка программ


Класс объектов sm_cmd_opt (опции команд окна диалога/списка вариантов SMIT)

Каждый объект в окне диалога, за исключением объекта заголовка, соответствует флагу, опции или атрибуту команды, выполняемой в этом окне. Для каждого окна диалога SMIT создается один или несколько объектов; с динамическим окном диалога может не быть связано ни одного объекта опций команды. Окно списка вариантов состоит из одного объекта, определяющего заголовок списка, и из одного объекта, определяющего опции команды.

Примечание: При программировании объекта данного объектного класса обозначайте пустые строки парой двойных кавычек (""), а пустые целые поля - нулем (0).

Для определения опций команды окна диалога и команды списка вариантов применяется объект sm_cmd_opt. Ниже перечислены дескрипторы класса объектов sm_cmd_opt и их функции:

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.

Инструкции по получению справки SMIT с помощью полей help_msg_id, help_msg_loc, help_msg_base и help_msg_book приведены в разделах Разделы справки man, Электронные библиотеки и Каталог сообщений главы "Создание справки по новой задаче SMIT" .

Связанная информация

Глава 25, Инструмент управления системой (SMIT)

Классы объектов SMIT

Команда smit

Класс объектов sm_name_hdr (заголовок списков вариантов SMIT) , Класс объектов sm_cmd_hdr (заголовок окна диалога SMIT) , Класс объектов sm_menu_opt (меню SMIT)

Пример программы SMIT


[ Страница назад | Страница вперед | Содержание | Индекс | Библиотека | Юридическая информация | Поиск ]