# 集信プログラムの起動方法

集信処理を行うためには、集信プログラムを立ち上げておく必要があります。

集信プログラムを立ち上げるには、以下の説明に従ってJCLを作成して実行してください。

## 集信プログラム

### プログラム名

XRRCV

### 実行（EXECステートメント）パラメーター

= 備考 =

実行（EXECステートメント）パラメーターは、下位バージョンとの互換のためのパラメーターです。

通常は、システム動作環境で設定を行ってください。

実行（EXECステートメント）パラメーターとシステム動作環境の両方を設定した場合は、実行（EXECステートメント）パラメーターの設定が有効になります。

システム動作環境の設定内容の詳細は、以下を参照してください。

HULFT10 for zOS アドミニストレーション マニュアル : システム動作環境の設定について

               a            b         c        d           e               f
    [APPLNM=xxxxxxxx][,MAX-CON=999][,RECCHK][,RWAIT][,RCVRETRY=9999][,RCVRTIME=99999]
                            g              h               i          j       k
                    [,JOBWTIME=9999][,TIMEOUT=999999][,TCPIP=xxxxx][,SMS][,CHRSET=x]

a.集信アプリケーション名

  PORT管理ファイル（HULFT.PROFILE.TCPIP）で設定した集信アプリケーション名を指定します（省略可）。

  英大文字で始まる8バイト以内の英数字で指定します。

  省略すると、システム動作環境設定の集信アプリ名（RCV-APPLNM）の設定値が有効になります。

b.集信多重度

  同時に集信を行うことができる集信子タスクの数を指定します（省略可）。

  “1”～“100”の範囲で指定します。

  “0”を指定すると、“16”が設定されます。最大値を超えて指定した場合は、“100”が設定されたときと同じ動作となります。

  省略すると、システム動作環境設定の集信多重度（RCV-MAXCON）の設定値が有効になります。

c.集信レコード長のチェック

  受信したデータのレコード長が集信ファイルのレコード長を超えた場合、処理を異常として終了させたいときに指定します（省略可）。

  省略すると、システム動作環境設定の集信レコード長のチェック（RCV-RECCHK）の設定値が有効になります。

d.集信ファイル使用時の扱い

  集信ファイルが他の集信処理で使用中の場合、完了を待って集信を行うときに指定します（省略可）。

  省略すると、システム動作環境設定の集信ファイル使用時の扱い（RCV-FILE-WAIT）の設定値が有効になります。

e.集信ファイルのリトライ回数

  集信ファイルが他のジョブで使用中の場合のリトライ回数を、“0”～“9999”の範囲で指定します（省略可）。

  省略すると、システム動作環境設定の集信ファイルのリトライ回数（RCV-FILE-RETRY）の設定値が有効になります。

f.集信ファイルのリトライ間隔

  集信ファイルが他のジョブで使用中の場合のリトライ間隔を、秒単位で“0”～“32760”の範囲で指定します（省略可）。

  省略すると、システム動作環境設定の集信ファイルのリトライ間隔（RCV-FILE-RTIME）の設定値が有効になります。

  なお、「集信ファイルのリトライ間隔」を指定するには「集信ファイルのリトライ回数」を“1”～“9999”の範囲で指定する必要があります。

g.集信後ジョブ実行タイムアウト時間

  集信完了通知（RCVEND-NOTICE）に“J（ジョブ完了）”が設定されている場合の集信後ジョブのタイムアウト時間を“1”～“1440”の範囲で分単位で指定します（省略可）。

  “0”を指定すると、“15”が設定されます。最大値を超えて指定した場合は、“1440”が設定されたときと同じ動作となります。

  省略すると、システム動作環境設定の集信後ジョブ実行タイムアウト時間（RCV-JOBWTIME）の設定値が有効になります。

  タイムアウトすると集信処理から集信後ジョブが切り離され、配信側ホストにジョブタイムアウトが通知されます。

h.ソケットリード待ち時間

  ソケットリード待ち時間を秒単位で指定します（省略可）。

  “10”～“259200”の範囲で指定します。

  省略すると、システム動作環境設定の集信ソケットリード待ち時間（RCV-TIMEOUT）の設定値が有効になります。

i.TCP/IPのアドレススペース名

  TCP/IPのアドレススペース名を指定します（省略可）。

  英大文字で始まる8バイト以内の英数字で指定します。

  省略すると、システム動作環境設定のTCP/IPのアドレススペース名（TCPIP）の設定値が有効になります。

j.データセットの探索方法

  集信データ・セット（集信ファイル）の存在をチェックするときに、カタログ簿を探索させたい場合に指定します（省略可）。

  省略すると、システム動作環境設定の集信ファイルの探索対象（RCV-FILE-SEARCH）の設定値が有効になります。

k.詰め文字の選択

  テキスト転送で、かつ固定長ファイルに集信するときに、レコードの後ろの余り個所に詰める文字を指定します（省略可）。

  0

    : NULL詰め

  S

    : スペース詰め

  省略すると、システム動作環境設定の詰め文字の選択（RCV-CHRSET）の設定値が有効になります。

### XRSYSIN定義カード

HULFTシステムの動作環境をXRSYSIN定義カードで設定します。設定内容の詳細は、以下を参照してください。

HULFT10 for zOS アドミニストレーション マニュアル : システム動作環境の設定について

定義カードの形式

    RCVBNO=集信用ファイルI/Oバッファー数
    TGRPCHK=転送グループチェック
    HSTCHK=ホストチェック
    LOGDELTHRESHOLD=ログ削除しきい値
    LOGKEEPCOUNT=ログ保持件数
    EBCDIC=EBCDICコード間変換
    PSCHG=パック・ゾーン変換
    PSEBCDIC=EBCDIC用符号部
    GAIJIFILE=外字テーブル使用
    GAIJIERR=外字未登録時の処理
    INIT-UNIT=配信ファイル・集信ファイルのUNIT名
    JLIB1=後続ジョブ付加ステップのSTEPLIB設定1
    JLIB2=後続ジョブ付加ステップのSTEPLIB設定1
    JLIB3=後続ジョブ付加ステップのSTEPLIB設定1
    JELIB1=後続ジョブ付加ステップのSTEPLIB設定2
    JELIB2=後続ジョブ付加ステップのSTEPLIB設定2
    JELIB3=後続ジョブ付加ステップのSTEPLIB設定2
    MSGDYNPARM=メッセージ動的パラメーター指定
    CIPHERTYPE=暗号化方式
    JCLRETRY=JCLライブラリーのリトライ回数
    JCLRTIME=JCLライブラリーのリトライ間隔
    PROCTRANSTYPE=電文転送タイプ
    CONSMSG=ユーザー固有メッセージ
    OUTSTSKID=子タスクID出力
    OPLSELECT=操作ログ出力選択（*1）
    HULLANG=HULFT動作言語
    DATEFMT=日付形式
    SNDSOCKSIZE=ソケット送信バッファーサイズ
    RCVSOCKSIZE=ソケット受信バッファーサイズ
    TTMODE=転送動作モード
    TTRCVOMIT=集信結果制御
    TTRCVFILOUTPUT=集信ファイル出力
    TTPRESNDJOB=配信前ジョブ実行
    TTSNDJOB=配信後ジョブ実行
    TTRCVJOB=集信後ジョブ実行
    TTSNDRCVLOG=転送履歴出力
    CNSSELECT=コンソールメッセージ出力選択
    HULCHARSET=HULFTキャラクターセット
    TERMLICENSEKEY=利用期間ライセンスキー
    SERIALNO=シリアル番号
    PRODUCTKEY=プロダクトキー
    INDOPTVAR=環境変数の頭文字選択
    LISTEN=接続待ち最大数
    RCV-APPLNM=集信アプリ名
    RCV-MAXCON=集信多重度
    RCV-RECCHK=集信レコード長のチェック
    RCV-FILE-WAIT=集信ファイル使用時の扱い
    RCV-FILE-SEARCH=集信ファイルの探索対象
    RCV-FILE-RETRY=集信ファイルのリトライ回数
    RCV-FILE-RTIME=集信ファイルのリトライ間隔
    RCV-JOBWTIME=集信後ジョブ実行タイムアウト時間
    RCV-CHRSET=詰め文字の選択
    RCV-TIMEOUT=集信ソケットリード待ち時間
    ALLOWINSTTRANS=未登録ホストからの簡易転送受付許可
    INSTTRANSRCVUNIT=簡易転送集信ファイルUNIT
    INSTTRANSRCVSPACE=簡易転送集信ファイル容量
    INSTTRANSMFRCVORG=簡易転送集信MF間配信属性利用
    INSTTRANSDSNLST=簡易転送集信ファイル名許可リストファイル
    INSTTRANSVOLLST=簡易転送集信ボリューム許可リストファイル
    CONSOLELOG=メッセージ重大度別出力要否選択
    CONS-MSGFILTER=メッセージフィルタファイル
    CONTROL-FILE=システム制御ファイル名
    STRONGKEYMODE=高強度暗号強制モード
    CODE-CONVERSION-LOCATION=コード変換テーブルの記憶域
    SYSFILEOUTPUTMODE=システムファイル出力モード

*1 | : | 操作ログ出力機能を使用する場合は、操作ログ関連の設定が必要です。詳細は「操作ログの動作設定」を参照してください。

### JCL例

    //HULRCV   JOB  CLASS=A,MSGCLASS=B,TIME=1440
    //HULRCV   EXEC PGM=XRRCV,REGION=4096K
    //STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR
    [//XREXTLIB DD  DSN=HULFT.LOAD,DISP=SHR]
    //XRFILE   DD   DSN=HULFT.FILE,DISP=SHR
    //XRHOST   DD   DSN=HULFT.HOST,DISP=SHR
    //XRLOG    DD   DSN=HULFT.LOG,DISP=SHR
    //XRLOG1   DD   DSN=HULFT.LOG.PATH1,DISP=SHR
    //XRLOG2   DD   DSN=HULFT.LOG.PATH2,DISP=SHR
    //XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR
    //PORTGET  DD   DSN=HULFT.PROFILE.TCPIP,DISP=SHR
    //SYSUDUMP DD   SYSOUT=*
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XREXTLIB | HULFT.LOAD | HULFTロードモジュールライブラリー(*1)
XRFILE | HULFT.FILE | 集配信管理ファイル
XRHOST | HULFT.HOST | 詳細ホスト情報ファイル
XRLOG | HULFT.LOG | 集配信履歴ファイルIDキーファイル
XRLOG1 | HULFT.LOG.PATH1 | 集配信履歴ホスト名キーファイル
XRLOG2 | HULFT.LOG.PATH2 | 集配信履歴日付キーファイル
XRSYSIN | HULFT.PARMLIB(HULPRM) | システム動作環境設定ファイル
PORTGET | HULFT.PROFILE.TCPIP | PORT管理ファイル

*1 | : | 集信側で外字コードを外字テーブルで変換させるときに、外字テーブルが格納されているライブラリーを付加します。外字テーブルの詳細は、以下を参照してください。 HULFT10 for zOS アドミニストレーション マニュアル : 外字テーブルについて

注意

集信プログラムを起動する際、コンソールから識別子を指定してSTARTコマンドを実行しないでください。

= 備考 =

通常は、JCLをスタートプロシージャーとして登録し、STARTコマンドを使用して起動します。