Job Management Partner 1/File Transmission Server/FTP Description, Reference and Operator's Guide

ftshistory - displays log information

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.

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"

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2010, Hitachi, Ltd.