HULFT Ver.6からのバージョンアップ
提供ファイル「HULFT8.INSTV6.JCL.XSP.TXT」(下記の[JCL例])を参照し、JCLを作成してください。
ユーザ環境に応じて変更が必要な箇所は変更してください。
作成したJCLを実行すると、以下の各ライブラリを既存ライブラリに上書きインストールします。
-
HULFT JCLライブラリ
-
HULFTロードモジュールライブラリ
-
HULFT PFDパネルライブラリ
-
HULFT PFDメッセージライブラリ
-
HULFTパラメータライブラリ
-
以降の手順を行うと、現在使用しているHULFTの環境が変更されます。
以降の作業項目には、バックアップを使用して行う作業も含まれています。
作業を行う前に、「HULFT Ver.7のバックアップ」に従いバックアップを必ず行ってください。
-
HULFTロードモジュールライブラリは、新規メンバが多数増えるため、既存ライブラリで容量不足が発生する可能性があります。
-
HULFT Ver.5からのバージョンアップでHULFT Ver.6を導入している場合には、HULFTパラメータライブラリが存在していない場合があります。その場合は、HULFTパラメータライブラリを新規インストールしてください。
[JCL例]
\ JOB VERUP6,LIST=(A,JS) \VERUP61 EX LIBE \ FD STEPCAT=DA,FILE=USERCAT \ FD U01=DA,VOL=HUL001,FILE=HULFT.V8.JCL \ FD U02=DA,FILE=HULFT.JCL \ FD LIST=DA,VOL=WORK,TRK=(10,10),SOUT=A \ FD COIN=* / RESTORE (OPLVSAM,OPLBKUP,XROPLBK,XROPLLST,XROPLLS2,BACKUP6, C / BACKUP7,BACKUP8,HULVSAM,LOGVSAM,QUEVSAM,FILEVSAM, C / HOSTVSAM,XRHULVER,XRCREATE,XREBCASC,XRASCEBC,XREBCEUC, C / XREUCEBC,XRSJSCNV,XREUCCNV,XRFILCNV,XRLOGCNV, C / CNTLVSAM,HULSNDGO,XRJCLEDT,XRJCLGEN,XRLIBVCK,XRPRMCNV, C / SMPJOBAP,SMPLOGAP,SMPRCVAP,SMPSNDAP,SMPHSAP), C / XRHSMVFY), C / IN=U01,OUT=U02,REP / FIN \* RESTORE (XRLOGCNT), \* RESTORE (XRPRMGEN), \* RESTORE (XRPRMSET), \* RESTORE (XRRSNDDL), \* \VERUP62 EX LIBE \ FD STEPCAT=DA,FILE=USERCAT \ FD I02=DA,FILE=HULFT.V8.JPN.PANEL \ FD I03=DA,FILE=HULFT.V8.JPN.MSG \ FD I04=DA,FILE=HULFT.V8.PARMLIB \ FD I05=DA,FILE=HULFT.V8.LOAD \ FD O02=DA,FILE=HULFT.PANEL \ FD O03=DA,FILE=HULFT.MSG \ FD O04=DA,FILE=HULFT.PARMLIB \ FD O05=DA,FILE=HULFT.LOAD \ FD LIST=DA,VOL=WORK,TRK=(10,10),SOUT=A \ FD COIN=* / RESTORE +,IN=I02,OUT=O02,REP / RESTORE +,IN=I03,OUT=O03,REP / RESTORE +,IN=I04,OUT=O04,REP / RESTORE +,IN=I05,OUT=O05,REP / FIN \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
U01 |
HULFT.V8.JCL |
HULFT JCLライブラリ(HULFT導入用ファイル アンロード形式) |
U02 |
HULFT.JCL |
HULFT JCLライブラリ(インストール先ファイル) |
STEPCAT |
USERCAT |
カタログ簿データセット名 |
I02 |
HULFT.V8.JPN.PANEL |
HULFT PFDパネルライブラリ(HULFT導入用ファイル アンロード形式) |
O02 |
HULFT.PANEL |
HULFT PFDパネルライブラリ(インストール先ファイル) |
I03 |
HULFT.V8.JPN.MSG |
HULFT PFDメッセージライブラリ(HULFT導入用ファイル アンロード形式) |
O03 |
HULFT.MSG |
HULFT PFDメッセージライブラリ(インストール先ファイル) |
I04 |
HULFT.V8.PARMLIB |
HULFTパラメータライブラリ(HULFT導入用ファイル アンロード形式) |
O04 |
HULFT.PARMLIB |
HULFTパラメータライブラリ(インストール先ファイル) |
I05 |
HULFT.V8.LOAD |
HULFTロードモジュールライブラリ(HULFT導入用ファイル アンロード形式) |
O05 |
HULFT.LOAD |
HULFTロードモジュールライブラリ(インストール先ファイル) |
パラメータ名 |
項目名 |
説明 |
---|---|---|
VOL |
HUL001 |
ボリューム名 |
ジョブステップ「VERUP61」でコメント行になっているJCLメンバが既存のライブラリに存在していない場合、コメントをはずしたJCLに修正後、JCLを実行してください。
(2) 認定ライブラリの登録
認定ライブラリの登録方法は、「認定ライブラリの登録」を参照してください。
(3) TISP環境設定
転送速度優先モードを使用し、転送速度の向上を図るためには、TISPのアプリケーション定義を変更する必要があります。
TISP環境設定に関する詳細は「TISP環境設定」を参照してください。
HULFT Ver.6の以下のファイルをHULFT Ver.8で使用できる形式に創成し直します。
-
集配信管理ファイル
-
詳細ホスト情報ファイル
-
配信制御ファイル
-
集配信履歴ファイル
-
システム制御ファイル
容量については、「VSAMファイルの容量計算」を参照してください。
また、INDEX部の容量も再度計算が必要です。「キー長」を基に容量計算を行ってください。
各ファイルを創成する際は、あわせて初期化処理も行う必要があります。
a) 集配信管理ファイルの創成
HULFT Ver.8の集配信管理ファイルの創成手順を以下に示します。
HULFT JCLライブラリ内のメンバ名「FILEVSAM」を修正して実行してください。
[JCL例]
\ JOB FILEVSAM,LIST=(A,JS) \*-------< VSAM DEFINE CLUSTER >--------------------------------------* \FILEVSAM EX KQCAMS \ FD STEPCAT=DA,FILE=USERCAT \ FD SYSPRINT=DA,TRK=(10,10),VOL=WORK,SOUT=A \ FD SYSIN=* DELETE HULFT.FILE DEFINE CLUSTER - (NAME(HULFT.FILE) - INDEXED) - DATA - (NAME(HULFT.FILE.DATA) - KEYS(54 0) - SHAREOPTIONS(4 3) - VOLUMES(HUL001) - CYLINDERS(1) - RECORDSIZE(610 22300)) - INDEX - (NAME(HULFT.FILE.IDX) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3)) - CATALOG(USERCAT) \*-------< FILE CREATE >--------------------------------------* \XRCREATE EX XRCREATE,RSIZE=2048K \ FD STEPCAT=DA,FILE=USERCAT \ FD XRLOG=DUMMY \ FD XRLOG1=DUMMY \ FD XRLOG2=DUMMY \ FD XRFILE=DA,FILE=HULFT.FILE,AMP=AMORG \ FD XRHOST=DUMMY \ FD XRQUE=DUMMY \ FD XRCNTL=DUMMY \ FD XROPLC1=DUMMY \ FD XROPLC2=DUMMY \ FD XROPLF1=DUMMY \ FD XROPLF2=DUMMY \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRFILE |
HULFT.FILE |
集配信管理ファイル |
パラメータ名 |
項目名 |
説明 |
---|---|---|
VOLUMES |
HUL001 |
ボリューム名 |
CATALOG |
USERCAT |
カタログ簿データセット名 |
NAME |
HULFT.FILE |
集配信管理ファイル |
NAME |
HULFT.FILE.DATA |
集配信管理ファイル データ・コンポーネント エントリ名 |
NAME |
HULFT.FILE.IDX |
集配信管理ファイル インデックス・コンポーネント エントリ名 |
b) 詳細ホスト情報ファイルの創成
HULFT Ver.8の詳細ホスト情報ファイルの創成手順を以下に示します。
HULFT JCLライブラリ内のメンバ名「HOSTVSAM」を修正して実行してください。
[JCL例]
\ JOB HOSTVSAM,LIST=(A,JS) \*-------< VSAM DEFINE CLUSTER >--------------------------------------* \HOSTVSAM EX KQCAMS \ FD STEPCAT=DA,FILE=USERCAT \ FD SYSPRINT=DA,TRK=(10,10),VOL=WORK,SOUT=A \ FD SYSIN=* DELETE HULFT.HOST DEFINE CLUSTER - (NAME(HULFT.HOST) - INDEXED) - DATA - (NAME(HULFT.HOST.DATA) - KEYS(51 0) - SHAREOPTIONS(4 3) - VOLUMES(HUL001) - CYLINDERS(1) - RECORDSIZE(500 500)) - INDEX - (NAME(HULFT.HOST.IDX) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3)) - CATALOG(USERCAT) \*-------< FILE CREATE >--------------------------------------* \XRCREATE EX XRCREATE,RSIZE=2048K \ FD STEPCAT=DA,FILE=USERCAT \ FD XRLOG=DUMMY \ FD XRLOG1=DUMMY \ FD XRLOG2=DUMMY \ FD XRFILE=DUMMY \ FD XRHOST=DA,FILE=HULFT.HOST,AMP=AMORG \ FD XRQUE=DUMMY \ FD XRCNTL=DUMMY \ FD XROPLC1=DUMMY \ FD XROPLC2=DUMMY \ FD XROPLF1=DUMMY \ FD XROPLF2=DUMMY \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRHOST |
HULFT.HOST |
詳細ホスト情報ファイル |
パラメータ名 |
項目名 |
説明 |
---|---|---|
VOLUMES |
HUL001 |
ボリューム名 |
CATALOG |
USERCAT |
カタログ簿データセット名 |
NAME |
HULFT.HOST |
詳細ホスト情報ファイル |
NAME |
HULFT.HOST.DATA |
詳細ホスト情報ファイル データ・コンポーネント エントリ名 |
NAME |
HULFT.HOST.IDX |
詳細ホスト情報ファイル インデックス・コンポーネント エントリ名 |
c) 配信制御ファイルの創成
HULFT Ver.8の配信制御ファイルの創成手順を以下に示します。
HULFT JCLライブラリ内のメンバ名「QUEVSAM」を修正して実行してください。
[JCL例]
\ JOB QUEVSAM,LIST=(A,JS) \**------< VSAM DEFINE CLUSTER >--------------------------------------- \DEFCLSTR EX KQCAMS \ FD STEPCAT=DA,FILE=USERCAT \ FD SYSPRINT=DA,TRK=(10,10),VOL=WORK,SOUT=A \ FD SYSIN=* DELETE HULFT.QUEUE DEFINE CLUSTER - (NAME(HULFT.QUEUE) - INDEXED) - DATA - (NAME(HULFT.QUEUE.DATA) - KEYS(61 0) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3) - RECORDSIZE(7600 7600) - CONTROLINTERVALSIZE(32768)) - INDEX - (NAME(HULFT.QUEUE.IDX) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3)) - CATALOG(USERCAT) \*-------< FILE CREATE >--------------------------------------* \XRCREATE EX XRCREATE,RSIZE=2048K \ FD STEPCAT=DA,FILE=USERCAT \ FD XRLOG=DUMMY \ FD XRLOG1=DUMMY \ FD XRLOG2=DUMMY \ FD XRFILE=DUMMY \ FD XRHOST=DUMMY \ FD XRQUE=DA,FILE=HULFT.QUEUE,AMP=AMORG \ FD XRCNTL=DUMMY \ FD XROPLC1=DUMMY \ FD XROPLC2=DUMMY \ FD XROPLF1=DUMMY \ FD XROPLF2=DUMMY \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRQUE |
HULFT.QUEUE |
配信制御ファイル |
パラメータ名 |
項目名 |
説明 |
---|---|---|
VOLUMES |
HUL001 |
ボリューム名 |
CATALOG |
USERCAT |
カタログ簿データセット名 |
NAME |
HULFT.QUEUE |
配信制御ファイル |
NAME |
HULFT.QUEUE.DATA |
配信制御ファイル データ・コンポーネント エントリ名 |
NAME |
HULFT.QUEUE.IDX |
配信制御ファイル インデックス・コンポーネント エントリ名 |
d) 集配信履歴ファイルの創成
HULFT Ver.8の集配信履歴ファイルの創成手順を、以下に示します。
HULFT JCLライブラリ内のメンバ名「LOGVSAM」を修正して、実行してください。
[JCL例]
\ JOB LOGVSAM,LIST=(A,JS) \*-------< VSAM DEFINE CLUSTER >--------------------------------------* \LOGVSAM EX KQCAMS \ FD STEPCAT=DA,FILE=USERCAT \ FD SYSPRINT=DA,TRK=(10,10),VOL=WORK,SOUT=A \ FD SYSIN=* DELETE HULFT.LOG DELETE HULFT.LOG.PATH1 DELETE HULFT.LOG.PATH2 DEFINE CLUSTER - (NAME(HULFT.LOG) - INDEXED - REUSE) - DATA - (NAME(HULFT.LOG.DATA) - KEYS(59 0) - VOLUMES(HUL001) - CYLINDERS(5) - SHAREOPTIONS(4 3) - RECORDSIZE(4000 4000) - CONTROLINTERVALSIZE(22528)) - INDEX - (NAME(HULFT.LOG.IDX) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3)) - CATALOG(USERCAT) DEFINE CLUSTER - (NAME(HULFT.LOG.PATH1) - INDEXED - REUSE) - DATA - (NAME(HULFT.LOG.PATH1.DATA) - KEYS(59 59) - VOLUMES(HUL001) - CYLINDERS(5) - SHAREOPTIONS(4 3) - RECORDSIZE(4000 4000) - CONTROLINTERVALSIZE(22528)) - INDEX - (NAME(HULFT.LOG.PATH1.IDX) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3)) - CATALOG(USERCAT) DEFINE CLUSTER - (NAME(HULFT.LOG.PATH2) - INDEXED - REUSE) - DATA - (NAME(HULFT.LOG.PATH2.DATA) - KEYS(9 118) - VOLUMES(HUL001) - CYLINDERS(5) - SHAREOPTIONS(4 3) - RECORDSIZE(4000 4000) - CONTROLINTERVALSIZE(22528)) - INDEX - (NAME(HULFT.LOG.PATH2.IDX) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3)) - CATALOG(USERCAT) \**------< FILE CREATE >--------------------------------------- \XRCREATE EX XRCREATE,RSIZE=2048K \ FD STEPCAT=DA,FILE=USERCAT \ 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=DUMMY \ FD XRHOST=DUMMY \ FD XRQUE=DUMMY \ FD XRCNTL=DUMMY \ FD XROPLC1=DUMMY \ FD XROPLC2=DUMMY \ FD XROPLF1=DUMMY \ FD XROPLF2=DUMMY \**------< LOGCNT >--------------------------------------- \XRLOGCNT EX XRLOGCNT,RSIZE=2048K \ FD PRGLIB=DA,FILE=HULFT.LOAD \ FD CF=DA,FILE=C.ALIB \ FD STEPCAT=DA,FILE=USERCAT \ 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 LIST=DA,VOL=WORK,TRK=(10,10),SOUT=A \ FD XRCRD=* LOGCNT=ALL \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
PRGLIB |
HULFT.LOAD |
HULFTロードモジュールライブラリ |
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRLOG |
HULFT.LOG |
集配信履歴ファイルIDキーファイル |
XRLOG1 |
HULFT.LOG.PATH1 |
集配信履歴ホスト名キーファイル |
XRLOG2 |
HULFT.LOG.PATH2 |
集配信履歴日付キーファイル |
パラメータ名 |
項目名 |
説明 |
---|---|---|
VOLUMES |
HUL001 |
ボリューム名 |
CATALOG |
USERCAT |
カタログ簿データセット名 |
NAME |
HULFT.LOG |
集配信履歴ファイルIDキーファイル |
NAME |
HULFT.LOG.DATA |
集配信履歴ファイルIDキーファイル データ・コンポーネント エントリ名 |
NAME |
HULFT.LOG.IDX |
集配信履歴ファイルIDキーファイル インデックス・コンポーネント エントリ名 |
NAME |
HULFT.LOG.PATH1 |
集配信履歴ホスト名キーファイル |
NAME |
HULFT.LOG.PATH1.DATA |
集配信履歴ホスト名キーファイル データ・コンポーネント エントリ名 |
NAME |
HULFT.LOG.PATH1.IDX |
集配信履歴ホスト名キーファイル インデックス・コンポーネント エントリ名 |
NAME |
HULFT.LOG.PATH2 |
集配信履歴日付キーファイル |
NAME |
HULFT.LOG.PATH2.DATA |
集配信履歴日付キーファイル データ・コンポーネント エントリ名 |
NAME |
HULFT.LOG.PATH2.IDX |
集配信履歴日付キーファイル インデックス・コンポーネント エントリ名 |
HULFT Ver.8のシステム制御ファイルの創成手順を、以下に示します。
HULFT JCLライブラリ内のメンバー名「CNTLVSAM」を修正して、実行してください。
また、作成したシステム制御ファイルは、システム動作環境設定に指定する必要があります。
詳細は、「(11) システム動作環境の設定について」を確認してください。
[JCL例]
\ JOB CNTLVSAM,LIST=(A,JS) \*-------< VSAM DEFINE CLUSTER >--------------------------------------* \CNTLVSAM EX KQCAMS \ FD STEPCAT=DA,FILE=USERCAT \ FD SYSPRINT=DA,TRK=(10,10),VOL=WORK,SOUT=A \ FD SYSIN=* DELETE HULFT.SYSCNTL DEFINE CLUSTER - (NAME(HULFT.SYSCNTL) - INDEXED) - DATA - (NAME(HULFT.SYSCNTL.DATA) - KEYS(52 0) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3) - RECORDSIZE(400 400) - CONTROLINTERVALSIZE(18432)) - INDEX - (NAME(HULFT.SYSCNTL.IDX) - VOLUMES(HUL001) - CYLINDERS(1) - SHAREOPTIONS(4 3)) - CATALOG(USERCAT) \*-------< FILE CREATE >--------------------------------------* \XRCREATE EX XRCREATE,RSIZE=2048K \ FD STEPCAT=DA,FILE=USERCAT \ FD XRLOG=DUMMY \ FD XRLOG1=DUMMY \ FD XRLOG2=DUMMY \ FD XRFILE=DUMMY \ FD XRHOST=DUMMY \ FD XRQUE=DUMMY \ FD XRCNTL=DA,FILE=HULFT.SYSCNTL,AMP=AMORG \ FD XROPLC1=DUMMY \ FD XROPLC2=DUMMY \ FD XROPLF1=DUMMY \ FD XROPLF2=DUMMY \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRCNTL |
HULFT.SYSCNTL |
システム制御ファイル |
パラメータ名 |
項目名 |
説明 |
---|---|---|
VOLUMES |
HUL001 |
ボリューム名 |
CATALOG |
USERCAT |
カタログ簿データセット名 |
NAME |
HULFT.SYSCNTL |
システム制御ファイルIDキーファイル |
NAME |
HULFT.SYSCNTL.DATA |
システム制御ファイルIDキーファイル データ・コンポーネント エントリ名 |
NAME |
HULFT.SYSCNTL.IDX |
システム制御ファイルIDキーファイル インデックス・コンポーネント エントリ名 |
(5) 操作ログファイルの創成
操作ログ出力機能を使用する場合、操作ログファイルを創成してください。
HULFTでは、操作ログファイルとして、以下の2種類のファイル(VSAM)が必要となります。
-
ファイルアクセスログファイル
-
コマンド実行ログファイル
JCL例
このJCLを、ユーザの環境に合わせて内容(ファイル名、ボリューム通番、容量など)を変更した後、実行すると上記2種類の操作ログファイルを創成できます。
容量については、「VSAMファイルの容量計算」を参照してください。
システムファイルの初期化プログラム(XRCREATE)を使用して、創成した操作ログファイルの初期化処理を必ず実行してください。
創成用の雛形JCL : HULFT.JCL(OPLVSAM)
\ JOB OPLVSAM,LIST=(A,JS) \*-------< VSAM DEFINE CLUSTER >--------------------------------------* \OPLVSAM EX KQCAMS \ FD STEPCAT=DA,FILE=USERCAT \ FD SYSPRINT=DA,TRK=(10,10),VOL=WORK,SOUT=A \ FD SYSIN=* DELETE HULFT.OPLFILE1 DELETE HULFT.OPLFILE2 DELETE HULFT.OPLCMD1 DELETE HULFT.OPLCMD2 DEFINE CLUSTER - (NAME(HULFT.OPLFILE1) - NUMBERED) - DATA - (NAME(HULFT.OPLFILE1.DATA) - VOLUMES(HUL001) - CYLINDERS(30 0) - SHAREOPTIONS(4 3) - RECORDSIZE(2048 2048) - CONTROLINTERVALSIZE(8192)) DEFINE CLUSTER - (NAME(HULFT.OPLFILE2) - NUMBERED) - DATA - (NAME(HULFT.OPLFILE2.DATA) - VOLUMES(HUL001) - CYLINDERS(30 0) - SHAREOPTIONS(4 3) - RECORDSIZE(2048 2048) - CONTROLINTERVALSIZE(8192)) DEFINE CLUSTER - (NAME(HULFT.OPLCMD1) - NUMBERED) - DATA - (NAME(HULFT.OPLCMD1.DATA) - VOLUMES(HUL001) - CYLINDERS(30 0) - SHAREOPTIONS(4 3) - RECORDSIZE(2048 2048) - CONTROLINTERVALSIZE(8192)) DEFINE CLUSTER - (NAME(HULFT.OPLCMD2) - NUMBERED) - DATA - (NAME(HULFT.OPLCMD2.DATA) - VOLUMES(HUL001) - CYLINDERS(30 0) - SHAREOPTIONS(4 3) - RECORDSIZE(2048 2048) - CONTROLINTERVALSIZE(8192)) \*-------< FILE CREATE >--------------------------------------* \XRCREATE EX XRCREATE,RSIZE=2048K \ FD STEPCAT=DA,FILE=USERCAT \ FD XRLOG=DUMMY \ FD XRLOG1=DUMMY \ FD XRLOG2=DUMMY \ FD XRFILE=DUMMY \ FD XRHOST=DUMMY \ FD XRQUE=DUMMY \ FD XRCNTL=DUMMY \ FD XROPLC1=DA,FILE=HULFT.OPLCMD1,AMP=AMORG,DISP=LOCK \ FD XROPLC2=DA,FILE=HULFT.OPLCMD2,AMP=AMORG,DISP=LOCK \ FD XROPLF1=DA,FILE=HULFT.OPLFILE1,AMP=AMORG,DISP=LOCK \ FD XROPLF2=DA,FILE=HULFT.OPLFILE2,AMP=AMORG,DISP=LOCK \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XROPLC1 |
HULFT.OPLCMD1 |
コマンド実行ログファイル1 |
XROPLC2 |
HULFT.OPLCMD2 |
コマンド実行ログファイル2 |
XROPLF1 |
HULFT.OPLFILE1 |
ファイルアクセスログファイル1 |
XROPLF2 |
HULFT.OPLFILE2 |
ファイルアクセスログファイル2 |
パラメータ名 |
項目名 |
説明 |
---|---|---|
VOLUMES |
HUL001 |
ボリューム名 |
CATALOG |
USERCAT |
カタログ簿データセット名 |
NAME |
HULFT.OPLCMD1 |
コマンド実行ログファイル1 |
NAME |
HULFT.OPLCMD1.DATA |
コマンド実行ログファイル1 データ・コンポーネント エントリ名 |
NAME |
HULFT.OPLCMD2 |
コマンド実行ログファイル2 |
NAME |
HULFT.OPLCMD2.DATA |
コマンド実行ログファイル2 データ・コンポーネント エントリ名 |
NAME |
HULFT.OPLFILE1 |
ファイルアクセスログファイル1 |
NAME |
HULFT.OPLFILE1.DATA |
ファイルアクセスログファイル1 データ・コンポーネント エントリ名 |
NAME |
HULFT.OPLFILE2 |
ファイルアクセスログファイル2 |
NAME |
HULFT.OPLFILE2.DATA |
ファイルアクセスログファイル2 データ・コンポーネント エントリ名 |
操作ログ出力先のVSAMファイルを初期化する場合は、FD文でDISP=LOCKを必ず指定してください。
(6) システムファイルのコンバート
HULFT Ver.6のシステムファイルを、HULFT Ver.8で使用できるようにコンバートする手順を以下に示します。
a) 集配信管理ファイルと詳細ホスト情報ファイルのコンバート
HULFT Ver.6の集配信管理ファイルと詳細ホスト情報ファイルを、HULFT Ver.8で使用できるようにコンバートします。HULFT JCLライブラリ内のメンバ名「XRFILCNV」を修正して実行してください。
[JCL例]
\ JOB XRFILCNV,LIST=(A,JS) \XRFILCNV EX XRFILCNV,RSIZE=2048K \ PARA V6,HULCHARSET=A \ FD PRGLIB=DA,FILE=HULFT.LOAD \ FD CF=DA,FILE=C.ALIB \ FD STEPCAT=DA,FILE=USERCAT \ FD XRBKUP=DA,FILE=HULFT.FILE.BKUP \ FD XRBKUP2=DA,FILE=HULFT.HOST.BKUP \ FD XRFILE=DA,FILE=HULFT.FILE,AMP=AMORG \ FD XRHOST=DA,FILE=HULFT.HOST,AMP=AMORG \ FD LIST=DA,VOL=WORK,TRK=(10,10),SOUT=A \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
PRGLIB |
HULFT.LOAD |
HULFTロードモジュールライブラリ |
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRBKUP |
HULFT.FILE.BKUP |
集配信管理ファイル(バックアップファイル) |
XRBKUP2 |
HULFT.HOST.BKUP |
詳細ホスト情報ファイル(バックアップファイル) |
XRFILE |
HULFT.FILE |
集配信管理ファイル |
XRHOST |
HULFT.HOST |
詳細ホスト情報ファイル |
-
バージョンアップ前のHULFTに存在しない管理情報の項目に対しては初期値が設定されます。
ただし、詳細ホスト情報のHULFT7通信モード(HUL7MODE)には、“Y(有効)”が設定されています。
相手ホストのHULFTがVer. 8.0.0以降の場合は、バージョンアップ後に必ず“N(無効)”に変更してください。
-
以下の項目について、HULFT8では初期値“0”を推奨していますが、バージョンアップ時には移行前の設定値を引き継ぎます。
-
配信管理情報の転送ブロック長(BLOCKLEN)
-
配信管理情報の転送ブロック数(BLOCKCNT)
必要に応じて、バージョンアップ後に設定値を変更してください。
-
PARA文の指定は省略できません。
b) 集配信履歴ファイルのコンバート
HULFT Ver.6の集配信履歴ファイルをHULFT Ver.8で使用できるようにコンバートします。
HULFT JCLライブラリ内のメンバ名「XRLOGCNV」を修正して、実行してください。
[JCL例]
\ JOB XRLOGCNV,LIST=(A,JS) \XRLOGCNV EX XRLOGCNV,RSIZE=4096K \ PARA V6,HULCHARSET=A \ FD STEPCAT=DA,FILE=USERCAT \ FD XRBKUP=DA,FILE=HULFT.LOG.BKUP \ 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 \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRBKUP |
HULFT.LOG.BKUP |
集配信履歴ファイル(バックアップファイル) |
XRLOG |
HULFT.LOG |
集配信履歴ファイルIDキーファイル |
XRLOG1 |
HULFT.LOG.PATH1 |
集配信履歴ホスト名キーファイル |
XRLOG2 |
HULFT.LOG.PATH2 |
集配信履歴日付キーファイル |
-
PARA文の指定は省略できません。
-
再度集配信履歴コンバート(XRLOGCNV)を実施する場合、集配信履歴ファイルを創成しなおしてください。
c) 集配信履歴ファイルの履歴件数情報の付加
集配信履歴ファイルをHULFT Ver.8で使用できるように、履歴件数情報を付加します。HULFT JCLライブラリ内のメンバ名「XRLOGCNT」を修正して実行してください。
[JCL例]
\ JOB XRLOGCNT,LIST=(A,JS) \XRLOGCNT EX XRLOGCNT,RSIZE=2048K \ FD PRGLIB=DA,FILE=HULFT.LOAD \ FD CF=DA,FILE=C.ALIB \ FD STEPCAT=DA,FILE=USERCAT \ 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 LIST=DA,VOL=WORK,TRK=(10,10),SOUT=A \ FD XRCRD=* LOGCNT=ALL \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
PRGLIB |
HULFT.LOAD |
HULFTロードモジュールライブラリ |
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRLOG |
HULFT.LOG |
集配信履歴ファイルIDキーファイル |
XRLOG1 |
HULFT.LOG.PATH1 |
集配信履歴ホスト名キーファイル |
XRLOG2 |
HULFT.LOG.PATH2 |
集配信履歴日付キーファイル |
(7) 外字変換出口ルーチンのコンバート
外字変換出口ルーチンを作成している場合は、外字変換出口ルーチンのロードモジュールからコンバート作業を行う必要があります。外字テーブルを使用している場合、この作業は不要です。「(8) 外字テーブルの作成または復元」へ進んでください。
外字変換出口ルーチンをユーザライブラリに作成している場合は、そのモジュールを使用してください。
HULFTのロードモジュールライブラリに格納している場合は、「バージョンアップの準備」で作成したバックアップを使用してコンバート作業を行います。
HULFT8では、外字変換出口ルーチンを使用した外字変換をサポートしていません。
以下のコンバート作業を行って、外字変換出口ルーチンで登録されていた外字を外字テーブルへ移行してください。
以下の外字変換出口ルーチンモジュールに外字を登録している場合は、b) およびc) の処理を、登録されている外字変換出口ルーチンモジュールごとに行う必要があります。
[外字変換出口ルーチンモジュール]
-
XRETJEXT
-
XRHTJEXT
-
XRITJEXT
-
XRJTEEXT
-
XRJTHEXT
-
XRJTIEXT
-
XRJTSEXT
-
XRSTJEXT
HULFTの外字変換出口モジュールに登録されている外字の定義を抽出します。抽出された結果はXRCRDに指定したファイルに格納されます。
HULFT JCLライブラリ内のメンバ名「XRTBLCNV」を修正し、作業を実施してください。
[JCL例]
\ JOB XRTBLCNV,LIST=(A,JS) \XRTBLCNV EX XRTBLCNV,RSIZE=4096K \ PARA XRJTSEXT,DEFAULT=81A0 \ FD PRGLIB=DA,FILE=HULFT.LOAD \ FD CF=DA,FILE=C.ALIB \ FD STEPCAT=DA,FILE=USERCAT \ FD XREXTLIB=DA,FILE=HULFT.LOAD \ FD XRCRD=DA,FILE=HULFT.GAIJI.TBL,VOL=HUL001, C CYL=(5,3),DISP=CAT \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
PRGLIB |
HULFT.LOAD |
HULFTロードモジュールライブラリ |
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XREXTLIB |
HULFT.LOAD |
HULFT Ver.6外字出口ルーチン格納ライブラリ |
XRCRD |
HULFT.GAIJI.TBL |
HULFT Ver.8用定義体生成カード |
パラメータ名 |
項目名 |
説明 |
---|---|---|
PARM |
XRJTSEXT |
a) の対象モジュール |
DEFAULT |
81A0 |
特定の文字 |
VOL |
HUL001 |
ボリューム名 |
定義体生成カードのファイル属性は以下のとおりです。
属性 |
|||
---|---|---|---|
編成 |
レコード形式 |
レコード長 |
ブロック長 |
PS |
FB |
80 |
6160 |
下位バージョンの外字変換出口ルーチンで、指定されていない文字を特定の文字に変換するように設定していた場合は、その特定の文字をEXECパラメータの「,DEFAULT=XXXX」で指定してください(XXXXは特定の文字の文字コードを表す4桁の16進数)。
「,DEFAULT=XXXX」を指定しなかった場合、XRTBLCNVによって文字コードが0x0000~0xFFFFまでのパラメータカードが作成されてしまい、生成処理に時間がかかってしまう場合があります。
b) の処理で作成された外字の定義をHULFT Ver.8のロードモジュールに登録します。
HULFT JCLライブラリ内のメンバ名「XRECTBL」を修正し、作業を実施してください。
登録方法、外字テーブルの使用方法の詳細は、「アドミニストレーション マニュアル」を参照してください。
[JCL例]
\ JOB XRECTBL,LIST=(A,JS),TIME=2 \XRECTBL EX XRECTBL,RSIZE=1024K,OPT=DUMP \ FD PRGLIB=DA,FILE=HULFT.LOAD \ FD CF=DA,FILE=C.ALIB \ FD STEPCAT=DA,FILE=USERCAT \ FD XRSYSIN=DA,FILE=HULFT.PARMLIB,MEMBER=HULPRM \ FD SLIB=DA,VOL=WORK,TRK=(30,10) \ FD MLIB=DA,FILE=SYS.SYSTEM.MACLIB \ FD U01=DA,VOL=WORK,TRK=(30,10) \ FD U02=DA,VOL=WORK,TRK=(30,10) \ FD U03=DA,VOL=WORK,TRK=(30,10) \ FD RLIB=DA,VOL=WORK,TRK=(10,10),DISP=CONT \ FD PUNCH=DA,VOL=WORK,TRK=(10,10),DISP=CONT \ FD SORTWK01=DA,VOL=WORK,TRK=(30,10) \ FD LIST=DA,VOL=WORK,TRK=(20,20),SOUT=A \ FD ELIB=DA,FILE=HULFT.LOAD \ FD ALIB=DA,FILE=HULFT.LOAD \ FD XRCRD=DA,FILE=HULFT.GAIJI.TBL \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
PRGLIB |
HULFT.LOAD |
HULFTロードモジュールライブラリ |
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XRSYSIN |
HULFT.PARMLIB(HULPRM) |
システム動作環境設定ファイル |
ELIB |
HULFT.LOAD |
導入したHULFT Ver.8のHULFTロードモジュール格納ライブラリ |
ALIB |
HULFT.LOAD |
導入したHULFT Ver.8のHULFTロードモジュール格納ライブラリ |
XRCRD |
HULFT.GAIJI.TBL |
b)で作成したHULFT Ver.8用定義体生成カード |
パラメータ名 |
項目名 |
説明 |
---|---|---|
OBJOUT |
HULFT.LOAD |
オブジェクトプログラム出力先FD名 |
d) 使用していた外字変換出口ルーチンのカード生成例
RO EQU 0 R1 EQU 1 R2 EQU 2 R3 EQU 3 R4 EQU 4 R5 EQU 5 R6 EQU 6 R7 EQU 7 R8 EQU 8 R9 EQU 9 R10 EQU 10 R11 EQU 11 R12 EQU 12 R13 EQU 13 R14 EQU 14 R15 EQU 15 XRJTSEXT CSECT XRJTSEXT AMODE 31 XRJTSEXT RMODE 24 USING XRJTSEXT,R15 B LINKPROG DC AL1(LINKPROG-*-1) DC C'V50000 ' DC C'GAIJI ',C'SSSSSS &SYSDATE &SYSTIME ' LINKPROG DS 0H STM R14,R12,12(R13) LR R12,R15 LR R11,R12 LA R11,2048(R11) LA R11,2048(R11) LR R10,R11 LA R10,2048(R10) LA R10,2048(R10) DROP R15 USING XRJTSEXT,R12,R11,R10 * * A setup of the base address of linkage area L R9,0(R1) USING LNKAREA,R9 * * An External character conversion table is searched LA R15,KNJTBL KNJSRCH DS 0H CLC 0(2,R15),LNKKNJ BE GIJSET CLC 0(2,R15),=X'FFFF' BE TBLEND LA R15,4(R15) B KNJSRCH * * Processing when existing in an External character conversion table GIJSET DS 0H MVC LNKKNJ,2(R15) LA R15,4 B RETURN * * Processing when not existing in an External character conversion table TBLEND DS 0H XR R15,R15 B RETURN * * Returns to a parent program RETURN DS 0H RETURN (14,12),,RC=(15) * * External character conversion table Area KNJTBL DS 0F * IBM SHIFT-JIS DC XL4'41F18754' * 41F1 8754 DC XL4'41F28755' * 41F2 8755 DC XL4'41F38756' * 41F3 8756 DC XL4'41F48757' * 41F4 8757 DC XL4'41F58758' * 41F5 8758 DC XL4'41F68759' * 41F6 8759 DC XL4'41F7875A' * 41F7 875A DC XL4'41F8875B' * 41F8 875B DC XL4'41F9875C' * 41F9 875C DC XL4'41FA875D' * 41FA 875D DC XL4'FFFFFFFF' * TABLE END ORG KNJTBL * KNJCNVB DS CL2 * KNJCNVA DS CL2 * ORG LTORG * * Linkage area with a parent program LNKAREA DSECT LNKKNJ DS CL2 LNKWRK DS CL8 END
[定義体生成カードの作成時のJCL例]
\ JOB XRTBLCNV,LIST=(A,JS) \XRTBLCNV EX XRTBLCNV,RSIZE=4096K \ PARA XRJTSEXT,DEFAULT=81A0 \ FD PRGLIB=DA,FILE=HULFT.LOAD \ FD CF=DA,FILE=C.ALIB \ FD STEPCAT=DA,FILE=USERCAT \ FD XREXTLIB=DA,FILE=HULFT.LOAD \ FD XRCRD=DA,FILE=HULFT.GAIJI.TBL,VOL=HUL001, C CYL=(5,3),DISP=CAT \ JEND
FD名 |
項目名 |
説明 |
---|---|---|
PRGLIB |
HULFT.LOAD |
HULFTロードモジュールライブラリ |
STEPCAT |
USERCAT |
カタログ簿データセット名 |
XREXTLIB |
HULFT.LOAD.BKUP |
HULFT Ver.6外字変換出口ルーチン格納ライブラリ |
XRCRD |
HULFT.GAIJI.TBL |
HULFT Ver.8用定義体生成カード |
パラメータ名 |
項目名 |
説明 |
---|---|---|
DEFAULT |
81A0 |
特定の文字 |
VOL |
HUL001 |
ボリューム名 |
前述の処理を実行するとファイル「HULFT.GAIJI.TBL」に以下のカードが作成されます。
JTSTBL DEFAULT 81A0 41F1 8754 41F2 8755 41F3 8756 41F4 8757 41F5 8758 41F6 8759 41F7 875A 41F8 875B 41F9 875C 41FA 875D END
外字テーブルを使用している場合、バージョンアップ後に外字テーブルを使用できるようにします。
以下のいずれかの方法で外字テーブルを使用可能にします。
外字変換出口ルーチンを作成している場合、この作業は不要です。
-
HULFT8では、外字変換出口ルーチンを使用した外字変換をサポートしていません。
-
HULFT Ver.6.0.3未満で作成された外字テーブルを使用していて、バージョンアップ後にシステム動作環境設定の外字テーブル使用(GAIJIFILE)を“1”に設定する場合、b) の手順で作成してください。
外字テーブルの使用方法については「アドミニストレーション マニュアル」を参照してください。
モジュール入れ替え作業で、以下のいずれかを行った場合、使用していた外字テーブルを復元または作成する必要があります。
-
HULFTロードモジュールライブラリを新規作成
-
HULFTロードモジュールライブラリ内のメンバ全削除
a) バックアップしたHULFTロードモジュールから復元する方法
バージョンアップの準備作業で作成したHULFTロードモジュールのバックアップから、外字テーブルを復元してください。復元する外字テーブルについては、以下の外字テーブル一覧を参照してください。
入力コード |
出力コード |
外字テーブル名 |
---|---|---|
JEF |
Shift-JIS |
JTSTBL |
JEF |
EUC-JP |
JTETBL |
JEF |
IBM漢字 |
JTITBL |
JEF |
KEIS |
JTKTBL |
JEF |
NEC漢字 |
JTNTBL |
Shift-JIS |
JEF |
STJTBL |
EUC-JP |
JEF |
ETJTBL |
IBM漢字 |
JEF |
ITJTBL |
KEIS |
JEF |
KTJTBL |
NEC漢字 |
JEF |
NTJTBL |
(9) EBCDICユーザテーブルの再作成
バージョンアップ前の環境でEBCDICユーザテーブルを作成していた場合は、「バージョンアップの準備」の「(4) EBCDICユーザテーブルの確認」の一覧に示されているメンバー名を修正した後の雛形JCLを使用して、新しくEBCDICユーザテーブルを作成してください。
EBCDICユーザテーブルの組み込みの詳細は、「アドミニストレーション マニュアル」を参照してください。
バージョンアップ前の環境で使用していたEBCDICユーザテーブル雛形JCLは使用できません。必ず提供媒体から復元したEBCDICユーザテーブル雛形JCLを使用してください。
(10) HULFT管理画面とHULFT AIFコマンドを使用するための設定
HULFT管理画面とHULFT AIFコマンドを使用するために必要な設定を行います。
a) ヘルプメッセージの登録
簡易転送配信要求コマンドを使用する場合、「ヘルプメッセージの登録」を参照し、ヘルプメッセージを登録してください。
b) プロシジャの変更
運用に合わせ、以下のどちらかの設定を行ってください。
HULFT Ver.6のシステム動作環境設定ファイル(HULPRM)を参照し、HULFT Ver.8のシステム動作環境設定ファイル(HULPRM)を編集してください。
HULFTの新機能を使用するためには、各設定が正しく指定されている必要があります。
特に電文転送タイプ(PROCTRANSTYPE)を設定して転送速度優先モードを使用する場合には注意が必要です。転送速度優先モードを使用すると、TISPのバッファ不足により通信エラーが発生する可能性があります。転送速度優先モードを使用する場合は「TISP環境設定」を参照し、TISPの設定を行ってください。HULFT Ver.6と同様の動作をさせたい場合は、電文転送タイプ(PROCTRANSTYPE)で異常検知優先モードを設定してください。
システム動作環境の設定については「アドミニストレーション マニュアル」を参照してください。
-
HULFTの各常駐プログラムの実行(PARA文)パラメータで指定していた一部のパラメータが、Ver.8.4.0以降、システム動作環境設定で設定できるようになりました。システム動作環境設定に追加された項目を確認し、実行(PARA文)パラメータではなく、システム動作環境設定で設定するように変更してください。システム動作環境設定に追加された項目については、「アドミニストレーション マニュアル」を参照してください。
-
高強度暗号強制モードの設定方法は、「高強度暗号強制モードを使用する場合の作業」を参照してください。
-
以下で作成したシステム制御ファイルは、システム制御ファイル名(CONTROL-FILE)に必ず指定してください。
(12) 製品情報の登録
HULFTが動作するように、システム動作環境設定ファイル(HULPRM)にシリアル番号およびプロダクトキーの登録を行います。登録方法は、「製品情報の登録」を参照してください。
(13) 機密保護機能(RACF)へのユーザIDおよびパスワードの登録
HULFT Ver.7以降では、HULFT Managerから接続する際のユーザ認証に、機密保護機能(RACF:Resource Access Control Facility)の機能を利用して、AIF(Advanced Interactive processing Facility)に登録したユーザIDおよびパスワードを使用できるようになりました。
機密保護機能(RACF)およびAIFは、OSIV/XSPから提供される機能です。
ユーザの運用に応じて従来のユーザ定義ファイルを使用する方法と、RACFおよびAIFを使用する方法のどちらかを選択できます。
この指定は、システム動作環境設定ファイルのユーザID・パスワードチェック(USRIDCHKMODE)で設定できます。詳細は、「アドミニストレーション マニュアル」のシステム動作環境設定ファイルの説明を参照してください。
HULFT Ver.8からRACFおよびAIFを使用する方法に切り替える場合は、RACFが稼動中の旧バージョンの運用環境でユーザ定義ファイルに登録していたユーザIDとパスワードの指定内容を、AIFに追加登録する必要があります。要求受付プログラム(XRACCPT)の起動JCLのユーザ定義ファイル(FD名:XRPASSWD)の定義を確認し、ユーザIDとパスワードの内容をAIFに登録してください。ユーザ定義ファイルの詳細は、「アドミニストレーション マニュアル」のHULFT Managerサービスの設定の説明を参照してください。
(14) 要求受付定義ファイルの編集
HULFT Ver.6の要求受付定義ファイル(HULAPT)を参照し、HULFT Ver.8の要求受付定義ファイル(HULAPT)を編集してください。
要求受付定義ファイルを編集する際、HULFT Ver.6の要求受付定義ファイルに定義されていないサービスがあっても削除しないでください。
要求受付定義ファイルの編集方法は、「アドミニストレーション マニュアル」を参照してください。
続いて、「バージョンアップに伴うJCLの変更」の作業を行ってください。