为新任务创建 SMIT 帮助信息

在线编辑

系统管理界面工具 (SMIT) 帮助是 SMIT 程序的扩展名。

它们是一系列的帮助，意在为您提供用于构造 对话框和菜单的 SMIT 组件的相关联机信息。 SMIT 帮助驻留在数据库中，就像 SMIT 可执行代码驻留在数据库中一样。 SMIT 有两种方法检索 SMIT 帮助信息：

所有这些方法均提供了从 SMIT 帮助数据库检索 SMIT help 的不同方法。

联机帮助页方法

先决条件任务或条件: 创建需要帮助信息的 SMIT 任务。

  1. 使用任何编辑器创建文件，并将帮助文本输入到文本中。 该文件必须遵循 man 命令指定的格式。 仅在一个文件中放置一组帮助信息。
  2. 为帮助文本文件提供由 man 命令指定的标题。
  3. 将帮助文本文件放置在手册子目录中的正确位置。
  4. 使用 man 命令测试新近创建的文件，从而确保该文件 有效。
  5. 查找新建的 SMIT 任务，从而获得包含 ASCII 对象节文件格式的文件。
  6. 在文件的对象节中查找帮助描述符字段。
  7. 设置help_msg_loc帮助描述符字段等于帮助文本文件的标题。 文本文件的标题也是要传递给 man 命令的参数。 例如：
    help_msg_loc = "xx", where "xx" = title string name
    此示例使用以下命令执行 man 命令:xx标题字符串名称。
  8. 将其余帮助描述符字段保留为空。

消息目录方法

先决条件任务或条件: 创建需要帮助信息的新 SMIT 任务。

  1. 使用任何编辑器创建文件，并将帮助消息输入到文件中。 .msg 文件必须遵循由消息工具指定的格式。
    注意：也可使用现有的 .msg 文件。
  2. 赋予每个帮助消息一个集合号 (Set #) 和一个消息号 (MSG#)。 这使系统能够检索正确的帮助文本。
  3. 使用 gencat 命令将 .msg 文件转换为 .cat 文件。 根据 NLSPATH 环境变量，将 .cat 文件放在正确的目录中。
  4. 使用 dspmsg 命令测试帮助消息。
  5. 查找新建的 SMIT 任务，从而获得包含 ASCII 对象节文件格式的文件。
  6. 在文件的对象节中查找帮助描述符字段。
  7. 对于每个对象节，找到help_msg_id帮助描述符字段。 在 .msg 文件中输入消息值 Set# 和 Msg#。 这些值必须遵 循消息工具格式。 例如，要为集合 #2 检索消息 #14，请设置：
    help_msg_id - "2,14"
  8. 设置 help_msg_loc帮助描述符字段到包含帮助文本的文件的文件名。
  9. 使其他帮助描述符字段为空。