送信要求コマンド

集信側から相手ホストに送信を依頼するためには、送信要求コマンドを実行して相手ホストに配信を要求します。

送信要求コマンドを実行するには、あらかじめ集信受付ジョブおよび相手側の配信受付ジョブと要求受付ジョブを起動しておく必要があります。また、要求先ホストで配信を行うために必要な管理情報が正しく登録されている必要があります。

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

CALL ライブラリー名/UTLRECV PARM(['LIB=ライブラリー名'] 'F=fileid' ['H=hostname']
   ['MSG0=message0'] ['MSG1=message1'] ['MSG2=message2'] ['MSG3=message3']
   ['MSG4=message4'] ['MSG5=message5'] ['MSGL0=lmessage0'] ['MSGL1=lmessage1']
   ['SYNC'] ['W=waittime'] ['G'] ['OUTPUT=filename'] ['EXIT' CL変数名])

パラメーター説明

LIB=ライブラリー名

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

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

F=fileid

集信を行うファイルID（省略不可）

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

H=hostname

送信を依頼する相手ホスト名（省略可）

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

省略すると集信管理情報の転送グループに登録されているすべてのホストに送信を依頼します。

MSG0=message0 ～ MSG5=message5

配信側へ送信するメッセージ（省略可）

50バイト以内で指定します。

省略すると配信側にメッセージは送信されません。

メッセージは6つまで指定できます。たとえば、メッセージ0を送信する場合は、パラメーター「MSG0=」にて指定します。

MSGL0=lmessage0 ～ MSGL1=lmessage1

配信側へ送信する拡張メッセージ（省略可）

200バイト以内で指定します。

省略すると配信側にメッセージは送信されません。

メッセージは2つまで指定できます。たとえば、拡張メッセージ0を送信する場合は、パラメーター「MSGL0=」にて指定します。

SYNC

同期転送要求（省略可）

省略すると非同期の送信要求となります。

W=waittime

同期転送待ち時間（秒）（省略可）

同期転送時に処理結果を受け取るために同期をとる時間を指定します。“10”から“259200”までの間で指定します。この時間に至ると、たとえ集信中であっても処理を戻します。その場合、転送結果はコマンドには戻りませんので注意してください。“0”を指定すると無限に待ちます。

このパラメーターを指定する場合は、パラメーター「SYNC」を指定する必要があります。

省略するとシステム動作環境設定ファイルのソケットリードタイムアウト（SOCKTIME）で設定された値になります。

G

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

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

OUTPUT=filename

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

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

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

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

EXIT CL変数名

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

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

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

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

注意

「MSG0」～「MSG5」または「MSGL0」～「MSGL1」を指定し、メッセージの置換を行う場合は、システム動作環境設定のメッセージ動的パラメーター指定（MSGDYNPARM）に“1”～“3”のいずれかを指定する必要があります。

また、相手ホストの言語設定によっては、メッセージの置換が正しく行われず、転送に失敗する場合があります。

メッセージ送信の注意点については、以下を参照してください。

HULFT10 for IBMi アドミニストレーションマニュアル : メッセージ送信
「MSG0」～「MSG5」または「MSGL0」～「MSGL1」で指定した文字列は、システム動作環境設定のHULFTキャラクターセット（HULCHARSET）で指定したCCSID (コード化文字セット識別コード）のデータとして扱われます。HULFT for IBMi Ver.8未満と同じキャラクターセットのデータとして扱うには、システム動作環境設定のメッセージキャラクターセット選択（CHARSETOPTMSG）の設定を変更してください。

設定内容の詳細は、以下を参照してください。

HULFT10 for IBMi アドミニストレーションマニュアル : コード変換関連設定

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

UTLRECV FILEID( ) HOSTNAME( ) MSG0( ) MSG1( ) MSG2( ) MSG3( ) MSG4( ) MSG5( )
   MSGL0( ) MSGL1( ) SYNC( ) WAITTIME( ) LIBRARY( ) MSG( ) FILE( ) MBR( )

パラメーター説明

FILEID

集信を行うファイルID（省略不可）

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

HOSTNAME

送信を依頼する相手ホスト名（省略可）

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

省略すると集信管理情報の転送グループに登録されている全てのホストに送信を依頼します。

MSG0～MSG5

配信側へ送信するメッセージ（省略可）

50バイト以内で指定します。

省略すると配信側にメッセージは送信されません。

MSGL0～MSGL1

配信側へ送信するメッセージ（省略可）

200バイト以内で指定します。

省略すると配信側にメッセージは送信されません。

SYNC

同期転送要求（省略時値 *NO）

*NO: : 非同期転送
*YES: : 同期転送

WAITTIME

同期転送待ち時間（秒）（省略可）

同期転送時に処理結果を受け取るために同期をとる時間を指定します。“000010”から“259200”までの間で指定します。“000000”を指定すると無限に待ちます。

このパラメーターを指定する場合は、パラメーター「SYNC(*YES)」を指定する必要があります。

省略するとシステム動作環境設定ファイルのソケットリードタイムアウト（SOCKTIME）で設定された値になります。

LIBRARY

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

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

MSG

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

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

FILE

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

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

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

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

MBR

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

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