再送要求

再送要求は、何らかの理由によりファイルを受信できなかった場合に要求します。

再送要求コマンドを実行するには、あらかじめ集信受付ジョブおよび相手側の配信受付ジョブと要求受付ジョブを起動しておく必要があります。

通常、再送要求は受信できなかった位置（データ）から受信します（チェックポイント再送）。ファイルの先頭から受信したい場合は、パラメータ「NP」を指定します。

(1) 再送要求コマンド

プログラムインタフェース

CALL ライブラリ名/UTLRECV PARM(['LIB=ライブラリ名'] 'R' 'H=hostname'
   ['F=fileid'] ['NP'] ['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])

パラメータ説明

LIB=ライブラリ名

HULFTがインストールされているライブラリ名（省略時値 HULFT）

先頭英字の10バイト以内の英数字で指定します。

R

再送要求依頼（省略不可）

H=hostname

再送要求を依頼する相手ホスト名（省略不可）

68バイト以内の英数字で指定します。

F=fileid

再送要求を依頼するファイルID（省略可）

50バイト以内の英数字で指定します。

省略すると指定した相手ホスト名の再配信待ちファイルがすべて配信されます。

NP

ファイルの先頭から再送信（省略可）

省略するとチェックポイント再送を行います。

G

再送要求コマンドが出力するエラーメッセージの表示抑制（省略可）

省略するとエラーメッセージが表示されます。

OUTPUT=filename

再送要求コマンドが出力するエラーメッセージの出力先（省略可）

「ライブラリ名/ファイル名(メンバ名)」の形式で指定します。

省略するとエラーメッセージは出力されません。

ログファイルのレコード保持件数は無制限です。

EXIT CL変数名

再送要求コマンドが出力するエラーコードの受け取りとCL変数名（省略可）

EXITとCL変数名は連続して指定してください。

異常終了の場合のみ、エラーコードをCL変数へセットします。

省略するとエラーコードはセットされません。

注意

チェックポイント再送は下記の条件が満たされていないとできません。1つでも条件が満たされていないと先頭からの再送信になります。

集信管理情報の登録モードが“N（新規作成）”または“R（置き換え）”
集信管理情報の異常時の処置が“K（保存）”
集信管理情報の集信形態が“S（単一集信）”
集信ファイルが物理データファイル

= 備考 =

再送要求時は、配信前ジョブIDが登録されていても配信前ジョブは実行されません。また、同期転送機能、メッセージ送信機能はありません。ただし、配信要求・送信要求時に指定されたメッセージは引き継がれます。

コマンドインタフェース

UTLRECV HOSTNAME( ) FILEID( ) RESEND( ) CHKP( ) LIBRARY( ) MSG( ) FILE( ) MBR( )

パラメータ説明

HOSTNAME

再送要求を依頼する相手ホスト名（省略不可）

68バイト以内の英数字で指定します。

FILEID

再送要求を依頼するファイルID（省略可）

50バイト以内の英数字で指定します。

省略すると指定した相手ホスト名の再配信待ちファイルがすべて配信されます。

RESEND

再送要求依頼（省略不可）

*NO: : 再送要求を依頼しない
*YES: : 再送要求を依頼する

再送要求を依頼する場合は必ず“*YES”を指定します。

CHKP

チェックポイント指定（省略時値 *YES）

*NO: : 先頭から再配信を行う
*YES: : 異常個所から再配信を行う

LIBRARY

HULFTがインストールされているライブラリ名（省略時値 HULFT）

先頭英字の10バイト以内の英数字で指定します。

MSG

エラーメッセージの表示抑制（省略時値 *YES）

*NO: : エラーメッセージを表示しない
*YES: : エラーメッセージを表示する

FILE

エラーメッセージ出力先ファイルのライブラリ名とファイル名（省略可）

「ライブラリ名/ファイル名」の形式で指定します。

それぞれ先頭英字の10バイト以内の英数字で指定します。

省略するとエラーメッセージは出力されません。ログファイルのレコード保持件数は無制限です。

MBR

エラーメッセージ出力先ファイルのメンバ名（省略時値 *FILE）

先頭英字の10バイト以内の英数字で指定します。