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

Note
  • 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

Note
  • 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