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 vi, and then apply the content of the text file to the management information.

Format of command

utliupdt -f filename [-r]

Explanation of the parameters

-f filename

Parameter file name (Mandatory)

Specify the file name as an alphanumeric character string within 256 bytes. Specify this field with an absolute path.

-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 indicates the end of one record of the management information.

• Specify each field in the format of 'Field=set value.' You cannot set a space or a tab 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.

  For the default value, refer to Settings of management information.

• Select one of the values if enclosed in curly brackets ('{' and '}').

• You can also specify only the underlined character (not written in full).

Format of Send Management Information parameters

The format of the parameter file for registering or modifying records of the Send Management Information is shown below.

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|4} ............................ Compression Preference 
[COMPSIZE=Compression Unit] 
[COMPMODE={S|D|C}] ........................... Compression Mode 
[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] 
GRPID=Transfer Group ID 
[FMTID=Format ID|Multi Format ID] 
[PASSWORD=Cipher Key] 
[COMMENT=Comment] 
END

Format of Receive Management Information parameters

The format of the parameter file for registering or modifying records of the Receive Management Information is shown below.

For details on each field, refer to Receive Management Information.

RCVFILE=File ID 
FILENAME=Receive File Name 
[OWNER=Owner Name] 
[GROUP=Group Name] 
PERM=Permission(*1) 
[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] 
[JOBWAIT={J|T}]  .............................. Notification 
[DATAVERIFY={0|1}] ............................ Verify Data 
[COMMENT=Comment] 
END

Format of Job Information parameters

The format of the parameter file for registering or modifying records of the Job Information is shown below.

For details on each field, refer to Job Information.

JOB=Job ID 
JOB DEF 
  Job name 1 
       : 
       :               (Up to 13 fields 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 shown below.

For details on each field, refer to Host Information.

HOST=Host Name 
HOSTTYPE={HOST|LINUX|WIN|IBMI} .................................... Host Type 
KCODETYPE={SHIFT-JIS|JEF|EUC-JP|IBM kanji|UTF-8|GB18030|IBM Simplified Chinese} 
  Code Set for Transfer 
JISYEAR={78|83} or {0|1} ................................ Standard for Japanese 
[CONNECTTYPE=LAN] .......................................... Connection Type 
[RCVPORT=Receive Port No.] 
[REQPORT=Observe Port No.] 
[HOSTSPSNUM=Send Process Multiplex Level by Host] 
[COMMENT=Comment] 
[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 
END

Format of Transfer Group Information parameters

The format of the parameter file for registering or modifying records of the Transfer Group Information is shown below.

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 shown below.

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 to '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 shown below.

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 for the delimiter of each key value and format ID.

Format of File Trigger Information parameters

The format of the parameter file for registering or modifying records of the File Trigger Information is shown below.

For details on each field, refer to File Trigger Information.

TRGID=Trigger ID 
DIRECTORYNAME=Path to Directory  ....... Monitoring path 
TARGETFILENAME=File Name 
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 
[COMMENT=Comment] 
END

Example

# Send Management Information 
SNDFILE=F0000001 
FILENAME=/users/home/p999/hulft/jinji 
INTERVAL=0 
BLOCKLEN=0 
BLOCKCNT=0 
COMP=3 
#COMPSIZE=0 
COMPMODE=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=/hulft/rcv/file1.rcv 
OWNER=p999 
GROUP=hulft 
PERM=777 
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 
   ls -l > /tmp/jobfile.000 
   /hulft/job/filesort.csh 
   cp file1.rcv file.bak 
DEFEND 
END 

# Host Information 
HOST=host01.honsya.co.jp 
HOSTTYPE=L 
KCODETYPE=S 
JISYEAR=83 
CONNECTTYPE=L 
RCVPORT=30000 
REQPORT=31000 
HOSTSPSNUM=20 
COMMENT=Headquarter host Linux 
SENDPERMIT=Y 
HULJOBPERMIT=Y 
HULSNDRCPERMIT=Y 
HULRJOBPERMIT=Y 
ALLOWINSTTRANS=Y 
USRNOTIFY=N 
HUL7MODE=N 
END 

# Transfer Group Information 
GRP=grp1 
COMMENT=Headquarter host 
SERVER DEF 
host01.honsya.co.jp 
DEFEND 
END 

# Format Information 
FMT=format01 
COMMENT=Format of Key 0001 in Personnel information file 
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 

# File Trigger Information 
TRGID=T0000001 
DIRECTORYNAME=/home/users/usr1/ 
TARGETFILENAME=file1 
JOBID=J0000001 
CREATE=Y 
DELETE=Y 
MODIFY=Y 
TYPE=S 
FILECHECK=Y 
FILECHECKWAIT=N 
INTERVAL=3600 
EXECUTION=Y 
COMMENT=Personnel information file 
END