Management Information Batch Registration command
To register or modify fields in each record of management information, you can first create a text file called 'parameter file' (definition card) by using a text editor such as Notepad, and then apply the content of the text file to the management information.
Syntax for the Management Information Batch Registration command
utliupdt -f filename [-r]
Explanation of the parameters
- -f filename
-
Parameter file name (Mandatory)
Specify the file name of the file which contains the definitions of the parameters to register.
- -r
-
Specify this parameter to modify records of the management information that already exist (Optional)
When a record with the same ID already exists, the existing management information record with the ID is overridden. If such a record does not exist, HULFT registers the management information record as a new one.
If you omit this parameter, HULFT attempts to register a new record. As a result, if another record with the same ID already exists, an error message is arisen and the registration of the ID is skipped. Then, HULFT proceeds to subsequent IDs.
Description format of parameter files
The format of the parameter file is as follows:
-
A line starting with a number sign (#) is a comment.
-
The 'END' line shows the end of one management information.
-
Specify each field in the format of 'Field=set value.' A space or tab cannot be put before or after an equal sign (=).
-
The fields are not case-sensitive.
-
Specify one field per line.
-
The field that is enclosed in square brackets ('[' and ']') can be omitted. When you do not specify this parameter, the default value is applied.
Refer to Settings of management information for default value.
-
Select one of the values if enclosed in curly brackets ('{' and '}').
-
Specification only by the underlined character (not written in full) is also possible.
Format of Send Management Information parameters
The format of the parameter file for registering or modifying records of the Send Management Information is as follows.
For details on each field, refer to Send Management Information.
SNDFILE=File ID FILENAME=Send File Name [INTERVAL=Transfer Interval] [BLOCKLEN=Transfer Block Length] [BLOCKCNT=Transfer Block Count] COMP={NO|1|2|3} .................................. Compression Preference [COMPSIZE=Compression Unit] [DEFLATELEVEL={S|D|C}] .......................... DEFLATE Level [TRANSPRTY=Transfer Priority] TRANSTYPE={FORMAT|BINARY|TEXT|MFORMAT} .......... Transfer Type [CODESET={0|A|B|C|D|E|F|G|H|I|V|W|X}] ............ EBCDIC Set KJCHNGE={S|R|N} .................................. Code Conversion [SHIFTTRANSACT={Y|N}] ............................ Shiftcode Mode [CLEAR={K|C|D|L}] ................................ Send File Mode [PREJOBID=Pre-send Job ID] [JOBID=Successful Job ID] [EJOBID=Unsuccessful Job ID] [DBID=Interface DBID] [MAILID=Mail Interface ID] GRPID=Transfer Group ID [FMTID=Format ID|Multi Format ID] [PASSWORD=Cipher Key] [COMMENT=Comment] END
-
You cannot specify "_INSTANT_TRANSFER_" for File ID.
-
If you set a value from '6' to '127' for Transfer Block Length (BLOCKLEN), HULFT automatically changes it to '128,' which is the lower limit value for HULFT Ver.8, before registering the value for the field in the Send Management Information.
-
If Forced Strong Key Mode (strongkeymode) is set to "Enabled (1)" in the System Environment Settings, use a cipher key of 64 digits hexadecimal character string (containing characters from A to F and from 0 to 9).
Format of Receive Management Information parameter
The format of the parameter file for registering or modifying records of the Receive Management Information is as follows.
For details on each field, refer to Receive Management Information.
RCVFILE=File ID FILENAME=Receive File Name [CODESET={0|A|B|C|D|E|F|G|H|I|V|W|X}] ............ EBCDIC Set TRANSMODE={NEW|REP|MOD} .......................... Registration Mode ABNORMAL={DELETE|KEEP|RESTORE} .................... Error Handling RCVTYPE={S|M} .................................... Receive Mode GENCTL={YES|NO} .................................. Generational Management [GENMNGNO=No. of Generations] [JOBID=Successful Job ID] [EJOBID=Unsuccessful Job ID] [GRPID=Transfer Group ID] [PASSWORD=Cipher Key] [MAILID=Mail Interface ID] [JOBWAIT={J|T}] .................................. Receive Completion Notification [DATAVERIFY={0|1}] ................................ Verify Data [COMMENT=Comment] END
-
You cannot specify "_INSTANT_TRANSFER_" for File ID.
-
If Forced Strong Key Mode (strongkeymode) is set to "Enabled (1)" in the System Environment Settings, use a cipher key of 64 digits hexadecimal character string (containing characters from A to F and from 0 to 9).
Format of Job Information parameters
The format of the parameter file for registering or modifying records of the Job Information is as follows.
For details on each field, refer to Job Information.
JOB=Job ID JOB DEF Job name 1 : : (Up to 13 job names can be specified) : Job name 13 DEFEND [COMMENT=Comment] END
Format of Host Information parameters
The format of the parameter file for registering or modifying records of the Host Information is as follows.
For details on each field, refer to Host Information.
HOST=Host Name HOSTTYPE={HOST|UNIX|NT|WIN|K|AS400} .................. Host Type KCODETYPE={SHIFT-JIS|JEF|EUC-JP|IBM kanji|KEIS|NEC|UTF-8|GB18030|IBM Simplified Chinese} ...................................................... Code Set for Transfer JISYEAR={0|1} ........................................ Standard for Japanese [CONNECTTYPE=LAN] .................................... Connection Type [RCVPORT=Receive Port No.] [REQPORT=Observe Port No.] [HOSTSPSNUM=Send Process Multiplex Level by Host] [MYPROXYNAME=Proxy Server Name] [MYPROXYPORT=Proxy Port No.] [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
Format of Transfer Group Information parameters
The format of the parameter file for registering or modifying records of the Transfer Group Information is as follows.
For details on each field, refer to Transfer Group Information.
GRP=Transfer Group ID SERVER DEF Host Name 1 : : (Up to 1000 fields can be specified) : Host Name 1000 DEFEND [COMMENT=Comment] END
Format of Format Information parameters
The format of the parameter file for registering or modifying records of the Format Information is as follows.
For details on each field, refer to Format Information.
FMT=Format ID FORMAT DEF Field Name 1 Start Position 1 Byte Count 1 Field Type 1 Decimal Places 1 : : (Up to 1000 fields can be specified) : Field Name 1000 Start Position 1000 Byte Count 1000 Field Type 1000 Decimal Places 1000 DEFEND [COMMENT=Comment] END
-
To obtain the default value for Start Position, enter an asterisk (*).
Then the sum of the start position and the byte count of the preceding field is provided as the default value (automatically calculated).
-
To delimit each field in a format, use one or more space and/or tab characters.
-
When Field Type is set as 'X,' 'I,' 'F,' 'N,' or 'M,' specify '0' for Decimal Places.
Format of Multi Format Information parameters
The format of the parameter file for registering or modifying records of the Multi Format Information is as follows.
For details on each field, refer to Multi Format Information.
MFMT=Multi Format ID KEYSTART=Key Start Position KEYLEN=Key Length [DFMTID=Default Format ID] MFORMAT DEF Key Value 1 Format ID 1 : : (Up to 20 fields can be specified) : Key Value 20 Format ID 20 DEFEND [COMMENT=Comment] END
-
An error occurs when you do not specify at least one set of keys and Format Information.
-
Use the Tab key or enter spaces as the delimiter of each value for Key Value and Format ID.
Format of the Mail Interface Information parameters
The format of the parameter file for registering or modifying records of the Mail Interface Information is as follows.
For details on each field, refer to Mail Interface Information.
MAIL=Mail Interface ID TITLE=Title DESTINATION=Address [MULTICAST=CC] TEXT DEF Text DEFEND [ATTACHMENT=Attachment file] [ATTACHMENTFILE=Attachment file] END
Format of Schedule Information parameters
The format of the parameter file for registering or modifying records of the Schedule Information is as follows.
For details on each field, refer to Schedule Information.
SCH=Schedule ID CMD=Command [USER=User Name] [DOMAIN=Domain Name] [PASSWD=Password] FREQUENCY={1|2|3|4|5} .................. Frequency [HOLIDAY={0|1}] ........................ Execution on Non-working Days STIME=Execution Time [WEEK={1|2|3|4|5|6|7}] ................ Execution Day of the Week [SDATE=Execution Date] [EDATE=Schedule Start Date] [COMMENT=Comment] END
-
Specify Execution Time (STIME) in the format of HHMM.
-
Specify Execution Date (SDATE) and Schedule Start Date (EDATE) in the format of YYYYMMDD.
-
When Frequency (FREQUENCY) is set to "Every Day (2)", "Every Week (3)", or "End of the Month (5)", specification of Execution Date causes an error.
Format of File Trigger Information parameters
The format of the parameter file for registering or modifying records of the File Trigger Information is as follows.
For details on each field, refer to File Trigger Information.
TRGID=Trigger ID TARGETFILENAME=File DIRECTORYNAME=Path to Directory .......... Monitoring path JOBID=Job Name [SUBDIRECTORY={Y|N}] .................. Monitor Subdirectories [CREATE={Y|N}] ........................ Monitor Creation [DELETE={Y|N}] ........................ Monitor Deletion [MODIFY={Y|N}] ........................ Monitor Modification [TYPE={T|S}] .......................... Monitoring Method [FILECHECK={Y|N}] ...................... Check File Occupancy [FILECHECKWAIT={Y|N}] .................. Wait File Availability [INTERVAL=Check Interval] [EXECUTION={Y|N}] ...................... Activate Monitoring [REGEX={Y|N}] .......................... Use Regular Expression [USER=User Name] [DOMAIN=Domain Name] [PASSWD=Password] [COMMENT=Comment] END
<Example>
# Send Management Information SNDFILE=F0000001 FILENAME=D:\users\home\p999\hulft\jinji.txt INTERVAL=0 BLOCKLEN=0 BLOCKCNT=0 COMP=3 #COMPSIZE=0 DEFLATELEVEL=D TRANSPRTY=50 TRANSTYPE=M CODESET=A KJCHNGE=S SHIFTTRANSACT=N CLEAR=K #PREJOBID= JOBID=j0000001 #EJOBID= DBID=CSV GRPID=grp1 FMTID=MFORMAT1 PASSWORD=RPC45231 COMMENT=Personnel information file END # Receive Management Information RCVFILE=F0000001 FILENAME=D:\hulft\rcv\file1.rcv CODESET=A TRANSMODE=R ABNORMAL=K RCVTYPE=S GENCTL=N JOBID=j0000002 #EJOBID= GRPID=grp1 PASSWORD=RPC45231 JOBWAIT=T DATAVERIFY=0 COMMENT=Personnel information file END # Job Information JOB=j0000001 COMMENT=Personnel information file Post-send Job JOB DEF D:\hulft\job\job_0001.exe DEFEND END # Host Information HOST=host01 HOSTTYPE=N KCODETYPE=S JISYEAR=1 CONNECTTYPE=L RCVPORT=30000 REQPORT=31000 HOSTSPSNUM=50 SENDPERMIT=Y HULJOBPERMIT=Y HULSNDRCPERMIT=Y HULRJOBPERMIT=Y ALLOWINSTTRANS=Y USRNOTIFY=N HUL7MODE=N COMMENT=Headquarter host Windows END # Transfer Group Information GRP=grp1 COMMENT=Headquarters host SERVER DEF host01 DEFEND END # Format Information FMT=FORMAT01 COMMENT=Personnel information file Key 0001 format FORMAT DEF CODE * 4 9 0 NAME * 20 X 0 AGE * 2 9 0 SEIBETU * 2 9 0 ADDRESS * 30 X 0 TEL * 11 X 0 SYOZOKU * 16 X 0 NAISEN * 10 X 0 DEFEND END # Multi Format Information MFMT=MFORMAT1 KEYSTART=1 KEYLEN=4 DFMTID=DEFAULT COMMENT=Personnel information file MFORMAT DEF 0001 FORMAT01 0002 FORMAT02 0003 FORMAT03 0004 FORMAT04 0005 FORMAT05 0006 FORMAT06 0007 FORMAT07 DEFEND END # Mail Interface Information MAIL=MAIL001 TITLE=Transfer Succeeded DESTINATION=xxx@yyy.co.jp,zzz@aaa.com MULTICAST=aaa@bbb.co.jp TEXT DEF The file transfer ended successfully. DEFEND ATTACHMENT=Y ATTACHMENTFILE=D:\users\home\p999\hulft\TransferResults.txt END # Schedule Information SCH=EVERYDAY CMD=utlsend.exe -f TEST_1 FREQUENCY=2 SDATE=00000000 WEEK=1 STIME=2145 HOLIDAY=0 EDATE=20171229 COMMENT=Schedule executed every day END # File Trigger Information TRGID=T0000001 DIRECTORYNAME=D:\users TARGETFILENAME=file1.txt JOBID=J0000001 CREATE=Y DELETE=Y MODIFY=Y TYPE=S FILECHECK=Y FILECHECKWAIT=N INTERVAL=3600 EXECUTION=Y COMMENT=Personnel information file END