Hitachi

JP1 Version 12 for UNIX Systems JP1/File Transmission Server/FTP Description, Reference and Operator's Guide


ftshistory - displays log information

Organization of this page

Format

ftshistory [-m format-file-name | -v] [-s transmission-time [,transmission-time] ] [-f log-file-name]

Function

The ftshistory command displays log information.

Arguments

-m format-file-name ((1 to 256-byte character string))

Displays log information in the format that was set up in the specified format file.

For details about the format file, see E. Format Files Used for Output of Definition Information.

If you specify a relative path for the file name, the command assumes the directory relative to the command execution directory.

This argument and -v are mutually exclusive.

Example of display when the default format file is specified:

[Figure]

If -m and -v are both omitted, the command displays information in the format that was set up in the default format file.

For details about the default format file, see E. Format Files Used for Output of Definition Information.

-v

Displays log information in list format.

This argument and -m are mutually exclusive.

Example of display:

[Figure]

In the list display format, the entries in the STAT (result) and S/C (server or client) columns have the following meanings:

  • STAT (result)

    • N: Transmission that terminated normally

    • A: Transmission that terminated abnormally

    • P: Start of auto-start program failed

  • S/C (server or client)

    • C: Client

    • S: Server

If the list format is used, the length of each item is limited as shown in the table below.

Table 6‒7: Number of characters displayed in the list format columns

Item name

Maximum number of characters displayed

Card name

10 characters

Local file name

18 characters

Remote host name

15 characters

Comment

15 characters

If -m and -v are both omitted, the command displays information in the format that was set up in the default format file.

For details about the default format file, see E. Format Files Used for Output of Definition Information.

-s transmission-time [,transmission-time]

Displays the log information for the specified transmission time.

If you specify two transmission time values, the command displays all log information items with an end-of-transmission time that falls within the range of the two times.

A transmission time is displayed in the following format:

YYYY/MM/DD HH:MM:SS

-f log-file-name ((1 to 256-byte character string))

Changes to the log information in the specified log file.

If you specify a relative path for the log file name, the command assumes the directory relative to the command execution directory.

Return values

0

Normal termination

64

Abnormal termination during display

91

Abnormal termination due to a syntax error in a command parameter

Note

A space character contained in a transmission time has a special meaning to the shell. In such a case, you must escape the space characters.

Example: Specifying 2004-01-01 at 00:00:00:

-s "2004/01/01 00:00:00"