Management Information Batch Registration utility

Reads a parameter file, and updates the management information on HULFT and HULFT-HUB Server.

Usage

utlhubiupdt -f filename [-t] [-c {e | s | 8}]

Explanation of parameters

-f filename

Parameter file name (Mandatory)

Specify the parameter file name in alphanumeric characters of no more than 256 bytes. Specify this field in an absolute path.

-t

Test (Optional)

Performs an integrity check to confirm that the specified file can be loaded without any errors. Therefore, the management information is not updated.

-c {e | s | 8}

Character code (Optional)

Specifies the character code of the parameter file.

If omitted, Kanji Code Type (KnjCode) of the System Environment Settings of HULFT-HUB Server is assumed.

Note

You can use only '-c 8' (UTF-8) in HULFT-HUB Server for Windows.

If you omit the -c parameter, the code set is automatically determined according to the Windows system locale.

Status code

0:

The utility was executed successfully.

10:

The specified options are incorrect.

12:

Failed to allocate memory.

13:

A system error occurred.

20:

There is an invalid value in the management information.

30:

An error occurred during the Distribution processing.

101 or above:

An SQL error occurred.

Notes on using the utilities

For details about the operation environment for using the utilities, see Notes on execution of utilities (commands).

Sharing a parameter file with HULFT-HUB Manager

Limitation on the administrator user

You cannot delete the administrator user (administrator).

You cannot change the settings of the administrator user (administrator).

Output example

   IMPORT
          ######################################################################### 1)
   DIST 
2) 0001/0002 HOST01:v72(New York Branch Office) 3) 
   4) 200 ######################################################################### 5)
   0002/0002 HOST02:v72(San Francisco Branch Office) 
      200 #########################################################################
   RESULT 
   HOST01:v72(New York Branch Office) 3)
   SEND 0000:0000 2015/12/11 11:13:21 Update TEST0001 
   SEND 0000:0000 2015/12/11 11:13:21 Update TEST0002 
   SEND 0000:0000 2015/12/11 11:13:22 Update TEST0003 
   SEND 0000:0000 2015/12/11 11:13:22 Update TEST0004 
   SEND 0000:0000 2015/12/11 11:13:22 Update TEST0005 
   SEND 0000:0000 2015/12/11 11:13:22 Update TEST0006 
   SEND 0000:0000 2015/12/11 11:13:22 Delete SAMPLE    
    6) :    7)              8)         9)    10)

IMPORT
       #######                                                                   11) 
The specified value is invalid.,Row Number: 571,Host Name: HOST01,Service Name: v7,
Management Information Type: SEND,ID:AC,Field Name: TransferType,Field 12)
Value: C
ERROR: The specified value is invalid.,Row Number: 572,Host Name: HOST01,Service
Name: v7,Management Information Type: SEND,ID:AD,Field Name: TransferType,Field
Value: D

Displayed fields

The following table lists and describes the fields shown in the output example.

Table 3.41 Management information type of the distribution status

Table 3.45 Displayed fields of the Management Information Batch Registration utility (when the management information type is in error)

Table 3.49 Management information type when the parameter file is in error

Re-distribution when distribution error occurs

If an error occurs during the Distribute processing, a parameter file for Re-distribution is created in the same directory as the parameter file.

After you removed the cause of the error, specify the parameter file for Re-distribution as a parameter file for the Management Information Batch Registration utility, to execute Re-distribution.

Note that this file will not be created when the error occurs during the integrity check of the field values.

The following shows an operation example when performing Re-distribution on Linux.

>utlhubiupdt -f test.csv   
IMPORT
      ##########################################################################
DIST
0001/0001 SMPLHOST:SMPLSVNAME
 000001 ########################################################################
RESULT
0001 SMPLHOST:SMPLSVNAME 
 SEND 0000:0000 2011/01/17 18:36:06 Update SMPLSND1 
 SEND 8001:8999 2011/01/17 18:36:06 Update SMPLSND2 
0082E, command (utlhubiupdt) terminated unsuccessfully. Termination code: 30 
 
>ls
test-0.csv
 
>utlhubiupdt -f test-0.csv
IMPORT
      ##########################################################################
DIST
0001/0001 SMPLHOST:SMPLSVNAME
 000001 ########################################################################
RESULT
0001 S00387:V7 
 SEND 0000:0000 2011/01/17 18:52:08 Update SMPLSND2 
 
>

Description Format of Parameter Files

The parameter file is in a CSV format. Double quotation marks (") are used as Enclosed Characters and commas (,) are used as Separators.

The following header is output in the first line:

"BATCH DISTRIBUTION FILE: HULFT-HUB SERVER VER.3.6"

The second line and onward contains parameters for each host and for each management information type. In each Management Information Block, the management information is output in a one-item-per-line basis with a title line at the top.

Figure 3.42 Output format of the parameters

For details about the setting values for each fields of management information on the client and Transfer Information on the server, see the online help provided by HULFT-HUB Manager.

For the setting values for User Information, Business Group Information, Business Permission Information, and Accumulation Environment Settings, see User Information, Business Group Information, Business Permission Information, and Accumulation Environment Settings.

Processing Mode

Processing Mode included in each output field of management information described in 2) and beyond represents an operation on the management information. There are four Processing Modes: 'U', 'A', 'D', and 'X'.

U:

Update

If there is management information with the same ID as the specified ID, the management information is updated.

A:

New creation

If there is management information with the same ID as the specified ID, a warning message is displayed and the information is not registered.

D:

Delete

No message is displayed even when the specified ID does not exist.

X:

Confirmation delete

Displays a warning message when the specified ID does not exist.

Send Management Information

Send Management Information consists of 50 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "send" is always output as the value in the first column.

Receive Management Information

Receive Management Information consists of 55 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "recv" is always output as the value in the first column.

Job Information

The Job Information consists of two types of records: Job Information Master and Job Information Slave.

Host Information

Host Information consists of 78 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "host" is always output as the value in the first column.

Transfer Group Information

The Transfer Group Information consists of two types of records: Transfer Group Information Master and Transfer Group Information Slave.

Format Information

The Format Information consists of two types of records: Format Information Master and Format Information Slave.

Multi Format Information

The Multi Format Information consists of two types of records: Multi Format Information Master and Multi Format Information Slave.

Mail Interface Information

The Mail Interface Information consists of 13 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "mail" is always output as the value in the first column.

Schedule Information

The Schedule Information consists of 20 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "sch" is always output as the value in the first column.

File Trigger Information

The File Trigger Information consists of 24 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "trg" is always output as the value in the first column.

Transfer Information

The Transfer Information consists of two type of records: Transfer Information Master and Transfer Conditions.

Transfer Destination Host Information

It consists of 13 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "transferHost" is always output as the value in the first column.

User Information

This is the information of a user used for logging in to HULFT-HUB Server from HULFT-HUB Manager.

It consists of 17 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "user" is always output as the value in the first column.

Business Group Information

It consists of 5 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "group" is always output as the value in the first column.

Business Permission Information

It consists of 8 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "auth" is always output as the value in the first column.

Accumulation Environment Settings

The fields to be set for Accumulation Environment Settings differ depending on the host.

The following types of hosts exist:

• HULFT-HUB Server logged in to via HULFT-HUB Manager

• Registered client

• Neighboring server

However, parameter files share a common format regardless of their host types. Depending on the host, parameter files may also include fields that are not used.

The definitions of the setting field types are shown in the following field description table.

The following describes the behavior of each field type by host type.

Network Connection Filter Information

It consists of 6 columns. The first line is the title line.

The setting values for the following information are output in the second line and onward. Also, "confilter" is always output as the value in the first column.