Editing system files

This section explains how to initialize the system files, define the default values of the system files, and define the number of log records to be output to the Operation Log files.

Program Name

XRCREATE

Execution parameters (for EXEC statement)

{INITSET|OPLLIMIT=999999999}

INITSET

Definition of default values

This parameter defines setting of the default values of control records of the system files.

Omitting this parameter initializes the system files.

OPLLIMIT

Definition of number of log records to be output to the Operation Log files (Optional)

This parameter defines the number of log records to be output to the Operation Log files.

Set a value from '10' to '999999999' for this parameter. When you omit the parameter itself, HULFT automatically calculates the value.

The set number of operation log initialization records and control records are output to the Operation Log files. If a data overflow occurs, the record count until that time will be the number of output log records.

= Remarks =

The number of log records to be output to the Operation Log files includes control records.
When the number of output operation log records exceeds the set value, HULFT switches the Operation Log files automatically. After switching to the new Operation Log file, HULFT initializes the old Operation Log file that has already been output. For details about the automatic switching of the operation logs, refer to Automatically switching operation logs.

System File Initialization

You can initialize the Send and Receive Management file (HULFT.FILE), the Host Information file (HULFT.HOST), the Send and Receive Log file (HULFT.LOG), the Send Control file (HULFT.QUEUE), and the Operation Log files simultaneously.

Example of JCL

The following is an example of a JOB statement that initializes the system files:

//XRCREATE JOB CLASS=A,MSGCLASS=B                                               
//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                                      
//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                                      
//XROPLF1  DD DSN=HULFT.OPLFILE1,DISP=SHR                                       
//XROPLF2  DD DSN=HULFT.OPLFILE2,DISP=SHR                                       
//XROPLC1  DD DSN=HULFT.OPLCMD1,DISP=SHR                                        
//XROPLC2  DD DSN=HULFT.OPLCMD2,DISP=SHR                                        
//

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
XRFILE	HULFT.FILE	Send and Receive Management File
XRHOST	HULFT.HOST	Host Information File
XRQUE	HULFT.QUEUE	Send Control File
XRCNTL	HULFT.SYSCNTL	System Control file
XROPLF1	HULFT.OPLFILE1	File Access Log File 1
XROPLF2	HULFT.OPLFILE2	File Access Log File 2
XROPLC1	HULFT.OPLCMD1	Command Execution Log File 1
XROPLC2	HULFT.OPLCMD2	Command Execution Log File 2

Note

These statements delete any data contained in the system files. Back up the system files as necessary.
To initialize only a single system file, define 'DUMMY' in the DD statements for the other system files. (Example: //XRFILE DD DUMMY)
After initialization of the Send and Receive Log file (HULFT.LOG), execute the Program to Add Information on Log Record Count (XRLOGCNT) as well.

Definition of default value

You can define the default values of control records without deleting the system information.

Example of JCL

The following is an example of a JOB statement that defines the default values of control records for the system files:

//XRCREATE JOB CLASS=A,MSGCLASS=B                                               
//XRCREATE EXEC PGM=XRCREATE,PARM='INITSET'                                     
//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                                      
//XROPLF1  DD DSN=HULFT.OPLFILE1,DISP=SHR                                       
//XROPLF2  DD DSN=HULFT.OPLFILE2,DISP=SHR                                       
//XROPLC1  DD DSN=HULFT.OPLCMD1,DISP=SHR                                        
//XROPLC2  DD DSN=HULFT.OPLCMD2,DISP=SHR                                        
//

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
XRFILE	HULFT.FILE	Send and Receive Management File
XRHOST	HULFT.HOST	Host Information File
XROPLF1	HULFT.OPLFILE1	File Access Log File 1
XROPLF2	HULFT.OPLFILE2	File Access Log File 2
XRQUE	HULFT.QUEUE	Send Control File
XRCNTL	HULFT.SYSCNTL	System Control file
XROPLC1	HULFT.OPLCMD1	Command Execution Log File 1
XROPLC2	HULFT.OPLCMD2	Command Execution Log File 2

Definition of number of log records to be output to Operation Log files

To create the Operation Log files based on the number of log records output instead of the file capacity, define the number of log records output as a parameter for execution (EXEC statement).

Example of JCL

The following is an example of a JOB statement that defines the number of log records to be output to the Operation Log files:

//XRCREATE JOB CLASS=A,MSGCLASS=B                                               
//XRCREATE EXEC PGM=XRCREATE,PARM='OPLLIMIT=3000'                               
//STEPLIB  DD DSN=HULFT.LOAD,DISP=SHR                                           
//XRLOG    DD DUMMY                                                             
//XRLOG1   DD DUMMY                                                             
//XRLOG2   DD DUMMY                                                             
//XRFILE   DD DUMMY                                                             
//XRHOST   DD DUMMY                                                             
//XRQUE    DD DUMMY                                                             
//XRCNTL   DD DUMMY                                  
//XROPLF1  DD DSN=HULFT.OPLFILE1,DISP=SHR                                       
//XROPLF2  DD DSN=HULFT.OPLFILE2,DISP=SHR                                       
//XROPLC1  DD DSN=HULFT.OPLCMD1,DISP=SHR                                        
//XROPLC2  DD DSN=HULFT.OPLCMD2,DISP=SHR                                        
//

DD Name	Value	Description
STEPLIB	HULFT.LOAD	HULFT load module library
XROPLF1	HULFT.OPLFILE1	File Access Log File 1
XROPLF2	HULFT.OPLFILE2	File Access Log File 2
XROPLC1	HULFT.OPLCMD1	Command Execution Log File 1
XROPLC2	HULFT.OPLCMD2	Command Execution Log File 2