fteDelete範本 (刪除 MFT 範本)

使用 fteDeleteTemplates 指令,從協調佇列管理程式中刪除現有的 Managed File Transfer 範本。

用途

fteDeleteTemplates 指令用於從協調佇列管理程式移除一個以上檔案傳送範本。 當您執行此指令時,會將要求傳遞至 IBM® MQ 系統,以從協調佇列管理程式移除範本,讓範本不再可供「 IBM MQ 探險家」或指令行使用。 在指令完成之後的一小段時間內,可能會繼續存取您要刪除的範本,直到 IBM MQ 系統處理要求為止。

您可以從可以連接至 IBM MQ 網路的任何系統執行 fteDeleteTemplates 指令,然後遞送至協調佇列管理程式。 具體而言,對於要執行的指令,您必須已在此系統上安裝 Managed File Transfer ,且必須已配置此系統的 Managed File Transfer 以與 IBM MQ 網路通訊。 如果沒有可用的連線功能詳細資料,則只要有可用的代理程式佇列管理程式詳細資料,即會改用這些詳細資料進行連線。

僅在要使用一組不同於您的預設集的配置選項時,才為此指令指定選用的 -p 參數。 如需相關資訊,請參閱 配置選項

Syntax

fteDeleteTemplates

Read syntax diagramSkip visual syntax diagramfteDeleteTemplates-pconfiguration_options-mquseriduser_id-nolpw-mqpasswordpassword-nolpwtemplate_names

參數

-p configuration_options
選用項目。 此參數決定一組用來刪除範本的配置選項。 依照慣例,會使用非預設協調佇列管理程式的名稱作為此參數的輸入。 然後,指令即會使用與此非預設協調佇列管理程式相關聯的一組內容檔。
如果未指定此參數,則會使用一組以預設協調佇列管理程式為基礎的配置選項。
-mquserid user_id
選用項目。 指定用來向協調佇列管理程式進行鑑別的使用者 ID。
-mqpassword password
選用項目。 指定用來向協調佇列管理程式進行鑑別的密碼。
當指定 -mqpassword 參數時,您也必須指定 -mquserid 參數。 如果您指定 -mquserid,但未指定 -mqpassword,則系統會提示您提供相關聯的密碼,不會顯示此密碼。

[MQ 9.3.0 Jun 2022][MQ 9.3.0 Jun 2022]IBM MQ 9.3 開始,指令預設為使用 MQCSP 鑑別,並將要鑑別的使用者 ID 和密碼傳送至 MQCSP 結構中的佇列管理程式。

[MQ 9.3.0 Jun 2022][MQ 9.3.0 Jun 2022]-nolpw
選用項目。 如果指令所連接的佇列管理程式不支援超過 12 個字元的密碼,請指定此參數。
當指定 -nolpw 參數時,您也必須指定 -mquserid 參數。 如果您指定 -mquserid-nolpw,但未指定 -mqpassword,則系統會提示您提供相關聯的密碼,不會顯示該密碼。
附註: 如果您指定 -nolpw 選項,且密碼長度超過 12 個字元,則指令會失敗,並顯示錯誤訊息 BFGCL0829E
template_names
必要項目。 指定要刪除的一個以上範本名稱。 根據 fteListTemplates 指令的顯示結果指定名稱。
-? 或 -h
選用項目。 顯示指令語法。

範例

在此範例中,會刪除範本 STANDBY:

fteDeleteTemplates STANDBY

回覆碼

0
指令已順利完成。
1
指令未順利結束。