Creation of the HULFT system files
This section explains how to create HULFT system files and the Operation Log files.
(1) System Files
HULFT requires the following system files (VSAM):
-
Send and Receive Management file
-
Host Information file
-
Send and Receive Log file
-
Send Control file
-
System Control file
Example of JCL
You can create the system files listed above when you execute the JCL after modifying the contents (such as File Name, Volume Serial, and Capacity) to suit the environment in use.
For details about the capacity for each system file, refer to Calculation of the size of the VSAM file.
You must carry out the initialization processing for the system files you created by using the System File Initialization program (XRCREATE). After executing the System File Initialization program (XRCREATE), use the Program to Add Information on Log Record Count (XRLOGCNT) to add information on the log record count.
JCL template for creation: HULFT.JCL (HULVSAM)
//HULVSAM 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
DELETE HULFT.FILE
DELETE HULFT.HOST
DELETE HULFT.QUEUE
DELETE HULFT.SYSCNTL
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))
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))
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))
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))
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 DSN=HULFT.LOG,DISP=SHR
//XRLOG1 DD DSN=HULFT.LOG.PATH1,DISP=SHR
//XRLOG2 DD DSN=HULFT.LOG.PATH2,DISP=SHR
//XRFILE DD DSN=HULFT.FILE,DISP=SHR
//XRHOST DD DSN=HULFT.HOST,DISP=SHR
//XRQUE DD DSN=HULFT.QUEUE,DISP=SHR
//XRCNTL DD DSN=HULFT.SYSCNTL,DISP=SHR
//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 |
|
XRFILE |
HULFT.FILE |
Send and Receive Management File |
|
XRHOST |
HULFT.HOST |
Host Information File |
|
XRQUE |
HULFT.QUEUE |
Send Control File |
|
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 |
|
XRCNTL |
HULFT.SYSCNTL |
System Control 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 |
|
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 |
|
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 |
|
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 |
|
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 the System Control file |
|
*1 |
: |
(1ST Extent Secondary) |
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 for each Operation Log file, 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) |