Management Information Batch Registration command

For registering or updating management information, create a parameter file (Definition card) in advance with the contents you want to register or modify. By specifying the contents at the time of execution, registration or update is carried out as per the contents of the parameter file.

Program interface

CALL Library name/UTLIUPDT PARM(['LIB=Library name'] 'F=filename' ['R'] 
   ['G'] ['OUTPUT=filename'] ['EXIT' CL variable name])

Explanation of parameters

LIB=Library name

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

F=filename

Parameter file name (Mandatory)

Specify this parameter in the format of Library name/File name(Member name).

R

Specify this parameter when you want to modify a record of the management information (Optional)

When the same ID already exists, the management information is modified. If the same ID does not exist, it is registered as a new ID.

Whenever you do not specify this tag, HULFT regards the transaction as new registration. Therefore the application outputs an error message if there is a same ID. In such a case, HULFT skips the registration of the relevant ID and moves on to register the next ID.

G

Control of error messages that the Management Information Batch Registration command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Management Information Batch Registration command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL variable name

Specifies to receive the error code output by the Management Information Batch Registration command and specifies the CL variable name to set the error code value (Optional)

The CL variable name must be immediately after the EXIT tag.

HULFT sets an error code to the CL variable only if the command ends unsuccessfully.

When omitted, an error code is not set.

Command interface

UTLIUPDT PARMFILE( ) PARMMBR( ) REPLACE( ) 
   LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

PARMFILE

Library name and file name of the parameter file (Mandatory)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

PARMMBR

Member name of the parameter file ("*FILE" by default)

REPLACE

Specify this parameter when you want to modify a record of the management information ("*NO" by default)

*NO :

Give an error when the same ID is registered

*YES :

Update the existing record with new one when the same ID is registered

LIBRARY

Library name in which HULFT is installed ("HULFT" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

MSG

Control of error messages ("*YES" by default)

*NO :

Suppress error messages.

*YES :

Show error messages.

FILE

Name of the library and the file to which error messages are output (Optional)

Specify this parameter in the format of Library name/File name.

Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output ("*FILE" by default)

Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.

Format of parameter file

The format of a parameter file is as follows:

• Lines starting with "*" are comments. Lines starting with 0x7B are also comments.

  However, the character represented by 0x7B varies depending on the code set.

  In the code sets for Japanese, 0x7B represents "#".

• In the parameter file output by Management Information Parameter File Generation command (UTLIGEN), the first character of the comment line is represented by an asterisk (*).

• The "END" line marks the end of a record of management information.

• Specify each field in the format of "Field=set value". You cannot set a space before and after an "equal sign (=)".

• Specify one field per line.

• The field that is enclosed in [] can be omitted. For the default value, refer to Configuring management information.

• Select one value from the value options within curved brackets {}.

• Specification only by the underlined character (not by full spell) is also possible.

• Format of Send Management Information parameters

  The format of a parameter file to register or to modify a record of the Send Management Information is as below.

  For details of each field, refer to Send Management Information.

  SNDFILE=file ID 
  FILENAME=send file name 
   [INTERVAL=transfer interval] 
   [BLOCKLEN=transfer block size] 
   [BLOCKCNT=transfer block count] 
  COMP={NO|1|2|3} ................................ Compression Preference 
   [DEFLATELEVEL={S|D|C}] ........................ DEFLATE Level 
   [TRANSPRTY=transfer priority] 
  CHARTYPE={0|A|B|C|D|E|F|G|H|I|V|W|X} ........... EBCDIC Set 
  TRANSTYPE={FORMAT|BINARY|TEXT|MULTI} ........... Transfer Type 
   [SHIFTTRANSACT={Y|N|S|C}] ..................... Shiftcode Mode 
   [SPCUT={S|N}] ................................. Subsequent Character 
   [KJCHNGE={S|R|N}] ............................. Code Conversion Side 
   [CLEAR={K|C|D|L}] ............................. Send File Mode 
   [PREJOBID=pre-send job ID] 
   [JOBID=successful job ID] 
   [ERRJOBID=unsuccessful job ID] 
   [FMTID=format ID|multi-format ID] 
   [DBID=interface DBID] 
  GRPID=transfer group ID 
   [PASSWORD=cipher key] 
   [COMMENT=comment] 
  END

  Note

  • If you specify a value from "6" to "127" for Transfer Block Length (BLOCKLEN), "128", the lower limit value for HULFT Ver.7, is set in the Send Management Information.
  • "_INSTANT_TRANSFER_" cannot be specified as File ID.
  • If Forced Strong Key Mode (STRONGKEYMODE) is set to "1" (Enabled) in the System Environment Settings, specify 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 parameters

  The format of a parameter file to register or to modify a record of the Receive Management Information is as below.

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

  RCVFILE=file ID 
  FILENAME=receive file name 
  RECORDLEN=receive file record length 
  CHANGETYPE={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} ................. Send Transfer Error Handling 
  RCVTYPE={S|M} .................................. Receive Mode 
  GENCTL={YES|NO} ................................ Generational Management 
   [GENMNGNO=number of generations] 
   [JOBID=successful job ID] 
   [ERRJOBID=unsuccessful job ID] 
   [GRPID=transfer group ID] 
   [JOBWAIT={J|T}] ............................... Receive Completion Notification 
   [PASSWORD=cipher key] 
   [DATAVERIFY={0|1}] ............................ Verify Data 
   [COMMENT=comment] 
  END

  Note

  • "_INSTANT_TRANSFER_" cannot be specified as File ID.
  • If Forced Strong Key Mode (STRONGKEYMODE) is set to "1" (Enabled) in the System Environment Settings, specify 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 a parameter file to register or to modify a record of the Job Information is as below.

  For details of each field, refer to Job Information.

  JOB=Job ID 
  JOBDESC=Job Description 
  JOB DEF 
    Job Name1 
         ： 
         : (Maximum of five names can be specified) 
         ： 
    Job Name5 
  DEFEND 
   [COMMENT=Comment] 
  END

• Format of Host Information parameters

  The format of a parameter file to register or to modify a record of the Host Information is as below.

  For details of each field, refer to Host Information.

  HOST=host name 
  HOSTTYPE={HOST|LINUX|WIN|IBMI}  .........  Host Type 
  KCODETYPE={SHIFT-JIS|JEF|EUC|IBM|UTF-8|GB18030|CH-S}  ......  Code Set for Transfer 
  JISYEAR={78|83} .......................... Standard for Japanese 
   [RCVPORT=receive port number] 
   [REQPORT=observe port number] 
   [HOSTSPSNUM=send process multiplex level by host] 
   [MYPROXYNAME=proxy server name] 
   [MYPROXYPORT=proxy port number] 
   [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}] ........................ HULFT7 Communication Mode 
   [COMMENT=comment] 
  END

  = Remarks =

  For the host type parameter, you can specify the following values specified in versions lower than HULFT10:

  • UNIX

  • NT

  • AS400

• Format of Transfer Group Information parameters

  The format of a parameter file to register or to modify a record of the Transfer Group Information is as below.

  For details of each field, refer to Transfer Group Information.

  GRP=Transfer Group ID 
  SERVER DEF 
    Host Name1 
         ： 
         : (Maximum of 48 names can be specified) 
         ： 
    Host Name48 
  DEFEND 
   [COMMENT=Comment] 
  END

• Format of Format Information parameters

  The format of a parameter file to register or to modify a record of the Format Information is as below.

  For details of each field, refer to Format Information.

  FMT=Format ID 
  FORMAT DEF 
   Field Name1 Start Position1 Byte Count1 Field Type1 Decimal Places1 
         ： 
         : (Maximum of 1000 formats can be specified) 
         ： 
    Field Name1000 Start Position1000 Bytes Count1000 Field Type1000 Decimal Places1000 
  DEFEND 
   [COMMENT=Comment] 
  END

  • To omit the Start Position, enter "*" for the field. If omitted, the sum value of the byte count and the Start Position of the preceding field is specified (automatically calculated).

  • Use a space as a delimiter of format fields.

  • Specify "0" for the Decimal Places, if the Field Type is "X", "I", "F", "N", or "M".

  Note

  If you describe comments between FORMAT DEF and DEFEND, do not begin a comment line with an asterisk (*).

  Using an asterisk (*) to begin a line between FORMAT DEF and DEFEND will handle the line as a field name.

  If you describe comments between FORMAT DEF and DEFEND, begin a comment line with 0x7B. However, the character represented by 0x7B varies depending on the code set. In the code sets for Japanese, 0x7B represents "#".

• Format of Multi Format Information parameters

  The format of a parameter file to register or to modify a record of the Multi Format Information is as below.

  For details of 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 Value1 Format ID1 
         ： 
         : (Maximum of 20 formats can be specified) 
         ： 
    Key Value20 Format ID20 
  DEFEND 
   [COMMENT=Comment] 
  END

  Separate each Key Value and Format ID with a space.

Description example

* SEND INFORMATION 
SNDFILE=F0000001 
FILENAME=MYLIB/HULFT(JINJI) 
INTERVAL=0 
BLOCKLEN=4096 
BLOCKCNT=3 
COMP=N 
TRANSPRTY=50 
TRANSTYPE=M 
CHARTYPE=A 
KJCHNGE=S 
SHIFTTRANSACT=S 
CLEAR=K 
*PREJOBID=
JOBID=J0000001 
*ERRJOBID=
*DBID=
GRPID=GRP1 
FMTID=MFORMAT1 
PASSWORD=RPC4523A 
COMMENT=PERSONNEL INFORMATION FILE 
END 

* RECEIVE INFORMATION 
RCVFILE=F0000001 
FILENAME=MYLIB/HULFT_R(JINJI_R) 
RECORDLEN=1024 
CHANGETYPE=A 
TRANSMODE=R 
ABNORMAL=K 
RCVTYPE=S 
GENCTL=N 
JOBID=J0000002 
*ERRJOBID=
GRPID=GRP1 
PASSWORD=RPC4523A 
JOBWAIT=T 
DATAVERIFY=0 
COMMENT=PERSONNEL INFORMATION FILE 
END 

* JOB INFORMATION 
JOB=J0000001 
JOBDESC=MYLIB/JOBD 
JOB DEF 
   SNDMSG MSG(SEND-SUCCESS) TOUSR(*SYSOPR) 
DEFEND 
COMMENT=JOB(PERSONNEL INFORMATION FILE) 
END 

* HOST INFORMATION 
HOST=AS400 
HOSTTYPE=I 
KCODETYPE=I 
JISYEAR=83 
RCVPORT=30000 
REQPORT=31000 
HOSTSPSNUM=20 
SENDPERMIT=Y 
HULJOBPERMIT=Y 
HULSNDRCPERMIT=Y 
HULRJOBPERMIT=Y 
USRNOTIFY=N 
COMMENT=AS400 HOST 
END 

* TRANSFER GROUP INFORMATION 
GRP=GRP1 
SERVER DEF 
   AS400 
DEFEND 
COMMENT=AS400 GROUP 
END 

* FORMAT INFORMATION 
FMT=FORMAT01 
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 
COMMENT=KEY-0001 FORMAT(PERSONNEL INFORMATION FILE) 
END 

* MULTI-FORMAT INFORMATION 
MFMT=MFORMAT1 
KEYSTART=1 
KEYLEN=4 
DFMTID=DEFAULT 
MFORMAT  DEF 
   0001  FORMAT01 
   0002  FORMAT02 
   0003  FORMAT03 
   0004  FORMAT04 
   0005  FORMAT05 
   0006  FORMAT06 
   0007  FORMAT07 
DEFEND 
COMMENT=PERSONNEL INFORMATION FILE 
END