Registration and modification of management information
You can register or modify the records of each type of management information by defining the contents as a definition card for a batch program and executing the program.
(1) Management Information Batch Registration Program (XRSYSINF)
Program Name
XRSYSINF
Execution parameters (for EXEC statement)
[NOREP|REP]
- NOREP
-
This parameter defines a new registration.
The program registers the new management information.
- REP
-
This parameter defines a modification.
If a defined ID does not exist, the program executes a new registration.
Defaulting this parameter sets 'NOREP.'
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 HULLANG=HULFT Operation Language HULCHARSET=HULFT Character Set STRONGKEYMODE=Forced Strong Key mode SYSFILEOUTPUTMODE=System File Output Mode
|
*1 |
: |
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
Use an editor or similar program to create JCL and definition cards.
For details on each field, refer to Settings of management information.
Adding an asterisk (*) at the first byte of the definition card makes the card a comment line.
-
Define the definition card of each type of management information as one record (one card). You cannot define two fields in a single line.
-
You can default the fields that are enclosed within square brackets ([]). However, there may be some restrictions depending on the files.
-
To use spaces for the Comment (COMMENT), enclose the entire comment within single quotations (').
-
The underlined strings represent the default settings.
The following shows the format of the definition card for registering or modifying a record of each type of management information.
Definition card for Send Management Information
SNDFILE=File ID
DSNAME=Dataset Name[,VOL=Volume Serial][,{CYL|TRK}={(1ST Extent,Secondary)|,OMIT}]
[WORK-VOL=Work Volume Serial]
[UNIT-CNT=UNIT Quantity]
[INTERVAL=Transfer Interval]
[BLOCKLEN=Transfer Block Length]
[BLOCKNUM=Transfer Block Count]
[CLEAR={KEEP|CLEAR|DELETE|LOCK}] ................ Send File Mode
[DIRECT={NO|YES}] .............................. Transfer Mode
[COMP={NO|1|2}] ................................ Compression Preference
[CODESET={0|A|B|C|D|E|F|G|H|V|W|X}] ............ EBCDIC Set
[TRANSTYPE]={FORMAT|BINARY|TEXT|MFORMAT} ........ Transfer Type
[SHIFT-CODE={C|S|Y|N}] .......................... Shiftcode Mode
[CODE-CONV]={SND|RCV|NOC} ...................... Code Conversion
[PRE-JOB=Pre-send Job ID]
[TRANSPRTY=Transfer Priority]
[JOBID=Successful Job ID]
[AB-JOBID=Unsuccessful Job ID]
[FMTID={Format ID|Multi Format ID}]
[DBID=Interface DBID]
GRPID=Transfer Group ID
[PASSWORD=Cipher Key|PW=Cipher Key]
[UNIT=Unit name]
[VSEQNO=Sequence Number]
[PAD={0|A|S|N}] ................................ Subsequent Character
[SND-RDW={Y|N}] ................................ Sending with RDW
[COMMENT='Comment']
END
-
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) as values because the tag names are reserved words in HULFT for the Send Management Information.
-
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) or 'NO' for the following fields because the tag names and 'NO' are reserved words in HULFT for the Send Management Information:
-
Successful Job ID (JOBID)
-
Unsuccessful Job ID (AB-JOBID)
-
Pre-send Job ID (PRE-JOB)
-
-
If the Transfer Block Length (BLOCKLEN) is set to a value from '6' to '127,' the program automatically converts it into '128,' the lower limit value for HULFT Ver.8, and registers it in the Send Management Information.
-
The available specifications and the default value of the Shiftcode Mode vary depending on the specification of the Code Set for Transfer (CS4TRNSFR) in the System Environment Settings. For details, refer to Send Management Information.
-
You cannot specify "_INSTANT_TRANSFER_" for File ID (SNDFILE).
-
If Forced Strong Key Mode (STRONGKEYMODE) is set to "1" (Enabled) in the System Environment Settings, select the tag "PW" and specify a cipher key of 64 digits hexadecimal character string (containing characters from A to F and from 0 to 9).
Definition card for Receive Management Information
RCVFILE=File ID
DSNAME=Dataset Name[,VOL=Volume Serial][,{CYL|TRK}=(1ST Extent,Secondary,RLSE)]
RECFM={F|V} .................................. Record Format
[CATALOG={Y|N|C}] ............................ Catalog method for Receive file
LRECL=Record Length
[BLOCKLEN=Block Size]
[CODESET={0|A|B|C|D|E|F|G|H|V|W|X}] .......... EBCDIC Set
TRANSMODE={NEW|REP|MOD} ...................... Registration Mode
ABNORMAL={DELETE|KEEP|RESTORE} .............. Error Handling
RCVTYPE={S|M} ................................ Receive Mode
[JOBID=Successful Job ID]
[AB-JOBID=Unsuccessful Job ID]
[GRPID=Transfer Group ID]
[RCVEND-NOTICE={T|J}] ........................ Receive Completion Notification
[PASSWORD=Cipher Key|PW=Cipher Key]
[VOL-TYPE={S|M|A}]............................ Multivolume
[MFRCVORG={R|S}] ............................ MF-to-MF File Attrib
[UNIT=Unit name]
[VSEQNO=Sequence Number]
[WORK-VOL=Work Volume Serial]
[PRINT-CNTL={A|M}] .......................... Print Character
[STORCLAS=Storage class]
[MGMTCLAS=Management Class]
[DATACLAS=Data class]
[DATAVERIFY={0|1}] .......................... Verify Data
[RCV-RDW={Y|N}] .............................. Receiving with RDW
[COMMENT='Comment']
END
-
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) as values because the tag names are reserved words in HULFT for the Receive Management Information.
-
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) or 'NO' for the following fields because the tag names and 'NO' are reserved words in HULFT for the Receive Management Information:
-
Successful Job ID (JOBID)
-
Unsuccessful Job ID (AB-JOBID)
-
-
You cannot specify "_INSTANT_TRANSFER_" for File ID (RCVFILE).
-
If Forced Strong Key Mode (STRONGKEYMODE) is set to "1" (Enabled) in the System Environment Settings, select the tag "PW" and specify a cipher key of 64 digits hexadecimal character string (containing characters from A to F and from 0 to 9).
Definition card for Job Information
JOB=Job ID DSNAME=Dataset Name MEMBER DEF Member Name 1 : : (You can specify up to 90 fields) : Member Name 90 DEFEND [JOB-RC=Value that HULFT uses to determine if the return code of a job that the user specified indicates that the job is successful] [COMMENT='Comment'] END
-
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) as values because the tag names are reserved words in HULFT for the Job Information.
-
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) or 'NO' for the Job ID (JOB) because the tag names and 'NO' are reserved words in HULFT for the Job Information.
Definition card for Host Information
HOST=Host Name
HOSTTYPE={HOST|UNIX|NT|WIN|AS400|K} ........ Host Type
KCODETYPE={SHIFT-JIS|JEF|EUC|IBM|KEIS|NEC|UTF-8|GB18030|ZH-HANS} .......... Code Set for Transfer
[JIS={78|83}] .............................. Standard for Japanese
[RCVPORT=Receive Port No.]
[REQPORT=Observe Port No.]
[LOCAL-PROXY=Proxy Server Name] ............ Proxy Server Name
[LOCAL-PROXY-PORT=Proxy Port No.] .......... Proxy Port No.
[CONNECTTYPE={L}] .......................... Connection Type
[HOSTSPSNUM=Send Process Multiplex Level by Host]
[SENDPERMIT={Y|N}] .......................... Allow Send Request/Resend Request
[HULJOBPERMIT={Y|N}] ........................ Allow to View Post-receive Job Result
[HULSNDRCPERMIT={Y|N}] ...................... Allow to Notify Job Result
[HULRJOBPERMIT={Y|N}] ...................... Allow to Execute Remote Job
[ALLOWINSTTRANS={Y|N}] ...................... Allow Instant Transfer
[USRNOTIFY={Y|N}] .......................... Notify User Details
[HUL7MODE={Y|N}] ............................ Use HULFT7 Comm. Mode
[COMMENT='Comment']
END
-
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) as values because the tag names are reserved words of HULFT for the Host Information.
-
The following fields are set when you use HULFT-HUB or HULFT-WebConnect. Do not change their values in HULFT:
-
Proxy Server Name
-
Proxy Port No.
-
For the Code Set for Transfer (KCODETYPE), 'IBM' indicates IBM Kanji, and 'EUC' indicates EUC-JP. Define 'IBM' to specify IBM Kanji, and define 'EUC' to specify EUC-JP.
Definition card for Transfer Group Information
HGRPID=Transfer Group ID SERVER DEF Host Name 1 : : (You can specify up to 1000 fields) : Host Name 1000 DEFEND [COMMENT='Comment'] END
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) as values because the tag names are reserved words of HULFT for the Transfer Group Information.
Definition card for Format Information
FMTID=Format ID FORMAT DEF Field Name 1 Start Position 1 Byte Count 1 Data type 1 [Number of decimal places 1] : : (You can specify up to 1000 fields) : Field Name 1000 Start Position 1000 Byte Count 1000 Data type 1000 [Number of decimal places 1000] DEFEND [COMMENT='Comment'] END
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) as values because the tag names are reserved words of HULFT for the Format Information.
-
You can default the Start Position. To default this field, specify '*.' Defaulting this field sets the sum value of the byte count and the Start Position of the preceding format field. (automatically calculated.)
-
Use one or more spaces to delimit fields in each format field.
Definition card for Multi Format Information
MFMTID=Multi Format ID KEY-START=Key Start Position KEY-LEN=Key Length [DEFAULT-FMTID=Default Format ID] MFORMAT DEF Key Value 1 Format ID 1 : : : : (You can specify up to 20 fields) : : Key Value 20 Format ID 20 DEFEND [COMMENT='Comment'] END
You cannot specify tag names (to the left-hand side of the strings including '=' and definition cards) as values because the tag names are reserved words of HULFT for the Multi Format Information.
Example of JCL
The following shows an example of JCL for registering the records of various types of management information:
//XRSYSINF JOB CLASS=A,MSGCLASS=B //XRSYSINF EXEC PGM=XRSYSINF,PARM='NOREP' //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 //SYSOUT DD SYSOUT=* //XRCRD DD * *DEFINITION OF FORMAT INFORMATION* FMTID=FMT0001 FORMAT DEF CODE 1 8 X NAME 9 20 N AGE * 2 9 GENDER * 2 B ADDRESS 33 30 M PHONE 63 12 X DEFEND COMMENT='PAYROLL FORMAT' END * *DEFINITION OF MULTI FORMAT INFORMATION* MFMTID=MFMT0001 KEY-START=1 KEY-LEN=2 DEFAULT-FMTID=FMT0001 MFORMAT DEF AA FMT0001 AB FMT0002 AC FMT0003 BA FMT0004 DEFEND COMMENT='TO HQ' END * *DEFINITION OF JOB INFORMATION* JOB=J0000001 DSNAME=HUL.FT01 JOB-RC=4 COMMENT='PAYROLL' MEMBER DEF DUMP1 DUMP2 DEFEND END * *DEFINITION OF HOST INFORMATION* HOST=SUN1 HOSTTYPE=HOST KCODETYPE=JEF JIS=83 RCVPORT=30000 REQPORT=31000 HOSTSPSNUM=5 SENDPERMIT=Y HULJOBPERMIT=Y HULSNDRCPERMIT=Y HULRJOBPERMIT=Y ALLOWINSTTRANS=Y USRNOTIFY=N COMMENT='HOST INFORMATION OF SYSX01' END * *DEFINITION OF TRANSFER GROUP INFORMATION* HGRPID=SUN01 SERVER DEF SUN1 SUN2 SUN3 DEFEND COMMENT='BRANCH OFFICES IN ASIA' END * *DEFINITION OF SEND MANAGEMENT INFORMATION* SNDFILE=F0000001 DSNAME=HUL.FT01,VOL=WRKX01,CYL=(1,1) WORK-VOL=WRKX01 UNIT-CNT=1 INTERVAL=0 BLOCKLEN=1000 BLOCKNUM=5 CLEAR=KEEP DIRECT=NO COMP=1 CODESET=B TRANSTYPE=MFORMAT SHIFT-CODE=S CODE-CONV=SND PRE-JOB=J0000009 TRANSPRTY=50 JOBID=J0000001 AB-JOBID=J0000002 FMTID=MFMT0001 DBID=CSV GRPID=NEWS1 UNIT=SYSDA PAD=N SND-RDW=N COMMENT='PAYROLL' END * *DEFINITION OF RECEIVE MANAGEMENT INFORMATION* RCVFILE=S0000001 DSNAME=HUL.FT01,VOL=WRKX01,CYL=(3,0) CATALOG=N RECFM=F LRECL=200 BLOCKLEN=1000 CODESET=A TRANSMODE=REP ABNORMAL=DELETE RCVTYPE=S JOBID=J000002 AB-JOBID=J000003 GRPID=SUN01 RCVEND-NOTICE=J VOL-TYPE=S UNIT=SYSDA STORCLAS=STOR01 MGMTCLAS=MGMT01 DATACLAS=DATA01 DATAVERIFY=0 RCV-RDW=N COMMENT='FILE OF EARNINGS' END *
|
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 |
|
Parameter Name |
Field Name |
Description |
|---|---|---|
|
UNIT |
SYSDA |
UNIT |
If an unregistered ID is referenced, an error occurs.
You must either register the ID to be referenced in advance, or define the ID before the ID is referenced in the JCL.