資源配置 Script
Scripting 程式庫提供多項 Script 程序，來自動執行您的應用程式伺服器配置。 使用郵件、URL 及資源環境配置 Script ，在您的環境中建立及配置資源。 您可以個別執行每一個 Script，或是合併一些程序，來建立自訂自動化 Script。
郵件、URL 及資源管理 Script 程序位於 app_server_root/scriptLibraries/resources/ 目錄中。
從第 7 版開始，Jython Script 程式庫提供了伺服器範圍的 JDBC 提供者、JMS 資源和資源提供者的 Script 功能。 您可以撰寫自己的自訂 Script 來配置 Cell、節點或叢集層次的資源。
避免麻煩: 請勿編輯 Script 程式庫中的 Script 程序。 若要撰寫自訂 Script 程式庫程序，請使用 app_server_root/scriptLibraries 目錄中的 Script 作為 Jython 語法範例。 請將自訂 Script 儲存在新的子目錄中，以免改寫程式庫。
捷徑: 從 Fix Pack 5 開始， Jython Script 程式庫為 Cell、節點、伺服器或叢集範圍的 JDBC 提供者、JMS 資源及資源提供者提供 Script 功能。 資源提供者包括郵件提供者、URL 提供者和資源環境提供者。 您不需要撰寫特定範圍的自訂 Script 來配置資源。
注意: 為了列印目的，會將範例用法 Script 和 Script 語法分割成多行。
使用下列 Script 程序來配置郵件設定:
使用下列 Script 程序來配置資源環境設定:
使用下列 Script 程序來配置 URL 提供者設定:
使用下列 Script 程序來配置其他 Java™ Enterprise Edition (Java EE) 資源:
scope 引數的格式
scope 格式適用於 Script 程式庫中有 scope 引數的 Script。
在節點、伺服器和叢集範圍上，Cell 是選用的。 在伺服器範圍上，節點是必要的。
您可以使用逗點 (，) 或冒號 (:) 來區隔類型。 您可以將先前的案例用於類型 (Cell =、節點 =、伺服器 = 或叢集 =。)
下表的範例，分割為數行是為了便於發佈。
| 範圍 | 包含路徑 | 配置 ID | 類型 |
|---|---|---|---|
| 儲存格 | /Cell:myCell/ | |
Cell=myCell 或 cell=myCell |
| 節點 | /Cell:myCell/Node:myNode/或 /Node:myNode/ | |
|
| 伺服器 | |
|
|
| 叢集 | |
|
|
createCompleteMailProvider
此 Script 會配置郵件提供者的其他配置屬性。 當郵件階段作業鑑別使用者並控制使用者對傳訊系統的存取權時，郵件提供者會封裝通訊協定提供者的集合，例如 SMTP、IMAP 及 POP3。 配置您自己的郵件提供者及階段作業，以自訂如何處理 JavaMail 。 Script 會傳回所建立郵件提供者的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| mailProvider名稱 | 指定應用程式伺服器用於這個郵件階段作業的郵件提供者。 |
| propName | 指定自訂內容的名稱。 |
| propValue | 指定自訂內容的值。 |
| protocolName | 指定通訊協定提供者的名稱。 應用程式伺服器包含 SMTP、IMAP 及 POP3的通訊協定提供者。 |
| className | 指定通訊協定提供者的實作類別名稱。 |
| mailSession名稱 | 指定 JavaMail 階段作業物件的管理名稱。 |
| JNDIName | 指定資源的「Java 命名和目錄介面 (JNDI)」名稱，包括任何命名子環境定義。 這個名稱提供用戶端應用程式部署描述子所定義之資源的平台連結資訊與平台將它連接到 JNDI 的實際資源之間的連結。 |
| mailStore主機 | 指定接收郵件時所存取的伺服器。 此設定結合郵件儲存庫使用者 ID 及密碼，代表有效的郵件帳戶。 例如，如果郵件帳戶是john_william@my.company.com，則郵件儲存庫主機是my.company.com. |
| mailStore使用者 | 指定給定郵件帳戶的使用者 ID。 例如，如果郵件帳戶是john_william@my.company.com則使用者是john_william. |
| mailStore密碼 | 指定給定郵件帳戶的密碼。 例如，如果郵件帳戶是john_william@my.company.com然後輸入 ID 的密碼john_william. |
語法
AdminResources.createCompleteMailProvider(nodeName,
serverName, mailProviderName, propName, propValue,
protocolName, className, mailSessionName, JNDIName,
mailStoreHost, mailStoreUser, mailStorePassword)範例用法
AdminResources.createCompleteMailProvider("myNode",
"myServer", "myMailProvider", "myProp", "myPropValue", "myMailProtocol",
"com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1",
"mailuser", "password")createCompleteMailProviderAtScope
此 Script 會為您指定的範圍配置郵件提供者的其他配置屬性。 當郵件階段作業鑑別使用者並控制使用者對傳訊系統的存取權時，郵件提供者會封裝通訊協定提供者的集合，例如 SMTP、IMAP 及 POP3。 配置您自己的郵件提供者及階段作業，以自訂如何處理 JavaMail 。 Script 會傳回針對指定範圍所建立之郵件提供者的配置 ID。
若要執行 Script ，請指定範圍、郵件提供者名稱、內容名稱、內容值、通訊協定名稱、類別名稱、類型、郵件階段作業名稱及 JNDI 名稱引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| mailProvider名稱 | 指定應用程式伺服器用於這個郵件階段作業的郵件提供者。 |
| propName | 指定自訂內容的名稱。 |
| propValue | 指定自訂內容的值。 |
| protocolName | 指定通訊協定提供者的名稱。 應用程式伺服器包含 SMTP、IMAP 及 POP3的通訊協定提供者。 |
| className | 指定通訊協定提供者的實作類別名稱。 |
| 類型 | 指定通訊協定提供者的類型。 有效選項為STORE或TRANSPORT. |
| mailSession名稱 | 指定 JavaMail 階段作業物件的管理名稱。 |
| jndiName | 指定資源的「Java 命名和目錄介面 (JNDI)」名稱，包括任何命名子環境定義。 這個名稱提供用戶端應用程式部署描述子所定義之資源的平台連結資訊與平台將它連接到 JNDI 的實際資源之間的連結。 |
| otherAttributesList、 mailProviderAttributesList、 mailSessionAttributesList | 選擇性地以特定格式指定其他屬性:
|
下表包含郵件提供者的選用屬性:
| 屬性 | 說明 |
|---|---|
| 類別路徑 | 指定一起形成資源提供者類別位置的路徑或 Java 保存檔 (JAR) 名稱清單。 請使用分號 (;) 來區隔類別路徑。 |
| 說明 | 指定郵件提供者的說明。 |
| isolatedClass載入器 | 如果設為 true ，則指定在郵件提供者自己的類別載入器中載入郵件提供者。 注意: 當指定原生程式庫路徑時，無法隔離提供者。
|
| nativePath | 指定任何原生程式庫 (例如 *.dll 和 *.so) 的選用路徑。 請使用分號 (;) 來區隔原生路徑項目。 |
| providerType | 指定此郵件提供者使用的郵件提供者類型。 |
下表包含郵件階段作業的選用屬性:
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| debug | 指定此郵件階段作業是否使用除錯模式。 預設值為 off。 |
| 說明 | 指定郵件提供者的說明。 |
| mailFrom | 指定網際網路電子郵件位址。 如果設為 true ，則會在其自己的類別載入器中載入此郵件提供者。 警告： 當指定原生程式庫路徑時，無法隔離提供者。
|
| mailStore主機 | 指定接收郵件時所要連接的伺服器。 |
| mailStore埠 | 指定接收郵件時要連接的埠。 |
| mailStore使用者 | 指定當送入郵件伺服器需要鑑別時，郵件帳戶的使用者。 |
| mailStore密碼 | 指定當送入郵件伺服器需要鑑別時，郵件帳戶的密碼。 |
| mailStore通訊協定 | 指定接收郵件時要用的通訊協定。 |
| mailTransport主機 | 指定當傳送郵件時所要連接的伺服器。 |
| mailTransport埠 | 指定傳送郵件時要連接的埠。 |
| mailTransport使用者 | 指定當外寄郵件伺服器需要鑑別時，郵件帳戶的使用者。 |
| mailTransport密碼 | 指定當外寄郵件伺服器需要鑑別時，郵件帳戶的密碼。 |
| mailTransport通訊協定 | 指定傳送郵件時所要使用的通訊協定。 |
| 嚴格 | 指定是否依照 RFC 822 來剖析收件者位址。 預設值為 true。 |
語法
AdminResources.createCompleteMailProviderAtScope(scope,
mailProviderName, propName, propValue,
protocolName, className, type, mailSessionName, JNDIName, otherAttributesList,
mailProviderAttributesList, mailSessionAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createCompleteMailProviderAtScope("myScope",
"myMailProvider", "myProp", "myPropValue", "myMailProtocol",
"com.ibm.mail.myMailProtocol.myMailStore", "myMailSession", "myMailSession/jndi", "server1", "STORE")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createCompleteMailProviderAtScope("Node=MY4Node09, server=server1", "myMailProvider", "myProp",
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi",
"classpath=c:/temp, description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true",
"category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1, mailStorePassword=password,
mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password, mailTransportHost=test2,
mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createCompleteMailProviderAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myMailProvider", "myProp",
"myPropValue", "myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore", "STORE", "myMailSession", "myMailSession/jndi",
[['classpath', 'c:/temp'], ['description', 'this is my mail'], ['nativepath', 'c:/temp/nativepath'],
['isolatedClassLoader', 'true']]
[['category', 'myCategory'], ['debug', 'true'], ['description', 'this is my mailsession'], ['mailStoreUser', 'user1'],
['mailStorePassword', 'password'], ['mailStoreHost', 'user1'], ['mailStorePort', 1000], ['mailTransportUser', 'user2'],
['mailTransportPassword', 'password'], ['mailTransportHost', 'test2'], ['mailTransportPort', 1001], ['strict', 'true'],
['mailFrom', 'test1@gmail.com']])createMail提供者
此 Script 會在您的環境中建立郵件提供者。 應用程式伺服器包括稱為內建提供者的預設郵件提供者。 如果您使用預設郵件提供者，則只需要配置郵件階段作業。 若要使用自訂郵件提供者，您必須先建立郵件提供者及階段作業。 Script 會傳回所建立郵件提供者的配置 ID。
若要執行 Script ，請指定下表中定義的節點、伺服器及郵件提供者名稱:
| 引數 | 說明 |
|---|---|
| nodeName | 指定要在其中建立郵件提供者的節點名稱。 |
| serverName | 指定要為其建立郵件提供者的伺服器名稱。 |
| mailProvider名稱 | 指定要指派給新郵件提供者的名稱。 |
語法
AdminResources.createMailProvider(nodeName, serverName,
mailProviderName)範例用法
AdminResources.createMailProvider("myNode", "myServer",
"myMailProvider")createMailProviderAt範圍
此 Script 會在您的環境中，於您指定的範圍建立郵件提供者。 應用程式伺服器包括稱為內建提供者的預設郵件提供者。 如果您使用預設郵件提供者，則只需要配置郵件階段作業。 若要使用自訂郵件提供者，您必須先建立郵件提供者及階段作業。 Script 會傳回針對指定範圍所建立之郵件提供者的配置 ID。
若要執行 Script ，請指定範圍及郵件提供者名稱引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| mailProvider名稱 | 指定要指派給新郵件提供者的名稱。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 類別路徑 | 指定一起形成資源提供者類別位置的路徑或 Java 保存檔 (JAR) 名稱清單。 請使用分號 (;) 來區隔類別路徑。 |
| 說明 | 指定郵件提供者的說明。 |
| isolatedClass載入器 | 如果設為 true ，則指定在郵件提供者自己的類別載入器中載入郵件提供者。 注意: 當指定原生程式庫路徑時，無法隔離提供者。
|
| nativePath | 指定任何原生程式庫 (例如 *.dll 和 *.so) 的選用路徑。 請使用分號 (;) 來區隔原生路徑項目。 |
| providerType | 指定此郵件提供者使用的郵件提供者類型。 |
語法
AdminResources.createMailProviderAtScope(scope, mailProviderName, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createMailProviderAtScope("myScope", "myMailProvider")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createMailProviderAtScope("Node=MY4Node09, server=server1", "myMailProvider", "classpath=c:/temp,
description='this is my mail', nativepath=c:/temp/nativepath, isolatedClassLoader=true")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createMailProviderAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myMailProvider",
[['classpath', 'c:/temp'],
['description', 'this ismy mail'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']])createMail階段作業
此 Script 會為您的郵件提供者建立新的郵件階段作業。 郵件階段作業由 javax.mail.Session 類別來表示。 郵件階段作業物件會鑑別使用者，並控制使用者對傳訊系統的存取權。 Script 會傳回所建立郵件階段作業的配置 ID。
若要執行 Script ，請指定節點名稱、伺服器名稱、郵件提供者名稱、郵件階段作業名稱及「Java 命名和目錄介面 (JNDI)」名稱引數，如下表中所定義:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| mailProvider名稱 | 指定應用程式伺服器用於這個郵件階段作業的郵件提供者。 |
| mailSession名稱 | 指定 JavaMail 階段作業物件的管理名稱。 |
| JNDIName | 請指定資源的 JNDI 名稱，其中包括任何命名子環境定義。 這個名稱提供用戶端應用程式部署描述子所定義之資源的平台連結資訊與平台將它連接到 JNDI 的實際資源之間的連結。 |
語法
AdminResources.createMailSession(nodeName, serverName,
mailProviderName, mailSessionName, JNDIName)範例用法
AdminResources.createMailSession("myNode", "myServer", "myMailProvider",
"myMailSession", "myMailSession/jndi")createMailSessionAt範圍
此 Script 會在您指定的範圍為您的郵件提供者建立新的郵件階段作業。 郵件階段作業由 javax.mail.Session 類別來表示。 郵件階段作業物件會鑑別使用者，並控制使用者對傳訊系統的存取權。 Script 會傳回針對指定範圍所建立之郵件階段作業的配置 ID。
如果要執行 Script ，請指定範圍、郵件提供者名稱、郵件階段作業名稱，以及「Java 命名和目錄介面 (JNDI)」名稱引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| mailProvider名稱 | 指定應用程式伺服器用於這個郵件階段作業的郵件提供者。 |
| mailSession名稱 | 指定 JavaMail 階段作業物件的管理名稱。 |
| JNDIName | 請指定資源的 JNDI 名稱，其中包括任何命名子環境定義。 這個名稱提供用戶端應用程式部署描述子所定義之資源的平台連結資訊與平台將它連接到 JNDI 的實際資源之間的連結。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| debug | 指定此郵件階段作業是否使用除錯模式。 預設值為 off。 |
| 說明 | 指定郵件提供者的說明。 |
| mailFrom | 指定網際網路電子郵件位址。 如果設為 true ，則會在其自己的類別載入器中載入此郵件提供者。 警告： 當指定原生程式庫路徑時，無法隔離提供者。
|
| mailStore主機 | 指定接收郵件時所要連接的伺服器。 |
| mailStore埠 | 指定接收郵件時要連接的埠。 |
| mailStore使用者 | 指定當送入郵件伺服器需要鑑別時，郵件帳戶的使用者。 |
| mailStore密碼 | 指定當送入郵件伺服器需要鑑別時，郵件帳戶的密碼。 |
| mailStore通訊協定 | 指定接收郵件時要用的通訊協定。 |
| mailTransport主機 | 指定當傳送郵件時所要連接的伺服器。 |
| mailTransport埠 | 指定傳送郵件時要連接的埠。 |
| mailTransport使用者 | 指定當外寄郵件伺服器需要鑑別時，郵件帳戶的使用者。 |
| mailTransport密碼 | 指定當外寄郵件伺服器需要鑑別時，郵件帳戶的密碼。 |
| mailTransport通訊協定 | 指定傳送郵件時所要使用的通訊協定。 |
| 嚴格 | 指定是否依照 RFC 822 來剖析收件者位址。 預設值為 true。 |
語法
AdminResources.createMailSessionAtScope(scope,
mailProviderName, mailSessionName, JNDIName, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createMailSessionAtScope("myScope", "myMailProvider",
"myMailSession", "myMailSession/jndi", attributes")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createMailSessionAtScope("Node=MY4Node09, server=server1", "myMailProvider", "myMailSession",
"myMailSession/jndi", "category=myCategory, debug=true, description='this is my mailsession', mailStoreUser=user1,
mailStorePassword=password, mailStoreHost=user1, mailStorePort=1000, mailTransportUser=user2, mailTransportPassword=password,
mailTransportHost=test2, mailTransportPort=1001, strict=true, mailFrom=test1@gmail.com")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createMailSessionAtScope("/Cell:MY4Cell01/ServerClust
er:c1/", "myMailProvider", "myMailSession", "myMailSession/jndi",
[['category','myCategory'], ['description', 'this is mailsession'], ['debug', 'true'],
['mailTransportHost', 'test1'], ['mailTransportUser', 'user2'], ['mailTransportPassword', 'password'],
['mailStoreUser', 'user1'], ['mailStorePassword', 'password'], ['mailStoreHost', 'test2'], ['strict', 'true'],
['mailFrom', 'tester@mail.com']]))createProtocol提供者
此 Script 會在配置中建立通訊協定提供者，以提供特定通訊協定的實作類別來支援 JavaMail 應用程式與郵件伺服器之間的通訊。 應用程式伺服器包含 SMTP、IMAP 及 POP3的通訊協定提供者。 如果您需要不同通訊協定的自訂提供者，請先在應用程式服務環境中安裝它們，然後再配置提供者。 請參閱 JavaMail API 設計規格，以取得準則。 配置好通訊協定提供者之後，請返回郵件提供者頁面來尋找配置郵件階段作業的鏈結。 Script 會傳回所建立通訊協定提供者的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| mailProvider名稱 | 指定應用程式伺服器與通訊協定提供者相關聯使用的郵件提供者名稱。 |
| protocolName | 指定通訊協定提供者的名稱。 應用程式伺服器包含 SMTP、IMAP 及 POP3的通訊協定提供者。 |
| className | 指定通訊協定提供者的實作類別名稱。 |
| 類型 | 指定通訊協定提供者的類型。 有效選項為STORE或TRANSPORT. |
語法
AdminResources.createProtocolProvider(nodeName,
serverName, mailProviderName, protocolName,
className, type)範例用法
AdminResources.createProtocolProvider("myNode", "myServer", "myMailProvider",
"myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore",
"STORE")createProtocolProviderAt範圍
此 Script 會在您的配置中，於您指定的範圍建立通訊協定提供者。 通訊協定提供者提供特定通訊協定的實作類別，以支援您在指定範圍內的 JavaMail 應用程式與郵件伺服器之間的通訊。 應用程式伺服器包含 SMTP、IMAP 及 POP3的通訊協定提供者。 如果您需要不同通訊協定的自訂提供者，請先在應用程式服務環境中安裝它們，然後再配置提供者。 請參閱 JavaMail API 設計規格，以取得準則。 配置好通訊協定提供者之後，請返回郵件提供者頁面來尋找配置郵件階段作業的鏈結。 此 Script 會針對指定的範圍，傳回所建立通訊協定提供者的配置 ID。
若要執行 Script ，請指定範圍郵件提供者名稱、通訊協定名稱、類別名稱及類型引數。 您可以選擇性地指定 classpath 屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| mailProvider名稱 | 指定應用程式伺服器與通訊協定提供者相關聯使用的郵件提供者名稱。 |
| protocolName | 指定通訊協定提供者的名稱。 應用程式伺服器包含 SMTP、IMAP 及 POP3的通訊協定提供者。 |
| className | 指定通訊協定提供者的實作類別名稱。 |
| 類型 | 指定通訊協定提供者的類型。 有效選項為STORE或TRANSPORT. |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 類別路徑 | 指定一起形成資源提供者類別位置的路徑或 Java 保存檔 (JAR) 名稱清單。 請使用分號 (;) 來區隔類別路徑。 |
語法
AdminResources.createProtocolProviderAtScope(nodeName,
serverName, mailProviderName, protocolName,
className, type, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createProtocolProviderAtScope("myScope", "myMailProvider",
"myMailProtocol", "com.ibm.mail.myMailProtocol.myMailStore",
"STORE")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createProtocolProviderAtScope("Node=MY4Node09, server=server1", "myMailProvider", "myMailProtocol",
“com.ibm.mail.myMailProtocol.myMailStore", "STORE", "classpath=c:/temp")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createProtocolProviderAtScope("/Cell:MY4Cell01/Server
Cluster:c1/", "myMailProvider", "myMailProtocol", "com.ibm.mail.myMailProtocol.m
yMailStore", "STORE", [['classpath', 'c:/temp']]))createCompleteResourceEnv提供者
此 Script 會配置資源環境提供者，其會封裝可參照項目，將資源環境項目資料轉換為配置中的資源物件。 此 Script 會傳回所建立資源環境提供者的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| resourceEnvProviderName | 指定要指派給資源環境提供者的名稱。 |
| propName | 指定要設定的自訂內容名稱。 |
| propValue | 指定自訂內容的值。 |
| factoryClass | 指定將資源環境項目資料轉換成實體資源之類別實例的 Factory。 |
| className | 指定可參照的類別名稱。 |
| resourceEnvEntryName | 指定資源環境項目的名稱。 |
| JNDIName | 指定資源環境項目的 JNDI 名稱，包括任何命名子環境定義。 這個名稱用來作為模組部署描述子所定義之資源的平台連結資訊，與平台連結到 JNDI 的實際資源之間的鏈結。 |
語法
AdminResources.createCompleteResourceEnvProvider(nodeName,
serverName, resourceEnvProviderName, propName,
propValue, factoryClass, className,
resourceEnvEntryName, JNDIName)範例用法
AdminResources.createCompleteResourceEnvProvider("myNode", "myServer",
"myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String",
"myResEnvEntry", "res1/myResEnv")createCompleteResourceEnvProviderAt範圍
此 Script 會在您指定的範圍配置資源環境提供者。 資源環境提供者會封裝可參照項，可將資源環境項目資料轉換成配置中的資源物件。 此 Script 會傳回所指定範圍之已建立資源環境提供者的配置 ID。
如果要執行 Script ，請指定範圍、資源環境提供者、自訂內容名稱、自訂內容值、Factory 類別、類別名稱、資源環境項目及 JNDI 名稱引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| resourceEnvProviderName | 指定要指派給資源環境提供者的名稱。 |
| propName | 指定要設定的自訂內容名稱。 |
| propValue | 指定自訂內容的值。 |
| factoryClass | 指定將資源環境項目資料轉換成實體資源之類別實例的 Factory。 |
| className | 指定可參照的類別名稱。 |
| resourceEnvEntryName | 指定資源環境項目的名稱。 |
| jndiName | 指定資源環境項目的 JNDI 名稱，包括任何命名子環境定義。 這個名稱用來作為模組部署描述子所定義之資源的平台連結資訊，與平台連結到 JNDI 的實際資源之間的鏈結。 |
| otherAttributesList， resourceEnvProviderAttributesList， resourceEnvEntryAttributesList | 選擇性地以特定格式指定其他屬性:
|
下表包含資源環境提供者的選用屬性:
| 屬性 | 說明 |
|---|---|
| 類別路徑 | 指定一起形成資源提供者類別位置的路徑或 Java 保存檔 (JAR) 名稱清單。 請使用分號 (;) 來區隔類別路徑。 |
| 說明 | 指定資源環境提供者的說明。 |
| isolatedClass載入器 | 如果設為 true ，則指定將這個資源環境提供者載入它自己的類別載入器中。 注意: 當指定原生程式庫路徑時，無法隔離提供者。
|
| nativePath | 指定任何原生程式庫 (例如 *.dll 和 *.so) 的選用路徑。 請使用分號 (;) 來區隔原生路徑項目。 |
| providerType | 指定這個資源環境提供者使用的資源提供者類型。 |
下表包含資源環境項目的選用屬性:
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| 說明 | 指定資源提供者的說明。 |
| providerType | 指定這個資源環境提供者使用的郵件提供者類型。 |
| 可參照 | 指定封裝 Factory 類別名稱的可參照項，這個 Factory 會將資源環境項目資料轉換成實體資源的類別實例。 |
語法
AdminResources.createCompleteResourceEnvProviderAtScope(scope,
resourceEnvProviderName, propName,
propValue, factoryClass, className,
resourceEnvEntryName, JNDIName, otherAttributesList,
resourceEnvProviderAttributesList, resourceEnvProviderAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createCompleteResourceEnvProviderAtScope("myScope",
"myResEnvProvider", "myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String",
"myResEnvEntry", "res1/myResEnv")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createCompleteResourceEnvProviderAtScope("Node=MY4Node09, server=server1", "myResEnvProvider", "myProp",
"myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", "classpath=c:/temp,
description='this is my resource provider', nativepath=c:/temp/nativepath,
isolatedClassLoader=false", "category=myCategory, description='this is my resource entry',
referenceable=(cells/MY4Cell01/nodes/MY4Node09|resources.xml#Referenceable_1238331401156)")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createCompleteResourceEnvProviderAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myResEnvProvider",
"myProp", "myPropValue", "com.ibm.resource.res1", "java.lang.String", "myResEnvEntry", "res1/myResEnv", [['classpath', 'c:/temp'],
['description', 'this is my resource provider'], ['nativepath','c:/temp/nativepath'], ['isolatedClassLoader', 'false']]
[['category', 'myCategory'], ['description', 'this is my resource entry'],
['referenceable', '(cells/MY4Cell01/nodes/MY4Node09|resources.xml#Referenceable_1238331401156)']])createResourceEnvEntries
此 Script 會在您的配置中建立資源環境項目。 在應用程式伺服器名稱空間內，資源環境項目所包含的資料會轉換成代表實體資源的物件。 此資源通常稱為環境資源。 Script 會傳回所建立資源環境項目的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| resourceEnvProviderName | 指定此項目的資源環境提供者。 提供者封裝一些類別，當實作這些類別時，可將資源環境項目資料轉換成資源物件。 |
| 可參照 | 指定封裝 Factory 類別名稱的可參照項，這個 Factory 會將資源環境項目資料轉換成實體資源的類別實例。 |
| resourceEnv項目 | 指定要建立之資源環境項目的名稱。 |
| JNDIName | 指定字串，用來利用 JNDI 來查閱這個環境資源。 您就是要將資源環境參照部署描述子連結至這個字串。 |
語法
AdminResources.createResourceEnvEntries(nodeName,
serverName, resourceEnvProviderName, referenceable,
resourceEnvEntry, JNDIName)範例用法
AdminResources.createResourceEnvEntries("myNode", "myServer",
"myResEnvProvider", "com.ibm.resource.res1", "myResEnvEntry", "res1/myResEnv")createResourceEnvEntriesAtScope
此 Script 會在您的配置中，於您指定的範圍建立資源環境項目。 在應用程式伺服器名稱空間內，資源環境項目所包含的資料會轉換成代表實體資源的物件。 此資源通常稱為環境資源。 Script 會傳回所指定範圍之已建立資源環境項目的配置 ID。
如果要執行 Script ，請指定資源環境提供者、資源環境項目和 JNDI 名稱引數的範圍。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| resourceEnvProviderName | 指定此項目的資源環境提供者。 提供者封裝一些類別，當實作這些類別時，可將資源環境項目資料轉換成資源物件。 |
| resourceEnv項目 | 指定要建立之資源環境項目的名稱。 |
| JNDIName | 指定字串，用來利用 JNDI 來查閱這個環境資源。 您就是要將資源環境參照部署描述子連結至這個字串。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| 說明 | 指定資源提供者的說明。 |
| providerType | 指定這個資源環境提供者使用的郵件提供者類型。 |
| 可參照 | 指定封裝 Factory 類別名稱的可參照項，這個 Factory 會將資源環境項目資料轉換成實體資源的類別實例。 |
語法
AdminResources.createResourceEnvEntriesAtScope(scope,
resourceEnvProviderName,
resourceEnvEntry, JNDIName, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createResourceEnvEntriesAtScope("myScope",
"myResEnvProvider", "myResEnvEntry", "res1/myResEnv")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createResourceEnvEntriesAtScope("Node=MY4Node09, server=server1", "myResEnvProvider",
"myResEnvEntry", "res1/myResEnv", "category=myCategory, description='this is my resource entry',
referenceable=(cells/MY4Cell01/nodes/MY4Node09|resources.xml#Referenceable_1238331401156)")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createResourceEnvEntriesAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myResEnvProvider",
"myResEnvEntry", "res1/myResEnv", [['category', 'myCategory'], ['description', 'this is my resource entry'],
['referenceable', '(cells/MY4Cell01/nodes/MY4Node09|resources.xml#Referenceable_1238331401156)']])createResourceEnvProvider
此 Script 會在您的配置中建立資源環境提供者。 資源環境提供者會封裝類別，這些類別在實作時，會將資源環境項目資料轉換成資源物件。 此 Script 會傳回所建立資源環境提供者的配置 ID。
若要執行 Script ，請指定節點名稱、伺服器名稱及資源環境提供者名稱引數，如下表中所定義:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| resourceEnvProviderName | 指定要建立的資源環境提供者。 |
語法
AdminResources.createResourceEnvProvider(nodeName,
serverName, resourceEnvProviderName)範例用法
AdminResources.createResEnvProvider("myNode", "myServer",
"myResEnvProvider")createResourceEnvProviderAtScope
這個 Script 會在您的配置中，依照您指定的範圍來建立資源環境提供者。 資源環境提供者會封裝類別，這些類別在實作時，會將資源環境項目資料轉換成資源物件。 此 Script 會傳回針對指定範圍所建立之資源環境提供者的配置 ID。
如果要執行 Script ，請指定範圍和資源環境提供者名稱引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| resourceEnvProviderName | 指定要建立的資源環境提供者。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 類別路徑 | 指定一起形成資源提供者類別位置的路徑或 Java 保存檔 (JAR) 名稱清單。 請使用分號 (;) 來區隔類別路徑。 |
| 說明 | 指定資源環境提供者的說明。 |
| isolatedClass載入器 | 如果設為 true ，則指定將這個資源環境提供者載入它自己的類別載入器中。 注意: 當指定原生程式庫路徑時，無法隔離提供者。
|
| nativePath | 指定任何原生程式庫 (例如 *.dll 和 *.so) 的選用路徑。 請使用分號 (;) 來區隔原生路徑項目。 |
| providerType | 指定這個資源環境提供者使用的資源提供者類型。 |
語法
AdminResources.createResourceEnvProviderAtScope(scope,
resourceEnvProviderName, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createResEnvProviderAtScope("myScope",
"myResEnvProvider")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createResourceEnvProviderAtScope("Node=MY4Node09, server=server1", "myResEnvProvider",
"classpath=c:/temp, description='this is my resource provider', nativepath=c:/temp/nativepath, isolatedClassLoader=false")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createResourceEnvProviderAtScope("/Cell:MY4Cell01/ServerCluster:c1/",
"myResEnvProvider", [['classpath', 'c:/temp'],
['description','this is my resource provider'], ['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'false']])createResourceEnvProvider參照
這個 Script 會在您的配置中建立資源環境提供者參照。 資源環境參照不同於資源參照。 資源環境參照可讓您的應用程式用戶端使用邏輯名稱來查閱連結至伺服器 JNDI 名稱空間的資源。 資源參照可讓您的應用程式使用邏輯名稱來查閱本端 JEE 資源。 JEE 規格未指定資源的特定實作。 此 Script 會傳回所建立資源環境提供者參照 ID 的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| resourceEnvProviderName | 指定此參照的資源環境提供者。 提供者封裝一些類別，當實作這些類別時，可將資源環境項目資料轉換成資源物件。 |
| factoryClass | 指定將資源環境項目資料轉換成實體資源之類別實例的 Factory 類別。 |
| className | 指定要與可參照項相關聯的類別名稱。 |
語法
AdminResources.createResourceEnvProviderRef(nodeName,
serverName, resourceEnvProviderName, factoryClass,
className)範例用法
AdminResources.createResourceEnvProviderRef("myNode", "myServer",
"myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")createResourceEnvProviderRefAt範圍
這個 Script 會在您的配置中，依照您指定的範圍來建立資源環境提供者參照。 資源環境參照不同於資源參照。 資源環境參照可讓您的應用程式用戶端使用邏輯名稱來查閱連結至伺服器 JNDI 名稱空間的資源。 資源參照可讓您的應用程式使用邏輯名稱來查閱本端 JEE 資源。 JEE 規格未指定資源的特定實作。 此 Script 會傳回所指定範圍之已建立資源環境提供者參照 ID 的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| resourceEnvProviderName | 指定此參照的資源環境提供者。 提供者封裝一些類別，當實作這些類別時，可將資源環境項目資料轉換成資源物件。 |
| factoryClass | 指定將資源環境項目資料轉換成實體資源之類別實例的 Factory 類別。 |
| className | 指定要與可參照項相關聯的類別名稱。 |
語法
AdminResources.createResourceEnvProviderRefAtScope(scope,
resourceEnvProviderName, factoryClass,
className, otherAttributesList)範例用法
AdminResources.createResourceEnvProviderRefAtScope("/Node:MY4Node09/Server:server1/",
"myResEnvProvider", "com.ibm.resource.res1", "java.lang.String")configURLProvider
此 Script 會配置 URL 提供者，以提供應用程式伺服器透過特定通訊協定存取 URL 所需的實作類別。 預設 URL 提供者透過 IBM® Developer Kit 所支援的通訊協定提供連線功能。 這些通訊協定包括 HTTP 及檔案傳送通訊協定 (FTP) ，它們適用於必須 URL。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| URLProviderName | 指定要配置的 URL 提供者名稱。 |
| URLStreamHandler類別 | 指定延伸特定 URL 通訊協定 (例如 FTP) 的 java.net.URLStreamHandler 類別之使用者定義 Java 類別的完整名稱。 |
| URLProtocol | 指定這個串流處理程式所支援的通訊協定。 例如：NNTP、SMTP、FTP。 |
| propName | 指定要為 URL 提供者設定的自訂內容名稱。 |
| propValue | 指定要為 URL 提供者設定的自訂內容值。 |
| URL 名稱 | 指定指向網際網路或內部網路資源的「統一資源定址器 (URL)」名稱。 例如: https://www.ibm.com。 |
| JNDIName | 請指定 JNDI 名稱。 請勿在不同資源類型之間指派重複的 JNDI 名稱，例如郵件階段作業與 URL 配置。 不在相同範圍中，指派重複的 JNDI 名稱給相同類型的多項資源。 |
| URLSpec | 指定用來形成 URL 的字串。 |
語法
AdminResources.configURLProvider(nodeName, serverName,
URLProviderName, URLStreamHandlerClass, URLProtocol,
propName, propValue, URLName, JNDIName,
URLSpec)範例用法
AdminResources.configURLProvider("myNode", "myServer", "myURLProvider",
"com.ibm.resource.url1", "ftp", "myProp", "myPropValue", "myURL", "url1/myURL",
"myURLSpec")createCompleteURLProvider
此 Script 會建立 URL 提供者，其提供應用程式伺服器透過特定通訊協定存取 URL 所需的實作類別。 預設 URL 提供者透過 IBM Developer Kit 所支援的通訊協定提供連線功能。 這些通訊協定包括 HTTP 及檔案傳送通訊協定 (FTP) ，它們適用於必須 URL。 此 Script 會傳回所建立 URL 提供者的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| URLProviderName | 指定要配置的 URL 提供者名稱。 |
| URLStreamHandler類別 | 指定延伸特定 URL 通訊協定 (例如 FTP) 的 java.net.URLStreamHandler 類別之使用者定義 Java 類別的完整名稱。 |
| URLProtocol | 指定這個串流處理程式所支援的通訊協定。 例如：NNTP、SMTP、FTP。 |
語法
AdminResources.createCompleteURLProvider(nodeName,
serverName, URLProviderName, URLStreamHandlerClass,
URLProtocol)範例用法
AdminResources.createCompleteURLProvider("myNode", "myServer",
"myURLProvider", "com.ibm.resource.url1", "ftp")createCompleteURLProviderAt範圍
此 Script 會在指定的範圍建立 URL 提供者。 URL 提供者提供應用程式伺服器透過特定通訊協定存取 URL 所需的實作類別。 預設 URL 提供者透過 IBM Developer Kit 所支援的通訊協定提供連線功能。 這些通訊協定包括 HTTP 及檔案傳送通訊協定 (FTP) ，它們適用於必須 URL。 Script 會傳回指定範圍所建立之 URL 提供者的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| URLProviderName | 指定要配置的 URL 提供者名稱。 |
| URLStreamHandler類別 | 指定延伸特定 URL 通訊協定 (例如 FTP) 的 java.net.URLStreamHandler 類別之使用者定義 Java 類別的完整名稱。 |
| URLProtocol | 指定這個串流處理程式所支援的通訊協定。 例如：NNTP、SMTP、FTP。 |
| propName | 指定要為 URL 提供者設定的自訂內容名稱。 |
| propValue | 指定要為 URL 提供者設定的自訂內容值。 |
| URL 名稱 | 指定指向網際網路或內部網路資源的「統一資源定址器 (URL)」名稱。 例如: https://www.ibm.com。 |
| jndiName | 請指定 JNDI 名稱。 請勿在不同資源類型之間指派重複的 JNDI 名稱，例如郵件階段作業與 URL 配置。 不在相同範圍中，指派重複的 JNDI 名稱給相同類型的多項資源。 |
| URLSpec | 指定用來形成 URL 的字串。 |
| otherAttributesList、 urlProviderAttributesList、 urlAttributesList | 選擇性地以特定格式指定其他屬性:
|
下表包含 URL 提供者的選用屬性:
| 屬性 | 說明 |
|---|---|
| 類別路徑 | 指定一起形成資源提供者類別位置的路徑或 Java 保存檔 (JAR) 名稱清單。 請使用分號 (;) 來區隔類別路徑。 |
| 說明 | 指定資源環境提供者的說明。 |
| isolatedClass載入器 | 如果設為 true ，則指定在其自己的類別載入器中載入這個 URL 提供者。 注意: 當指定原生程式庫路徑時，無法隔離提供者。
|
| nativePath | 指定任何原生程式庫 (例如 *.dll 和 *.so) 的選用路徑。 請使用分號 (;) 來區隔原生路徑項目。 |
| providerType | 指定這個資源環境提供者使用的 URL 提供者類型。 |
下表包含 URL 的選用屬性:
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| 說明 | 指定資源提供者的說明。 |
| providerType | 指定這個資源環境提供者使用的郵件提供者類型。 |
| 可參照 | 指定封裝 Factory 類別名稱的可參照項，這個 Factory 會將資源環境項目資料轉換成實體資源的類別實例。 |
語法
AdminResources.createCompleteURLProviderAtScope(Scope,
URLProviderName, URLStreamHandlerClass,
URLProtocol, propName, propValue,
URLName, JNDIName, URLSpec, otherAttributesList,
urlProviderAttributesList, urlAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createCompleteURLProviderAtScope("Scope",
"myURLProvider", "com.ibm.resource.url1", "ftp", myProp", myPropValue",
"myURL", "url1/myURL", "myURLSpec")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createCompleteURLProviderAtScope("Node=MY4Node09, server=server1", "myURLProvider",
"com.ibm.resource.url1",
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", "classpath=c:/temp, description='this
is my url provider',
nativepath=c:/temp/nativepath, isolatedClassLoader=true", "category=myCategory, description='this is my url'")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createCompleteURLProviderAtScope("/Cell:MY4Cell01/ServerCluster:c1/",
"myURLProvider", "com.ibm.resource.url1",
"ftp","myProp", "myPropValue", "myURL", "url1/myURL", "myURLSpec", [['classpath', 'c:/temp'],
['description', 'this is my urlProvider'],
['nativepath', 'c:/temp/nativepath'], ['isolatedClassLoader', 'true']] [['category', 'myCategory'],
['description', 'this is my url']])createURL
此 Script 會建立 URL 提供者，其提供應用程式伺服器透過特定通訊協定存取 URL 所需的實作類別。 預設 URL 提供者透過 IBM Developer Kit 所支援的通訊協定提供連線功能。 這些通訊協定包括 HTTP 及檔案傳送通訊協定 (FTP) ，它們適用於必須 URL。 Script 會傳回所建立 URL 的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| URLProviderName | 指定要指派 URL 的 URL 提供者名稱。 |
| URL 名稱 | 指定要建立的 URL 名稱。 |
| JNDIName | 請指定 JNDI 名稱。 請勿在不同資源類型之間指派重複的 JNDI 名稱，例如郵件階段作業與 URL 配置。 不在相同範圍中，指派重複的 JNDI 名稱給相同類型的多項資源。 |
| URLSpec | 指定用來形成 URL 的字串。 |
語法
AdminResources.createURL(nodeName, serverName,
URLProviderName, URLName, JNDIName,
URLSpec)範例用法
AdminResources.createURL("myNode", "myServer", "myURLProvider",
"myURL", "url1/myURL", "myURLSpec")createURLAt範圍
此 Script 會在您指定的範圍建立 URL 提供者。 URL 提供者提供應用程式伺服器透過特定通訊協定存取 URL 所需的實作類別。 預設 URL 提供者透過 IBM Developer Kit 所支援的通訊協定提供連線功能。 這些通訊協定包括 HTTP 及檔案傳送通訊協定 (FTP) ，它們適用於必須 URL。 Script 會傳回針對指定範圍所建立之 URL 的配置 ID。
如果要執行 Script ，請指定範圍、URL 提供者名稱、URL 名稱、JNDI 名稱和 URL 規格引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| URLProviderName | 指定要指派 URL 的 URL 提供者名稱。 |
| URL 名稱 | 指定要建立的 URL 名稱。 |
| JNDIName | 請指定 JNDI 名稱。 請勿在不同資源類型之間指派重複的 JNDI 名稱，例如郵件階段作業與 URL 配置。 不在相同範圍中，指派重複的 JNDI 名稱給相同類型的多項資源。 |
| URLSpec | 指定用來形成 URL 的字串。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| 說明 | 指定 URL 提供者的說明。 |
| providerType | 指定這個 URL 提供者使用的郵件提供者類型。 |
語法
AdminResources.createURLAtScope(scope,
URLProviderName, URLName, JNDIName,
URLSpec, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createURLAtScope("myScope", "myURLProvider",
"myURL", "url1/myURL", "myURLSpec")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createURLAtScope("Node=MY4Node09, server=server1", "myURLProvider", "myURL", "url1/myURL",
"myURLSpec", "category=myCategory, description='this is my url'")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createURLAtScope("/Cell:MY4Cell01/ServerCluster:c1/",
"myURLProvider", "myURL", "url1/myURL", "myURLSpec", [['category', 'myCategory'], ['description', 'this is my url']])createURLProvider
此 Script 會建立 URL 提供者，其提供應用程式伺服器透過特定通訊協定存取 URL 所需的實作類別。 預設 URL 提供者透過 IBM Developer Kit 所支援的通訊協定提供連線功能。 這些通訊協定包括 HTTP 及檔案傳送通訊協定 (FTP) ，它們適用於必須 URL。 此 Script 會傳回所建立 URL 提供者的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| URLProviderName | 指定要配置的 URL 提供者名稱。 |
| URLStreamHandler類別 | 指定延伸特定 URL 通訊協定 (例如 FTP) 的 java.net.URLStreamHandler 類別之使用者定義 Java 類別的完整名稱。 |
| URLProtocol | 指定這個串流處理程式所支援的通訊協定。 例如：NNTP、SMTP、FTP。 |
語法
AdminResources.createURLProvider(nodeName,
serverName, URLProviderName, URLStreamHandlerClass,
URLProtocol)範例用法
AdminResources.createURLProvider("myNode", "myServer",
"myURLProvider", "com.ibm.resource.url1", "ftp")createURLProviderAtScope
此 Script 會在您指定的範圍建立 URL 提供者。 URL 提供者提供應用程式伺服器透過特定通訊協定存取 URL 所需的實作類別。 預設 URL 提供者透過 IBM Developer Kit 所支援的通訊協定提供連線功能。 這些通訊協定包括 HTTP 及檔案傳送通訊協定 (FTP) ，它們適用於必須 URL。 Script 會傳回指定範圍所建立之 URL 提供者的配置 ID。
若要執行 Script ，請指定範圍、URL 提供者名稱、URL 串流處理程式類別及 URL 通訊協定引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| URLProviderName | 指定要配置的 URL 提供者名稱。 |
| URLStreamHandler類別 | 指定延伸特定 URL 通訊協定 (例如 FTP) 的 java.net.URLStreamHandler 類別之使用者定義 Java 類別的完整名稱。 |
| URLProtocol | 指定這個串流處理程式所支援的通訊協定。 例如：NNTP、SMTP、FTP。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 類別路徑 | 指定一起形成資源提供者類別位置的路徑或 Java 保存檔 (JAR) 名稱清單。 請使用分號 (;) 來區隔類別路徑。 |
| 說明 | 指定資源環境提供者的說明。 |
| isolatedClass載入器 | 如果設為 true ，則指定在其自己的類別載入器中載入這個 URL 提供者。 注意: 當指定原生程式庫路徑時，無法隔離提供者。
|
| nativePath | 指定任何原生程式庫 (例如 *.dll 和 *.so) 的選用路徑。 請使用分號 (;) 來區隔原生路徑項目。 |
| providerType | 指定這個資源環境提供者使用的 URL 提供者類型。 |
語法
AdminResources.createURLProviderAtScope(scope,
URLProviderName, URLStreamHandlerClass,
URLProtocol, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createURLProviderAtScope("myScope",
"myURLProvider", "com.ibm.resource.url1", "ftp")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createURLProviderAtScope("Node=MY4Node09, server=server1", "myURLProvider", "com.ibm.resource.url1",
"ftp", "classpath=c:/temp, description='this is my url provider', nativepath=c:/temp/nativepath, isolatedClassLoader=true")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createURLProviderAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myURLProvider", "com.ibm.resource.url1",
"ftp", [['classpath', 'c:/temp'], ['description', 'this is my url provider'], ['nativepath', 'c:/temp/nativepath'],
['isolatedClassLoader', 'true']])createJAASAuthentication別名
這個 Script 會建立「Java 鑑別和授權服務 (JAAS)」鑑別別名。 別名可識別鑑別資料項目。 當配置資源配接器或資料來源時，管理者可以使用對應的別名來指定要選擇哪些鑑別資料。 該 Script 會傳回所建立「 DB2®鑑別和授權服務 (JAAS) 鑑別別名」的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| authAlias名稱 | 指定要建立的鑑別別名名稱。 |
| authAliasID | 預期的安全網域的使用者身分。 例如，如果使用特定鑑別資料項目來開啟與 DB2的新連線，則此項目包含 DB2 使用者身分。 |
| authAliasPW | 指定在配置儲存庫中編碼使用者身分的密碼。 |
語法
AdminResources.createJAASAuthenticationAlias(authAliasName,
authAliasID, authAliasPW)範例用法
AdminResources.createJAASAuthenticationAlias("myJAAS", "user01",
"password")createLibrary參照
此 Script 會建立程式庫參照，以定義如何使用廣域程式庫。 讓伺服器上部署的多個應用程式可以使用程式庫檔案的首要步驟，是為您應用程式需要的每一個程式庫檔案建立共用程式庫。 當您建立共用程式庫時，請設定程式庫檔案的變數。 Script 會傳回所建立程式庫參照的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| libraryRef名稱 | 指定要建立的檔案庫參照名稱。 |
| applicationName | 指定要與程式庫參照相關聯的應用程式名稱。 |
語法
AdminResources.createLibraryRef(libraryRefName,
applicationName)範例用法
AdminResources.createLibraryRef("myLibrary", "myApplication")createShared程式庫
此 Script 會在您的配置中建立共用程式庫。 讓伺服器上部署的多個應用程式可以使用程式庫檔案的首要步驟，是為您應用程式需要的每一個程式庫檔案建立共用程式庫。 當您建立共用程式庫時，請設定程式庫檔案的變數。 Script 會傳回所建立程式庫的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| sharedLib名稱 | 指定要指派給共用程式庫的名稱。 |
| sharedLibClassPath | 指定產品在其中搜尋共用程式庫的類別和資源的檔案路徑。 如果清單中的路徑是檔案，產品會搜尋該 .jar 或壓縮 .zip 檔案的內容。 如果清單中的路徑是目錄，則產品會搜尋該目錄中 .jar 及 .zip 檔案的內容。 基於效能原因，只有在目錄包含子目錄或檔案 (非 .jar 或 .zip 檔案) 時，產品才會搜尋目錄本身。 |
語法
AdminResources.createSharedLibrary(nodeName,
serverName, sharedLibName, sharedLibClassPath)範例用法
![[Windows]](../images/ngwin.svg)
AdminResources.createSharedLibrary("myNode", "myServer",
"myLibrary", "c:/myLibrary.zip")![[Linux]](../images/nglinux.svg)
![[AIX]](../images/ngaix.svg)
![[z/OS]](../images/ngzos.svg)
![[HP-UX]](../images/nghpux.svg)
![[IBM i]](../images/ngibmi.svg)
![[Solaris]](../images/ngsolaris.svg)
AdminResources.createSharedLibrary("myNode", "myServer", "myLibrary",
"/myLibrary.zip")createSharedLibraryAt範圍
此 Script 會在您的配置中，於您指定的範圍建立共用程式庫。 讓伺服器上部署的多個應用程式可以使用程式庫檔案的首要步驟，是為您應用程式需要的每一個程式庫檔案建立共用程式庫。 當您建立共用程式庫時，請設定程式庫檔案的變數。 Script 會傳回針對指定範圍所建立之程式庫的配置 ID。
如果要執行 Script ，請指定範圍共用程式庫名稱和共用程式庫類別路徑引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定郵件提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| sharedLib名稱 | 指定要指派給共用程式庫的名稱。 |
| sharedLibClassPath | 指定產品在其中搜尋共用程式庫的類別和資源的檔案路徑。 如果清單中的路徑是檔案，產品會搜尋該 .jar 或壓縮 .zip 檔案的內容。 如果清單中的路徑是目錄，則產品會搜尋該目錄中 .jar 及 .zip 檔案的內容。 基於效能原因，只有在目錄包含子目錄或檔案 (非 .jar 或 .zip 檔案) 時，產品才會搜尋目錄本身。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 說明 | 指定共用程式庫的說明。 |
| isolatedClass載入器 | 如果設為 true ，則指定在其自己的類別載入器中載入 URL 提供者。 預設值為 false。注意: 當指定原生程式庫路徑時，無法隔離提供者。
|
| nativePath | 指定任何原生程式庫 (例如 *.dll 和 *.so) 的選用路徑。 請使用分號 (;) 來區隔原生路徑項目。 |
語法
AdminResources.createSharedLibraryAtScope(scope,
sharedLibName, sharedLibClassPath, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createSharedLibraryAtScope("myScope",
"myLibrary", "c:/myLibrary.zip")AdminResources.createSharedLibraryAtScope("myScope", "myLibrary",
"/myLibrary.zip")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createSharedLibraryAtScope("Node=MY4Node09, server=server1", "myLibrary",
"c:/myLibrary.zip", "description='this is my library',
nativePath=c:/nativepath, isolatedClassLoader=true") AdminResources.createSharedLibraryAtScope("Node=MY4Node09, server=server1", "myLibrary",
"c:/myLibrary.zip", "description='this is my library',
nativePath=/nativepath, isolatedClassLoader=true")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createSharedLibraryAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myLibrary",
"c:/myLibrary.zip", [['description', 'this is my library'],
['nativePath', 'c:/nativepath'], ['isolatedClassLoader', 'true']])AdminResources.createSharedLibraryAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myLibrary",
"c:/myLibrary.zip", [['description', 'this is my library'],
['nativePath', '/nativepath'], ['isolatedClassLoader', 'true']])createScheduler
這個 Script 會在您的配置中建立排程器。 排程器是能夠執行商業邏輯的持續性交易式計時器服務。 每一個排程器都獨立執行作業，並具有可從 JEE 應用程式使用「Java 命名和目錄介面 (JNDI)」來存取的程式設計介面。 您也可以使用「Java 管理延伸 (JMX)」MBean 來管理排程器。 如需如何配置及使用排程器的詳細資料，請參閱排程器文件。 Script 會傳回所建立排程器的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| schedulerName | 指定這個排程器用來進行管理的名稱。 |
| JNDIName | 指定 JNDI 名稱，以決定這個排程器實例在名稱空間中的連結位置。 雖然我們會建議您使用資源參照，但是用戶端也可以直接查看這個名稱。 |
| scheduleCategory | 指定一個可用來分類或分組這個排程器的字串。 |
| datasourceJNDI | 指定持續性作業儲存所在之資料來源的名稱。 名稱空間中任何可用的資料來源都可以搭配排程器來使用。 多個排程器共用單一資料庫，您可以指定表格字首，讓它們使用不同的表格。 |
| tablePrefix | 指定要附加到排程器表格中的字串字首。 如果每個實例都指定不同的字首字串，則多個獨立的排程器就可以共用同一個資料庫。 |
| pollInterval | 指定排程器輪詢資料庫的間隔（秒）。 預設值適當於大部分應用程式。 每個輪詢作業都可能很耗費資源。 如果間隔非常短，且排定的作業非常多，輪詢可能會耗用掉大部分的系統資源。 預設值為30. |
| workMgmtJNDI | 指定用來管理可以與排程器同時執行的作業數目之工作管理員的 JNDI 名稱。 工作管理員也可以限制套用至作業的 Java EE 環境定義數量。 |
語法
AdminResources.createScheduler(nodeName, serverName,
schedulerName, JNDIName, scheduleCategory,
datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI)範例用法
AdminResources.createScheduler("myNode", "myServer", "myScheduler",
"myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager")createSchedulerAtScope
這個 Script 會在您的配置中，於您指定的範圍建立排程器。 排程器是能夠執行商業邏輯的持續性交易式計時器服務。 每一個排程器都獨立執行作業，並具有可使用「Java 命名和目錄介面 (JNDI)」從 Java EE 應用程式存取的程式設計介面。 您也可以使用「Java 管理延伸 (JMX)」MBean 來管理排程器。 如需如何配置及使用排程器的詳細資料，請參閱排程器文件。 Script 會傳回針對指定範圍所建立之排程器的配置 ID。
如果要執行 Script ，請指定範圍、排程器名稱、JNDI 名稱、JNDI 資料來源、表格字首、輪詢間隔、工作管理員的 JNDI 名稱，以及排程器提供者 ID 引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定 JMS 提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| schedulerName | 指定這個排程器用來進行管理的名稱。 |
| JNDIName | 指定 JNDI 名稱，以決定這個排程器實例在名稱空間中的連結位置。 雖然我們會建議您使用資源參照，但是用戶端也可以直接查看這個名稱。 |
| datasourceJNDI | 指定持續性作業儲存所在之資料來源的名稱。 名稱空間中任何可用的資料來源都可以搭配排程器來使用。 多個排程器共用單一資料庫，您可以指定表格字首，讓它們使用不同的表格。 |
| tablePrefix | 指定要附加到排程器表格中的字串字首。 如果每個實例都指定不同的字首字串，則多個獨立的排程器就可以共用同一個資料庫。 |
| pollInterval | 指定排程器輪詢資料庫的間隔（秒）。 預設值適當於大部分應用程式。 每個輪詢作業都可能很耗費資源。 如果間隔非常短，且排定的作業非常多，輪詢可能會耗用掉大部分的系統資源。 預設值為30. |
| workMgmtJNDI | 指定用來管理可以與排程器同時執行的作業數目之工作管理員的 JNDI 名稱。 工作管理員也可以限制套用至作業的 Java EE 環境定義數量。 |
| schedulerProviderID | 指定這個排程器的提供者 ID。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| 說明 | 指定 URL 提供者的說明。 |
| providerType | 指定這個 URL 提供者使用的資源提供者類型。 |
| datasourceAlias | 指定這個 URL 提供者用來存取資料來源之使用者名稱和密碼的別名。 |
| loginConfig名稱 | 指定登入配置名稱。 |
| securityRole | 指定安全角色。 |
| useAdmin角色 | 指定當同時啟用這個選項和管理安全時，會施行使用者管理角色。 若要施行使用者管理角色，您必須使用排程器 JMX 指令或 API 來建立及修改作業。 如果未啟用這個選項，所有使用者都可以建立和修改作業。 預設值為 false。 |
| 可參照 | 指定封裝 Factory 類別名稱的可參照項，這個 Factory 會將資源環境項目資料轉換成實體資源的類別實例。 |
語法
AdminResources.createSchedulerAtScope(scope,
schedulerName, JNDIName,
datasourceJNDI, tablePrefix, pollInterval, workMgmtJNDI,
ScheduleProviderID, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createSchedulerAtScope("myNode", "myScheduler",
"myScheduleJndi", "Default", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager, "SchedulerProvider(cells/MY4Cell01/nodes/MY4Node09/servers/server1|resources-pme.xml#SchedulerProvider_1)")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createSchedulerAtScope("Node=MY4Node09, server=server1", "myScheduler",
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager", "SchedulerProvider(cells/MY4Cell01/nodes/MY4Node09/servers/server1|
resources-pme.xml#SchedulerProvider_1)", "category=myCategory,
description='this is my scheduler', datasourceAlias=abc, useAdminRoles=false, loginConfigName=test,
securityRole=user1")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createSchedulerAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myScheduler",
"myScheduleJndi", "jdbc/MyDatasource", "sch1", "30",
"myWorkManager", "SchedulerProvider(cells/MY4Cell01/clusters/c1|resources-pme.xml#SchedulerProvider_1)",
[['category', 'myCategory'],
['description', 'this is my scheduler'], ['datasourceAlias', 'abc'], ['useAdminRoles', 'false'],
['loginConfigName', 'test'], ['securityRole', 'user1']])createWork管理程式
這個 Script 會在您的配置中建立工作管理員。 工作管理員包含連結到 Java 命名和目錄介面的執行緒儲存區。 這個 Script 會傳回所建立之工作管理員的配置 ID。
若要執行 Script ，請指定下列引數:
| 引數 | 說明 |
|---|---|
| nodeName | 指定相關節點的名稱。 |
| serverName | 指定相關伺服器的名稱。 |
| workMgr名稱 | 指定用來識別這個工作管理員的名稱，以進行管理。 |
| JNDIName | 請指定用來在名稱空間中查閱工作管理員的「Java 命名和目錄介面 (JNDI) 」名稱。 |
| workMgr種類 | 請指定可用來將這個工作管理員分類或分組的字串。 |
| alarmThreads | 指定用於警示的所需執行緒數目上限。 預設值為2. |
| minThreads | 指定這個工作管理員中可用的執行緒數目下限。 |
| maxThreads | 指定這個工作管理員中可用的執行緒數目上限。 |
| threadPriority | 請指定這個工作管理員中可用執行緒的優先順序。 每一個執行緒都有一個優先順序。 優先順序較高的執行緒會在優先順序較低的執行緒之前執行。 如需如何使用執行緒優先順序的相關資訊，請參閱 Java EE 規格中 java.lang.Thread 類別之 setPriority 方法的 API 文件。 |
| isGrowable | 指定這個工作管理員能不能增加執行緒數目。 將值指定為true以指出執行緒數目可以增加。 |
| serviceNames | 指定要提供給這個工作管理員的服務清單。 |
語法
AdminResources.createWorkManager(nodeName, serverName,
workMgrName, JNDIName, workMgrCategory,
alarmThreads, minThreads, maxThreads, threadPriority,
isGrowable, serviceNames)範例用法
AdminResources.createWorkManager("myNode", "myServer", "myWorkManager",
"Work Manager", "wm/myWorkManager", "Default", 5, 1, 10, 5, "true",
"AppProfileService UserWorkArea com.ibm.ws.i18n security")createWorkManagerAt範圍
這個 Script 會在您的配置中，依照您指定的範圍來建立工作管理員。 工作管理員包含連結到 Java 命名和目錄介面的執行緒儲存區。 這個 Script 會針對指定的範圍，傳回已建立之工作管理員的配置 ID。
如果要執行 Script ，請指定範圍工作管理員名稱、JNDI 名稱、警示執行緒、最小執行緒、最大執行緒、執行緒優先順序，以及工作管理員提供者 ID 引數。 您可以選擇性地指定屬性。 引數和屬性定義在下列表格中:
| 引數 | 說明 |
|---|---|
| scope | 指定 JMS 提供者的 Cell、節點、伺服器或叢集的 範圍 。 |
| workMgr名稱 | 指定用來識別這個工作管理員的名稱，以進行管理。 |
| JNDIName | 請指定用來在名稱空間中查閱工作管理員的「Java 命名和目錄介面 (JNDI) 」名稱。 |
| alarmThreads | 指定用於警示的所需執行緒數目上限。 預設值為2. |
| minThreads | 指定這個工作管理員中可用的執行緒數目下限。 |
| maxThreads | 指定這個工作管理員中可用的執行緒數目上限。 |
| threadPriority | 請指定這個工作管理員中可用執行緒的優先順序。 每一個執行緒都有一個優先順序。 優先順序較高的執行緒會在優先順序較低的執行緒之前執行。 如需如何使用執行緒優先順序的相關資訊，請參閱 Java EE 規格中 java.lang.Thread 類別之 setPriority 方法的 API 文件。 |
| workManagerProviderID | 指定母項工作管理員提供者的配置 ID。 會在這個 ID 建立工作管理員。 您可以在現有的工作管理員提供者之下，或在新的工作管理員提供者之下，建立工作管理員。 下列 wsadmin 指令範例說明如何從伺服器範圍擷取現有工作管理員提供者的配置 ID: |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
| 屬性 | 說明 |
|---|---|
| 種類 | 指定可用來分類或分組資源的種類。 |
| 說明 | 指定 URL 提供者的說明。 |
| providerType | 指定這個 URL 提供者使用的資源提供者類型。 |
| daemonTran類別 | 指定用於常駐程式工作之工作量分類的交易類別。 常駐程式工作適用於工作量管理程式服務。 |
| defTran類別 | 指定當工作環境定義資訊中沒有包含 z/OS 工作量管理程式服務類別資訊時，用來分類這個工作管理程式實例所執行之工作的交易類別名稱。 |
| isDistributable | 指定這個工作管理員是否可配送。 預設值為 false。 |
| isGrowable | 指定這個工作管理員能不能增加執行緒數目。 預設值為 true。 |
| serviceNames | 指定要提供給這個工作管理員的服務清單。 |
| workReqQFullAction | 請指定當執行緒儲存區已用盡且工作要求佇列已滿時，所要採取的動作。 預設值為 0。 |
| workReqQSize | 指定工作要求佇列的大小。 預設值為 0。 |
| workTimeout | 指定在試圖釋放工作單位之前，要等待的毫秒數。 預設值為 0。 |
| 可參照 | 指定封裝 Factory 類別名稱的可參照項，這個 Factory 會將資源環境項目資料轉換成實體資源的類別實例。 |
| otherAttributes清單 | 選擇性地以特定格式指定其他屬性:
|
語法
AdminResources.createWorkManagerAtScope(scope,
workMgrName, JNDIName,
alarmThreads, minThreads, maxThreads, threadPriority,
workManagerProviderID, otherAttributesList)範例用法
下列範例 Script 僅包含必要屬性:
AdminResources.createWorkManagerAtScope("scope", "myWorkManager",
"Work Manager", "Default", 5, 1, 10,
"WorkManagerProvider(cells/MY4Cell01/nodes/MY4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")下列範例 Script 包含字串格式的選用屬性:
AdminResources.createWorkManagerAtScope("Node=MY4Node09, server=server1", "myWorkManager",
"wm/myWorkManager", "5", "1", "10", "5",
"WorkManagerProvider(cells/MY4Cell01/nodes/MY4Node09/servers/server1|resources-pme.xml#WorkManagerProvider_1)")下列範例 Script 包含清單格式的選用屬性:
AdminResources.createWorkManagerAtScope("/Cell:MY4Cell01/ServerCluster:c1/", "myWorkManager",
"wm/myWorkManager", "5", "1", "10", "5",
WorkManagerProvider(cells/MY4Cell01/clusters/c1|resources-pme.xml#WorkManagerProvider_1)",
[['category', 'myCategory'], ['description', 'this is my workmanager'],
['daemonTranClass', ''], ['defTranClass', ''], ['isDistributable', 'false'], ['isGrowable', 'true'],
['serviceNames', 'security'], ['workReqQFullAction', 0],
['workReqQSize', 0], ['workTimeout', 10]])help
這個 Script 會顯示 AdminResources Script 程式庫支援的 Script 程序。 如果要顯示特定 Script 的詳細說明，請指定您屬意之 Script 的名稱，如下表中的定義所示：
| 引數 | 說明 |
|---|---|
| Script | 指定您屬意之 Script 的名稱。 |
語法
AdminResources.help(script)範例用法
AdminResources.help("createWorkManager")