AddJob 指令
此指令可代替網站或商店排定工作。在時間方面則是藉由指定起始時間與間隔而來。
已排定的工作可重新發出;亦即,這些工作可在指定的逾時期間內定期執行。

參數值
- http://host_name/path/
- WebSphere Commerce Server 與架構路徑的完整名稱。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- URL
- 當指令順利完成時所要呼叫的 URL。
- name
- 排程器代以執行工作的使用者。此參數取自 USERREG 表格中的 LOGONID 直欄。
- pathInfo
- 所要執行的 WebSphere Commerce 指令。例如:
request=commerce/servlet/pathInfo?queryString
- queryString
- 所要執行的指令參數。 所有特殊字元(如 &、=、/ 與 ?)皆必須括上括弧。
- start
- 第一次應執行此工作的時間,格式為 YYYY:MM:DD:HH:MM:SS;只有 HH:MM:SS 值方面為必須輸入的。
- host
- 容許執行此項工作的主電腦名稱。如果省略此參數,則表示任何主電腦皆可執行該項工作。只有在排程器執行於多部主電腦上,
而需要限定工作在某部主電腦上執行時,才需用到此參數。主電腦名稱的格式應為:
name.domain
- interval
- 隔幾秒後即再次執行一次此工作。如果省略此參數,則工作只會執行一次。
- attempts
- 如果工作失敗,則排程器將重試此工作幾次。此參數應與 delay 參數一起使用。這兩個參數必須同時提供,才能重試工作。
- delay
- 要過幾秒後才重試一次該失敗的工作。此參數應與 attempts 參數一起使用。這兩個參數必須同時提供,才能重試工作。
- schedulePolicy
- 指出當工作執行失敗時,排程器所要採行的原則。可供定義的值如下:
- 0 - 工作只執行一次,且下次的執行時間是排定在未來;此為預設值。
- 1 - 工作無限次地執行,以恢復所有錯過的執行。
- priority
- 連結此工作之優先順序的號碼。此值將插入到 SCHCONFIG 表格的 SCCPRIORITY 直欄中。值愈大表示該工作的優先順序愈高。
- applicationType
- 用以執行所要新增之工作的應用程式類型。此參數的用途是在限制資源使用密集的工作使用有限的執行緒數目。而應用程式類型以及管理其資源存取的規則,是由使用者定義在 XML 伺服器架構檔中。預設的應用程式類型為空值。
- storeId
- 擁有所排定之工作的商店。
- checkCmdId
- 此種作業指令會施行 CheckForWorkCmd 介面,
以決定是否需執行指令。
範例 1
下列範例是在指定的起始時間新增一項工作:
http://myhostname/webapp/wcs/stores/servlet/AddJob?start=2000:07:15:14:15:20
&pathInfo='/InterestItemDisplay'&URL=basemall.jsp&name=login999&queryString=listId%3D
範例 2
下列範例是排定一項下單工作,而該訂單的參考號碼為 3。
它是代替 wcsadmin 使用者執行,執行時間起自 2001 年 2 月 21 日中午 12:15,
並且每隔 5 分鐘(300 秒)重複一次。若指令失敗,則在失敗後的 60 秒會執行一次指令以期恢復:
http://myhostname/webapp/wcs/stores/servlet/AddJob?command=OrderProcess
¶meters=orderId%3D3&interval=300&name=wcsadmin&start=2001:12:15:00
&attempts=1&delay=60&URL=/demomall/basemall.html
規則
- 為背景伺服器設定一項要執行的工作。
- 在 SCHCONFIG 與
SCHACTIVE 表格中新增一個項目。如開始時間省掉年、月或日,則將使用對應本日的值。只有如下的起始時間組合能夠省略:
- 排程器將代替 name 參數指定的使用者執行指令。此指令將執行 interval 參數所指的次數,
並且根據 attempts 與 delay 參數的值來重試工作。
異常狀況
無。
