集信プログラムの起動方法
集信処理を行うためには、集信プログラムを立ち上げておく必要があります。
集信プログラムを立ち上げるには、以下の説明に従ってJCLを作成して実行してください。
(1) 集信プログラム
プログラム名
XRRCV
起動方法
集信プログラムを起動させるには、コンソールから以下のコマンドを投入し、サブシステムとして起動します。
S 集信プログラムのジョブ名
実行(PARA文)パラメータ
実行(PARA文)パラメータは、下位バージョンとの互換のためのパラメータです。
通常は、システム動作環境で設定を行ってください。
実行(PARA文)パラメータとシステム動作環境の両方を設定した場合は、実行(PARA文)パラメータの設定が有効になります。
システム動作環境の設定内容の詳細は、「アドミニストレーション マニュアル」のシステム動作環境の説明を参照してください。
a b c d e f [APPLNM=xxxxxxxx][,MAX-CON=999][,RECCHK][,RWAIT][,RCVRETRY=9999][,RCVRTIME=99999] g h [,JOBWTIME=9999][,CHRSET=x]
- a.集信アプリケーション名
-
TISPの環境で設定した集信アプリケーション名を指定します(省略可)。
英大文字で始まる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.詰め文字の選択
-
テキスト転送で、かつ固定長ファイルに集信するときに、レコードの後ろの余り個所に詰める文字を指定します(省略可)。
- 0
-
: NULL詰め
- S
-
: スペース詰め
省略すると、システム動作環境設定の詰め文字の選択(RCV-CHRSET)の設定値が有効になります。
XRSYSIN定義カード
HULFTシステムの動作環境をXRSYSIN定義カードで設定します。設定内容の詳細は、「アドミニストレーション マニュアル」のシステム動作環境の説明を参照してください。
定義カードの形式
TGRPCHK=転送グループチェック HSTCHK=ホストチェック LOGDELTHRESHOLD=ログ削除しきい値 LOGKEEPCOUNT=ログ保持件数 EBCDIC=EBCDICコード間変換 PSCHG=パック・ゾーン変換 PSEBCDIC=EBCDIC用符号部 GAIJIFILE=外字テーブル使用 GAIJIERR=外字未登録時の処理 INIT-UNIT=配信ファイル・集信ファイルのUNIT名 JLIB1=後続ジョブ付加ステップのPRGLIB設定1 JLIB2=後続ジョブ付加ステップのPRGLIB設定1 JLIB3=後続ジョブ付加ステップのPRGLIB設定1 JELIB1=後続ジョブ付加ステップのPRGLIB設定2 JELIB2=後続ジョブ付加ステップのPRGLIB設定2 JELIB3=後続ジョブ付加ステップのPRGLIB設定2 JCAT1=後続ジョブ付加ステップのSTEPCAT設定1 JCAT2=後続ジョブ付加ステップのSTEPCAT設定1 JCAT3=後続ジョブ付加ステップのSTEPCAT設定1 JECAT1=後続ジョブ付加ステップのSTEPCAT設定2 JECAT2=後続ジョブ付加ステップのSTEPCAT設定2 JECAT3=後続ジョブ付加ステップのSTEPCAT設定2 MSGDYNPARM=メッセージ動的パラメータ指定 CIPHERTYPE=暗号化方式 KEEPALIVE=生存確認要求時間 JCLRETRY=JCLライブラリのリトライ回数 JCLRTIME=JCLライブラリのリトライ間隔 PROCTRANSTYPE=電文転送タイプ CONSMSG=ユーザ固有メッセージ OUTSTSKID=子タスクID出力 OPLSELECT=操作ログ出力選択 (*1) DATEFMT=日付形式 TTMODE=転送動作モード TTRCVOMIT=集信結果制御 TTRCVFILOUTPUT=集信ファイル出力 TTPRESNDJOB=配信前ジョブ実行 TTSNDJOB=配信後ジョブ実行 TTRCVJOB=集信後ジョブ実行 TTSNDRCVLOG=転送履歴出力 CNSSELECT=コンソールメッセージ出力選択 HULCHARSET=HULFTキャラクタセット TERMLICENSEKEY=利用期間ライセンスキー SERIALNO=シリアル番号 PRODUCTKEY=プロダクトキー INDOPTVAR=環境変数の頭文字選択 RCV-APPLNM=集信アプリ名 RCV-MAXCON=集信多重度 RCV-RECCHK=集信レコード長のチェック RCV-FILE-WAIT=集信ファイル使用時の扱い RCV-FILE-RETRY=集信ファイルのリトライ回数 RCV-FILE-RTIME=集信ファイルのリトライ間隔 RCV-JOBWTIME=集信後ジョブ実行タイムアウト時間 RCV-CHRSET=詰め文字の選択 ALLOWINSTTRANS=未登録ホストからの簡易転送受付許可 INSTTRANSRCVUNIT=簡易転送集信ファイルUNIT INSTTRANSRCVSPACE=簡易転送集信ファイル容量 INSTTRANSMFRCVORG=簡易転送集信MF間配信属性利用 INSTTRANSDSNLST=簡易転送集信ファイル名許可リストファイル INSTTRANSVOLLST=簡易転送集信ボリューム許可リストファイル CONSOLELOG=メッセージ重大度別出力要否選択 CONS-MSGFILTER=メッセージフィルタファイル CONTROL-FILE=システム制御ファイル名 STRONGKEYMODE=高強度暗号強制モード
*1 |
: |
操作ログ出力機能を使用する場合は、操作ログ関連の設定が必要です。詳細は「操作ログの動作設定」を参照してください。 |
JCL例
/ DEFINE HULRCV,RSIZE=16M \ CODE HLR \ JOB HULRCV,PSW=STAR \HULRCV EX XRRCV,RSIZE=\RSIZE,WTYP=2,CMND=(S,J), C KEY=ZERO,TIME=8388607,OPT=DUMP \ FD STEPCAT=DA,FILE=USERCAT \ FD SYSUDUMP=DA,VOL=WORK,TRK=(10,10),SOUT=A [\ FD XREXTLIB=DUMMY] \ FD XRLOG=DA,FILE=HULFT.LOG,AMP=AMORG \ FD XRLOG1=DA,FILE=HULFT.LOG.PATH1,AMP=AMORG \ FD XRLOG2=DA,FILE=HULFT.LOG.PATH2,AMP=AMORG \ FD XRFILE=DA,FILE=HULFT.FILE,AMP=AMORG \ FD XRHOST=DA,FILE=HULFT.HOST,AMP=AMORG \ FD XRSYSIN=DA,FILE=HULFT.PARMLIB,MEMBER=HULPRM \ FIN / DEFEND
FD名 |
項目名 |
説明 |
---|---|---|
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XREXTLIB |
DUMMY |
DUMMYファイル(*1) |
XRLOG |
HULFT.LOG |
集配信履歴ファイルIDキーファイル |
XRLOG1 |
HULFT.LOG.PATH1 |
集配信履歴ホスト名キーファイル |
XRLOG2 |
HULFT.LOG.PATH2 |
集配信履歴日付キーファイル |
XRFILE |
HULFT.FILE |
集配信管理ファイル |
XRHOST |
HULFT.HOST |
詳細ホスト情報ファイル |
XRQUE |
HULFT.QUEUE |
配信制御ファイル |
XRSYSIN |
HULFT.PARMLIB(HULPRM) |
システム動作環境設定ファイル |
*1 |
: |
外字テーブル利用時に設定が必要 |
パラメータ名 |
項目名 |
説明 |
---|---|---|
APPLNM |
HULRCV |
集信アプリケーション名(*1) |
*1 |
: |
TISP の集信アプリケーション名 |
外字テーブルを利用する場合はXREXTLIBのFD行を定義してください。