Hitachi

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


3.6 Checking the transmission logs

You can check the logs of file transmissions (such as for the transmission times, the names of the transmitted files, the results and details of the transmissions, and the details of errors).

To display transmission logs, you must use the ftshistory command on the server and client.

The following table lists and describes each item in the transmission logs.

Table 3‒6: Items in the transmission logs

Item

Description

Transmission card

  • Client

    Displays the name of the card that was transmitted.

  • Server

    Not displayed.

Local file name

  • For sending

    Displays the name of the file sent from the local system.

  • For receiving

    Displays the name of the file received by the local system.

Remote file name

  • Client

    For sending: Displays the output file name at the remote system.

    For receiving: Displays the name of the input source file as is.

  • Server

    Not displayed.

Sent or received

Displays the send/receive type (Sent or Received) that was specified during the transmission request.

Transmission mode

Displays the transmission mode (ASCII or BINARY) that was specified in the transmission request.

Output type

Displays the output type (Append or Overwrite) that was specified in the transmission request.

Compress mode

Displays the compression mode (Compress or Uncompress) that was specified in the transmission request.

Remote host name

Displays the remote host name that was specified in the transmission request. This is a host name defined in the system or an IP address.

Port number

  • Client

    Displays the remote port number that executed transmission.

  • Server

    Displays 0.

User name

  • Client

    Displays the name of the remote login user that executed transmission.

  • Server

    Displays the name of the login user that received the transmission.

Comment

  • Client

    Displays the comment that was specified in the transmission request.

  • Server

    Not displayed.

Transmission number

Displays the transmission number. This number is determined separately at the server and the client. Because this is a unique number assigned to each transmission, you can use it as an identifier when you view logs. The largest transmission number is 999,999 (if this value is exceeded, the counter is reset to 0).

Server or client

  • Client

    Displayed when file transmission was executed by the client.

  • Server

    Displayed when file transmission was executed by the server.

Status at termination

Displays the termination status of the file transmission (Normal or Abnormal).

If automatic program start fails but file transmission itself was successful, Normal is displayed.

Starting time

Displays the date and time transmission started.

Ending time

Displays the date and time transmission ended.

Transmission period

Displays the amount of time (in seconds) required for the file transmission.

Transmission size

Displays the data size (in bytes) of the transmitted file.

Connection number

Displays a transmission identifier based on when JP1/FTP established connection with the remote system. This is a separate number for the server and the client in the range from 1 to the maximum number of concurrent transmissions for each. Because various traces (such as the protocol trace) are output for each connection number, you can use this number as a guide for viewing traces of the corresponding transmission.

Example: When Connection number is 2:

Client's protocol trace file: CSProtocolTrace2

Server's protocol trace file: SSProtocolTrace2

Error type

When the transmission status is Abnormal, displays one of the errors listed below.

  • System call error

  • Protocol error

  • Logical error

  • Forced termination error

  • SSL communication error

Position where error occurred

Displays the position where the error occurred in JP1/FTP.

Error module name

Displays the name of the JP1/FTP module where the error occurred.

Error system function name

Displays the name of the system call where the error occurred.

Error message

Displays details about the error.

Error protocol

Displays details about the protocol error.

SSL communication error message

Displays an SSL communication error message.

About the display of file transmission errors when a wildcard is used

Only the first error that occurred is displayed.

The following example displays all log information:

[Figure]

The following example displays the details of all log information (default format):

[Figure]

The following example displays the details of log information (default format) with a specified time (transmission end time of 2004/04/01 15:30:45):

[Figure]

The following example changes the log file and displays the log information:

[Figure]

For details about the ftshistory command, see ftshistory - displays log information in 6. Commands.