Hitachi

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


ftstran - executes transmission

Organization of this page

Format

ftstran transmission-card-name [-N file-name] [-E file-name] [-M [B|T] ] [-H host-name] [transmission-information-option transmission-option-parameter]

Function

The ftstran command executes file transmission based on the information in a specified transmission card (Select Card method of file transmission) or by modifying information in a specified transmission card (Enter Information method of file transmission).

Arguments

transmission-card-name ((1 to 20-byte character string))

Specifies the name of a transmission card that has been registered using the Transmission Regist. & Exe. window

-N file-name ((1 to 256-byte character string))

Specifies the name of the file to which the results are output when the transmission terminates normally. If this option is omitted, transmission results are not output when the transmission terminates normally.

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

If a file with the same name exists, it is overwritten.

-E file-name ((1 to 256-byte character string))

Specifies the name of the file to which the results are output when the transmission terminates abnormally. If this option is omitted, transmission results are not output when the transmission terminates abnormally.

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

If a file with the same name exists, it is overwritten.

-M [B|T]

Specifies the output format.

  • B: Binary format (data consisting of consecutive FTS_FTP_API_DATA_EX or FTS_FTP_API_RETDATA_EX structures)

  • T: Text format

-H host-name ((1 to 256-byte character string))

Specifies the host name or IP address of the computer on which the client's JP1/FTP daemon is running. When you specify an IP address, you can specify an IPv4 or IPv6 address. Use this option to specify a specific address when the ftstran command is executed in an environment where the local host has multiple IP addresses.

If you have enabled specification of the FTP client's local IP address, the value specified in this option becomes the FTP client's local IP address. If you omit this option, the address of the physical host is assumed.

If you have disabled specification of the FTP client's local IP address, the address that is assigned automatically by the OS becomes the FTP client's local IP address regardless of the specification of this option. For details about how to enable specification of the FTP client's local IP address, see 3.15 Using JP1/FTP in a multiple IP address environment.

transmission-information-option transmission-option-parameter

Specifies desired options in order to modify some of the transmission information on the specified transmission card (Enter Information method of file transmission).

For details about the transmission information options, see ftsregc - registers, changes, deletes, and displays transmission information in this chapter. For details about the transmission option parameters for the transmission information options, see 3.4.1 Registering transmission information onto a transmission card.

Return values

0

Normal termination

10

Normal termination with a warning due to an open error on the transmission-end information storage file

11

Normal termination with a warning due to an output error on the transmission-end information storage file

12

Normal termination with a warning due to a JP1/FTP connection release error

13

Abnormal termination due to unacquired card information

50

Abnormal termination due to an error in [fts_ftp_open_ex()] during JP1/FTP connection establishment

51

Abnormal termination due to an error in [fts_ftp_syn_request_ex()] during transmission request registration (synchronous)

90

Abnormal termination of transmission

91

Abnormal termination due to a syntax error in a command parameter

For details about the messages that are displayed, see 8.9 Messages issued by the ftstran command (KDJF50xx).

Usage examples