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:
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:
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.
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"