Transfer Summary command

The size, time, and number of transfers can be calculated on a host basis at regular intervals.

Format of command

utllogcnt {{{[-h hostname] [-f fileid]}|-a} [-s|-r]} 
       [-fd Date1 [-ft hhmm1]|-td Date2 [-tt hhmm2]] 
       [-between hhmmss1-hhmmss2] [-c l] [-ok] 
       [-csv filename [-nt] [-o n|r|a]] [-d]

Explanation of the parameters

-h hostname

Name of the host to include in the calculation

Specify the host name as an alphanumeric character string within 68 bytes.

Multiple hosts can be specified by using an asterisk (*). Additionally, by using an asterisk (*), you can specify all host names, or specify a prefix match or a suffix match (example: ABC*).

-f fileid

File ID to include in the calculation

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

For instant transfer, specify "-f _INSTANT_TRANSFER_".

Multiple file IDs can be specified by using an asterisk (*). Additionally, by using an asterisk (*), you can specify all host names, or specify a prefix match or a suffix match (example: ABC*).

= Remarks =

When '-f' is specified and '-h' is not specified, the results are output in the sequence: File ID and host name. For other combinations, the results are output in the sequence: host name and File ID.

-a

All the hosts and file IDs will be included in the calculation

-s|-r

Type of transfer to include in the calculation (Optional)

-s:

Transfer information of the Send file.

-r:

Transfer information of the Receive file.

When not specified, all the send and receive information will become calculation targets.

-fd Date1 [-ft hhmm1]|-td Date2 [-tt hhmm2]

Date to include in the calculation (Optional)

Specify this parameter in a numeric string within 8 bytes.

Specify the date in the format that is specified for Date Format (datefmt) in the System Environment Settings. It is necessary to specify the date in the range of Date1<=Date2. The specified Date1 and Date2 also become targets for search.

Specify the time in the format of 'hhmm.' When Date1 and Date2 are the same date, it is necessary to specify the time in the range of hhmm1<=hhmm2. The specified hhmm1 and hhmm2 also become targets for search.

When you specify time by using one or both of '-ft' and '-tt,' the dates '-fd' and '-td' are mandatory.

Be sure to specify the date with either '-fd' or '-td.'

When you omit "-ft", the log records at and after 00:00 on the date you specify for "-fd" become the target of this command.

When you omit "-tt", the log records up to 23:59 on the date you specify for "-td" become the target of this command.

When you omit '-fd,' all the dates up to the date specification in '-td' become targets.

When you omit '-td,' all the dates on and after the date that is specified in '-fd' become targets.

If you specify all the parameters, HULFT targets all the data within the range of Date1 and hhmm1 to Date2 and hhmm2.

HULFT searches the start dates of sending or receiving.

-between hhmmss1-hhmmss2

Time period to include in the calculation (Optional)

Specifies the time frame that is targeted for the calculation of the date and time that is specified in the conditions.

Specify the time in the format of hhmmss. It is necessary to specify the time in the range of hhmmss1 <= hhmmss2.

The specified hhmmss1 and hhmmss2 are also targeted.

HULFT searches the start time of sending or receiving.

-c l

Connection Type (Optional)

l:

LAN transfer

When not specified, all the connection types will become the calculation targets.

-ok

Status code to include in the calculation (Optional)

When specified, transfers that ended successfully will be targeted.

When you omit this parameter, the transfers that ended successfully and unsuccessfully will be targeted.

-csv filename

Output format (Optional)

Output is done in CSV format with the specified file name.

When not specified, there will be no output in the CSV format.

The fields (CSV format) to be output in the file are as follows. Note that the target log to be output varies depending on conditions.

Host Name:

Host name

File ID:

File ID

Transfer size:

Size of the transfer

Count:

Number of transfers

Time:

Transfer time

-nt

Title (Optional)

When you specify this parameter, the title will not be output in CSV format.

This can be specified only when -csv is specified.

-o n|r|a

Parameter to specify the output file mode (Optional)

n (New Creation):

Return an error if the file exists

r (Replace):

Replace the contents if the file exists

a (Append):

Append records if the file exists

When the file does not exist, a new file will be created.

If you omit this parameter, a new file will be created.

This can be specified only when -csv is specified.

-d

Parameter to output the file in the detailed display format (Optional)

When you specify this parameter, the file will be output in the detailed display format.

When you omit this parameter, the file will be output in the simple display format.

Remarks

• When you use the simple display format for output in CSV format, the specified conditions, the transfer size, transfer count, and transfer time will be output.

• Milliseconds are truncated (not included) in the calculation of the transfer time.