了解配置文件和选项文件

在线编辑

配置文件和选项文件设置会话运行的条件和边界。

您作为管理员或最终用户，可设置选项值以实现以下目的：

  • 设置与服务器的连接
  • 控制哪些对象发送到服务器以及与其相关联的管理类。

当您在工作站上安装 API 时在一个或两个文件中定义选项。

在 UNIX 和 Linux® 操作系统上，选项位于两个选项文件中:

  • dsm.opt - 客户机选项文件
  • dsm.sys - 客户机系统选项文件

在其他操作系统上，客户机选项文件 (dsm.opt) 包含所有选项。

限制: API 不支持以下备份/归档客户机选项:
  • autofsrename
  • changingretries
  • 域
  • 事件日志记录
  • 组
  • subdir
  • 用户
  • virtualmountpoint

还可以在 dsmInitEx 函数调用上指定选项。 使用选项字符串参数或 API 配置文件参数。

相同选项可以派生自多个配置源。 发生这种情况时，具有最高级优先级的源文件优先。 表 1 列出了优先级顺序。
表 1. 按降序优先级显示的配置源
优先级 UNIX 和 Linux Windows 描述
1 dsm.sys 文件

（客户机系统选项）

不适用

此文件包含系统管理员仅针对 UNIX 和 Linux设置的选项。

提示: 如果 dsm.sys 文件包含服务器节，请确保 passwordaccess 选项在每个节中指定相同的值 ( prompt 或 generate)。
2 选项字符串

（客户机选项）

 选项字符串

（所有选项）

其中一个选项在作为参数传递到 dsmInitEx 调用时生效。 该列表可以包含客户机选项，例如 compressalways， servername (仅限 UNIX 和 Linux ) 或 tcpserveraddr (非 UNIX)。

通过 API 选项字符串，应用程序客户机可以对 API 配置文件和客户机选项文件中的选项值进行更改。 例如，如果要求压缩，那么应用程序可能查询最终用户。 根据用户响应，您可以使用此选项来构造 API 选项字符串，并将其传递到 dsmInitEx调用中。

有关 API 选项字符串格式的信息，请参阅 dsmInitEx. 还可以将该参数设置为 NULL。 这表明该会话没有 API 选项字符串。
3

API 配置文件

（客户机选项）

API 配置文件

（所有选项）

 在 API 配置文件中设置的值会覆盖在客户机选项文件中设置的值。 在 API 配置文件中使用适用于用户的 IBM® Storage Protect 会话中的值来设置选项。 当 API 配置文件名作为 dsmInitEx 调用中的参数传递时，这些值将生效。

还可将该参数设置为 NULL。 这表明该会话不存在 API 配置文件。
4

dsm.opt 文件

（客户机选项）

dsm.opt 文件

（所有选项）

在 UNIX 和 Linux 操作系统上， dsm.opt 文件仅包含用户选项。 在其他操作系统上，dsm.opt 文件包含所有选项。 要覆盖这些文件中的选项，请遵循该表中所描述的方法。