# 集信キャンセルコマンド

集信処理をキャンセルすることができます。

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

    CALL ライブラリー名/UTLRCAN PARM(['LIB=ライブラリー名'] ['F=fileid'] ['H=hostname']
         ['TRID=transfer-id'] ['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])

## パラメーター説明

LIB=ライブラリー名

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

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

F=fileid

  キャンセルする集信中のファイルID（省略可）

  50バイト以内の英数字および“_”で指定します。

  簡易転送の処理を一括してキャンセルする場合、「_INSTANT_TRANSFER_」を指定します。

  簡易転送の処理を個別にキャンセルしたい場合は、「TRID=」で指定してください。

  省略すると該当ホスト名すべてに対して集信処理をキャンセルします。

H=hostname

  キャンセルする集信中の相手先ホスト名（省略可）

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

  省略すると該当ファイルIDすべてに対して集信処理をキャンセルします。

TRID=transfer-id

  キャンセルする集信中または集信待ちの転送識別子（省略可）

  64バイトの英数字で指定します。

  省略すると「F=」および「H=」で指定した該当ファイルID、該当ホストすべてに対して集信処理をキャンセルします。

G

  集信キャンセルコマンドが出力するエラーメッセージの表示有無（省略可）

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

OUTPUT=filename

  集信キャンセルコマンドが出力するエラーメッセージの出力先（省略可）

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

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

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

EXIT CL変数名

  集信キャンセルコマンドが出力するエラーコードの受け取りとCL変数名（省略可）

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

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

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

注意

- 同一ホスト、同一ファイルIDが存在する場合は、該当するすべての集信処理がキャンセルされます。

- キャンセルされた集信処理に集信後ジョブが指定されていても、ジョブは起動しません。

- 集信キャンセルを行った場合、要求が正常に受け付けられても、次のような場合には実際にキャンセルされるまでに時間がかかる場合があります。

  - 配信側ホストの転送間隔が大きく取られている場合

  - 相手ホストからの応答待ち状態の場合

- 集信後ジョブ実行が開始されている場合、集信処理はキャンセルできません。

## コマンドインターフェイス

    UTLRCAN FILEID( ) HOSTNAME( ) TRID( ) LIBRARY( ) MSG( ) FILE( ) MBR( )

## パラメーター説明

FILEID

  キャンセルする集信中のファイルID（省略可）

  50バイト以内の英数字および“_”で指定します。

  簡易転送の処理を一括してキャンセルする場合、「_INSTANT_TRANSFER_」を指定します。

  簡易転送の処理を個別にキャンセルしたい場合は、「TRID=」で指定してください。

  省略すると該当ホスト名すべてに対して集信処理をキャンセルします。

HOSTNAME

  キャンセルする集信中の相手ホスト名（省略可）

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

  省略すると該当ファイルIDすべてに対して集信処理をキャンセルします。

TRID

  キャンセルする集信中または集信待ちの転送識別子（省略可）

  64バイトの英数字で指定します。

  省略すると「FILEID」および「HOSTNAME」で指定した該当ファイルID、該当ホストすべてに対して集信処理をキャンセルします。

LIBRARY

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

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

MSG

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

  *NO

    : エラーメッセージを表示しない

  *YES

    : エラーメッセージを表示する

FILE

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

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

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

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

MBR

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

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