AIX命令参考大全，卷 3，i - m

invscoutd 命令

用途

启动一个永久库存监控服务器守护进程。

语法

invscoutd [ -o] [ -p Portno] [ -b Bufsize] [ -t Timeout] [ -v Verblev]

描述

invscoutd 命令在用户本地网络的一台机器上实现一个永久库存监控服务器守护进程。通常的客户端是运行在用户浏览器中的 Java 小应用程序，该程序是从中央库存监控 CGI 应用程序下载下来的。

守护进程的初始化包括读取命令行选项和一些本地库存监控伴随文件。当操作时，每个客户机／服务器事务涉及从一个熟悉的套接字读取文本字符串和在相同的套接字上返回一个文本报告。

守护进程在日志文件里维护它的操作记录。根据指定的冗长级别，记录日志行可能涉及启动和关闭标志、每个调用的跟踪、详细的内部程序跟踪和错误语句。根据指定的冗长级别，启动标志可能也写入标准错误中。

协议

到守护进程套接字的客户机连接使用因特网 TCP/IP 协议。在事务中，调用客户端 applet 发送一个操作请求（作为一个 URL 编码文本字符串）到服务器守护进程。请求是通过任何 ASCII 控制字符（x00 到 x1F）来触发请求处理。

一些请求需要客户机传递其它的数据。在这种情况下，其它的数据紧跟一个在操作请求中指定长度的终止字节。

有一个例外（ACTION=PING），服务器守护进程总会返回一个写回到同一个套接字连接的伪 MIME 格式化文本报告。伪 MIME 格式甚至可以用作错误结果。守护进程通过关闭套接字终止返回文本和事务本身，产生一个调用客户机的文件结束符（EOF）指示。客户机应该在一收到 EOF 标志就在连接的结束处关闭套接字。

URL 编码消息

操作请求字符串是一个标准 URL 编码的字符串。例如：

"ACTION=actionword&NAME1=value1&NAME2&NAME3=word%xx+word+word\0"

1. 字段名称和它们的值被等号（=）隔开。
2. Name = Value 对被一个 & 字符隔开。
3. Name 字段总是不区分大小写。
4. Value 字段不区分大小写，除非另有说明。
5. 必须提供 ACTION=keyword 对。
6. 在 & 符号之间且没有等于符号的字符串解析为一个带有空值的 Name 字段。
7. 空格可由 +（加号）表示。
8. 二进制字符也许编码为一个百分符号的转义序列，该百分号后紧跟两个十六进制的字符（%xx）。这个转义序列也必须用来编码值内 &、=（等于号）、和+（加号）的之类的 URL 元字符。
9. 控制字符终止字节必须总是由客户机发送。

"action=ping\0"

<EOF>

"action=ECHO&MRDM=xyz&datalen=5\0abcde"

"RESULT=0\n"
"\n"
"action=ECHO&MRDM=xyz&datalen=5\n"
"abcde"<EOF>

"action=UrlDecode&subaction=xyz\0"
 

"RESULT=0\n"
"\n"
"  0: ACTION       UrlDecode\n"
"  1: SUBACTION    xyz\n"
<EOF>

"ACTION=TESTPWD&MRDM=thepassword\0"
 
"RESULT=0\n"
"\n"
<EOF>

"ACTION=VERSIONS\0"
 
"RESULT=0\n"
"\n"
"\n"
"1.2.3.4\n"
"5.6.7.8\n"
<EOF>

"ACTION=CATALOG&MRDM=xyz&DATALEN=17042\0"
"...ascii 数据的 17042 字节..."

"RESULT=0\n"
"\n"
<EOF>

"ACTION=MCODES&MRDM=xyz\0"
 
"RESULT=0\n"
"\n"
"Report Line 1\n"
"Report Line 2\n"
    :
    :
"Report Line N\n"
<EOF>

"ACTION=VPDS&MRDM=xyz\0"
 
"RESULT=0\n"
"\n"
"Report Line 1\n"
"Report Line 2\n"
    :
    :
"Report Line N\n"
<EOF>

结果

守护进程返回一个伪 MIME 格式的文本结果。它通过其自身返回由一个或多个 Name=Value 对构成的报头，每个一行。第一个 Name =Value 对是 RESULT=number 格式的结果代码。每个操作都返回结果代码，除了 PING 操作。

仅应用于 Java applet 的内部监控结果代码没有记录在以下信息中。

根据结果代码，一个可选的自由格式的文本报告可以紧随报头行。如果有自由格式的文本报告，报头首先被一个空行终止，比如两个连续的换行。

无论什么情况，在读取套接字报告文本的最后部分后，结果报告会被一个 EOF 指示符终止。EOF 也表示事务本身的结束。

标志

指定任意参数，由一个连字符（-）开始。在标志和它的值之间不允许空格。

退出状态

该命令返回以下退出值：

安全性

守护进程必须作为一个有效用户标识 0 （root）而执行。它为 root 用户所有，并且安装时“setuid”位设为 ON 以使任何用户均可启动它。然而在某个执行点上，守护进程的子服务重新设置它们的用户标识为认证用户标识 invscout。守护进程不会执行除非用户 invscout 已经在主机系统上创建。

缺省情况下，对于大多数操作，需要从客户机获得一个随附的明文密码。如果客户机密码不匹配认证用户标识 invscout 的系统密码，那么操作将退出并有一个返回码。认证用户标识是不能改变的。

文件

相关信息

invscout 命令。