WebGet 指令

語法

WEBGET 的網路郵件工作負荷用法：

WEBGET [-sumonly | -alldata]

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

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

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

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

iNotes® WEBGET 的網路郵件工作負荷用法：

WEBGET [-sumonly | -alldata]

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

[ -qp | -qi | -qt  | 

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

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

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

-qca <msgsize> <duration> <mindaysaway> <maxdaysaway> [<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) 擷取網路內容之後，可將 -walk 參數用於越過在每一頁上找到的超鏈結。<depth> 參數指出要對給定頁面遍訪的超鏈結數目；對於每一個遍訪的 HTML 文件，該參數亦會遞迴套用至該頁面。<span> 參數指出返回起始要求頁面之前，可遍訪之給定鏈結的頁數上限。

-walk 參數不遍訪先前已遍訪的鏈結（亦即，不會選取返回首頁鏈結）；這樣可以防止無休止的遞迴迴圈。-walk 指令亦不會瀏覽連至其他 HTTP 伺服器的鏈結（亦即，不會選取 www.renovations.com 上連至 www.ibm.com 的鏈結），這樣可避免無休止地瀏覽 HTTP 伺服器。

如果指定的 URL 是外部網站（即必須透過指定的 Proxy 伺服器存取的 URL），則應使用 -proxy 參數。

-holdtime 參數指定在完成 HTTP 異動之前，WebGet 將等待的時間量。完成 HTTP 交易所需的事件順序是：建立 HTTP 伺服器的連線、將指令傳送給 HTTP 伺服器、從 HTTP 伺服器接收資料。

<ct> 參數指出在向 HTTP 伺服器發出指令之後要等待的時間量（以微秒為單位）。這會有效地使已調度的 HTTP 伺服器執行緒/程序為處於閑置狀態中的申請服務。<ct> 應小於 HTTP 伺服器的連線時間逾時參數（通常是 2 分鐘）。<st> 參數指定將指令傳送給 HTTP 伺服器之後要等待的時間量。這樣會有效地使服務中的 HTTP 伺服器執行緒/程序保持閑置，即使它可能備妥傳送資料。<rt> 參數指定將指令傳送給 HTTP 伺服器之後要等待的時間量。

-mi 參數特別用於 WebMail 工作負荷，以開啟使用者的網路郵件信箱。

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

-mis 參數特別用於網路郵件工作負荷以傳送郵件（msgsize = 訊息內文的大小），'設定檔' 一字用於隨機選取訊息及附件檔，其大小取決於下列設定檔：

<numrecipients> 參數等於訊息收件人數目，選用參數 <nthiteration> 控制實際執行指令的頻率。例如，

• 如果 nthiteration = 1，一律執行指令。
• 如果 nthiteration = 2，每隔一個疊代執行一次指令。
• 如果 nthiteration = 6，每第六個疊代執行一次指令。

-mir <numtoread> [<numtodel>] 參數特別用於「網路郵件」工作量以讀取「網路郵件」。numtoread 參數指示要讀取的訊息數，可選用的 numtodel 參數指示要刪除的訊息數。

-mp 參數特別用於 WebMail 工作負荷以設定網路郵件資料庫的擁有者。

-qp 參數特別用於 iNotes® 工作量，以設定 iNotes® 資料庫的擁有者。

-qi 參數特別用於 iNotes® 工作量，以開啟使用者的 iNotes® 資料庫（收件匣），但不讀取任何文件。

-qt 參數特別用於 iNotes® 工作量，以判斷用於此資料庫的郵件範本。

-qis <msgsize> <numrecipients> [<nthIteration>] 參數特別用於 iNotes® 工作量，以傳送郵件。msgsize 參數等於訊息內文的大小，'設定檔' 一字用於隨機選取訊息和附件檔，其大小取決於下列設定檔：

numrecipients 參數等於訊息收件人數目，可選用的參數 nthiteration 控制實際執行指令的頻率。例如，

• 如果 nthiteration = 1，一律執行指令。
• 如果 nthiteration = 2，每隔一個疊代執行一次指令。
• 如果 nthiteration = 6，每第六個疊代執行一次指令。

-qir <numtoread> [<numtodel>] [<numtoadd>] 參數特別用於 iNotes® 工作量以讀取郵件。參數 <numtoread> 指出要讀取的訊息數，而選用參數 <numtodel> 則指出要從 $Inbox 刪除的訊息數。選用參數 <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 參數等於從今天以後到安排邀請的最多天數，numrecipients 參數等於訊息收件人數目。選用性參數 nthiteration 以實際執行此指令來控制頻率。

-qmr <num> [<nthIteration>] 參數特別用於 iNotes® 工作量，以建立回應並將其傳送至已接收的邀請。num 參數等於要建立的 RSVP 的數目，也就是要處理的已接收邀請數目。選用性參數 nthiteration 以實際執行此指令來控制頻率。

範例 1

網路瀏覽器將指令 [-url www.renovations.com -walk 2 1] 解譯如下：從網頁 www.renovations.com 開始，選取該頁上的兩個鏈結（如果該頁至少有兩個鏈結的話）並按一下。按一下第一個選取的連結，返回到初始網頁，然後按一下第二個連結，再返回到初始網頁。

範例 2

網路瀏覽器將指令 [-url www.renovations.com -walk 1 2] 解譯如下：從網頁 www.renovations.com 開始，選取該頁上的兩個鏈結並按一下。按一下連結，然後將相同的規則遞迴套用到每一個新頁。假設按一下的第一個鏈結是 www.renovations.com/sales.htm，則規則需要 WebGet 尋找該頁上的一個鏈結並遍訪它。span 參數指出遞迴程序的停止點。

此外，-walk 0 0 指出 WebGet 只應要求由 <urlname> 指出的頁面，而不應要求其他頁面。相當於省去 -walk 參數。或者，-walk 10000 10000（或其他較大的數字）的數字指出您要讓 WebGet 越過該頁上每個可信的鏈結，更像機械式 Web。