# HULFT Ver.7からのバージョンアップ

## 新リリースの復元

以下のJCL例1を修正して実行することで、「提供媒体からの復元手順」で復元したHULFT導入用ファイルのHULFT JCLライブラリー（HULFT.V10.JCL）から、既存のHULFT JCLライブラリー（HULFT.JCL）にメンバー名「VERUP7」を復元してください。

［JCL例1］

    //INSTALL  JOB CLASS=A,MSGCLASS=B
    //*
    //JCLGEN   EXEC PGM=IEBCOPY
    //IN       DD DSN=HULFT.V10.JCL,DISP=SHR
    //OUT      DD DSN=HULFT.JCL,DISP=SHR
    //SYSUT3   DD UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSUT4   DD UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSPRINT DD SYSOUT=*
    //SYSIN    DD *
        COPY OUTDD=OUT,INDD=((IN,R))
        SELECT M=(VERUP7)

DD名 | 項目名 | 説明
--- | --- | ---
IN | HULFT.V10.JCL | HULFT JCLライブラリー（HULFT導入用ファイル）
OUT | HULFT.JCL | HULFT JCLライブラリー（導入先ファイル）

パラメーター名 | 項目名 | 説明
--- | --- | ---
UNIT | SYSDA | UNIT

復元した「VERUP7」をJCL例2に示します。このJCLを修正して実行することで、HULFT導入用ファイルから以下のライブラリーの新リリースを既存のライブラリーに上書きインストールします。

- HULFT JCL ライブラリー

- HULFT ロードモジュールライブラリー

- HULFT ISPFパネルライブラリー

- HULFT ISPFメッセージライブラリ

- HULFTパラメーターライブラリー

なお、HULFTロードモジュールライブラリーは再作成が必要となります。

［HULFTロードモジュールライブラリー（HULFT.LOAD）の再作成］

HULFTロードモジュールライブラリーのDSNTYPEの形式を変更します。

HULFT10より、HULFTロードモジュールライブラリーは、PDSEデータセットに格納する必要があります。

今まで利用していたHULFTロードモジュールライブラリーを任意の名前にリネームしバックアップしてください。

新規で作成されるHULFTロードモジュールライブラリーは以下の属性になります。

表9.1 属性

容量（CYL） | 属性
--- | ---
初期分 | 編成 | レコード形式 | レコード長 | ブロック長 | DSNTYPE
50 | PO | U | 0 | 19069 | LIBRARY

「VERUP7」の［JCL例2］を実行すると、HULFTロードモジュールライブラリーを再作成します。

［JCL例2］

    //VERUP    JOB  CLASS=A,MSGCLASS=B
    //*
    //JCLGEN   EXEC PGM=IEBCOPY
    //IN       DD   DSN=HULFT.V10.JCL,DISP=SHR
    //OUT      DD   DSN=HULFT.JCL,DISP=SHR
    //SYSUT3   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSUT4   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
        COPY   OUTDD=OUT,INDD=((IN,R))
        SELECT M=(BACKUP7,BACKUP8,BACKUP10)
        SELECT M=(HULVSAM,LOGVSAM,QUEVSAM,FILEVSAM,HOSTVSAM)
        SELECT M=(XRHULVER,XRFILCNV,XRLOGCNV)
        SELECT M=(XREBCASC,XRASCEBC,XREBCEUC)
        SELECT M=(XREUCEBC,XRSJSCNV,XREUCCNV)
        SELECT M=(OPLVSAM,CNTLVSAM,XRCREATE)
        SELECT M=(HULSNDGO)
        SELECT M=(SMPJOBAP,SMPLOGAP,SMPRCVAP,SMPSNDAP,SMPHSAP)
        SELECT M=(XRHSMVFY)
    //PNLGEN   EXEC PGM=IEBCOPY
    //IN       DD   DSN=HULFT.V10.JPN.PANEL,DISP=SHR
    //OUT      DD   DSN=HULFT.PANEL,DISP=SHR
    //SYSUT3   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSUT4   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
        COPY   OUTDD=OUT,INDD=((IN,R))
    //*
    //MSGGEN   EXEC PGM=IEBCOPY
    //IN       DD   DSN=HULFT.V10.JPN.MSG,DISP=SHR
    //OUT      DD   DSN=HULFT.MSG,DISP=SHR
    //SYSUT3   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSUT4   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
        COPY   OUTDD=OUT,INDD=((IN,R))
    //*
    //PARMGEN  EXEC PGM=IEBCOPY
    //IN       DD   DSN=HULFT.V10.PARMLIB,DISP=SHR
    //OUT      DD   DSN=HULFT.PARMLIB,UNIT=SYSDA,DISP=SHR
    //SYSUT3   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSUT4   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
        COPY   OUTDD=OUT,INDD=((IN,R))
    //*
    //LOADGEN  EXEC PGM=IEBCOPY
    //IN       DD   DSN=HULFT.V10.LOAD,DISP=SHR
    //OUT      DD   DSN=HULFT.LOAD,UNIT=SYSDA,
    //             VOL=SER=HUL001,DSNTYPE=LIBRARY,
    //             DCB=(DSORG=PO,RECFM=U,LRECL=0,BLKSIZE=19069),
    //             DISP=(NEW,CATLG),SPACE=(CYL,(50))
    //SYSUT3   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSUT4   DD   UNIT=SYSDA,SPACE=(CYL,(5))
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
        COPY   OUTDD=OUT,INDD=IN
    //*
    //

DD名 | 項目名 | 説明
--- | --- | ---
IN | HULFT.V10.JCL | HULFT JCLライブラリー（HULFT導入用ファイル）
OUT | HULFT.JCL | HULFT JCLライブラリー（導入先ファイル）
IN | HULFT.V10.JPN.PANEL | HULFT ISPFパネルライブラリ（JPN HULFT導入用ファイル）
OUT | HULFT.PANEL | HULFT ISPFパネルライブラリ（導入先ファイル）
IN | HULFT.V10.JPN.MSG | HULFT ISPFメッセージライブラリ（JPN HULFT導入用ファイル）
OUT | HULFT.MSG | HULFT ISPFメッセージライブラリ（導入先ファイル）
IN | HULFT.V10.PARMLIB | HULFTパラメーターライブラリー（HULFT導入用ファイル）
OUT | HULFT.PARMLIB | HULFTパラメーターライブラリー（導入先ファイル）
IN | HULFT.V10.LOAD | HULFTロードモジュールライブラリー（HULFT導入用ファイル）
OUT | HULFT.LOAD | HULFTロードモジュールライブラリー（導入先ファイル）

パラメーター名 | 項目名 | 説明
--- | --- | ---
UNIT | SYSDA | UNIT

注意

- このJCLを実行すると、現在使用しているHULFTの環境が変更されます。以降の作業項目には、バックアップを使用して行う作業も含まれています。作業を行う前に、「HULFT Ver.7のバックアップ」に従いバックアップを必ず行ってください。

- HULFTロードモジュールライブラリーは、新規メンバーが増える場合があるため、既存ライブラリーで容量不足が発生する可能性があります。

## APF許可ライブラリーへの定義

APF許可ライブラリーへの定義方法は、「APF許可ライブラリーへの定義」を参照してください。

## HULFT Ver.10用システムファイルの創成

HULFT Ver.7の以下のファイルをHULFT Ver.10で使用できる形式に創成し直します。

- 集配信管理ファイル

- 詳細ホスト情報ファイル

- 配信制御ファイル

- 集配信履歴ファイル

- システム制御ファイル

容量については、「VSAMファイルの容量計算」を参照してください。

また、INDEX部の容量も再度計算が必要です。「キー長」を基に容量計算を行ってください。

各ファイルを創成する際は、あわせて初期化処理も行う必要があります。

### 集配信管理ファイルの創成

HULFT Ver.10の集配信管理ファイルの創成手順を以下に示します。

HULFT JCLライブラリー内のメンバー名「FILEVSAM」を修正して実行してください。

［JCL例］

    //FILEVSAM JOB  CLASS=A,MSGCLASS=B
    //*------< VSAM DEFINE CLUSTER >---------------------------------------
    //DEFCLSTR EXEC PGM=IDCAMS
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
         DELETE HULFT.FILE
         DEFINE CLUSTER                     -
                (NAME(HULFT.FILE)           -
                 INDEXED)                   -
                DATA                        -
                (NAME(HULFT.FILE.DATA)      -
                 KEYS(54 0)                 -
                 SHAREOPTIONS(4 3)          -
                 VOLUMES(HUL001)            -
                 CYLINDERS(1 1)             -
                 RECORDSIZE(610 22300))     -
                INDEX                       -
                (NAME(HULFT.FILE.IDX)       -
                 VOLUMES(HUL001)            -
                 CYLINDERS(1 1)             -
                 SHAREOPTIONS(4 3))
    //*------< FILE CREATE         >---------------------------------------
    //XRCREATE EXEC PGM=XRCREATE,REGION=1024K
    //STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR
    //XRLOG    DD   DUMMY
    //XRLOG1   DD   DUMMY
    //XRLOG2   DD   DUMMY
    //XRFILE   DD   DSN=HULFT.FILE,DISP=SHR
    //XRQUE    DD   DUMMY
    //XRHOST   DD   DUMMY
    //XRCNTL   DD   DUMMY
    //XROPLC1  DD   DUMMY
    //XROPLC2  DD   DUMMY
    //XROPLF1  DD   DUMMY
    //XROPLF2  DD   DUMMY
    //SYSUDUMP DD   SYSOUT=*
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRFILE | HULFT.FILE | 集配信管理ファイル

パラメーター名 | 項目名 | 説明
--- | --- | ---
VOLUMES | HUL001 | ボリューム名
CYLINDERS | (*1) | 容量
NAME | HULFT.FILE | 集配信管理ファイル
NAME | HULFT.FILE.DATA | 集配信管理ファイル データ・コンポーネント エントリー名
NAME | HULFT.FILE.IDX | 集配信管理ファイル インデックス・コンポーネント エントリー名

*1 | : | (一次要求量 増分量)

### 詳細ホスト情報ファイルの創成

HULFT Ver.10の詳細ホスト情報ファイルの創成手順を以下に示します。

HULFT JCLライブラリー内のメンバー名「HOSTVSAM」を修正して実行してください。

［JCL例］

    //HOSTVSAM JOB  CLASS=A,MSGCLASS=B
    //*------< VSAM DEFINE CLUSTER >---------------------------------------
    //DEFCLSTR EXEC PGM=IDCAMS
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
         DELETE HULFT.HOST
         DEFINE CLUSTER                     -
                (NAME(HULFT.HOST)           -
                 INDEXED)                   -
                DATA                        -
                (NAME(HULFT.HOST.DATA)      -
                 KEYS(51 0)                 -
                 SHAREOPTIONS(4 3)          -
                 VOLUMES(HUL001)            -
                 CYLINDERS(1 1)             -
                 RECORDSIZE(500 500))       -
                INDEX                       -
                (NAME(HULFT.HOST.IDX)       -
                 VOLUMES(HUL001)            -
                 CYLINDERS(1 1)             -
                 SHAREOPTIONS(4 3))
    //*------< FILE CREATE         >---------------------------------------
    //XRCREATE EXEC PGM=XRCREATE,REGION=1024K
    //STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR
    //XRLOG    DD   DUMMY
    //XRLOG1   DD   DUMMY
    //XRLOG2   DD   DUMMY
    //XRFILE   DD   DUMMY
    //XRQUE    DD   DUMMY
    //XRHOST   DD   DSN=HULFT.HOST,DISP=SHR
    //XRCNTL   DD   DUMMY
    //XROPLC1  DD   DUMMY
    //XROPLC2  DD   DUMMY
    //XROPLF1  DD   DUMMY
    //XROPLF2  DD   DUMMY
    //SYSUDUMP DD   SYSOUT=*
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRHOST | HULFT.HOST | 詳細ホスト情報ファイル

パラメーター名 | 項目名 | 説明
--- | --- | ---
VOLUMES | HUL001 | ボリューム名
CYLINDERS | (*1) | 容量
NAME | HULFT.HOST | 詳細ホスト情報ファイル
NAME | HULFT.HOST.DATA | 詳細ホスト情報ファイル データ・コンポーネント エントリー名
NAME | HULFT.HOST.IDX | 詳細ホスト情報ファイル インデックス・コンポーネント エントリー名

*1 | : | (一次要求量 増分量)

### 配信制御ファイルの創成

HULFT Ver.10の配信制御ファイルの創成手順を以下に示します。

HULFT JCLライブラリー内のメンバー名「QUEVSAM」を修正して実行してください。

［JCL例］

    //QUEVSAM  JOB  CLASS=A,MSGCLASS=B
    //*------< VSAM DEFINE CLUSTER >---------------------------------------
    //DEFCLSTR EXEC PGM=IDCAMS
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
         DELETE HULFT.QUEUE
         DEFINE CLUSTER                      -
                (NAME(HULFT.QUEUE)           -
                 INDEXED)                    -
                DATA                         -
                (NAME(HULFT.QUEUE.DATA)      -
                 KEYS(61 0)                  -
                 VOLUMES(HUL001)             -
                 CYLINDERS(1 1)              -
                 SHAREOPTIONS(4 3)           -
                 RECORDSIZE(7600 7600)       -
                 CONTROLINTERVALSIZE(26624)) -
                INDEX                        -
                (NAME(HULFT.QUEUE.IDX)       -
                 VOLUMES(HUL001)             -
                 CYLINDERS(1 1)              -
                 SHAREOPTIONS(4 3))
    //*------< FILE CREATE         >---------------------------------------
    //XRCREATE EXEC PGM=XRCREATE,REGION=1024K
    //STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR
    //XRLOG    DD   DUMMY
    //XRLOG1   DD   DUMMY
    //XRLOG2   DD   DUMMY
    //XRHOST   DD   DUMMY
    //XRFILE   DD   DUMMY
    //XRQUE    DD   DSN=HULFT.QUEUE,DISP=SHR
    //XRCNTL   DD   DUMMY
    //XROPLC1  DD   DUMMY
    //XROPLC2  DD   DUMMY
    //XROPLF1  DD   DUMMY
    //XROPLF2  DD   DUMMY
    //SYSUDUMP DD   SYSOUT=*
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRQUE | HULFT.QUEUE | 配信制御ファイル

パラメーター名 | 項目名 | 説明
--- | --- | ---
VOLUMES | HUL001 | ボリューム名
CYLINDERS | (*1) | 容量
NAME | HULFT.QUEUE | 配信制御ファイル
NAME | HULFT.QUEUE.DATA | 配信制御ファイル データ・コンポーネント エントリー名
NAME | HULFT.QUEUE.IDX | 配信制御ファイル インデックス・コンポーネント エントリー名

*1 | : | (一次要求量 増分量)

### 集配信履歴ファイルの創成

HULFT Ver.10の集配信履歴ファイルの創成手順を、以下に示します。

HULFT JCLライブラリー内のメンバー名「LOGVSAM」を修正して、実行してください。

［JCL例］

    //LOGVSAM  JOB  CLASS=A,MSGCLASS=B
    //*------< VSAM DEFINE CLUSTER >---------------------------------------
    //DEFCLSTR EXEC PGM=IDCAMS
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
         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 1)              -
                 SHAREOPTIONS(4 3)           -
                 RECORDSIZE(1600 1600)       -
                 CONTROLINTERVALSIZE(26624)) -
                INDEX                        -
                (NAME(HULFT.LOG.IDX)         -
                 VOLUMES(HUL001)             -
                 CYLINDERS(1 1)              -
                 SHAREOPTIONS(4 3))
         DEFINE CLUSTER                      -
                (NAME(HULFT.LOG.PATH1)       -
                 INDEXED                     -
                 REUSE)                      -
                DATA                         -
                (NAME(HULFT.LOG.PATH1.DATA)  -
                 KEYS(59 59)                 -
                 VOLUMES(HUL001)             -
                 CYLINDERS(5 1)              -
                 SHAREOPTIONS(4 3)           -
                 RECORDSIZE(1600 1600)       -
                 CONTROLINTERVALSIZE(26624)) -
                INDEX                        -
                (NAME(HULFT.LOG.PATH1.IDX)   -
                 VOLUMES(HUL001)             -
                 CYLINDERS(1 1)              -
                 SHAREOPTIONS(4 3))
         DEFINE CLUSTER                      -
                (NAME(HULFT.LOG.PATH2)       -
                 INDEXED                     -
                 REUSE)                      -
                DATA                         -
                (NAME(HULFT.LOG.PATH2.DATA)  -
                 KEYS(9 118)                 -
                 VOLUMES(HUL001)             -
                 CYLINDERS(5 1)              -
                 SHAREOPTIONS(4 3)           -
                 RECORDSIZE(1600 1600)       -
                 CONTROLINTERVALSIZE(26624)) -
                INDEX                        -
                (NAME(HULFT.LOG.PATH2.IDX)   -
                 VOLUMES(HUL001)             -
                 CYLINDERS(1 1)              -
                 SHAREOPTIONS(4 3))
    //*
    //*------< FILE CREATE         >---------------------------------------
    //XRCREATE EXEC PGM=XRCREATE,REGION=1024K
    //STEPLIB  DD   DSN=HULFT.LOAD,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
    //XRHOST   DD   DUMMY
    //XRFILE   DD   DUMMY
    //XRQUE    DD   DUMMY
    //XRCNTL   DD   DUMMY
    //XROPLC1  DD   DUMMY
    //XROPLC2  DD   DUMMY
    //XROPLF1  DD   DUMMY
    //XROPLF2  DD   DUMMY
    //SYSUDUMP DD   SYSOUT=*
    //*------< LOGCNT              >---------------------------------------
    //XRLOGCNT EXEC PGM=XRLOGCNT,REGION=1024K
    //STEPLIB  DD   DSN=HULFT.LOAD,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
    //XRCRD    DD   *
    LOGCNT=ALL
    //SYSOUT   DD   SYSOUT=*
    //SYSUDUMP DD   SYSOUT=*
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRLOG | HULFT.LOG | 集配信履歴ファイルIDキーファイル
XRLOG1 | HULFT.LOG.PATH1 | 集配信履歴ホスト名キーファイル
XRLOG2 | HULFT.LOG.PATH2 | 集配信履歴日付キーファイル

パラメーター名 | 項目名 | 説明
--- | --- | ---
VOLUMES | HUL001 | ボリューム名
CYLINDERS | (*1) | 容量
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 | 集配信履歴日付キーファイル インデックス・コンポーネント エントリー名

*1 | : | (一次要求量 増分量)

### システム制御ファイルの創成

HULFT Ver.10のシステム制御ファイルの創成手順を、以下に示します。

HULFT JCLライブラリー内のメンバー名「CNTLVSAM」を修正して、実行してください。

また、作成したシステム制御ファイルは、システム動作環境設定に指定する必要があります。

詳細は、「システム動作環境の設定について」を確認してください。

［JCL例］

    //CNTLVSAM JOB  CLASS=A,MSGCLASS=B
    //*------< VSAM DEFINE CLUSTER >---------------------------------------
    //DEFCLSTR EXEC PGM=IDCAMS
    //SYSPRINT DD   SYSOUT=*
    //SYSIN    DD   *
         DELETE HULFT.SYSCNTL
         DEFINE CLUSTER                      -
                (NAME(HULFT.SYSCNTL)         -
                 INDEXED)                    -
                DATA                         -
                (NAME(HULFT.SYSCNTL.DATA)    -
                 KEYS(52 0)                  -
                 VOLUMES(HUL001)             -
                 CYLINDERS(1 1)              -
                 SHAREOPTIONS(4 3)           -
                 RECORDSIZE(400 400)         -
                 CONTROLINTERVALSIZE(18432)) -
                INDEX                        -
                (NAME(HULFT.SYSCNTL.IDX)     -
                 VOLUMES(HUL001)             -
                 CYLINDERS(1 0)              -
                 SHAREOPTIONS(4 3))
    //*------< FILE CREATE         >---------------------------------------
    //XRCREATE EXEC PGM=XRCREATE,REGION=1024K
    //STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR
    //XRLOG    DD   DUMMY
    //XRLOG1   DD   DUMMY
    //XRLOG2   DD   DUMMY
    //XRHOST   DD   DUMMY
    //XRFILE   DD   DUMMY
    //XRQUE    DD   DUMMY
    //XRCNTL   DD   DSN=HULFT.SYSCNTL,DISP=SHR
    //XROPLC1  DD   DUMMY
    //XROPLC2  DD   DUMMY
    //XROPLF1  DD   DUMMY
    //XROPLF2  DD   DUMMY
    //SYSUDUMP DD   SYSOUT=*
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRCNTL | HULFT.SYSCNTL | システム制御ファイル

パラメーター名 | 項目名 | 説明
--- | --- | ---
VOLUME | HUL001 | ボリューム名
CYLINDERS | (*1) | 容量
NAME | HULFT.SYSCNTL | システム制御ファイル
NAME | HULFT.SYSCNTL.DATA | システム制御ファイル データ・コンポーネント エントリー名
NAME | HULFT.SYSCNTL.IDX | システム制御ファイル インデックス・コンポーネント エントリー名

*1 | : | (一次要求量 増分量)

## システムファイルのコンバート

HULFT Ver.7のシステムファイルを、HULFT Ver.10で使用できるようにコンバートする手順を以下に示します。

### 集配信管理ファイルと詳細ホスト情報ファイルのコンバート

HULFT Ver.7の集配信管理ファイルと詳細ホスト情報ファイルを、HULFT Ver.10で使用できるようにコンバートします。HULFT JCLライブラリー内のメンバー名「XRFILCNV」を修正して実行してください。

［JCL例］

    //XRFILCNV  JOB  CLASS=A,MSGCLASS=B
    //XRFILCNV  EXEC PGM=XRFILCNV,REGION=1024K,PARM='V7,HULCHARSET=939'
    //STEPLIB   DD   DSN=HULFT.LOAD,DISP=SHR
    //XRBKUP    DD   DSN=HULFT.FILE.BKUP,DISP=SHR
    //XRBKUP2   DD   DSN=HULFT.HOST.BKUP,DISP=SHR
    //XRFILE    DD   DSN=HULFT.FILE,DISP=SHR
    //XRHOST    DD   DSN=HULFT.HOST,DISP=SHR
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRBKUP | HULFT.FILE.BKUP | 集配信管理ファイル（バックアップファイル）(*1)
XRBKUP2 | HULFT.HOST.BKUP | 詳細ホスト情報ファイル（バックアップファイル）(*1)
XRFILE | HULFT.FILE | 集配信管理ファイル
XRHOST | HULFT.HOST | 詳細ホスト情報ファイル

パラメーター名 | 項目名 | 説明
--- | --- | ---
PARM= | V7 | 移行元HULFTのバージョン
HULCHARSET= | 939 | エミュレーターのCCSID（コード化文字セット識別コード）

*1 | : | 以下で作成したバックアップファイルを指定 「HULFT Ver.7のバックアップ」の「システムファイルのバックアップ」

= 備考 =

- バージョンアップ前のHULFTに存在しない管理情報の項目に対しては初期値が設定されます。

  ただし、詳細ホスト情報のHULFT7通信モード（HUL7MODE）には、“Y（有効）”が設定されています。

  相手ホストのHULFTがVer.8.0.0以降の場合は、バージョンアップ後に必ず“N（無効）”に変更してください。

- 以下の項目について、HULFT10では初期値“0”を推奨していますが、バージョンアップ時には移行前の設定値を引き継ぎます。

  - 配信管理情報の転送ブロック長（BLOCKLEN）

  - 配信管理情報の転送ブロック数（BLOCKCNT）

  必要に応じて、バージョンアップ後に設定値を変更してください。

### 集配信履歴ファイルのコンバート

HULFT Ver.7の集配信履歴ファイルをHULFT Ver.10で使用できるようにコンバートします。

HULFT JCLライブラリー内のメンバー名「XRLOGCNV」を修正して、実行してください。

［JCL例］

    //XRLOGCNV JOB  CLASS=A,MSGCLASS=B
    //XRLOGCNV EXEC PGM=XRLOGCNV,REGION=1024K,PARM='V7,HULCHARSET=939'
    //STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR
    //XRBKUP   DD   DSN=HULFT.LOG.BKUP,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
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRBKUP | HULFT.LOG.BKUP | 集配信履歴ファイル（バックアップファイル）(*1)
XRLOG | HULFT.LOG | 集配信履歴ファイルIDキーファイル
XRLOG1 | HULFT.LOG.PATH1 | 集配信履歴ホスト名キーファイル
XRLOG2 | HULFT.LOG.PATH2 | 集配信履歴日付キーファイル

パラメーター名 | 項目名 | 説明
--- | --- | ---
RARM= | V7 | 移行元HULFTのバージョン
HULCHARSET= | 939 | エミュレーターのCCSID（コード化文字セット識別コード）

*1 | : | 以下で作成したバックアップファイルを指定 「HULFT Ver.7のバックアップ」の「システムファイルのバックアップ」

注意

- PARM指定は省略できません。

- 再度集配信履歴コンバート（XRLOGCNV）を実施する場合、集配信履歴ファイルを創成し直してください。

### 集配信履歴ファイルの履歴件数情報の付加

集配信履歴ファイルをHULFT Ver.10で使用できるように、履歴件数情報を付加します。HULFT JCLライブラリー内のメンバー名「XRLOGCNT」を修正して実行してください。

［JCL例］

    //XRLOGCNT JOB  CLASS=A,MSGCLASS=B
    //*
    //XRLOGCNT EXEC PGM=XRLOGCNT,REGION=1024K
    //STEPLIB  DD   DSN=HULFT.LOAD,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
    //SYSOUT   DD   SYSOUT=*
    //XRCRD    DD   *
    LOGCNT=ALL
    //

DD名 | 項目名 | 説明
--- | --- | ---
STEPLIB | HULFT.LOAD | HULFTロードモジュールライブラリー
XRLOG | HULFT.LOG | 集配信履歴ファイルIDキーファイル
XRLOG1 | HULFT.LOG.PATH1 | 集配信履歴ホスト名キーファイル
XRLOG2 | HULFT.LOG.PATH2 | 集配信履歴日付キーファイル

## 外字テーブルの作成または復元

外字テーブルを使用している場合、バージョンアップ後に外字テーブルを使用できるようにします。

以下のいずれかの方法で外字テーブルを使用可能にします。

- バックアップしたHULFTロードモジュールから復元する方法（「バックアップしたHULFTロードモジュールから復元する方法」）

- 前回作成した外字テーブル生成用定義カードを使用する方法（「外字テーブル生成用定義カードを使用する方法」）

注意

- HULFT Ver.6から、外字変換は外字変換出口ルーチンを使用する方法から外字テーブルを使用する方法へ変更になりました。また、HULFT Ver.6以降、COBOLで作成した外字変換出口ルーチンは、サポートしません。

- HULFT Ver.6.0.3未満で作成された外字テーブルを使用していて、バージョンアップ後にシステム動作環境設定の外字テーブル使用（GAIJIFILE）を“1”に設定する場合、「外字テーブル生成用定義カードを使用する方法」の手順で作成してください。
  外字テーブルの使用方法については、以下を参照してください。

  HULFT10 for zOS アドミニストレーション マニュアル : 外字テーブルの使用方法

モジュール入れ替え作業で、以下のいずれかを行った場合、使用していた外字テーブルを復元または作成する必要があります。

- HULFTロードモジュールライブラリーを新規作成

- HULFTロードモジュールライブラリー内のメンバーを全削除

### バックアップしたHULFTロードモジュールから復元する方法

バージョンアップの準備作業で作成したHULFTロードモジュールのバックアップから、外字テーブルを復元してください。復元する外字テーブルについては、以下の外字テーブル一覧を参照してください。

表9.2 外字テーブル一覧

入力コード | 出力コード | 外字テーブル名
--- | --- | ---
IBM漢字 | Shift-JIS | ITSTBL
IBM漢字 | EUC-JP | ITETBL
IBM漢字 | JEF | ITJTBL
IBM漢字 | UTF-8 | ITU8TBL
Shift-JIS | IBM漢字 | STITBL
EUC-JP | IBM漢字 | ETITBL
JEF | IBM漢字 | JTITBL
UTF-8 | IBM漢字 | U8TITBL、U8TITBL2

### 外字テーブル生成用定義カードを使用する方法

バージョンアップ前の環境で作成した外字テーブル生成用定義カードを指定して外字テーブル登録プログラム（XRECTBL）を実行してください。

## EBCDICユーザーテーブルの再作成

バージョンアップ前の環境でEBCDICユーザーテーブルを作成していた場合は、「バージョンアップの準備」の「EBCDICユーザーテーブルの確認」の一覧に示されているメンバー名を修正した後の雛形JCLを使用して、新しくEBCDICユーザーテーブルを作成してください。

EBCDICユーザーテーブルの組み込みの詳細は、以下を参照してください。

HULFT10 for zOS アドミニストレーション マニュアル : EBCDICユーザテーブルの組み込み

注意

バージョンアップ前の環境で使用していたEBCDICユーザーテーブル雛形JCLは使用できません。必ず提供媒体から復元したEBCDICユーザーテーブル雛形JCLを使用してください。

## HULFT管理画面とHULFT TSOコマンドを使用するための設定

HULFT管理画面とHULFT TSOコマンドを使用するために必要な設定を行います。

### ヘルプメッセージの登録

簡易転送配信要求コマンドを使用する場合、「ヘルプメッセージの登録」を参照し、ヘルプメッセージを登録してください。

### プロシージャの変更

運用に合わせ、以下のどちらかの設定を行ってください。

- ログオンプロシージャーに設定する方法

  以下の手順を実施してください。

  - ログオンプロシージャーの変更

  - HULFT管理画面用コマンドプロシージャーの変更

- ログオンした後で設定する方法

  以下の手順を実施してください。

  - HULFT環境コマンドプロシージャーの変更

  - HULFT管理画面用コマンドプロシージャーの変更

## システム動作環境の設定について

HULFT Ver.7のシステム動作環境設定ファイル（HULPRM）を参照し、HULFT Ver.10のシステム動作環境設定ファイル（HULPRM）を編集してください。

HULFTの新機能を使用するためには、各設定が正しく指定されている必要があります。

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

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

注意

- 日本語で利用する場合は、HULFT動作言語（HULLANG）は“JPN（日本語）”を設定してください。それ以外の場合は“ENG（英語）”を設定してください。

- 操作ログEBCDICコード（OPLEBCDIC）を設定していた場合は、項目ごと設定を削除してください。HULFT Ver.8.1以降では、HULFTキャラクターセットの設定を推奨します。

  なお、操作ログEBCDICコードが設定されているとHULFTキャラクターセットの設定値ではなく、操作ログEBCDICコードの設定値が有効になります。

- HULFTの各常駐プログラムの実行（EXECステートメント）パラメーターで指定していた一部のパラメーターが、Ver.8.4.0以降、システム動作環境設定で設定できるようになりました。システム動作環境設定に追加された項目を確認し、実行（EXECステートメント）パラメーターではなく、システム動作環境設定で設定するように変更してください。システム動作環境設定に追加された項目については、以下を参照してください。

  HULFT10 for zOS アドミニストレーション マニュアル : システム動作環境設定一覧

- 高強度暗号強制モードの設定方法は、「高強度暗号強制モードを使用する場合の作業」を参照してください。

- 以下で作成したシステム制御ファイルは、システム制御ファイル名（CONTROL-FILE）に必ず指定してください。

  「HULFT Ver.10用システムファイルの創成」ー「システム制御ファイルの創成」

## 製品情報の登録

HULFTが動作するように、システム動作環境設定ファイル（HULPRM）にシリアル番号およびプロダクトキーの登録を行います。登録方法は、「製品情報の登録」を参照してください。

## OMVSセグメントの定義

OMVSセグメントの定義方法は、「OMVSセグメントの定義」を参照してください。

= 備考 =

すでにHULFTが動作している環境で同じジョブ（PROC）名でHULFTシステムを起動する場合は、OMVSセグメントがすでに定義されているので当作業を行う必要はありません。

## RACFへのユーザーIDおよびパスワードの登録

HULFT Ver.7以降では、HULFT Managerから接続する際のユーザー認証に、RACF（Resource Access Control Facility）に登録したユーザーIDおよびパスワードを使用できるようになりました。RACFは、IBM Security Serverから提供される機能です。

従来のユーザー定義ファイルを使用する方法と、RACFを使用する方法を選択できます。この指定は、システム動作環境設定ファイルのユーザーID・パスワードチェック（USRIDCHKMODE）で設定できます。詳細は、以下を参照してください。

HULFT10 for zOS アドミニストレーション マニュアル : 各項目の説明

HULFT Ver.10からRACFを使用する方法に切り替える場合は、旧バージョンの環境でユーザー定義ファイルに登録していたユーザーIDとパスワードの指定内容を、RACFに追加登録する必要があります。要求受付プログラム（XRACCPT）の起動JCLのユーザー定義ファイル（DD名：XRPASSWD）の定義を確認し、ユーザーIDとパスワードの内容をRACFに登録してください。ユーザー定義ファイルの詳細は、以下を参照してください。

HULFT10 for zOS アドミニストレーション マニュアル : HULFT Managerサービスの設定

## 要求受付定義ファイルの編集

HULFT Ver.7の要求受付定義ファイル（HULAPT）を参照し、HULFT Ver.10の要求受付定義ファイル（HULAPT）を編集してください。

要求受付定義ファイルを編集する際、HULFT Ver.7の要求受付定義ファイルに定義されていないサービスがあっても削除しないでください。

要求受付定義ファイルの編集方法は、以下を参照してください。

HULFT10 for zOS アドミニストレーション マニュアル : 要求受付定義ファイル

続いて、「バージョンアップに伴うJCLの変更」の作業を行ってください。