modifySIBus 指令

請利用 modifySIBus 指令來修改服務整合匯流排的內容。

如果要執行這個指令,請使用 wsadmin Scripting 用戶端的 AdminTask 物件。

[IBM i][IBM i]從 Qshell 執行 wsadmin Scripting 用戶端

服務整合匯流排指令有指令行說明:
  • 如需 Jython 中可用的服務整合匯流排指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:

    print AdminTask.help('SIBAdminCommands')

  • 如需給定指令的概觀說明,請在 wsadmin 提示下,輸入下列指令:

    print AdminTask.help('command_name')

使用指令之後,請利用下列指令,儲存對主要配置所做的變更:

AdminConfig.save()

用途

這個指令會修改服務整合匯流排的內容。

目標物件

一輛巴士

必要參數

-bus 匯流排名稱
用來識別服務整合匯流排的名稱。 您可以使用 listSIBuses 指令來列出現有匯流排的名稱。

條件式參數

無。

選用參數

-description 文字
匯流排的選用說明(基於管理用途)。
-secure TRUE | FALSE
此版本已淘汰此參數。
-mediationsAuthAlias 名稱
用來授權調解存取匯流排之鑑別別名的名稱。
-securityGroupCacheTimeout timeout_value
將快取安全群組的時間長度(分鐘)。 timeout_value 可以在 099999的範圍內。 預設值為 120

增加逾時值會減少使用者登錄負載,可以改進效能,但對於使用者群組成員資格的變更,系統的回應性比較差。 若要將群組快取調整為最佳設定,您需要平衡回應性與登錄負載的需求。 例如,如果系統必須快速回應使用者群組成員資格中的變更,請指定逾時 15 分鐘。 如果系統回應頻率較低 (例如為了回應夜間變更) ,請指定逾時 1440 分鐘 (24 小時)。 如果設定為 0,則快取中的項目不會逾時,因此會保留到下次重新啟動伺服器為止。

變更這個值會立即生效,只會影響已變更配置之匯流排的群組快取。

-protocol 通訊協定
這個匯流排中的傳訊引擎之間進行通訊所用的傳輸鏈。
-discardOnDelete TRUE | FALSE
如果可以捨棄已刪除訊息點上的訊息,請將此選項設為 TRUE 。 如果已刪除訊息點上的訊息應該保留在系統異常狀況目的地,請將此選項設為 FALSE
-busSecurity TRUE | FALSE
將此選項設為 TRUE ,以施行匯流排的授權原則,這也需要啟用管理安全。 如果您一律要停用匯流排安全,請將此選項設為 FALSE 。 如果已停用管理安全,則匯流排不安全。
-permittedChains ALL | SSL_ENABLED | LISTED
設定三個選項之一,以施行匯流排的傳輸原則。
全部
容許使用所有已定義的傳輸通道鏈。
ssl_enabled
將已定義傳輸通道鏈的使用限制為 SSL 所保護的那些傳輸通道鏈。
已列出
將使用已定義的傳輸通道鏈限制為受保護傳輸的清單。
-bootstrapPolicy SIBSERVICE_ENABLED | MEMBERS_AND_NOMINATED | MEMBERS_ONLY
設定三個選項之一,以施行匯流排成員原則。
SIBSERVICE_ENABLED
Cell 中已啟用 SIB 服務的任何伺服器都可以處理引導要求。
MEMBERS_AND_NOMINATED
只有匯流排成員或指定的引導伺服器可以處理引導要求。
僅成員
只有匯流排成員可以處理引導要求。
-useServerIdForMediations TRUE | FALSE
如果您要使用匯流排的單一伺服器身分來執行調解,請將此選項設為 TRUE 。 這個選項可讓您在多個安全網域之間執行調解,而不需要指定每一個網域的調解鑑別別名。 在廣域網域上,您可以利用伺服器身分來執行調解。 如果您要使用調解鑑別別名來執行調解,請將此選項設為 FALSE
-auditAllowed TRUE | FALSE
將此選項設為 TRUE ,以啟用匯流排的安全審核。 將此選項設為 FALSE 以停用匯流排的安全審核。 預設值為 true。 您必須具有「審核管理者」專用權才能使用此參數。

範例

AdminTask.modifySIBus('[-bus bus1 -description [A new description of the bus]]')
'bus1(cells/cell01/buses/bus1|sib-bus.xml)'