fteCreate範本 (建立新的檔案傳送範本)

用途

您使用 fteCreateTemplate 指令建立的傳送範本與您在 fteCreateTransfer 指令上使用 -gt 參數建立的 XML 訊息不同。 您不能交替地使用兩種不同類型的範本。

您可以從可以連接至 IBM MQ 網路的任何系統執行 fteCreateTemplate 指令，然後遞送至協調佇列管理程式。 具體而言，對於要執行的指令，您必須已在此系統上安裝 Managed File Transfer ，且必須已在此系統上配置 Managed File Transfer 元件，以與 IBM MQ 網路通訊。

從 IBM MQ 9.3.0，此指令會使用 coordination.properties 檔案來連接至 Managed File Transfer 拓蹼的協調佇列管理程式。 如果 coordination.properties 檔案包含 coordinationQMgrHost 內容，則指令會使用 CLIENT 傳輸連接至協調佇列管理程式。 否則，該指令會使用 BINDINGS 傳輸來連接至協調佇列管理程式。 如需相關資訊，請參閱 MFT corodination.properties 檔案。

您可以為檔案傳送指定多個來源檔案，但只能指定一個目的地代理程式；不支援將一個檔案傳送至多個目的地代理程式。 但是，您可以在單一目的地代理程式上，將多個來源檔案傳送至多個目的地檔案。

如需如何傳送檔案的指引，請參閱 傳送檔案的準則。

特殊字元

請謹慎使用包含特殊字元的參數，避免指令 Shell 以超乎預期的方式來解譯字元。 例如，包含單引號的完整資料集名稱及包含星號字元的來源規格可能會由指令 Shell 解譯，而不是在傳送要求中傳遞。若要避免指令 Shell 解譯字元，請將整個參數含括在雙引號中，如最後兩個範例 範例所示， 或使用指令 Shell 的 ESC 序列來跳出特殊字元。

相對路徑

fteCreateTemplate 指令支援使用相對檔案路徑。 在分散式系統上， 及 z/OS® UNIX® System Services 預設會將路徑視為相對於執行代理程式之使用者的起始目錄。 若要變更路徑名稱相對的目錄，請在 agent.properties 檔案中設定 transferRoot 內容。 此檔案位於 MQ_DATA_PATH/mqft/config/coordination_qmgr/agents/agent_name 目錄中。 將下面這一行加到檔案中：

transferRoot=directory_name

您必須跳出 Windows 路徑，或以 UNIX 格式寫入這些路徑。 例如，將 C:\TransferRoot 指定為 C:\\TransferRoot 或 C:/TransferRoot。

在 z/OS上，依預設，代理程式目前執行所在的使用者名稱會作為高階限定元字首新增至尚未完整定義的資料集規格。 例如：//ABC.DEF。 若要變更加在資料集名稱上作為字首的值，請在 agent.properties 檔案中設定 transferRootHLQ 內容。 此檔案位於 MQ_DATA_PATH/mqft/config/coordination_qmgr/agents/agent_name 目錄中。 將下面這一行加到檔案中：

transferRootHLQ=prepend_value

不過，對於涉及 z/OS 系統上 Connect:Direct® 節點的傳送，資料集規格會解譯為完整名稱。 資料集名稱不會加上高階限定元。

參數

-sa source_agent_name

選用項目。 從中傳送來源檔案的代理程式名稱。 如果您在建立範本時不指定此代理程式名稱，則必須在使用範本時指定來源代理程式名稱。

-sm 來源代理程式佇列管理程式名稱

選用項目。 來源代理程式所連接的佇列管理程式的名稱。

如果未指定 -sm 參數，則根據來源代理程式名稱，由使用中的配置選項集來決定使用的佇列管理程式。 如果使用這些選項無法決定佇列管理程式名稱，傳送範本建立會失敗。 例如，如果找不到來源代理程式的 agent.properties 檔案，則範本建立會失敗。

-da destination_agent_name

選用項目。 檔案傳送至其中的代理程式名稱。 如果您在建立範本時不指定目的地代理程式名稱，則必須在使用範本時指定目的地代理程式名稱。

-dm destination_agent_qmgr_name

選用項目。 目的地代理程式所連接的佇列管理程式名稱。

如果未指定 -dm 參數，則根據目的地代理程式名稱，由使用中的配置選項集來決定使用的佇列管理程式。 如果使用這些選項無法決定佇列管理程式名稱，傳送範本建立會失敗。 例如，如果找不到目的地代理程式的 agent.properties 檔案，則範本建立會失敗。

-td transfer_definition_file

選用項目。 XML 文件的名稱，定義傳送的一個以上來源及目的地檔案規格。

需要 -td、-df、-dd、-ds、-dq、-du 及 -dp 參數之一。 如果您指定 -td 參數，則無法指定來源檔案，或者無法指定 -df、-dd、-ds、-dp、-dq、-du、-sd、-r、-de、-t 或 -cs 參數。

fteCreateTemplate 指令可尋找與您的現行目錄相關的傳送定義檔。 如果您無法使用相對路徑表示法來指定傳送定義檔的位置，請改用傳送定義檔的完整路徑及檔名。

或者，此參數可以是包含受管理傳送要求的 XML 文件名稱。 使用 fteCreateTransfer 指令的 -gt 參數建立 XML 作業定義。

在 z/OS上，您必須將傳送定義檔儲存在 z/OS UNIX System Services上的 UNIX 檔案中。 您不能將傳送定義檔儲存在 z/OS 循序檔或 PDS 成員中。

在 IBM i上，您必須將傳送定義檔儲存在整合檔案系統中。

如需相關資訊，請參閱 使用傳送定義檔。

-df destination_file

選用項目。 目的地檔案的名稱。 指定目的地代理程式執行所在的系統上有效的檔名。

如果目的地代理程式是 Connect:Direct 橋接器代理程式，則會以 connect_direct_node_name:file_path格式指定目的地檔案。 Connect:Direct 橋接器代理程式只接受以此格式指定的檔案路徑。 如果目的地代理程式是 Connect:Direct 橋接器代理程式，且目的地是 PDS 成員，則您還必須指定 -de 參數，值為 overwrite。

需要 -td、-df、-dd、-ds、-dq、-du 及 -dp 參數之一。 如果您指定 -df 參數，則無法指定 -td、-dd、-dp、-dq、-du 或 -ds 參數，因為這些參數是互斥的。

-dd destination_directory

選用項目。 傳送檔案的目的地目錄名稱。 指定目的地代理程式執行所在的系統上有效的目錄名稱。

如果目的地代理程式是 Connect:Direct 橋接器代理程式，則會以 connect_direct_node_name:directory_path格式指定目的地目錄。 如果目的地代理程式是 Connect:Direct 橋接器代理程式，且目的地是 PDS ，則您必須同時指定 -de 參數，值為 overwrite。

需要 -td、-df、-dd、-ds、-dq、-du 及 -dp 參數之一。 如果您指定 -dd 參數，則無法指定 -td、-df、-dp、-dq、-du 或 -ds 參數，因為這些參數是互斥的。

-ds destination_sequential_data_set

只適用於 z/OS。 選用項目。 檔案傳送至其中的循序資料集名稱或 PDS 成員。 指定循序資料集名稱或分割的資料集成員。

需要 -td、-df、-dd、-ds、-dq、-du 及 -dp 參數之一。 如果您指定 -ds 參數，則無法指定 -td、-dd、-df、-dq、-du 或 -dp 參數，因為這些參數是互斥的。

資料集名稱的語法如下所示：

 //data_set_name{;attribute;..;attribute} 

or

 //pds_data_set_name(member_name){;attribute;..;attribute}

亦即，字首為 // 的資料集名稱指定元，選擇性地後接許多屬性（以分號區隔）。

如果資料集位於 Connect:Direct 節點，您必須以節點名稱作為資料集名稱的字首。 例如：

CD_NODE1://'OBJECT.LIB';RECFM(F,B);BLKSIZE(800);LRECL(80)

如果目的地代理程式是 Connect:Direct 橋接器代理程式，且目的地是 PDS 成員，則您也必須指定 -de 參數，值為 overwrite。 如需往返於 Connect:Direct 節點的資料集傳送的相關資訊，請參閱 往返於 Connect:Direct 節點傳送資料集。

對於僅涉及 Managed File Transfer 代理程式的傳送，如果資料集名稱部分以單引號字元括住，則它會指定完整資料集名稱。 如果未以單引號字元括住資料集名稱，系統會加上目的地代理程式的預設高階限定元（transferRootHLQ 代理程式內容的值，或者，如果未設定 transferRootHLQ，則是執行代理程式的使用者 ID）。

附註: 不過，對於涉及 z/OS 系統上 Connect:Direct 節點的傳送，資料集規格會解譯為完整名稱。 資料集名稱不會加上高階限定元。 即使資料集名稱以單引號字元括住，也是如此。

資料集屬性用於建立資料集，或確保現有的資料集是相容的。 資料集屬性的規格採用適合 BPXWDYN 的格式 (如需相關資訊，請參閱 要求動態配置 )。 當代理程式要建立目的地資料集時，會自動指定下列 BPXWDYN 屬性 :DSN (data_set_name) NEW CATALOG MSG (numeric_file_descriptor) ，其中 numeric_file_descriptor 是 Managed File Transfer所產生的檔案描述子。 對於資料集至資料集傳送，則為新目的地資料集從來源選取 RECFM、LRECL 及 BLKSIZE 的屬性。 請注意，新目的地資料集的 SPACE 設定不是由 Managed File Transfer 設定，而是使用系統預設值。 因此，建立新的資料集時，建議您指定 SPACE 屬性。 您可以使用 agent.properties 檔案中的 bpxwdynAllocAdditionalProperties 內容，來設定套用至所有傳送的 BPXWDYN 選項。 如需相關資訊，請參閱 MFT agent.properties 檔案。

使用 fteCreateTemplate 指令、 fteCreateTransfer 指令或 agent.properties 檔案中的 bpxwdynAllocAdditionalOptions 內容時，不得指定部分 BPXWDYN 選項。 如需這些內容的清單，請參閱 不得與 MFT 搭配使用的 BPXWDYN 內容。

當您將檔案或資料集傳送至磁帶時，任何已在磁帶上的現有資料集都會被取代。 新資料集的屬性將根據傳送定義中所傳遞的屬性進行設定。 如果您沒有指定任何屬性，會將屬性設定為與來源資料集相同，或者，在來源為檔案時設定為預設值。 現有磁帶資料集的屬性會被忽略。

當目的地代理程式是通訊協定橋接器代理程式時，不支援 -ds 參數。

-dp destination_partitioned_data_set

只適用於 z/OS。 選用項目。 檔案傳送至其中的目的地 PDS 名稱。 指定分割的資料集名稱。 如果因為傳送而建立 PDS，此 PDS 依預設會建立為 PDSE。 您可以指定 DSNTYPE=PDS 來置換預設值。

需要 -td、-df、-dd、-ds、-dq、-du 及 -dp 參數之一。 如果您指定 -dp 參數，則無法指定 -td、-dd、-df、-dq、-du 或 -ds 參數，因為這些參數是互斥的。

PDS 資料集名稱的語法如下所示：

//pds_data_set_name{;attribute;..;attribute}

資料集名稱的語法與 -ds destination_sequential_data_set 參數的說明相同。 用於指定位於 Connect:Direct 節點上的資料集的所有語法詳細資料也適用於 -dp 參數。 如果目的地代理程式是 Connect:Direct 橋接器代理程式，則還必須指定 -de 參數，值為 overwrite。

當目的地代理程式是通訊協定橋接器代理程式時，不支援 -dp 參數。

-du destination_user

選用項目。 使用者的名稱，檔案將傳送至該使用者的目的地檔案空間。

需要 -td、-df、-dd、-ds、-dp、-du 及 -dq 參數之一。 如果您指定 -du 參數，則無法指定 -td、-dd、-df、-dp、-dq 或 -ds 參數，因為這些參數是互斥的。

當目的地代理程式是通訊協定橋接器代理程式或 Connect:Direct 橋接器代理程式時，不支援 -du 參數。

-dq destination_queue

選用項目。 檔案傳送至其中的目的地佇列名稱。 您可以選擇性地使用 QUEUE@QUEUEMANAGER 格式，在此規格中包含佇列管理程式名稱。 如果未指定佇列管理程式名稱，而且未將 enableClusterQueueInputOutput 代理程式內容設定為 true，則會使用目的地代理程式佇列管理程式名稱。 如果您已將 enableClusterQueueInput輸出代理程式內容設為 true ，則目的地代理程式會使用標準 IBM MQ 解析程序來判定佇列所在的位置。 您必須指定佇列管理程式上存在的有效佇列名稱。

需要 -td、-df、-dd、-ds、-dp、-du 及 -dq 參數之一。 如果您指定 -dq 參數，則無法指定 -td、-dd、-df、-dp、-du 或 -ds 參數，因為這些參數是互斥的。

當目的地代理程式是通訊協定橋接器代理程式或 Connect:Direct 橋接器代理程式時，或當來源規格是佇列時，不支援 -dq 參數。

-dqp persistent

選用項目。 指定寫入目的地佇列的訊息是否持續保存。 有效選項如下所示：

true

將持續性訊息寫入目的地佇列。 這是預設值。

false

將非持續性訊息寫入目的地佇列。

qdef

持續性值取自目的地佇列的 DefPersistence 屬性。

如果您還指定了 -dq 參數，則只能指定 -dqp 參數。

-qmp 布林

選用項目。 指定由傳送寫入目的地佇列的第一則訊息是否已設定 IBM MQ 訊息內容。 有效選項如下所示：

true

在傳送所建立的第一個訊息上設定訊息內容。

false

不在由傳送建立的第一則訊息上設定訊息內容。 這是預設值。

如果您還指定了 -dq 參數，則只能指定 -qmp 參數。 如需相關資訊，請參閱 MFT 在寫入目的地佇列的訊息上設定的MQ 訊息內容

-qs message_size

選用項目。 指定是否要將檔案分割為多則固定長度的訊息。 所有訊息都具有相同的 IBM MQ 群組 ID; 群組中的最後一則訊息已設定 IBM MQ LAST_MSG_IN_GROUP 旗標。 訊息的大小由 message_size 的值指定。 message_size 的格式為 lengthunits，其中 length 為正整數值，units 為下列其中一個值：

B

位元組。 容許的最小值為目的地訊息字碼頁的每個字元佔用的位元組數最大值的兩倍。

K

這相等於 1024 個位元組。

M

這相等於 1048576 個位元組。

如果您指定值 text 給 -t 參數，且檔案是雙位元組字集或多位元組字集，則會將檔案分割成與指定訊息大小最接近字元界限的訊息。

如果您還指定了 -dq 參數，則只能指定 -qs 參數。 您只能指定 -qs、-dqdb 及 -dqdt 參數之一。

-dqdb 十六進位定界字元

選用項目。 指定將一個二進位檔分割為多則訊息時要使用的十六進位定界字元。 所有訊息都具有相同的 IBM MQ 群組 ID; 群組中的最後一則訊息已設定 IBM MQ LAST_MSG_IN_GROUP 旗標。 指定十六進位位元組作為定界字元的格式是 xNN，其中 N 是範圍介於 0-9 或 a-f 間的字元。 透過指定以逗點區隔的十六進位位元組清單（例如：x3e,x20,x20,xbf），您可以將十六進位位元組的序列指定為定界字元。

如果您還指定了 -dq 參數，且傳送採用二進位模式，則只能指定 -dqdb 參數。 您只能指定 -qs、-dqdb 及 -dqdt 參數之一。

-dqdt 型樣

選用項目。 指定將一個文字檔分割為多則訊息時要使用的正規表示式。 所有訊息都具有相同的 IBM MQ 群組 ID; 群組中的最後一則訊息已設定 IBM MQ LAST_MSG_IN_GROUP 旗標。 將正規表示式指定為定界字元所採用的格式為：以括弧括住正規表示式（(regular_expression)）。 此參數的值會評估為 Java 正規表示式。 如需相關資訊，請參閱 MFT 使用的正規表示式。

依預設，目的地代理程式限制正規表示式可以比對的字串長度為五個字元。 您可以使用 maxDelimiterMatchLength 代理程式內容變更此行為。 如需相關資訊，請參閱 進階代理程式內容。

如果您還指定了 -dq 參數，及為 -t 參數指定值 text，則只能指定 -dqdt 參數。 您只能指定 -qs、-dqdb 及 -dqdt 參數的其中一個。

-dqdp

選用項目。 指定分割檔案時預期的目的地文字及二進位定界字元的位置。 如果您還指定了 -dqdt 及 -dqdb 參數之一，則只能指定 -dqdp 參數。

請指定下列其中一個選項：

prefix

定界字元應該在每一行開頭。

postfix

定界字元應該在每一行結尾。 這是預設選項。

-qi

選用項目。 指定是否要在訊息中包含將檔案分割為多則訊息所使用的定界字元。 如果已指定 -qi 屬性，則會在訊息（包含定界字元之前的檔案資料）的結尾包含定界字元。 依預設，訊息不包括定界字元。

如果您還指定了 -dqdt 及 -dqdb 參數之一，則只能指定 -qi 參數。

-de destination_file_behavior

選用項目。 指定如果目的地系統上存在目的地檔案時要採取的動作。 有效選項如下所示：

error

報告錯誤，且不傳送檔案。 這是預設值。

overwrite

改寫現有目的地檔案。

如果您指定 -de 參數，則不能指定 -td 參數，因為這些參數是互斥的。

-sd source_file_disposition

選用項目。 指定來源檔案已順利地傳送至其目的地時，對來源檔案採取的動作。 有效選項如下所示：

leave

來源檔案維持不變。 這是預設值。

delete

在順利傳送來源檔案之後，從來源系統刪除來源檔案。

在 z/OS上，如果來源是磁帶資料集，且您指定 delete 選項，則會重新裝載磁帶以刪除資料集。 此行為是因為系統環境行為而造成。

如果來源是佇列，且您指定 leave 選項，則指令會傳回錯誤，不會要求傳送。

如果來源代理程式是 Connect:Direct 橋接器代理程式，且您指定 delete 選項，則行為不同於一般來源處置行為。 發生下列其中一種情況：

• 如果 Connect:Direct 使用 Managed File Transfer 所產生的處理程序從來源移動檔案或資料集，則指定 delete 選項會導致傳送失敗。 若要指定刪除來源檔案，您必須提交使用者定義的 Connect:Direct 處理程序。 如需相關資訊，請參閱 從檔案傳送要求提交使用者定義的 Connect:Direct 程序。
• 如果 Connect:Direct 使用使用者定義的處理程序從來源移動檔案或資料集，則此參數會透過 %FTEFDISP 本質符號變數傳遞至處理程序。 使用者定義的程序決定是否刪除來源。 傳送所傳回的結果，取決於使用者定義的程序所傳回的結果。

如果您指定 -sd 參數，則不能指定 -td 參數，因為這些參數是互斥的。 但是，您可以在傳送定義檔中指定來源處置行為。

-pr 傳送優先順序

選用項目。 指定傳送的優先順序層次。 優先順序是範圍 0-9 中的值，其中 0 是最低優先順序。 預設優先順序層次是 0，依預設，傳送時會使用來源代理程式的優先順序層次。

此值符合 IBM MQ所使用的訊息優先順序值，如需相關資訊，請參閱 從佇列取得訊息: 優先順序 。 檔案傳送資料的訊息資料流量預設為優先順序層次 0 ，這可讓 IBM MQ 訊息資料流量取得優先順序。

-rt 傳送回復逾時

選用項目。 設定時間量（以秒為單位），在此期間內，來源代理程式會一直嘗試回復已停止的檔案傳送。 請指定下列其中一個選項：

-1

代理程式繼續嘗試回復已停止的傳送，直至傳送完成為止。 使用此選項相當於代理程式在未設定此內容時的預設行為。

0

一旦進入回復，代理程式即停止檔案傳送。

>0

代理程式繼續嘗試回復已停止的傳送，直至達到已指定的正整數值所設定的時間量（以秒為單位）為止。 例如，

-rt 21600

指出代理程式從進入回復的 6 小時內會一直嘗試回復傳送。 此參數的最大值為 999999999。

透過這種方式指定傳送回復逾時值是以每個傳送為基礎來進行設定。 若要設定 Managed File Transfer 網路中所有傳送的廣域值，您可以將 transferRecoveryTimeout 內容新增至 agent.properties 檔案。

-p configuration_options

選用項目。 此參數會決定用於建立傳送範本的配置選項集。 請使用非預設協調佇列管理程式的名稱作為此參數的輸入。 然後，指令即會使用與此非預設協調佇列管理程式相關聯的一組內容檔。

如果未指定此參數，則會使用一組以預設協調佇列管理程式為基礎的配置選項。

-r

選用項目。 當 source_specification 包含萬用字元時，遞迴地傳送子目錄中的檔案。 當 Managed File Transfer 以萬用字元作為 source_specification時，只有在您指定 -r 參數時，才會傳送任何符合萬用字元的目錄。 在 source_specification 與子目錄相符時，該目錄及其子目錄中的所有檔案（包括隱藏式檔案）都一律會傳送。

如需 Managed File Transfer 如何處理萬用字元的相關資訊，請參閱 搭配使用萬用字元與 MFT

如果您指定 -r 參數，則不能指定 -td 參數，因為這些參數是互斥的。 不過，您可以在傳送定義檔中指定遞迴行為。

-t

選用項目。 指定檔案傳送的類型：二進位模式或文字模式。

二進位

傳送檔案中的資料時不經過任何轉換。 這是預設值。

text

轉換檔案的字碼頁及行尾字元。 執行的確切轉換視來源代理程式及目的地代理程式的作業系統而定。

例如，從 Windows 傳送至 z/OS 的檔案會將其字碼頁從 ASCII 轉換為 EBCDIC。 檔案從 ASCII 轉換為 EBCDIC 時，行尾字元會從 ASCII 歸位 (CR) 及換行 (LF) 字元配對轉換為 EBCDIC 新行 (NL) 字元。

如需如何傳送 z/OS 資料集的相關資訊，請參閱 在 z/OS 與分散式系統之間傳送檔案及資料集 ，以及 在 z/OS上的資料集之間傳送。

如果您指定 -t 參數，則不能指定 -td 參數，因為這些參數是互斥的。 但是，您可以在傳送定義檔中指定傳送模式行為。

-cs

選用項目。 指定是否對檔案傳送資料執行總和檢查演算法，以檢查所傳送檔案的完整性。 請指定下列其中一個選項：

MD5

計算資料的 MD5 總和檢查。 來源及目的地檔案的總和檢查結果會寫入傳送日誌中作為驗證用途。 依預設， Managed File Transfer 會計算所有檔案傳送的 MD5 總和檢查。

無

不計算檔案傳送資料的 MD5 總和檢查。 傳送日誌會記錄總和檢查設為 none，總和檢查的值為空白。 例如：

<checksum method="none"></checksum>

如果使用 none 選項，視環境而定，可能會改善檔案傳送效能。 不過，選取此選項表示不驗證來源或目的地檔案。

如果您指定 -cs 參數，則不能指定 -td 參數，因為這些參數是互斥的。 但是，您可以在傳送定義檔中指定總和檢查行為。

-tr

選用項目。 指定要進行檔案傳送時必須成立的條件。 如果條件不是 true，根據來源代理程式，檔案傳送會被捨棄，無法進行傳送。 請指定下列格式：

condition,namelist

其中 condition 是下列其中一個值：

file=exist

名稱清單中至少一個檔案存在。 亦即，如果名稱清單中的任何檔案存在，則條件成立。

file!=exist

namelist 中至少其中一個檔案不存在。 亦即，如果名稱清單中的任何檔案不存在，則條件成立。

檔案大小> =size

namelist 中至少其中一個檔案存在，且以 size 指定大小下限。 size 的值是整數，選用大小單位為 KB、MB 或 GB。 例如，filesize">"=10KB。 如果未指定大小單位，則假設以位元組為大小單位。 在所有作業系統上，當您在指令行指定 filesize 選項時，必須以雙引號括住大於符號 (>)，如這個範例所示。

其中，namelist 是位於來源系統上的檔案名稱清單（以逗點區隔）。 視作業系統而定，如果您想要在名稱清單中使用包含空格的路徑名稱或檔案名稱，可能必須以雙引號括住路徑名稱和檔案名稱。 多次使用 -tr 參數可以指定多個觸發條件。 不過，在此情況下，每一個觸發條件都必須成立，才會進行檔案傳送。

附註: 若要持續監視資源以將觸發條件設為 true ，建議您使用 資源監視。 您可以使用 fteCreateMonitor 指令來建立資源監視器。

在下列範例中，file1.doc 檔從 AGENT1 傳送至 AGENT2，條件為 A.txt 檔、B.txt 檔或兩個檔案都存在於 AGENT1，且 A.txt 檔、B.txt 檔或兩個檔案都等於或大於 1GB：

fteCreateTemplate -tn JUPITER_AGENT_TRIGGER_TEST_TEMPLATE -sa AGENT1 -sm QM_JUPITER -da AGENT2 -dm QM_NEPTUNE
-tr file=exist,C:\export\A.txt,C:\export\B.txt
-tr filesize">"=1GB,C:\export\A.txt,C:\export\B.txt
-df C:\import\file1.doc C:\export\file1.doc 

您可以將觸發參數與排程參數相結合。 如果指定這兩種參數，觸發條件會套用至排程參數所建立的檔案傳送。

-tl

選用項目。 指定是否記載觸發程式失敗。 請指定下列其中一個選項：

yes

為失敗的觸發傳送建立日誌項目。 即使未指定 -tl 參數，這也是預設行為。

否

不為失敗的觸發傳送建立日誌項目。

-md

選用項目。 指定傳遞至代理程式的結束點的使用者定義的 meta 資料。 -md 參數可以採用一個以上名稱/值配對（以逗點區隔）。 每一個名稱配對由 name=value 組成。 您可以在指令中多次使用 -md 參數。

在 z/OS上，空格代表定界字元，因此您必須使用底線來區隔值。 例如，使用 kw=text1_text2_text3 取代 kw="text1 text2 text3"

-tb

選用項目。 指定您要用於排定檔案傳送的時間基準。 亦即，使用系統時間或世界標準時間 (UTC)。 您僅必須將此參數與 -ss 參數搭配使用。 請指定下列其中一個選項：

admin

用於排定的傳送的開始及結束時間基於管理者使用的系統時間及日期。 這是預設值。

source

用於排定的傳送的開始及結束時間基於來源代理程式所在系統的時間及日期。

UTC

用於排定的傳送的開始及結束時間基於「世界標準時間 (UTC)」。

-jn job_name

選用項目。 在啟動傳送時新增至日誌訊息的使用者定義的工作名稱 ID。

-ss schedule_start_time

選用項目。 指定要執行排定傳送的時間和日期。 使用下列其中一種格式來指定時間和日期。 使用 24 小時制指定時間：

yyyy-MM-ddThh:mm

hh:mm

如果沒有可能會影響傳送的問題，排定的檔案傳送會在排程開始時間的一分鐘內啟動。 例如，網路或代理程式可能發生問題，造成排定的傳送無法開始。

-oi

選用項目。 指定排定的傳送發生的間隔。 您僅必須將此參數與 -ss 參數搭配使用。 請指定下列其中一個選項：

分鐘

小時

日

週

月

年

-of occurrence_frequency

選用項目。 指定排定的傳送發生的頻率。 例如，每隔 5 週或每隔 2 個月。 此參數只能搭配 -oi 及 -ss 參數一起指定。 如果未指定此參數，則會使用預設值 1。

-oc occurrence_count

選用項目。 指定您想要此排定傳送發生的次數。 在符合發生次數之後，排定的傳送會刪除。

此參數只能搭配 -oi 及 -ss 參數一起指定。

如果您指定 -oc 參數，則不能指定 -es 參數，因為這些參數是互斥的。

您可以同時省略 -oc 及 -es 參數，以建立無限期重複的傳送。

-es schedule_end_time

選用項目。 重複的排定傳送結束的時間及日期。

此參數只能搭配 -oi 及 -ss 參數一起指定。

如果您指定 -es 參數，則不能指定 -oc 參數，因為這些參數是互斥的。

您可以同時省略 -es 及 -oc 參數，以建立無限期重複的傳送。

請使用下列其中一種格式來指定結束時間及日期。 使用 24 小時制指定時間：

yyyy-MM-ddThh:mm

hh:mm

-tn template_name

必要項目。 要建立的範本的名稱。 使用敘述性字串，以讓您稍後選取用於傳送的正確範本。 對此字串的長度沒有特定限制，但請注意，過長的名稱可能無法正確顯示在部分使用者介面中。

請勿建立多個具有相同名稱的範本。

-sqgi

選用項目。 指定訊息依 IBM MQ 群組 ID 分組。 第一個完整群組會寫入目的地檔案。 如果未指定此參數，則來源佇列上的所有訊息會寫入目的地檔案。

如果您還指定了 -sq 參數，則只能指定 -sqgi 參數。

-sqdt 文字定界字元

選用項目。 指定在將多則訊息附加到文字檔時，要作為定界字元插入的文字序列。 您可以在定界字元中針對字串文字包含 Java ESC 序列。 例如，-sqdt \u007d\n。

如果您還指定了 -sq 參數，及為 -t 參數指定值 text，則只能指定 -sqdt 參數。

-sqdb 十六進位定界字元

選用項目。 指定在將多則訊息附加到二進位檔時，要作為定界字元插入的一個以上位元組值。 每一個值必須指定為兩個十六進位數字，範圍為 00-FF，字首為 x。 若有多個位元組，必須以逗點區隔。 例如，-sqdb x08,xA4。

如果您還指定了 -sq 參數，則只能指定 -sqdb 參數。 如果您還為 -t 參數指定值 text，則只能指定 -sqdb 參數。

-sqdp

選用項目。 指定來源文字及二進位定界字元的插入項目的位置。 如果您還指定了 -sqdt 及 -sqdb 參數之一，則只能指定 -sqdp 參數。

請指定下列其中一個選項：

prefix

在每一個訊息的開頭插入定界字元。

postfix

在每一個訊息的結尾插入定界字元。 這是預設選項。

-sqwt wait_time

選用項目。 指定等待下列其中一個條件成立的時間（以秒為單位）：

• 使新訊息放在佇列上
• 如果已指定 -sqgi 參數，則條件為完整群組放在佇列上。

在 wait_time 指定的時間內，如果這兩個條件都不成立，來源代理程式會停止讀取佇列，並完成傳送。 如果未指定 -sqwt 參數，則在以下情況下來源代理程式會立即停止從來源佇列進行讀取：來源佇列為空白或者已指定 -sqgi 參數，佇列上沒有完整群組。

如果您還指定了 -sq 參數，則只能指定 -sqwt 參數。

-sq

選用項目。 指定傳送的來源是佇列。

-mquserid user_id

選用項目。 指定用來向協調佇列管理程式進行鑑別的使用者 ID。

-mqpassword password

選用項目。 指定用來向協調佇列管理程式進行鑑別的密碼。

當指定 -mqpassword 參數時，您也必須指定 -mquserid 參數。 如果您指定 -mquserid，但未指定 -mqpassword，則系統會提示您提供相關聯的密碼，不會顯示此密碼。

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

-nolpw

選用項目。 如果指令所連接的佇列管理程式不支援超過 12 個字元的密碼，請指定此參數。

當指定 -nolpw 參數時，您也必須指定 -mquserid 參數。 如果您指定 -mquserid 及 -nolpw，但未指定 -mqpassword，則系統會提示您提供相關聯的密碼，不會顯示該密碼。

附註: 如果您指定 -nolpw 選項，且密碼長度超過 12 個字元，則指令會失敗，並顯示錯誤訊息 BFGCL0829E。

source_specification

如果您已指定 -df、-dd、-dp、-dp 或 -ds 參數，則為必要項目。 如果指定 -td 參數，請不要指定 source_specification。

• 如果未指定 -sq 參數，則 source_specification 是一個以上檔案規格，決定檔案傳送的一個以上來源。 檔案規格以空格區隔。 檔案規格可接受五種格式，也可包括萬用字元。 如需 WMQFTE 中萬用字元的相關資訊，請參閱 將萬用字元與 MFT 搭配使用。 您可以在檔案規格中使用兩個星號字元 (**)，以跳出檔案規格中的星號。
  若要傳送其檔名包含空格的檔案，請以雙引號括住包含空格的檔名。 例如，若要將檔案 a b.txt 傳送至檔案 c d.txt ，請指定下列文字作為 fteCreateTemplate 指令的一部分:

  
  -df "c d.txt" "a b.txt"

  每一個檔案規格必須採用下列其中一種格式：

  檔案名稱

  檔案的名稱，使用來源代理程式執行所在系統的適當表示法表示。 在檔名指定為來源檔案規格時，會複製檔案的內容。

  目錄

  目錄的名稱，使用來源代理程式執行所在系統的適當表示法表示。 在目錄指定為來源檔案規格時，會複製目錄的內容。 更準確地說，會複製目錄中及其所有子目錄中的所有檔案，包括隱藏式檔案。

  例如，若要僅將 DIR1 的內容複製到 DIR2 ，請指定 DIR1/* DIR2

  循序資料集

  （僅限 z/OS）。 循序資料集的名稱或分割的資料集成員。 在資料集名稱之前加上兩個正斜線字元 (//) 來表示資料集。

  分割的資料集

  （僅限 z/OS）。 分割資料集的名稱。 在資料集名稱之前加上兩個正斜線字元 (//) 來表示資料集名稱。

  Connect:Direct 節點上的檔名或目錄

  (僅限Connect:Direct 橋接器代理程式)。 Connect:Direct 節點的名稱、冒號字元 (:) ，以及管理 Connect:Direct 節點之系統上的檔案或目錄路徑。 例如，connect_direct_node_name:file_path。

  如果來源代理程式是 Connect:Direct 橋接器代理程式，則只會接受此形式的來源規格。

  附註: 當來源代理程式是 Connect:Direct 橋接器代理程式時，檔案路徑中不支援萬用字元。

• 如果已指定 -sq 參數，則 source_specification 是來源代理程式佇列管理程式上的本端佇列名稱。 您只能指定一個來源佇列。 以下列格式指定來源佇列：

  
  QUEUE_NAME

  來源佇列規格中不包括佇列管理程式名稱，因為佇列管理程式與來源代理程式佇列管理程式必須相同。

-? 或 -h

選用項目。 顯示指令語法。

回覆碼