送信要求

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

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

(1) 送信要求コマンド

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

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”のいずれかを指定する必要があります。

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

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

設定内容の詳細は、「アドミニストレーションマニュアル」のシステム動作環境設定を参照してください。

コマンドインタフェース

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