# 再送要求コマンド

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

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

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

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

    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バイト以内の英数字で指定します。