MFFTP 制御変数

以下の制御変数を使用して、MFFTP ユーティリティを構成できます。

MFFTP_ABCODE=nnnn

MFFTP が異常終了する場合、デフォルトでは U0001 のコードになります。1 から 4095 の範囲で値を設定するには、この変数を使用します。

MFFTP_ABEND=RC8

MFFTP が入力ストリームでエラーを検出するか、入出力エラーが発生した場合、デフォルトではユーザー異常終了コード U0001 で終了します。戻りコード 8 ですぐにプログラムを終了するには、代わりにこの制御変数を使用します。

MFFTP_CATALOG_CHARSET=xxx

デフォルトでは、新しいデータセットはサーバー文字セットでカタログされます。この変数を利用して文字セットをオーバーライドできます。使用可能な値は次のとおりです。

A
ASC
ASCII
E
EBC
EBCDIC

指定された文字セットがサーバーの文字セットに一致しない場合、警告メッセージが表示されます。

MFFTP_CHECK_221={Y | N}

MFFTP が BYE または QUIT コマンドを処理した場合、ホスト FTP クライアントには 221 でプレフィックスされたメッセージが表示されます。そのメッセージが表示されなかった場合、ネットワークに障害があるか、同様の障害があることがわかります。

この変数が Y に設定されており、221 メッセージが表示されなかった場合、戻りコードは 4 に設定されます。

MFFTP_EXIT_EQUALS={N | Y}

デフォルトでは、MFFTP がエラーを検出した場合、0 以外の戻りコードで終了するか、U0001 で異常終了します。異常終了コードの変更方法の詳細については、MFFTP_ABCODE を参照してください。

EXIT=nnnn が EXEC カード PARM 上でコーディングされた場合、これを Y に設定すると、MFFTP が戻りコード nnnn を返します。

MFFTP_CLIENT={FTP | USER}

呼び出される FTP クライアントを設定します。

これが指定されていないか、FTP に設定されている場合、ホストのデフォルト FTP クライアントが使用されます。

USER が指定されている場合、MFFTP_USR_FTP_PGM も指定して、FTP クライアントを呼び出すモジュールを対象とする必要があります。

MFFTP_EPSV={N | Y}

一部の FTP サーバーには、USER コマンドの後に EPSV コマンドを送信する必要があります。デフォルトでは、セッションをアクティブなまま保持します。

これを Y に設定すると、サーバーはパッシブ FTP セッションになります。サーバーが IPv6 通信プロトコルを使用している場合、これを使用します。これにより、ユーザーがルーターまたはファイアウォールの後ろにいて、アクティブ PORT/EPRT FTP セッションを通した接続が機能しない場合でも、FTP 接続が可能になります。

MFFTP_FTP_DEBUG={1 | 2}

FTP DEBUG コマンドを FTP コマンドストリームに挿入します。

1 の値は、最初の文としてコマンドを挿入します。
2 の値は、ログイン資格情報の後にコマンドを挿入します。

MFFTP_KEEP={N | Y | C}

Y に設定されている場合、MFFTP_KEEP_IP=N (下記参照) も設定されていない限り (この場合、必ず入力作業ファイルが削除されます)、すべての作業ファイルがステップの最後に保持されます。

C に設定されている場合、FTP クライアントからの戻りコードが 0 に設定されるとファイルは削除されます。それ以外の場合、作業ファイルは保持されます。

MFFTP_KEEP_IP={N | Y}

N に設定されている場合、MFFTP_KEEP が Y に設定されても、入力作業ファイルはステップの最後に削除されます。

MFFTP_OUTPUT_LRECL=xxx

デフォルトでは、OUTPUT DD 文のレコードサイズ (LRECL) は 133 バイトです。この変数を使用して、レコードサイズを最大値の 512 バイトに変更できます。

MFFTP_PREFIX={N | Y}

Y に設定されている場合、サーバーインスタンス名が一時ファイル名にプレフィックスとして使用されます。

MFFTP_PROCESS_TRAILS_ONGET={TRUE | FALSE}

GET コマンドで後続空白文字を処理するかどうかを指定します。デフォルトは TRUE です。後続空白文字を無視するには、この値を FALSE に設定すると同時に、LOCSTAT 値の TRAILINGBLANKS=FALSE を設定します。

MFFTP_RETCODE=n1,n2,n3,n4

JES に返される戻りコード (条件コード) を決定します。デフォルトでは、戻りコードは以下を示します。

0: 問題が発生していません。
4: MFFTP が、ホスト FTP クライアントからエラーを示す出力 (5nn または 4nn シリーズのエラーメッセージなど) を受け取りました。1 つ以上のコマンドが失敗した可能性があります。必要に応じて変更できる MFFTPURR モジュールの提供されたコードで、「pass」または「fail」のデフォルト値を確認できます。
8: MFFTP は、認識されたメッセージ番号で始まるホスト FTP クライアントからの出力を受け取っていません。これは通常、FTP クライアントが FTP サーバーへの接続に失敗した場合に発生します。
16: 他の重大なエラー：

上記のコードはそれぞれ、n1、n2、n3、n4 を表します。これらは、たとえば戻りコード 8 が常に必要となるように変更できます (MFFTP_RETCODE=0,8,8,8)。

注: 4 つの値すべてをコーディングする必要があります。

MFFTP_SENDEOL={NONE | CR | LF | CRLF}

通常、分散システム上のテキストファイルで検出される行末文字を指定します。Mainframe Subsystem Support (MSS) を持つエンタープライズサーバーインスタンスがメインフレームをエミュレートしているため、GET を使用すると、指定された文字がスキャンおよび削除され、PUT コマンドを使用すると各論理レコードに指定された文字が追加されます。

MFFTP_SYSPRINT_LRECL=xxx

デフォルトでは、SYSPRINT DD 文のレコードサイズ (LRECL) は 133 バイトです。この変数を使用して、レコードサイズを最大値の 512 バイトに変更できます。

MFFTP_TEMP_DIR=dir

MFFTP が一時ファイルを作成するデフォルトデータディレクトリではなく、絶対ディレクトリパスを指定します。そのディレクトリはすでに存在しており、サーバーインスタンスがアクセスできる必要があります。

注: UNIX では、対象ディレクトリと大文字と小文字を一致させて入力するようにします。

MFFTP_TIME={N | C | L | B}

MFFTP は、開始時間および終了時間を記録し、経過時間を計算します。また、FTP クライアントの動作時間も記録します。これらの時間を表示するには、この指令に以下の値を設定します。

N: デフォルト値です。非表示を意味します。
C: コンソール
L: リスト
B: コンソールとリストの両方

MFFTP_TRANSLATE_SAFETY={ON | OFF}

デフォルトでは、コードページ変換が (EXEC カードで TRAN オプションを使用して) 要求されると、MFFTP が「ラウンドトリップ」によってデータが破損しないことをチェックします。それは、x'00' から x'ff' を含む、256 バイト領域の PUT をシミュレートすることで行われます。そして、結果として得られる出力を取り、そのデータで GET をシミュレートします。テーブルが正しい場合、GET からの結果が元のデータと等しくなければなりません。データが一致しない場合に警告を無視するには、この変数を使用します。

注: この変数を使用する際は注意してください。

MFFTP_UFLAG={N | Y}

一部の FTP クライアントには -u フラグを設定する必要があります。これによって、MFFTP は初期接続中に自動認証を試行しなくなります。

MFFTP_USR_FTP_PGM=program-name

MFFTP_CLIENT が USER に設定されている場合、これが必要です。FTP クライアントを呼び出すユーザー指定モジュールの名前を指定します。

注: UNIX では、モジュールと大文字と小文字を一致させて入力しないと、MFFTP がモジュールを呼び出せないことをレポートします。

MFFTP_VERBOSE_OUTPUT={ON | OFF}

印刷ファイルに書き込まれるものを決定します。デフォルトでは、元の入力カードおよびそこで発生したエラーを含む多くの情報が印刷されます。OFF に設定されている場合、MFFTP は FTP クライアントおよびサーバーからの出力のみ印刷します。