oncmsm 实用程序

可以使用 oncmsm 实用程序启动或关闭连接管理器、加载新的配置文件到连接管理器以便修改连接管理器的设置或更新配置文件格式。

语法

UNIX™ syntax diagram:

Windows™ syntax diagram:

元素	用途	关键注意事项
-c	启动连接管理器或转换当前的连接管理器配置文件的格式
`connection_manager_name`	指定连接管理器实例的名称
-i	在 Windows™ 服务上安装连接管理器	该选项只在 Windows 平台上可用
-k	关闭连接管理器实例
-n	指定转换配置文件的名称
`new_configuration_file`	输出到 $GBASEDBTDIR/etc 目录下作为格式转换过程的一部分的文件名称
`configuration_file`	位于 $GBASEDBTDIR/etc 目录下配置文件的名称	如果没有指定配置文件，连接管理器会试图加载到 $GBASEDBTDIR/etc/cmsm.cfg
-r	在不停止和重启的连接管理器的情况下重新加载连接管理器
-u	在 Windows 服务上卸载连接管理器	该选项只在 Windows 平台上可用

从命令行运行 oncmsm 实用程序来初始化连接管理器。连接管理器运行时，您可以添加、更改或删除服务等级协议（SLAs），然后重新加载该配置文件。

仅 UNIX ：下列用户可以执行 oncmsm 实用程序：

仅 Windows ：下列用户可以执行 oncmsm 实用程序：

在启动它之前，您必须安装 oncmsm 实用程序作为一个服务。

oncmsm 实用程序可以按以下两种方式启动：

如果您在使用多个连接管理器，可以执行 onstat -g cmsm 来显示连接管理器实例的名称。

以下示例中的连接管理器的 configuration_file_1 存在于 $GBASEDBTDIR/etc 目录。在已安装连接管理器的电脑上运行以下命令行，即可启动连接管理器：

oncmsm -c configuration_file_1

连接管理器启动。

以下示例中的连接管理器的 configuration_file_2 存在于 $GBASEDBTDIR/etc 目录。在已安装连接管理器的电脑上运行以下命令行，即可启动连接管理器：

oncmsm -i -c configuration_file_2
          oncmsm connection_manager_2

名为 connection_manager_2 的连接管理器启动。

在已安装连接管理器的电脑上运行以下命令行，即可终止连接管理器：

oncmsm -k connection_manager_3

名为 connection_manager_3 的连接管理器停止。

对于以下示例，名为 connection_manager_4 管理器的 $GBASEDBTDIR\etc\configuration_file_4会被更改。要更新该连接管理器的设置，在已安装 connection_manager_4 的电脑上执行以下命令：

oncmsm -r connection_manager_4

以下示例中名为 cmsm.cfg 的文件存储在$GBASEDBTDIR/etc 目录下。要启动该连接管理器，在已安装连接管理器的电脑上执行以下命令：

oncmsm -n configuration_file_5

oncmsm 实用程序转换 cmsm.cfg 成当前配置文件的格式。然后在 $GBASEDBTDIR/etc/ 目录下输出名为 configuration_file_5 的文件。

以下示例中名为 configuration_file_4 的文件存储在 $GBASEDBTDIR/etc 目录下。要启动该连接管理器，在已安装连接管理器的电脑上执行以下命令：

oncmsm -c configuration_file_6 -n configuration_file_7

oncmsm 实用程序转换 configuration_file_6 成当前配置文件格式。然后在 $GBASEDBTDIR/etc/ 目录下输出名为 configuration_file_7 的文件。

对于该示例，您已经在 Windows 服务上安装了名为 connection_manager_4 的连接管理器。要卸载该连接管理器，在已安装连接管理器的电脑上执行以下命令：

oncmsm -u connection_manager_4

oncmsm 实用程序可用于卸载连接管理器。