WebGet 命令

语法

Web 邮件负载 WEBGET 的用法：

WEBGET [-sumonly | -alldata]

{-url <urlname>   [-walk  <depth> <span>]    [-proxy <urlname>]   

[-mi | -mis  <msgsize> <numrecipients> [<nthIteration>] 

| -mir <numtoread> [<numtodel>] | -mp] }  | 

[ -holdtime <waitconn> <waitsend><waitrecv>]

iNotes® WEBGET 的工作负载的用法：

WEBGET [-sumonly | -alldata]

{ -url <urlname>   [-walk  <depth> <span>]    [-proxy <urlname>]   

[ -qp | -qi | -qt  | 

-qis <msgsize> <numrecipients> [<nthIteration>]  | 

-qir <numtoread> [<numtodel>] | 

-qca <msgsize> <duration> <mindaysaway> <maxdaysaway> [<nthIteration>] | 

-qci <msgsize> <duration> <mindaysaway> <maxdaysaway> <numrecipients>[<nthIteration>] | 

-qmr <num> [<nthIteration>] }  | 

[ -holdtime <waitconn> <waitsend><waitrecv>]

描述

[sumonly | alldata] 参数检索概要信息 (sumonly) 或实际数据，例如，指定 URL 的图像 (alldata)。概要信息使用 HTTP HEAD 命令检索；实际数据使用 HTTP GET 命令检索。要使 HTTP 服务器负载较轻时，概要方式很有用，因为概要信息通常少于 300 字节，而 HTML 文档或图像可以为任意大小。

[{-url <urlname> [-walk <depth> <span>] [-proxy <urlname>] }-[holdtime <ct> <st><waitrecv>] 

在从 URL（例如，-url www.ibm.com）中检索出 Web 内容以后，可以使用 -walk 开关遍历各个页面上的超链接。<depth> 参数表示对于给定页面以及所遍历的各个 HTML 文档要遍历的超链接的数量，并且递归地应用于该页面。<span> 参数表示对于给定链接来说，在返回初始请求页面以前可以遍历的页面的最大数量。

-walk 开关不会遍历先前已经遍历的链接（即不会选择“返回主页”链接）；这可以防止出现无穷递归循环。-walk 命令也不会浏览指向其他 HTTP 服务器的链接（即不会选择位于 www.renovations.com 上指向 www.ibm.com 的链接），从而避免了无止境地浏览 HTTP 服务器。

-proxy 开关应当在指定的 URL 是外部站点（即必须通过指定的代理服务器访问的站点）时使用。

-holdtime 开关指定在完成 HTTP 事务之前 WebGet 将等待的时间。完成 HTTP 事务所需的事件序列为：建立到 HTTP 服务器的连接，将命令发送到 HTTP 服务器，从 HTTP 服务器接收数据。

<ct> 参数表示在将命令发送到 HTTP 服务器以后等待的时间（毫秒）。这可以有效地将分配用来服务于响应请求的 HTTP 服务器线程/进程保留在空闲状态下。<ct> 应该小于 HTTP 服务器的连接时间超时参数（通常为 2 分钟）。<st> 参数用于指定在将命令发送到 HTTP 服务器后所等待的时间。这可以有效地将提供服务的 HTTP 服务器线程/进程保留在空闲状态下，即使它可能已经准备好发送数据。<rt> 参数用于指定从 HTTP 服务器收到请求的数据后所等待的时间。

-mi 开关特别适用于 WebMail负载打开用户的 Web Mail 收件箱。

-mis <msgsize> <numrecipients> [<nthIteration>] 

-mis 开关特别适用于 Web Mail 负载发送邮件（msgsize = 邮件正文的大小），或者单词“profile”被用来随机选择邮件，并根据下列概要文件确定的大小选择附件：

<numrecipients> 参数等于邮件收件人的数量，可选参数 <nthiteration> 控制此命令实际执行的频率。例如，

• 如果 nthiteration = 1，则总是执行此命令。
• 如果 nthiteration = 2，则每隔一个循环执行一次此命令。
• 如果 nthiteration = 6，则每 6 个循环执行一次此命令。

-mir <numtoread> [<numtodel>] 开关特别适用于 Web Mail 负载读取 Web 邮件。参数 numtoread 表示要读取的邮件数，可选参数 numtodel 表示要删除的邮件数。

-mp 开关特别适用于 WebMail 负载设置 Web 邮件数据库的所有者。

-qp 开关特别适用于 iNotes® 工作负载设置 iNotes® 数据库的所有者。

-qi 开关特别适用于 iNotes® 工作负载打开用户的 iNotes® 数据库（收件箱），无须读取任何文档。

-qt 开关特别适用于 iNotes® 工作负载确定该数据库使用的邮件模板。

-qis <msgsize> <numrecipients> [<nthIteration>] 开关特别适用于 iNotes® 工作负载发送邮件。参数 msgsize 等于邮件正文的大小，单词“profile”用来随机选择邮件和附件，附件的大小取决于下列概要文件：

numrecipients 参数等于邮件收件人的数量，可选参数 nthiteration 控制此命令实际执行的频率。例如，

• 如果 nthiteration = 1，则总是执行此命令。
• 如果 nthiteration = 2，则每隔一个循环执行一次此命令。
• 如果 nthiteration = 6，则每 6 个循环执行一次此命令。

-qir <numtoread> [<numtodel>] [<numtoadd>] 开关专门用于 iNotes® 工作负载读取邮件。参数 <numtoread> 表示读取的邮件数量，可选参数 <numtodel> 表示删除的邮件数量。可选参数 <numtoadd> 表示添加到 $Inbox 的消息数量。

-qca <msgsize> <duration> <mindaysaway> <maxdaysaway> [<nthIteration>] 开关专门用于 iNotes® 工作负载创建日程表指定。参数 msgsize 等于约会正文的大小，参数 duration 等于以分钟为单位的约会长度，参数 mindaysaway 等于从今天起到预定约会为止的最小天数，参数 maxdaysaway 等于从今天起到预定约会的最大天数。可选参数 nthiteration 控制此命令的实际执行频率。

-qci <msgsize> <duration> <mindaysaway> <maxdaysaway> <numrecipients> [<nthIteration>] 开关专门用于 iNotes® 工作负载创建并发送邀请。参数 msgsize 等于邀请正文的大小，参数 duration 等于以分钟为单位的邀请长度，参数 mindaysaway 等于从今天起到预定邀请为止的最小天数，参数 maxdaysaway 等于从今天起到预定邀请的最大天数。可选参数 nthiteration 控制此命令的实际执行频率。

-qmr <num> [<nthIteration>] 开关专门用于 iNotes® 工作负载创建并发送收到的邀请的响应。参数 num 等于要创建的 RSVP 数量，即收到邀请等待处理的数量。可选参数 nthiteration 控制此命令的实际执行频率。

示例 1

从 Web 浏览器的角度，命令 [-url www.renovations.com -walk 2 1] 解释为：从 Web 页面 www.renovations.com 开始，在该页面上选择两个要单击的链接（如果该页面至少含有两个链接）。单击第一个选定的链接，返回到初始页面，然后单击第二个链接，并返回到初始页面。

示例 2

从 Web 浏览器的角度，命令 [-url www.renovations.com -walk 1 2] 解释为：从 Web 页面 www.renovations.com 开始，在该页面上选择一个要单击的链接。单击该链接，然后将同一规则递归地应用于每个新页面。假定所单击的第一个链接为 www.renovations.com/sales.htm，那么该规则将要求 WebGet 在该页面上找到一个链接并遍历它。span 参数表示该递归过程的停止位置。

另外，-walk 0 0 表示 WebGet 应当仅请求由 <urlname> 指示的页面，而不再请求其他页面。等效于省略 -walk 开关。或者，使用 -walk 10000 10000（或其他较大数字），表示您希望 WebGet 遍历该页面上每个可能的链接，这非常像一个网络机器人。