支撑平台工具使用说明

目录1综述 (2)2winnttcp (3)2.1 简介： (3)2.2 操作方法 (4)2.2.1 链路状态图 (4)2.2.2 链路详细信息页 (5)2.2.3 配置选项页 (6)3tcpout (7)3.1 简介： (7)3.2 操作方法 (7)4 S10see (8)4.1 简介： (8)4.2 操作方法 (9)4.2.1 支撑系统信息页 (9)4.2.2 支撑打印信息页和业务打印信息页 (10)4.2.3 参数设置页 (10)5 Printctl (12)5.1 简介： (12)5.2 操作方法 (12)5.2.1流向选择页 (12)5.2.2业务模块选择页 (13)5.2.3测试选项页 (13)6 Ommsee (14)6.1 简介： (14)6.2 操作方法 (14)1综述支撑系统的主要功能是为上层应用进程提供和操作系统平台无关的调用接口，对应用进程进行基于消息的调度，建立和维护通信链路，统一管理定时器和内存资源，实时监控系统的运行情况，收集运行参数，捕获各种异常情况并进行记录和相应处理。

支撑系统各个主要模块的分布结构如图所示，图中实线箭头为链路建立的方向：2winnttcp1.1 简介：winnttcp又称小轮子、小齿轮，是运行在后台服务器129-139节点以及客户端30-64，165-199，210-239上的通信程序，专门负责建立、维护通信链路以及应用进程之间的通信。

应用进程通过调用动态连接库comm.dll中的接口函数RegisterOnZXTcp注册到winnttcp，然后就可以调用接口函数ZXClientSendMsg来发送消息到其他本地或远端的应用进程了。

Winnttcp启动以后，通过读取配置文件$WINNT\tcpseek.ini中的信息绑定本地的IP地址和端口号，侦听远端节点发来的连接（当本机设为服务器时），同时也通过读取配置文件中的远端节点的节点号和IP地址，向远端节点发起连接，默认情况本地绑定的端口和要连接的远端端口号都是5000。

关于comm.dll中的接口函数使用方法，详见如下文档：winnttcp启动以后会根据配置文件中的配置自动建立好所有链路；应用进程通过comm.dll与winnttcp交互，调用comm.dll中的接口注册到winnttcp，将消息发到winnttcp，然后由winnttcp将消息发送到目的地，若为本节点的进程，则winnttcp 直接将消息发往目的进程，若为其他节点上的进程，winnttcp会检查与远端节点链路是否已建立，若建立，则将消息发送目的节点，目的节点上若运行的是winnttcp则目的节点上的winnttcp会将接收到的消息分发到目的进程，若目的节点上运行的是NT/UNIX或MP支撑，则这些支撑的通信模块会将消息分发到目的进程。

在发送消息接口函数ZXClientSendMsg中会在所有业务消息之前加上一个29字节的消息头，然后再发到winnttcp，消息头中主要包括消息发送者的PID、消息接收者的PID、事件号、消息长度、加密域等内容：typedef struct tagMsgHead_T{PID sender; //发送者PIDPID receiver; //接收者PIDWORD event; // 事件号WORD len; // 消息体长度BYTE type; // 消息类型DWORD SecretField; // 加密域DWORD Reserved1; // 保留DWORD Reserved2;WORD Reserved3;} MsgHead_T;winnttcp投递到业务进程的消息是包括消息头的，用户必须调用comm.dll中的接口GetMsgCopy获取消息体的指针，用完之后应调用FreeMsg释放消息内存。

2.2 操作方法2.2.1 链路状态图程序启动以后界面如下所示（这是第一页（链路状态图））：该图显示了本机节点以及与本机节点相连的其他节点：最上面的是MP节点，每一个MP模块包括主备两个节点，他们的节点号之间相差64，比如3号和67号节点。

位于中间的是本机节点和服务器（129－139）节点，若本机还连接了其他服务器节点，则这些节点分布在本机节点左右；最下面是客户机节点和业务处理机节点，除了MP节点以及服务器节点以外的节点都显示在这里。

节点之间的连线有三种状态：红线表示断链，黄线表示本节点正在向远端节点发起连接，绿线加黄点表示连接成功，绿线上的黄点会周而复始不断从连通的远端节点向本节点移动；对于MP节点，绿线上如果是黄点，则表示该节点为主用MP；如果是绿点则表示该节点为备用MP。

2.2.2 链路详细信息页第二页（链路详细信息）:该图最上面的表格是与本节点相连的远端节点状态的详细信息，包括远端节点的区号，局号，节点号，连接状态（断开、正常、连接中），发送计数（发送的消息数），接收计数，发送溢出（队列溢出次数），发送错误（发送时消息内容错误或其他原因导致的发送错误），接收错误，重连次数（即链路断开次数）。

中间的表格是在winnttcp上注册的应用进程的详细信息，包括了每一个注册的应用进程的用于接收消息的窗口类名，窗口句柄，应用进程号（由OMM统一分配），发送计数（本进程发往其他进程的消息数），接收计数（本进程接收到的消息数），发送事件（当前发送的事件号），接收事件，异常次数。

最下面的表格是一些统计信息，包括发送总流量（当前每秒发送的KBYTE数），接收总流量，断链总次数，异常总次数，运行时间，总注册次数。

2.2.3 配置选项页这一页包括本地节点的信息（区号、局号、节点号、绑定的IP地址、端口号），以及要连接的远端节点的信息。

当需要修改本地节点信息时，如下操作即可：1、单击winnttcp界面上的最小化图标，使托盘图标区出现小齿轮图标：2、在小齿轮图标上单击鼠标右键，在弹出菜单中选“配置”，在密码输入框中输入“xxxxxx”，这时winnttcp程序界面自动切换到第三页；3、在第三页界面上单击“更改位置”按钮，在弹出对话框中用户可以编辑本机的区号、局号、节点号、绑定的IP地址和子网掩码，在局域网内一般选“本机是使用网卡通讯”；4、单击“确定”，在弹出的重启程序对话框中选“确定”，在重启NT对话框中选“取消”（否则操作系统会重启）；5、重启程序即可使设置生效；当需要设置本节点要连接的远端节点时，操作如下：1、2两步同上；3、在第三页界面上单击“新增”按钮，在弹出对话框中用户可以设置要连接的远端节点的节点号、节点名和IP地址，注意不要选“侦听”复选框，否则程序不会去连该节点；当然，用户也可以直接在配置文件$WINNT\tcpseek.ini中修改，然后重启winnttcp程序，但是建议用户在界面上修改，这样更为可靠；关于tcpseek.ini的说明见如下文档：3tcpout3.1 简介：tcpout是运行在中兴通讯外部通讯网关（节点号一般为200）的通讯程序，其主要功能是用来实现局内节点和其他厂家的程序之间的连接，比如外部营帐接口（节点号201-209）。

tcpout侦听的本地端口号是3000，对于外部客户，它是服务器，接受外部客户的连接，对于本局的服务器（129），它是客户端，向服务器发起连接。

但必须在配置文件$WINNT\tcpout.ini中配置它要接受连接的远端节点的节点号、IP等信息，否则远端客户节点将无法连入。

3.2 操作方法tcpout是类winnttcp的程序，所以操作方法和winnttcp基本相同，关于配置文件$WINNT\tcpout.ini的详细内容详见如下文档：4 S10see 4.1 简介：本程序用于：1、业务处理机上的实时信息显示，主要包括支撑系统的一些运行参数；2、打印信息显示，包括支撑打印和业务打印信息。

本程序只能运行在业务处理机上，只能用于显示业务处理机的信息。

4.2 操作方法4.2.1 支撑系统信息页该页最上面一行是本节点的区号、局号、节点号（由于对应NT业务处理机多个进程只有一个S10see程序，这里的节点号只是配置文件中LOCALMODULE1的节点号），OMM 服务器的节点号，“Configure Table”按钮用于显示业务处理机配置文件S10dog.ini的内容。

C:\config\S10cfg.ini是业务处理机支撑的重要配置文件，其用法详见如下文档：第二排的表格用于显示和本节点相连的所有节点的连接情况，包括节点号，连接状态（正常、断开、连接中），当前消息发送者pno，当前发送事件号，当前消息接收者pno，当前接收事件号，发送计数，接收计数，接收异常，断链次数，等待队列长度，溢出计数。

再下面从左至右第一个表格是系统信息表格，包括：定时器队列访问申请信号量失败次数TMCBSemaFail，定时器控制块耗尽次数TMCBExhaust（申请定时器控制块失败），定时器控制块溢出次数TMCBOverflow（归还定时器控制块失败），UB队列访问申请信号量失败次数UBSemaFail，调用GetUB申请太大的UB的次数GetUBLarge，释放UB时UB 头中的队列值大于7的次数RetUBLarge，重复释放已经释放的UB的次数RetUBDuplicate，释放UB时UB头中的token值错误的次数RetUBInvalidToken，UB利用率UBRate（实际上是前6个UB池利用率中的最大值），向任务邮箱放消息失败的次数PostMsgFail，定时器任务100ms循环周期超长的次数TimeTaskLong，时间校正出错次数SysTimeErr等。

第二个表格是8个UB队列的由于UB耗尽导致申请UB失败的次数；第三个表格是8个UB队列的由于UB队列中的所有UB块均未分配导致释放UB失败的次数；第四个表格是16个任务邮箱的溢出计数，当任务邮箱满时，向任务投递消息会失败，这时该计数会加1；第五个表格是16个任务邮箱的邮箱信号量申请失败次数；该页最下面显示了业务处理机节点的CPU利用率，每3秒更新一次。

4.2.2 支撑打印信息页和业务打印信息页这两页纯粹用于显示支撑和业务的打印信息。

4.2.3 参数设置页该页用于NT业务处理机以100ms为周期向前台进程发异步测试消息AsynTestEvent，用户可以在界面上设置每个周期发包数目以及每包字节数、前台目标模块号和进程号，“Print DebugInfo”复选框无用，只有当“Communication Test”复选框选中并单击“OK”按钮以后业务处理机才会向前台发异步测试消息，该测试页不适用于单机多进程的情况（因为不可控，无法确定发送异步测试消息的业务处理机进程）。

5 Printctl5.1 简介：Printctl是打印控制程序，一般运行在129上，用于设置业务处理机和MP的打印目的地、打印级别以及进行一些测试。