Procedure for the level upgrade
After you complete the preparation for the Level Upgrade, carry out the Level Upgrade work in accordance with the procedure shown below.
(1) Restoration of a new member and a new release
Modify the JCL example shown below and execute the modified JCL to restore the member names 'REVUP' and 'JCLMADD' from HULFT JCL library (HULFT.V8.JCL) for HULFT installation files restored in Procedure for restoration from the provided media to the existing HULFT JCL library (HULFT.JCL).
[Example of JCL]
//INSTALL JOB CLASS=A,MSGCLASS=B
//*
//JCLGEN EXEC PGM=IEBCOPY
//IN DD DSN=HULFT.V8.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=(REVUP,JCLMADD)
//*
|
DD Name |
Value |
Description |
|---|---|---|
|
IN |
HULFT.V8.JCL |
HULFT JCL library (HULFT installation file) |
|
OUT |
HULFT.JCL |
HULFT JCL library (installation destination file) |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
UNIT |
SYSDA |
UNIT |
a) Restoration of new release
The restored 'REVUP' is shown in the example of JCL below. Modify and execute this JCL to overwrite the existing releases of the following libraries with the new releases of the libraries from HULFT installation files:
-
HULFT load module library
-
HULFT ISPF panel library
-
HULFT ISPF message library
[Example of JCL]
//REVUP JOB CLASS=A,MSGCLASS=B
//*
//PANEL EXEC PGM=IEBCOPY
//IN DD DSN=HULFT.V8.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))
//*
//MSG EXEC PGM=IEBCOPY
//IN DD DSN=HULFT.V8.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))
//*
//LOAD EXEC PGM=IEBCOPY
//IN DD DSN=HULFT.V8.LOAD,DISP=SHR
//OUT DD DSN=HULFT.LOAD,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))
//*
//
|
DD Name |
Value |
Description |
|---|---|---|
|
IN |
HULFT.V8.JPN.PANEL |
HULFT ISPF panel library (JPN HULFT installation file) |
|
OUT |
HULFT.PANEL |
HULFT ISPF panel library (JPN installation destination file) |
|
IN |
HULFT.V8.JPN.MSG |
HULFT ISPF message library (JPN HULFT installation file) |
|
OUT |
HULFT.MSG |
HULFT ISPF message library (JPN installation destination file) |
|
IN |
HULFT.V8.LOAD |
HULFT load module library (HULFT installation file) |
|
OUT |
HULFT.LOAD |
HULFT load module library (installation destination file) |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
UNIT |
SYSDA |
UNIT |
b) Restoration of a new member
The restored 'JCLMADD' is shown in the example of JCL below.
Modify and execute this JCL to install newly added members in the following libraries to the existing libraries using the HULFT installation files:
-
HULFT JCL library
-
HULFT parameter library
[Example of JCL]
//JCLMADD JOB CLASS=A,MSGCLASS=B
//*
//JCLGEN EXEC PGM=IEBCOPY
//IN DD DSN=HULFT.V8.JCL,DISP=(OLD,PASS),
// UNIT=SYSDA,VOL=SER=HUL001
//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=()
//*
//PARMGEN EXEC PGM=IEBCOPY
//IN DD DSN=HULFT.V8.PARMLIB,DISP=(OLD,PASS),
// UNIT=SYSDA,VOL=SER=HUL001
//OUT DD DSN=HULFT.PARMLIB,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=()
//
|
DD Name |
Value |
Description |
|---|---|---|
|
IN |
HULFT.V8.JCL |
HULFT JCL library (HULFT installation file) |
|
OUT |
HULFT.JCL |
HULFT JCL library (installation destination file) |
|
IN |
HULFT.V8.PARMLIB |
HULFT parameter library (HULFT installation file) |
|
OUT |
HULFT.PARMLIB |
HULFT parameter library (installation destination file) |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
UNIT |
SYSDA |
UNIT |
|
VOL=SER |
HUL001 |
Volume Name |
If the SYSIN definition card of the restored "JCLMADD" is commented out, there is no new member. In this case, you do not need to restore new members.
(2) Creation of system files for latest version of HULFT
Re-create the following system files:
-
Send and Receive Management file
-
Host Information file
-
Send Control file
-
Send and Receive Log file
-
System Control file
For details about the size, refer to Calculation of the size of the VSAM file.
You must recalculate the size of the INDEX components. Calculate the size based on the Key Length.
When creating each file, you must also carry out the initialization processing.
a) Creation of the Send and Receive Management file
Modify the contents (such as the File Name, the Volume Serial, and the Capacity) of the JCL example shown below to suit your environment.
Execute the modified JCL to create the Send and Receive Management file in a new format.
When creating the Send and Receive Management file, you must also carry out the initialization processing.
Modify the member name 'FILEVSAM' in HULFT JCL library and execute the JCL.
[Example of 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 Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRFILE |
HULFT.FILE |
Send and Receive Management File |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
VOLUMES |
HUL001 |
Volume Name |
|
CYLINDERS |
(*1) |
Capacity |
|
NAME |
HULFT.FILE |
Send and Receive Management File |
|
NAME |
HULFT.FILE.DATA |
Names of entries for data component of Send and Receive Management File |
|
NAME |
HULFT.FILE.IDX |
Names of entries for index component of Send and Receive Management File |
|
*1 |
: |
(1ST Extent Secondary) |
b) Creation of the Host Information file
Modify the contents (such as the File Name, the Volume Serial, and the Capacity) of the JCL example shown below to suit your environment.
Execute the modified JCL to create the Host Information file in a new format.
When creating the Host Information file, you must also carry out the initialization processing.
Modify the member name 'HOSTVSAM' in HULFT JCL library and execute the JCL.
[Example of 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 Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRHOST |
HULFT.HOST |
Host Information File |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
VOLUMES |
HUL001 |
Volume Name |
|
CYLINDERS |
(*1) |
Capacity |
|
NAME |
HULFT.HOST |
Host Information File |
|
NAME |
HULFT.HOST.DATA |
Names of entries for data component of Host Information File |
|
NAME |
HULFT.HOST.IDX |
Names of entries for index component of Host Information File |
|
*1 |
: |
(1ST Extent Secondary) |
c) Creation of the Send Control file
Modify the contents (such as the File Name, the Volume Serial, and the Capacity) of the JCL example shown below to suit your environment.
Execute the modified JCL to create the Send Control file in a new format.
When creating the Send Control file, you must also carry out the initialization processing.
Modify the member name 'QUEVSAM' in HULFT JCL library and execute the JCL.
[Example of 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 Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRQUE |
HULFT.QUEUE |
Send Control File |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
VOLUMES |
HUL001 |
Volume Name |
|
CYLINDERS |
(*1) |
Capacity |
|
NAME |
HULFT.QUEUE |
Send Control File |
|
NAME |
HULFT.QUEUE.DATA |
Names of entries for data component of Send Control File |
|
NAME |
HULFT.QUEUE.IDX |
Names of entries for index component of Send Control File |
|
*1 |
: |
(1ST Extent Secondary) |
d) Creation of the Send and Receive Log file
Modify the contents (such as the File Name, the Volume Serial, and the Capacity) of the JCL example shown below to suit your environment.
Execute the modified JCL to create the Send and Receive Log file in a new format.
When creating the Send and Receive Log file, you must also carry out the initialization processing.
Modify the member name 'LOGVSAM' in HULFT JCL library and execute the JCL.
[Example of 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(4000 4000) -
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(4000 4000) -
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(4000 4000) -
CONTROLINTERVALSIZE(26624)) -
INDEX -
(NAME(HULFT.LOG.PATH2.IDX) -
VOLUMES(HUL001) -
CYLINDERS(1 1) -
SHAREOPTIONS(4 3))
//*
//*------< FILE CREATE >---------------------------------------
//XRCREATE EXEC PGM=XRCREATE
//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 Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRLOG |
HULFT.LOG |
Send and Receive Log File ID Key File |
|
XRLOG1 |
HULFT.LOG.PATH1 |
Send and Receive Log Host Name Key File |
|
XRLOG2 |
HULFT.LOG.PATH2 |
Send and Receive Log Date Key File |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
VOLUMES |
HUL001 |
Volume Name |
|
CYLINDERS |
(*1) |
Capacity |
|
NAME |
HULFT.LOG |
Send and Receive Log File ID Key File |
|
NAME |
HULFT.LOG.DATA |
Names of entries for data component of Send and Receive Log File ID Key File |
|
NAME |
HULFT.LOG.IDX |
Names of entries for index component of Send and Receive Log File ID Key File |
|
NAME |
HULFT.LOG.PATH1 |
Send and Receive Log Host Name Key File |
|
NAME |
HULFT.LOG.PATH1.DATA |
Names of entries for data component of Send and Receive Log Host Name Key File |
|
NAME |
HULFT.LOG.PATH1.IDX |
Names of entries for index component of Send and Receive Log Host Name Key File |
|
NAME |
HULFT.LOG.PATH2 |
Send and Receive Log Date Key File |
|
NAME |
HULFT.LOG.PATH2.DATA |
Names of entries for data component of Send and Receive Log Date Key File |
|
NAME |
HULFT.LOG.PATH2.IDX |
Names of entries for index component of Send and Receive Log Date Key File |
|
*1 |
: |
(1ST Extent Secondary) |
e) Creating the System Control file
The procedure for creating the System Control file for HULFT Ver.8 is shown below.
Modify the member name "CNTLVSAM" in HULFT JCL library and execute the JCL.
Then, you must specify the created System Control file in the System Environment Settings.
For details, refer to (7) System Environment Settings.
[Example of 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 Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRCNTL |
HULFT.SYSCNTL |
System Control file |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
VOLUME |
HUL001 |
Volume Name |
|
CYLINDERS |
(*1) |
Capacity |
|
NAME |
HULFT.SYSCNTL |
System Control file |
|
NAME |
HULFT.SYSCNTL.DATA |
Names of entries for data component of the System Control file |
|
NAME |
HULFT.SYSCNTL.IDX |
Names of entries for index component of System Control file |
|
*1 |
: |
(1ST Extent Secondary) |
(3) Conversion of system files
The procedure for converting system files so that they can be used in the latest version of HULFT is shown below.
a) Conversion of the Send and Receive Management file and the Host Information file
Convert the Send and Receive Management file and the Host Information file so that they can be used in the latest version of HULFT.
Modify the member name 'XRFILCNV' in HULFT JCL library and execute the JCL.
[Example of JCL]
//XRFILCNV JOB CLASS=A,MSGCLASS=B //XRFILCNV EXEC PGM=XRFILCNV,REGION=2048K,PARM='V8,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 Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRBKUP |
HULFT.FILE.BKUP |
Send and Receive Management File (backup file) (*1) |
|
XRBKUP2 |
HULFT.HOST.BKUP |
Host Information File (backup file) (*1) |
|
XRFILE |
HULFT.FILE |
Send and Receive Management File |
|
XRHOST |
HULFT.HOST |
Host Information File |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
PARM= |
V8 |
Version of migration source HULFT |
|
HULCHARSET= |
939 |
CCSID (Coded Character Set Identifier) of the emulator |
|
*1 |
: |
Specify backup files created with the following procedure: |
You cannot omit the PARM definition.
b) Conversion of the Send and Receive Log file
Convert the Send and Receive Log file so that it can be used in the latest version of HULFT.
Modify the member name 'XRLOGCNV' in HULFT JCL library and execute the JCL.
[Example of JCL]
//XRLOGCNV JOB CLASS=A,MSGCLASS=B //XRLOGCNV EXEC PGM=XRLOGCNV,REGION=2048K,PARM='V8,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 Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRBKUP |
HULFT.LOG.BKUP |
Send and Receive Log File (backup file) (*1) |
|
XRLOG |
HULFT.LOG |
Send and Receive Log File ID Key File |
|
XRLOG1 |
HULFT.LOG.PATH1 |
Send and Receive Log Host Name Key File |
|
XRLOG2 |
HULFT.LOG.PATH2 |
Send and Receive Log Date Key File |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
RARM= |
V8 |
Version of migration source HULFT |
|
HULCHARSET= |
939 |
CCSID (Coded Character Set Identifier) of the emulator |
|
*1 |
: |
Specify backup files created with the following procedure: |
-
You cannot omit the PARM definition.
-
If you execute the Send and Receive Log Conversion program (XRLOGCNV) again, re-create the Send and Receive Log file.
c) Addition of information on log record count for the Send and Receive Log file
Add the information on log record counts so that the Send and Receive Log file can be used in the latest version of HULFT. Modify the member name 'XRLOGCNT' in HULFT JCL library and execute the JCL.
[Example of 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 //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //XRCRD DD * LOGCNT=ALL //
|
DD Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRLOG |
HULFT.LOG |
Send and Receive Log File ID Key File |
|
XRLOG1 |
HULFT.LOG.PATH1 |
Send and Receive Log Host Name Key File |
|
XRLOG2 |
HULFT.LOG.PATH2 |
Send and Receive Log Date Key File |
(4) Creation or restoration of custom character table
If you are using custom character tables, you can continue to use them after the Level Upgrade.
Use either of the following methods to make the custom character table available for use:
-
Restoration from HULFT load module backup files (a) )
-
Use of the definition card to generate a custom character table that you previously created (b) )
If you use one of the following methods to replace modules, you must restore or re-create the custom character table that was in use prior to module replacement:
-
Creation of a new HULFT load module library
-
Deletion of all members in HULFT load module library
a) Restoration from HULFT load module backup files
Restore custom character tables from the backup files for HULFT load module you created in preparation for the Level Upgrade. Refer to the following list for the custom character tables to be restored:
|
Input Code |
Output Code |
Custom Character Table Name |
|---|---|---|
|
IBM Kanji |
Shift-JIS |
ITSTBL |
|
IBM Kanji |
EUC-JP |
ITETBL |
|
IBM Kanji |
JEF |
ITJTBL |
|
IBM Kanji |
KEIS |
ITKTBL |
|
IBM Kanji |
NEC |
ITNTBL |
|
IBM Kanji |
UTF-8 |
ITU8TBL |
|
Shift-JIS |
IBM Kanji |
STITBL |
|
EUC-JP |
IBM Kanji |
ETITBL |
|
JEF |
IBM Kanji |
JTITBL |
|
KEIS |
IBM Kanji |
KTITBL |
|
NEC |
IBM Kanji |
NTITBL |
|
UTF-8 |
IBM Kanji |
U8TITBL, U8TITBL2 |
(5) Re-creation of EBCDIC user tables
If you have created EBCDIC user tables in the environment before the Level Upgrade, use the JCL templates for EBCDIC user tables to create new EBCDIC user tables.
In the JCL templates for EBCDIC user tables, you can specify the conversion tables that you used to create the EBCDIC user tables in the environment before the Level Upgrade.
For details, refer to Administration Manual.
(6) Settings for using the HULFT Management Console and TSO commands
Configure the settings required for use of the HULFT Management Console and the HULFT TSO commands.
a) Registration of help messages
For information on how to register help messages when you use the Instant Transfer Send File Issuance command, refer to Registration of help messages.
b) Modification of the procedure
Configure one of the following settings according to operation.
Configuring settings in the logon procedure
Perform the following procedures:
Configuring settings after logging on
Perform the following procedures:
(7) System Environment Settings
Refer to the System Environment Settings file (HULFT.PARMLIB(HULPRM)) in your environment prior to level upgrade to edit the System Environment Settings file (HULFT.PARMLIB(HULPRM)) in HULFT Ver.8.
In order to use the new functions in HULFT, you must define each definition correctly.
For details about the System Environment settings, refer to Administration Manual.
-
In a HULFT version that is lower than Ver.8.4.0, the function for checking the requestor hosts was set with Request Acknowledge Host Check (APTHSTCHK). In HULFT Ver.8.4.0 and higher, you can set the function by specifying separate fields for each service type, as shown below:
-
Allow Send/Resend Request from Unregistered Host (ALLOWSNDREQ)
-
Allow Post-Receive Job Result Inquiry from Unregistered Host (ALLOWPOSTRJOBRSLT)
-
Allow Job Result Notification Request from Unregistered Host (ALLOWJOBRSLTNTFY)
-
Allow Remote Job Execution Request from Unregistered Host (ALLOWRMTJOBEXE)
If you have carried out a level upgrade, set the function for checking the requestor hosts by using the fields listed above.
If "1" was set for Request Acknowledge Host Check (APTHSTCHK), that setting is given priority. Regardless of the settings of the above fields, HULFT denies the connections from the hosts that issue requests, and an error occurs. Therefore, to enable the settings of the newly added fields listed above, be sure to specify Request Acknowledge Host Check (APTHSTCHK) as "0".
For details about the observe setting functions for unregistered hosts and the System Environment settings, refer to Administration Manual.
-
-
In HULFT Ver.8.4.0 and higher, some of the parameters that were defined by using the execution parameters (for EXEC statement) of the resident programs of HULFT can now be set in the System Environment Settings. Check which settings have been added to the System Environment Settings, and hereafter configure those settings in the System Environment Settings and not by using the execution parameters (for EXEC statement). For details about the settings that have been added to the System Environment Settings, refer to Administration Manual.
-
The value for Forced Strong Key Mode (STRONGKEYMODE) in the System Environment Settings is carried over from the settings before the update. Note that, in Update Installation from versions lower than Ver.8.4.0, "0" (Disabled) is set.
-
For details on how to specify Forced Strong Key mode, refer to Preparation before using Forced Strong Key mode.
-
Be sure to specify the System Control file created in the following procedure for System Control File Name (CONTROL-FILE):
(2) Creation of system files for latest version of HULFT - e) Creating the System Control file