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

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


Класс объектов sm_name_hdr (заголовок списков вариантов SMIT)

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

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

Если в меню SMIT Заголовок списка (sm_name_hdr) с типом "c" при вводе значений используется двоеточие ( : ), например, tty:0, то программа SMIT вставит перед двоеточием #! (знак фунта и восклицательный знак), чтобы не путать двоеточие с разделителем полей. После того как SMIT проанализирует оставшуюся часть значения, символы #! будут удалены, а значение записано в дескриптор cmd_to_classify. При последующем добавлении данных в дескриптор cmd_to_classify необходимо снова вставить #! перед :

Существуют следующие дескрипторы класса объектов sm_name_hdr:

id Идентификатор или имя объекта. В поле id можно указать идентификатор команды быстрого доступа, если только для has_name_select не установлено значение "y" (да). Значение поля id - строка длиной до 64 символов. Идентификатор должен быть уникален как в приложении, так и в системе.
next_id Задает объект заголовка следующего окна; в этом поле указано значение поля id объекта sm_cmd_hdr или объекта sm_name_hdr, следующего за данным списком вариантов. Описанное ниже поле next_type определяет класс объекта. Значение next_id - строка длиной до 64 символов.
option_id Задает содержимое списка вариантов; соответствует значению поля id объекта sm_cmd_opt. Значение поля option_id - строка длиной не более 64 символов.
has_name_select Указывает, будет ли перед данным окном выдаваться окно со списком вариантов. Допустимы следующие значения:

"" или "n"
Нет; это значение по умолчанию. Идентификатор данного объекта может использоваться в качестве команды быстрого доступа, даже если перед ним выдается окно со списком вариантов.

"y"
Да; данному объекту может предшествовать список выбора. Если указано это значение, то id данного объекта не может применяться в качестве команды быстрого доступа к соответствующему окну диалога.
name Текст для заголовка окна со списком вариантов. Значение поля name - строка длиной не более 1024 символов. Строка может быть отформатирована и может содержать символы новой строки (\n).
name_msg_file Неполное имя файла для каталога Средств работы с сообщениями, применяемого для строки name. Значение поля name_msg_file - строка длиной не более 1024 символов. Средства работы с сообщениями можно применять для создания каталогов сообщений прикладных программ.
name_msg_set Идентификатор набора Средств работы с сообщениями для строки name. Эти идентификаторы могут применяться для указания подкаталогов одного и того же каталога. Поле name_msg_set - целого типа.
name_msg_id Идентификатор Средства работы с сообщениями для строки name. Поле name_msg_id - целого типа.
тип Способ обработки списка вариантов. Значение поля type - строка, состоящая из одного символа. Допустимы следующие значения:

"" или "j"
Следующий идентификатор; за данным объектов всегда следует объект, определяемый значением дескриптора next_id. Дескриптор next_id - это строка максимальной длины, инициализированная в программе при ее создании.

"r"
Конкатенация исходного (необработанного) имени; в этом случае дескриптор next_id частично определяется при написании программы, а частично - при ее выполнении, когда пользователь вводит недостающую информацию. Выполняется конкатенация значения дескриптора next_id, определенного в программе, и значения, указанного пользователем. Полученное в результате значение дескриптора id применяется для поиска следующего объекта (окна диалога или списка вариантов).

"c"
Конкатенация обработанного имени; для получения дополнительной информации необходима обработка значения, выбранного пользователем. Это значение передается в команду, указанную в дескрипторе cmd_to_classify, после чего вывод команды объединяется со значением дескриптора next_id для создания дескриптора id, который используется для поиска следующего объекта (окна диалога или списка вариантов).
ghost Указывает, следует ли показывать окно со списком вариантов или только всплывающую панель, которая была создана командой, указанной в поле cmd_to_list. Значение ghost - строчная константа. Допустимы следующие значения:

"" или "n"
Нет; показывать окно со списком вариантов.

"y"
Да; показывать только всплывающую панель, которая была создана командой, указанной в полях cmd_to_list и cmd_to_list_postfix связанного объекта sm_cmd_opt. Если значение в поле cmd_to_list не указано, то SMIT считает данный объект виртуальным, выполняет команду cmd_to_classify и продолжает обработку.
cmd_to_classify Задает текст команды, которая при необходимости будет использоваться для классификации значения поля name объекта sm_cmd_opt. Значение поля cmd_to_classify представляет собой строку длиной до 1024 символов. Входные данные для cmd_to_classify (исходное имя) считываются из поля entry, а на выходе команда cmd_to_classify выдает обработанное имя. В версиях AIX, предшествующих 4.2.1, с помощью cmd_to_classify можно было создавать только одно значение. Если это значение содержит двоеточие, оно автоматически пропускается. В AIX версии 4.2.1 и выше с помощью cmd_to_classify можно создавать сразу несколько значений, причем в данная команда использует двоеточие как ограничитель. Если вам нужны значения с символами двоеточий, то задавайте их вручную.
cmd_to_classify_postfix Постфикс, который анализируется и добавляется к тексту команды, заданному в поле cmd_to_classify. Значение поля cmd_to_classify_postfix представляет собой строку длиной до 1024 символов.
raw_field_name Альтернативное имя для исходного значения. Значение поля raw_field_name представляет собой строку длиной до 1024 символов. Значение по умолчанию - "_rawname".
cooked_field_name Альтернативное имя для обработанного значения. Значение поля cooked_field_name представляет собой строку длиной до 1024 символов. Значение по умолчанию - "cookedname".
next_type Тип окна, показываемого после списка вариантов. Допустимы следующие значения:

"n"
Имя; будет показано окно со списком вариантов. Подробная информация приведена в описании поля next_id (см. выше).

"d"
Окно диалога; будет показано окно диалога. Подробная информация приведена в описании поля next_id (см. выше).
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_cmd_hdr (заголовок окна диалога SMIT) , Класс объектов sm_cmd_opt (опции команд окна диалога/списка вариантов SMIT) , Класс объектов sm_menu_opt (меню SMIT) .

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


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