csmftplshistory (Displaying the transmission log)

Organization of this page

Format
Function
Arguments
Output format
Return values
Notes

Format

csmftplshistory J2EE-server-name
 [-csv output-file-path]
 [-date display-start-date-and-time,display-end-date-and-time]

To Page Top

Function

Displays the transmission log.

For details on how to use this command, see 5.4.18 Acquiring the transfer history in the uCosminexus Service Platform Setup and Operation Guide.

To Page Top

Arguments

`J2EE-server-name`

Specifies the name of the J2EE server specified when HCSC starts.

If you specify the name of a J2EE server, for which the setup has been removed, the transmission log that is already collected by this J2EE server is displayed.

`-csv` `output-file-path`

Outputs the transmission log to a CSV file. Specify the output file path as an absolute or relative path. However, in Windows, you cannot specify a relative path with a drive letter (example: C:temp\history.csv). If this option is omitted, the transmission log is output to the standard output.

`-date` `display-start-date-and-time,display-end-date-and-time`

Specify this option when the transmission command start date and time outputs only the transmission log from the display start date and time to the display end date and time.

Specify the display start date and time and the display end date and time in the following format:

Display start date and time: Specify the date and time in the YYYYMMDDhhmmss format.
Display end date and time: Specify the date and time in the YYYYMMDDhhmmss format.

YYYY: Year (1970 YYYY)

MM: Month (01 MM 12)

DD: Date (01 DD 31)

hh: Hours (00 hh 23)

mm: Minutes (00 mm 59)

ss: Seconds (00 ss 59)

In the display end date and time, if you specify a value that is older than the display start date and time, nothing is displayed. Also, if the transmission command start date and time is not stored in the transmission log due to reasons such as the abnormal termination of the transmission processing, that transmission log is not displayed.

To Page Top

Output format

Example of output in the CSV format

The name of the output item is output in the first line and the transmission log for one time is output on one line.

TransferID UserName ServerFileName...ClientPort
10.209.12.111/2200/0x00000000000000c7 admin /service1/file1...1071
10.209.12.111/2200/0x00000000000000c8 admin /service1/file2...1072
 ...

Example of output to the standard output

TransferID :10.209.12.111/2200/0x00000000000000c7
UserName :admin
ServerFileName :/service1/file1
TransferType :RETR
TransferMode :ASCII
CompressionMode :uncompress
Status :SUCCESS
TransferCmdStartTime :2010/07/22 19:00:00.000
TransferCmdEndTime :2010/07/22 19:00:02.000
TransferCmdTime :2.000
TransferStartTime :2010/07/22 19:00:01.000
TransferEndTime :2010/07/22 19:00:02.000
TransferTime :1.000
TransferSize :1024
ClientIP :10.209.12.110
ClientPort :1071
 ...

Description

Display item	Description
`TransferID`	Indicates a unique number for each transmission. This forms the PRF root application information. The ID is displayed in the format `xxx.xxx.xxx.xxx/aaa/bbb`. `xxx.xxx.xxx.xxx`: IP address of the root application `aaa`: Process ID of the root application `bbb`: Root communication number
`UserName`	Indicates the name of an authenticated user.
`ServerFileName`	Indicates the server file name for which a transmission has been requested from the client. The name is displayed in the format `/assigned-identifier/file-name`.
`TransferType`	Indicates the transfer type. One of the following is displayed: `RETR`: Transmission of files from the server to the client `STOR`: Transmission of files from the client to the server `APPE`: Transmission of files from the client to the server (additional writing to a file on the server)
`TransferMode`	Indicates the transmission mode specified for the transmission request. `ASCII`: ASCII mode `BINARY`: BINARY mode
`CompressionMode`	Indicates the compression mode specified for the transmission request. `compress`: Compress `uncompress`: Uncompress `unknown`: Data connection failed to open
`Status`	Indicates the end status of file transmission. `SUCCESS`: File transmission is successful `FAILURE`: File transmission failed
`TransferCmdStartTime`	Indicates the time at which the transmission command was received and the transmission command processing started. The time is displayed in the format `YYYY/MM/DD HH:MM:SS.mmm`. `YYYY`: Year `MM`: Month `DD`: Date `HH`: Hours `MM`: Minutes `SS`: Seconds `mmm`: Milliseconds `*****`: An error occurred before the processing of the transmission command started
`TransferCmdEndTime`	Indicates the time at which the processing of the transmission command ended. The time is displayed in the format `YYYY/MM/DD HH:MM:SS.mmm`. `YYYY`: Year `MM`: Month `DD`: Date `HH`: Hours `MM`: Minutes `SS`: Seconds `mmm`: Milliseconds
`TransferCmdTime`	Indicates the total time required for the processing of the transmission command. The time is displayed in the format `ss.SSS`. `ss`: Seconds `SSS`: Milliseconds `*****`: An error occurred before the processing of the transmission command started
`TransferStartTime`	Indicates the time at which the file transmission started. The time is displayed in the format `YYYY/MM/DD HH:MM:SS.mmm`. `YYYY`: Year `MM`: Month `DD`: Date `HH`: Hours `MM`: Minutes `SS`: Seconds `mmm`: Milliseconds `*****`: An error occurred before the transmission started
`TransferEndTime`	Indicates the time at which the file transmission ended. The time is displayed in the format `YYYY/MM/DD HH:MM:SS.mmm`. `YYYY`: Year `MM`: Month `DD`: Date `HH`: Hours `MM`: Minutes `SS`: Seconds `mmm`: Milliseconds `*****`: Transmission failed
`TransferTime`	Indicates the total time required for the file transmission. The time is displayed in the format `ss.SSS`. `ss`: Seconds `SSS`: Milliseconds `*****`: Transmission failed
`TransferSize`	Indicates the data size of the transmitted file in bytes. If the transmission fails, `-1` is displayed.
`ClientIP`	Indicates the IP address of the client that requested the transmission.
`ClientPort`	Indicates the port number of the client that requested the transmission.

To Page Top

Return values

Return value	Meaning
`0`	The command terminated normally.
`1`	The command terminated abnormally.
`3`	An exclusion error occurred.
`9`	An error occurred when checking the execution permission.

To Page Top

Notes

You can execute the command irrespective of the status of the HCSC server.
You can execute the command irrespective of the status of the FTP inbound adapter.
An error occurs when a user other than the System Administrator attempts to execute the command.

To Page Top