使用 fteCreateTransfer 啟動程式的範例

您可以使用 fteCreateTransfer 指令，指定程式在傳送之前或之後執行。

除了使用 fteCreateTransfer 以外，還有其他方法也可在傳送之前或之後呼叫程式。 如需相關資訊，請參閱 指定要與 MFT一起執行的程式。

所有範例都可使用下列語法來指定程式：
[type:]commandspec[,[retrycount][,[retrywait][,successrc]]]
如需此語法的相關資訊，請參閱 fteCreateTransfer: 啟動新的檔案傳送。

執行可執行程式

下列範例指定稱為 mycommand 的可執行程式，並將 a 及 b 這兩個引數傳遞至程式。

mycommand(a,b)
若要於傳送開始前在來源代理程式 AGENT1 上執行此程式，請使用下列指令：
fteCreateTransfer -sa AGENT1 -da AGENT2 -presrc mycommand(a,b) 
destinationSpecification sourceSpecification

執行及重試可執行程式

下列範例指定未使用任何引數的可執行程式 simple。 retrycount 的指定值是 1，retrywait 的指定值是 5。 這些值表示如果程式未傳回成功回覆碼，則會在等待五秒後重試一次。 successrc 未指定任何值，因此唯一的成功回覆碼是預設值 0。

executable:simple,1,5
若要於傳送完成後在來源代理程式 AGENT1 上執行此程式，請使用下列指令：
fteCreateTransfer -sa AGENT1 -da AGENT2 -postsrc executable:simple,1,5 
destinationSpecification sourceSpecification

執行 Ant Script 並指定成功回覆碼

下列範例指定稱為 myscript 的 Ant Script ，並將兩個內容傳遞至 Script。 請使用 fteAnt 指令來執行此 Script。 successrc 的值指定為 >2&<7&!5|0|14，這指定回覆碼 0、3、4、6 及 14 皆表示作業成功。

antscript:myscript(prop1=fred,prop2=bob),,,>2&<7&!5|0|14
若要於傳送開始前在目的地代理程式 AGENT2 上執行此程式，請使用下列指令：
fteCreateTransfer -sa AGENT1 -da AGENT2 -predst 
"antscript:myscript(prop1=fred,prop2=bob),,,>2&<7&!5|0|14"destinationSpecification sourceSpecification

執行 Ant Script 並指定要呼叫的目標

下列範例指定一個稱為 script2 的 Ant Script ，以及兩個要呼叫的目標 target1 和 target2。 同時也會傳入內容 prop1，其值為 recmfm(F,B)。 此值中的逗點 (,) 及括弧皆以反斜線字元 (\) 跳出。

antscript:script2(target1,target2,prop1=recmfm\(F\,B\)),,,>2&<7&!5|0|14
若要於傳送完成後在目的地代理程式 AGENT2 上執行此程式，請使用下列指令：
fteCreateTransfer -sa AGENT1 -da AGENT2 
-postdst "antscript:script2(target1,target2,prop1=recmfm\(F\,B\)),,,>2&<7&!5|0|14" 
destinationSpecification sourceSpecification

在 Ant Script 中使用 meta 資料

您可以將 Ant 作業指定為傳送的下列任何呼叫:
  • pre source
  • post source
  • predestination
  • post destination
執行 Ant 作業時，會使用環境變數來提供傳送的使用者 meta 資料。 例如，您可以使用下列程式碼來存取此資料：

<property environment="environment" />
<echo>${environment.mymetadata}</echo>
其中 mymetadata 是插入傳送中的某個 meta 資料的名稱。

執行 JCL Script

下列範例指定稱為 ZOSBATCH的 JCL Script。 retrycount 的指定值是 3、retrywait 的指定值是 30，successrc 的指定值是 0。 這些值表示如果 Script 未傳回成功回覆碼 0，則會重試三次，每次嘗試之間會等待 30 秒。

jcl:ZOSBATCH,3,30,0
其中，ZOSBATCH 為呼叫 MYSYS.JCL 的 PDS 成員，agent.properties 檔包含 commandPath=....://'MYSYS.JCL':... 行
若要於傳送完成後在來源代理程式 AGENT1 上執行此程式，請使用下列指令：

fteCreateTransfer -sa AGENT1 -da AGENT2 -postsrc jcl:ZOSBATCH,3,30,0 
destinationSpecification sourceSpecification