Management Information Parameter File Generation

From the registered records of each type of management information, you can generate a definition card for the Management Information Batch Registration program (XRSYSINF).

(1) Management Information Parameter File Generation Program (XRINFGEN)

Program Name

XRINFGEN

XRSYSIN Definition Card

This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the explanation of the System Environment Settings in Administration Manual.

Format of definition card

OPLSELECT=Operation Log Output Option (*1) 
HULCHARSET=HULFT Character Set 
STRONGKEYMODE=Forced Strong Key mode

When you use the operation log output function, you must include definitions related to operation logs. For details, refer to Definitions for operation logs.

XRCRD Definition Card

The following shows the format of the definition card for generating a definition card for each type of management information:

SNDFILE=File ID  ..................  Definition card for Send Management Information 
RCVFILE=File ID  ..................  Definition card for Receive Management Information 
JOB=Job ID  .......................  Definition card for Job Information 
HOST=Host Name   ..................  Definition card for Host Information 
HGRPID=Transfer Group ID   ........  Definition card for Transfer Group Information 
FMTID=Format ID  ..................  Definition card for Format Information 
MFMTID=Multi Format ID ............  Definition card for Multi Format Information

The program generates a definition card for the ID that you define for each type of management information.

You can define a prefix match for IDs (by using '*'). (Example: SNDFILE=FILE*)

Defaulting the definition card for each type of management information creates all types of the management information.

Destination file to which generated definition cards are output

Table 5.1 Format of Output Destination File
DD Name	XRGEN
File Organization	Sequential Organization File
Record Length	80 bytes
Record Format	Fixed-length blocked format

Example of JCL

The following shows an example of JCL for generating definition cards for various types of management information:

//XRINFGEN JOB CLASS=A,MSGCLASS=B                                               
//INFGEN   EXEC PGM=XRINFGEN                                                    
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRFILE   DD   DSN=HULFT.FILE,DISP=SHR                                         
//XRHOST   DD   DSN=HULFT.HOST,DISP=SHR                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//XRGEN    DD   DSN=HULFT.FILE.OUT,DISP=(NEW,KEEP,DELETE),UNIT=SYSDA,           
//             VOL=SER=HUL001,DCB=(BLKSIZE=6160,LRECL=80,RECFM=FB),             
//             SPACE=(CYL,(5,1),RLSE)                                           
//SYSOUT   DD   SYSOUT=*                                                        
//XRCRD    DD   *                                                               
SNDFILE=LOOPTEST                                                                
RCVFILE=LOOPTEST                                                                
JOB=JOB01                                                                       
HOST=ZOS                                                                        
HGRPID=GRP01                                                                    
FMTID=FMT01                                                                     
MFMTID=MFMT01                                                                   
//

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
XRSYSIN	HULFT.PARMLIB(HULPRM)	System Environment Settings File
XRGEN	HULFT.FILE.OUT	Definition card output file

Parameter Name	Value	Description
UNIT	SYSDA	UNIT
VOL=SER	HUL001	Volume Name

(2) Note on changing the Forced Strong Key Mode setting

When you change the setting of Forced Strong Key Mode (STRONGKEYMODE) from "1" (Enabled) to "0" (Disabled) or from "0" (Disabled) to "1" (Enabled) in the System Environment Settings, follow the steps below to revise settings in the parameter file:

Generate a parameter file with the previous Forced Strong Key Mode (STRONGKEYMODE) setting.
Change the cipher key to a type that can be used after the Forced Strong Key Mode (STRONGKEYMODE) setting is changed.
Change the Forced Strong Key Mode (STRONGKEYMODE) setting and register the parameter file.

If you attempt to generate the parameter file by simply changing the Forced Strong Key Mode (STRONGKEYMODE) setting, not following the above steps, "%ERROR" is output into the cipher key.