FP_FTP_TRANSFER_CONTROL

単一のEthernetユニットへのFTP転送の制御

このFP命令は、nTransferID (0～15)で指定された1台のEthernetユニットのFTP転送を制御します。有効な制御ワードは'ENABLE'、'DISABLE'、および'CANCEL'です。

パラメータ

入力

nTransferID (INT)

EthernetユニットID (値: 0–15）

sControl (STRING)

制御文字列:

'ENABLE'：Ethernetユニットへのファイル転送を有効にします。
'DISABLE'：Ethernetユニットへのファイル転送を無効にします。
'CANCEL'：Ethernetユニットへのファイル転送をキャンセルします。

出力

bError (BOOL)

以下の条件でTRUEになります。

接続のタイムアウトが経過した場合
IPアドレスが無効な場合

エラーが発生した場合は、エラーコード番号のシステム変数sys_iEthernetConnectionErrorCodeを確認してください。

解説

文字列データは、256文字以内にする必要があります。
この命令は、割り込みプログラム中で使用することはできません。
定数を指定する文字のオペランドには、大文字または小文字を使用することができます。「Abcd」、「ABCD」、「abcd」は同義語となります。しかし、ファイル名では大文字小文字が区別されます。
命令を実行する前に、FP_FTP_SET_MODEまたはFTPクライアントの設定ダイアログを使用して転送設定を指定する必要があります。
命令を実行する前にsys_bIsEthernetInitializingがFALSEであることを確認してください。命令が実行されるとsys_bIsEthernetInitializingはTRUEになります。sys_bIsEthernetInitializingがTRUEのときに命令を実行すると、エラーが発生します。
この命令が正常に実行されると、システム変数sys_bIsCarryおよびsys_iEthernetConnectionErrorCodeがリセットされます。
転送中止要求は処理に時間がかかります。FP_FTP_GET_STATUSにより転送状態を確認し、命令を実行した後に転送が停止しているか確認してください。
エラーが発生した場合は、エラーコード番号のシステム変数sys_iEthernetConnectionErrorCodeを確認してください。

エラーフラグ

sys_bIsOperationErrorHold (TRUEになり、TRUEを保持)

'ENABLE'、'DISABLE'、または'CANCEL'以外の制御文字列がsControlに指定されている場合。
命令が割り込みプログラム内で実行された場合。
文字列データが256文字を超えた場合。
FP_FTP_SET_MODEで設定されていない、またはFTPクライアントの設定ダイアログで設定されていない転送設定が指定された場合。

sys_bIsOperationErrorNonHold (1回のスキャンに対してTRUE)

'ENABLE'、'DISABLE'、または'CANCEL'以外の制御文字列がsControlに指定されている場合。
命令が割り込みプログラム内で実行された場合。
文字列データが256文字を超えた場合。
FP_FTP_SET_MODEで設定されていない、またはFTPクライアントの設定ダイアログで設定されていない転送設定が指定された場合。

sys_bIsCarry (1回のスキャンに対してTRUE)

Ethernet初期化中に命令を実行した場合は、sys_iEthernetConnectionErrorCodeが「11：Ethernet初期化中」に設定されます。

例

POUヘッダ

POUヘッダには、このプログラムで使用するすべての入力変数と出力変数を宣言します。 POUヘッダは全プログラム言語で使用できます。

	VAR
		bEnableFTP: BOOL:=FALSE;
		bDisableTransferError: BOOL:=FALSE;
		iID10: INT:=10;
	END_VAR

POUボディ

bEnableFTPがFALSEからTRUEに変わると、命令が実行されます。制御ワード 'ENABLE' によりEthernetユニット10のFTP転送を有効にします。

LDボディ

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_VARIN,,iID10,10,2,12,4,);
B(B_VARIN,,'ENABLE',10,3,12,5,);
B(B_VAROUT,,bEnableTransferError,27,2,29,4,);
B(B_CONTACT,,bEnableFTP,4,1,6,3,R);
B(B_F,FP_FTP_TRANSFER_CONTROL!,,12,0,27,5,,?DEN?DnTransferID?DsControl?AENO?CbError);
L(1,2,4,2);
L(6,2,12,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

STボディ

If DF(bDisableAll) then
    FP_FTP_TRANSFER_CONTROL(nTransferID := iID10,
                            sControl := 'ENABLE',
                            bError => bError);
End_if;
If DF(bDisableAll) then
    FP_FTP_TRANSFER_CONTROL(nTransferID := iID10,
                            sControl := 'ENABLE',
                            bError => bError);
End_if;