Version upgrade from HULFT Ver.6
(1) Restoration of new release
Modify Example 1 of JCL shown below and execute the modified JCL to restore the member name 'VERUP6' 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 1 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=(VERUP6)
|
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 |
The restored 'VERUP6' is shown in Example 2 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 JCL library
-
HULFT load module library
-
HULFT ISPF panel library
-
HULFT ISPF message library
-
HULFT parameter library
[Example 2 of JCL]
//VERUP 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=(OPLVSAM,OPLBKUP,XROPLBK,XROPLLST,XROPLLS2)
SELECT M=(BACKUP6,BACKUP7,BACKUP8)
SELECT M=(HULVSAM,LOGVSAM,QUEVSAM,FILEVSAM,HOSTVSAM)
SELECT M=(XRHULVER,XRCREATE,XRFILCNV,XRLOGCNV)
SELECT M=(XREBCASC,XRASCEBC,XREBCEUC)
SELECT M=(XREUCEBC,XRSJSCNV,XREUCCNV)
SELECT M=(CNTLVSAM,HULSNDGO)
//* SELECT M=(XRLOGCNT)
//* SELECT M=(XRPRMGEN)
//* SELECT M=(XRPRMSET)
//* SELECT M=(XRRSNDDL)
//*
//PNLGEN 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))
//*
//MSGGEN 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))
//*
//PARMGEN EXEC PGM=IEBCOPY
//IN DD DSN=HULFT.V8.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.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.JCL |
HULFT JCL library (HULFT installation file) |
|
OUT |
HULFT.JCL |
HULFT JCL library (installation destination file) |
|
IN |
HULFT.V8.JPN.PANEL |
HULFT ISPF panel library (JPN HULFT installation file) |
|
OUT |
HULFT.PANEL |
HULFT ISPF panel library (installation destination file) |
|
IN |
HULFT.V8.JPN.MSG |
HULFT ISPF message library (JPN HULFT installation file) |
|
OUT |
HULFT.MSG |
HULFT ISPF message library (installation destination file) |
|
IN |
HULFT.V8.PARMLIB |
HULFT parameter library (HULFT installation file) |
|
OUT |
HULFT.PARMLIB |
HULFT parameter library (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 |
-
If a JCL member that is defined as a comment line in the job step 'JCLGEN' does not exist in an existing library, modify the JCL to uncomment the line and then execute the JCL.
-
If you execute the JCL, the environment for HULFT that you are currently using will be modified. The following operations include the use of backups. Before starting this work, be sure to create backups in HULFT as explained in Backup in HULFT Ver.6.
-
Since new members may be added and the number of members in HULFT load module library may increase, the capacity of the existing library may be insufficient.
-
If you have installed HULFT Ver.6 as an upgrade from HULFT Ver.5, HULFT parameter library may not exist. Then, perform the New Installation of HULFT parameter library.
(2) Definition in APF-authorized Library
For details about the method of definition in the APF-authorized Library, refer to Definition in the APF-authorized Library.
(3) Creation of HULFT Ver.8 system files
Re-create the following HULFT Ver.6 files in a format that can be used in HULFT Ver.8:
-
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
The procedure for creating the Send and Receive Management file for HULFT Ver.8 is shown below.
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
The procedure for creating the Host Information file for HULFT Ver.8 is shown below.
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
The procedure for creating the Send Control file for HULFT Ver.8 is shown below.
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
The procedure for creating the Send and Receive Log file for HULFT Ver.8 is shown below.
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 (10) 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) |
(4) Creation of the Operation Log files
If you will use the operation log output function, create the Operation Log files.
HULFT requires the following two types of files (VSAM) as operation log files:
-
File Access Log files
-
Command Execution Log files
Example of JCL
You can create the two types of Operation Log file listed above when you execute the JCL after modifying the contents (such as the File Name, the Volume Serial, and the Capacity) to suit the user's environment.
For details about the size, refer to Calculation of the size of the VSAM file.
You must carry out the initialization processing for the Operation Log files you created by using the System File Initialization program (XRCREATE).
The JCL is based on the assumption that the Operation Log files are created with '0' defined for the Secondary. When the capacity automatically increases, such as when you create the Operation Log files on SMS-managed volumes, define the OPLLIMIT parameter for the System File Initialization program (XRCREATE). For details, refer to the explanation of the editing of system files in Administration Manual.
JCL template for creation: HULFT.JCL (OPLVSAM)
//OPLVSAM JOB CLASS=A,MSGCLASS=B
//*------< VSAM DEFINE CLUSTER >---------------------------------------
//DEFCLSTR EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DELETE HULFT.OPLFILE1
DELETE HULFT.OPLFILE2
DELETE HULFT.OPLCMD1
DELETE HULFT.OPLCMD2
DEFINE CLUSTER -
(NAME(HULFT.OPLFILE1) -
NUMBERED -
UNIQUE) -
DATA -
(NAME(HULFT.OPLFILE1.DATA) -
VOLUMES(HUL001) -
CYLINDERS(30 0) -
SHAREOPTIONS(4 3) -
RECORDSIZE(2048 2048) -
CONTROLINTERVALSIZE(8192))
DEFINE CLUSTER -
(NAME(HULFT.OPLFILE2) -
NUMBERED -
UNIQUE) -
DATA -
(NAME(HULFT.OPLFILE2.DATA) -
VOLUMES(HUL001) -
CYLINDERS(30 0) -
SHAREOPTIONS(4 3) -
RECORDSIZE(2048 2048) -
CONTROLINTERVALSIZE(8192))
DEFINE CLUSTER -
(NAME(HULFT.OPLCMD1) -
NUMBERED -
UNIQUE) -
DATA -
(NAME(HULFT.OPLCMD1.DATA) -
VOLUMES(HUL001) -
CYLINDERS(30 0) -
SHAREOPTIONS(4 3) -
RECORDSIZE(2048 2048) -
CONTROLINTERVALSIZE(8192))
DEFINE CLUSTER -
(NAME(HULFT.OPLCMD2) -
NUMBERED -
UNIQUE) -
DATA -
(NAME(HULFT.OPLCMD2.DATA) -
VOLUMES(HUL001) -
CYLINDERS(30 0) -
SHAREOPTIONS(4 3) -
RECORDSIZE(2048 2048) -
CONTROLINTERVALSIZE(8192))
//*
//*------< 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 DUMMY
//XROPLC1 DD DSN=HULFT.OPLCMD1,DISP=SHR
//XROPLC2 DD DSN=HULFT.OPLCMD2,DISP=SHR
//XROPLF1 DD DSN=HULFT.OPLFILE1,DISP=SHR
//XROPLF2 DD DSN=HULFT.OPLFILE2,DISP=SHR
//SYSUDUMP DD SYSOUT=*
|
DD Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XROPLC1 |
HULFT.OPLCMD1 |
Command Execution Log File 1 |
|
XROPLC2 |
HULFT.OPLCMD2 |
Command Execution Log File 2 |
|
XROPLF1 |
HULFT.OPLFILE1 |
File Access Log File 1 |
|
XROPLF2 |
HULFT.OPLFILE2 |
File Access Log File 2 |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
VOLUMES |
HUL001 |
Volume Name |
|
CYLINDERS |
(*1) |
Capacity |
|
NAME |
HULFT.OPLCMD1 |
Command Execution Log File 1 |
|
NAME |
HULFT.OPLCMD1.DATA |
Names of entries for data component of Command Execution Log File 1 |
|
NAME |
HULFT.OPLCMD2 |
Command Execution Log File 2 |
|
NAME |
HULFT.OPLCMD2.DATA |
Names of entries for data component of Command Execution Log File 2 |
|
NAME |
HULFT.OPLFILE1 |
File Access Log File 1 |
|
NAME |
HULFT.OPLFILE1.DATA |
Names of entries for data component of File Access Log File 1 |
|
NAME |
HULFT.OPLFILE2 |
File Access Log File 2 |
|
NAME |
HULFT.OPLFILE2.DATA |
Names of entries for data component of File Access Log File 2 |
|
*1 |
: |
(1ST Extent Secondary) |
(5) Conversion of system files
The procedure for converting HULFT Ver.6 system files so that they can be used in HULFT Ver.8 is shown below.
a) Conversion of the Send and Receive Management file and the Host Information file
Convert HULFT Ver.6 Send and Receive Management file and Host Information file so that they can be used in HULFT Ver.8. 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='V6,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= |
V6 |
Version of migration source HULFT |
|
HULCHARSET= |
939 |
CCSID (Coded Character Set Identifier) of the emulator |
|
*1 |
: |
Specify backup files created with the following procedure: |
-
Management information fields that do not exist in HULFT before a version upgrade are set to their default values.
However, Use HULFT7 Comm. Mode (HUL7MODE) in the Host Information is set as "Y" (enabled).
If the remote host is HULFT Ver.8.0.0 or higher, you need to change the setting to "N" (disabled) after a version upgrade.
-
We recommend that you set the default value "0" for the following fields in HULFT8. However, when you perform a version upgrade, the field values in the environment before the migration will be inherited.
-
Transfer Block Length (BLOCKLEN) in the Send Management Information
-
Transfer Block Count (BLOCKCNT) in the Send Management Information
Modify the setting values after a version upgrade as necessary.
-
b) Conversion of the Send and Receive Log file
The procedure for converting HULFT Ver.6 Send and Receive Log file so that it can be used in HULFT Ver.8 is shown below.
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='V6,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 |
|---|---|---|
|
PARM= |
V6 |
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 HULFT Ver.8. 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 |
(6) Conversion of custom character conversion exit routines
If you have created custom character conversion exit routines, you must convert from the load modules for the custom character conversion exit routines. If you are using custom character tables, this operation is not necessary. Proceed to (7) Creation or restoration of custom character table.
If you have stored the custom character conversion exit routines in a user library, use the modules in that library. If you have stored the custom character conversion exit routines in HULFT load module library, use the backup file that you created in Preparation for a version upgrade for conversion.
In HULFT8, the conversion of custom characters by using custom character conversion exit routines is no longer supported.
Perform the following conversion to migrate the registered custom characters from the custom character conversion exit routines to custom character tables.
If you registered custom characters in any of the following custom character conversion exit routine modules, you must perform the operations in b) and c) for each custom character conversion exit routine module.
[Custom character conversion exit routine modules]
-
XRETJEXT
-
XRHTJEXT
-
XRITJEXT
-
XRJTEEXT
-
XRJTHEXT
-
XRJTIEXT
-
XRJTSEXT
-
XRSTJEXT
b) Creation of cards for the custom character conversion exit routines in use
Extract the definitions of the custom characters that you have registered in the custom character conversion exit routine modules of HULFT. The extraction results are stored in the data set that is defined on XRCRD.
Modify the member name 'XRTBLCNV' in HULFT JCL library and perform the operation.
[Example of JCL]
//XRTBLCNV JOB CLASS=A,MSGCLASS=B //XRTBLCNV EXEC PGM=XRTBLCNV,REGION=4096K,PARM='XRJTSEXT,DEFAULT=81A0' //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XREXTLIB DD DSN=HULFT.LOAD.BKUP,DISP=SHR //XRCRD DD DSN=HULFT.GAIJI.TBL,DISP=(,CATLG,DELETE), // UNIT=SYSDA,VOL=SER=HUL001,SPACE=(CYL,(5,3),RLSE) //SYSUDUMP DD SYSOUT=* //
|
DD Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XREXTLIB |
HULFT.LOAD.BKUP |
Storage library for HULFT Ver.6 custom character conversion exit routines |
|
XRCRD |
HULFT.GAIJI.TBL |
Card for generating the definition for HULFT Ver.8 |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
PARM |
XRJTSEXT |
Target module listed in a) |
|
DEFAULT |
81A0 |
Specific character |
|
UNIT |
SYSDA |
UNIT |
|
VOL=SER |
HUL001 |
Volume Name |
The data set attributes of a card for generating the definition are shown below.
|
Attribute |
|||
|---|---|---|---|
|
Organization |
Record Format |
Record Length |
Block Size |
|
PS |
FB |
80 |
6160 |
If you specified conversion of an undefined character to a specific character in the custom character conversion exit routines of lower versions, set the specific character in the EXEC statement parameter ',DEFAULT=XXXX' (XXXX is the 4-digit hexadecimal number of the specific character).
If you do not specify ',DEFAULT=XXXX', XRTBLCNV creates parameter cards for the character codes from 0x0000 to 0xFFFF, and the generation processing may take some time.
c) Migration from custom character conversion exit routines to tables
Register the custom character definitions that were created in b) in HULFT Ver.8 load module.
Modify the member name 'XRECTBL' in HULFT JCL library and perform the operation.
For details about the registration method and the usage of custom character tables, refer to Administration Manual.
[Example of JCL]
//XRECTBL JOB CLASS=A,MSGCLASS=B //XRECTBL EXEC PGM=XRECTBL,REGION=2048K[,PARM='OBJOUT=SYSLMOD'] //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //SYSLMOD DD DSN=HULFT.LOAD,DISP=SHR //SYSIN DD DSN=&&OBJECT,DISP=(,PASS,DELETE),UNIT=SYSDA, // SPACE=(CYL,(010)) //SYSLIB DD DSN=SYS1.MACLIB,DISP=SHR //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(10)) //SYSUT2 DD UNIT=SYSDA,SPACE=(CYL,(10)) //SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(10)) //SYSLIN DD DSN=&&OBJECT2,DISP=(,PASS,DELETE),UNIT=SYSDA, // SPACE=(CYL,(010)) //SYSOUT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //XRCRD DD DSN=HULFT.GAIJI.TBL,DISP=SHR //* /* //
|
DD Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRSYSIN |
HULFT.PARMLIB(HULPRM) |
System Environment Settings File |
|
SYSLMOD |
HULFT.LOAD |
HULFT load module library of HULFT Ver.8 that is installed |
|
XRCRD |
HULFT.GAIJI.TBL |
Card for generating the definition for HULFT Ver.8 that you created in b) |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
OBJOUT |
SYSLMOD |
Object program output DD name |
|
UNIT |
SYSDA |
UNIT |
d) Example of creation of card for custom character conversion exit routine in use
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
[Example of JCL for creating card for generating definition]
//XRTBLCNV JOB CLASS=A,MSGCLASS=B //XRTBLCNV EXEC PGM=XRTBLCNV,REGION=4096K, // PARM='XRJTSEXT,DEFAULT=81A0' //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XREXTLIB DD DSN=HULFT.LOAD.BKUP,DISP=SHR //XRCRD DD DSN=HULFT.GAIJI.TBL,DISP=(,CATLG,DELETE), //* // UNIT=SYSDA,VOL=SER=HUL001,SPACE=(CYL,(5,3),RLSE) //SYSUDUMP DD SYSOUT=* //
|
DD Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XREXTLIB |
HULFT.LOAD.BKUP |
Storage library for HULFT Ver.6 custom character conversion exit routines |
|
XRCRD |
HULFT.GAIJI.TBL |
Card for generating the definition for HULFT Ver.8 |
|
Parameter Name |
Value |
Description |
|---|---|---|
|
DEFAULT |
81A0 |
Specific character |
|
UNIT |
SYSDA |
UNIT |
|
VOL=SER |
HUL001 |
Volume Name |
After you perform the above-mentioned operation, the following card is created in the data set 'HULFT.GAIJI.TBL.'
ITSTBL DEFAULT 81A0 41F1 8754 41F2 8755 41F3 8756 41F4 8757 41F5 8758 41F6 8759 41F7 875A 41F8 875B 41F9 875C 41FA 875D END
(7) Creation or restoration of custom character table
If you are using custom character tables, you can continue to use them after a version upgrade.
Use one of the following methods to allow the use of custom character tables after an upgrade:
-
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 have created custom character conversion exit routines, this operation is not necessary.
-
In HULFT8, the conversion of custom characters by using custom character conversion exit routines is no longer supported.
-
If you intend to use custom character tables created in HULFT lower than Ver.6.0.3, and specify '1' for Use Custom Character Table (GAIJIFILE) in the System Environment Settings after a version upgrade, perform the procedure in b) to create the custom character tables.
For details about how to use custom character tables, refer to Administration Manual.
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 the custom character tables from the backup files for HULFT load module created in preparation for the version 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 |
|
Shift-JIS |
IBM Kanji |
STITBL |
|
EUC-JP |
IBM Kanji |
ETITBL |
|
JEF |
IBM Kanji |
JTITBL |
|
KEIS |
IBM Kanji |
KTITBL |
|
NEC |
IBM Kanji |
NTITBL |
(8) Re-creation of EBCDIC user tables
If you have created EBCDIC user tables in the environment before a version upgrade, use the JCL templates for EBCDIC user tables where you have modified member names that are shown in the list in (4) Confirmation of EBCDIC User Table of
Preparation for a version upgrade and create new EBCDIC user tables.
For details about incorporating EBCDIC user tables, refer to Administration Manual.
You cannot use the JCL templates for EBCDIC user tables that you used in HULFT before a version upgrade. Be sure to use the JCL templates for EBCDIC user tables that were restored from the provided media.
(9) Settings for using the HULFT Management Console and HULFT 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:
(10) System Environment Settings
Refer to the System Environment Settings file (HULFT.PARMLIB(HULPRM)) in HULFT Ver.6 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.
-
If you want to use HULFT in Japanese, specify 'JPN' (Japanese) for HULFT Operation Language (HULLANG). Otherwise, specify 'ENG' (English).
-
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.
-
For details about how to configure the settings for the 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):
(3) Creation of HULFT Ver.8 system files - e) Creating the System Control file
(11) Registration of product information
Register the Serial Number and the Product Key in the System Environment Settings file (HULFT.PARMLIB(HULPRM)) so that HULFT runs. For details about registration methods, refer to Registration of the product information.
(12) Definition of OMVS segment
For details about how to define the OMVS segment, refer to Definition of the OMVS segment.
If you will start HULFT with the same job (PROC) name in an environment where HULFT system is already running, you do not need to perform this procedure, because the OMVS segment is already defined.
(13) Registration of user ID and password in RACF
With HULFT Ver.7 and higher, you can now use the user ID and password you registered for user authentication in RACF (Resource Access Control Facility) when connecting from HULFT Manager. RACF is a function provided by IBM Security Server.
You can select either the method of using the conventional user definition file, or the method of using RACF. You can define this definition in User ID/Password Check (USRIDCHKMODE) in the System Environment Settings file (HULFT.PARMLIB(HULPRM)). For details, refer to the explanation of the System Environment Settings file (HULFT.PARMLIB(HULPRM)) in Administration Manual.
If you switch to using RACF in HULFT Ver.8, you must register in RACF the user ID and password that you registered in the user definition file in the environment for the previous version. Check the definition for the user definition file (DD name: XRPASSWD) for the Startup JCL of the Observe program (XRACCPT), and register the user ID and password in RACF. For details about user definition files, refer to the explanation of HULFT Manager service settings in Administration Manual.
(14) Editing of Observe Definition files
Refer to the Observe Definition file (HULAPT) in HULFT Ver.6 to edit the Observe Definition file (HULAPT) in HULFT Ver.8.
When you edit the Observe definition file, do not delete any services, even if they are not defined in the Observe Definition file for HULFT Ver.6.
For details about how to edit the Observe Definition file, refer to Administration Manual.
Then, perform the procedure in Modifications to the JCL following a version upgrade.