3.4.1 Registering transmission information onto a transmission card

Transmission card name

((1 to 20-byte character string))

Specifies a name for the transmission information. If you link to JP1/AJS3, make sure that the specified transmission card name does not contain any spaces. This item is mandatory.

Remote host name

((1 to 256-byte character string))

Specifies the name or IP address of the remote host. When you specify an IP address, you can specify an IPv4 or IPv6 address. This item is mandatory.

Port number

((1 to 65,535))

<<21>>

Specifies the port number of the remote host. If this item is omitted, 21 is assumed.

• For transmitting to the JP1/FTP server:

  Specify the port number that was specified in ftss in the port number settings.

• For transmitting to the OS's default FTP server:

  Specify the default value (21).

Remote user name

((1 to 50-byte character string))

Specifies the name of the login user at the transmission target. This item is mandatory.

Password

((0 to 50-byte character string))

Specifies the password registered for the login user. If no password was specified during the registration process, leave this item blank.

Send/receive type

Specifies the transmission type:

• Send

• Receive

Transmission mode

Specifies the transmission mode according to the file to be transmitted.

• ASCII: In this transmission mode, the receiving end adjusts linefeed codes according to the local system. Use this mode to transmit text files.

• BINARY: This mode achieves transparent transmission without having to be aware of the data contents. Use this mode to transmit data files and executable files.

Output type

Specifies how to output files after transmission:

• Append: If a file with the same name already exists, the transmitted data will be appended to that file. If there is no file with the same name, a new file will be created. This option is not available when the send/receive type is Receive.

• Overwrite: If a file with the same name already exists, that file will be overwritten (in which case the file's existing contents will be destroyed). If there is no file with the same name, a new file will be created.

Compression mode

Specifies whether to compress the transmitted files.

About the compression specification:

• If the remote FTP host does not support the compression mode, data is not compressed during transmission even if you specify compression.

• The run-length compression method defined in RFC 959 (FILE TRANSFER PROTOCOL) is used as the compression method.

Size check

Specifies whether to check the size of a transmitted file at the sending and receiving ends for errors after file transmission. If a file's transmission data size does not match between the sending and receiving ends, a transmission error results.

For the size check to be enabled, the remote FTP server must be JP1/FTP (version 06-00 or later) or uCosminexus Service Platform (version 08-53 or later).

Single/Multiple-file transmission

Specifies whether to transmit is to be of a single file or of multiple files.

• Auto: If the remote file name contains * or ?, JP1/FTP is to perform multiple-file transmission. If the file name does not contain * or ?, JP1/FTP is to perform single-file transmission.

• Multiple: JP1/FTP is to perform multiple-file transmission exactly as dictated by the wildcard.

• Single: JP1/FTP is to perform single-file transmission. If a wildcard is specified, JP1/FTP treats it as a character and transmits a single file.

Local file name

Specification depends on the transmission type, as described below. This item is mandatory.

• Send transmission type ((1 to 259-byte character string))

  Specifies the name of the file to be sent from the local system. You can use wildcard characters to specify multiple files. If you use a wildcard character, the length of the expanded path name must not exceed 259 bytes.

  To specify multiple files: You can use the following wildcard characters to specify multiple files:

  *: Any number of any characters, including no characters

  ?: Any single character

  If you send multiple files, specify a directory for the remote files. Files with the same names as local files will be created in the specified directory.

• Receive transmission type ((1 to 259-byte character string))

  Specifies the name of the file to be output at the local system after the file is received. If you have specified a wildcard in the remote file name, specify a directory name (other than the root directory). Note that the length of the expanded path name must not exceed 259 bytes.

When specifying a relative path:

If the specified directory and file exist under JP1/FTP-installation-directory\temp, the file is transmitted. If there is no such directory or file, the transmission terminates abnormally.

Local file name:

No shortcut can be specified for local file names.

Remote file name

Specification depends on the transmission type, as described below. This item is mandatory.

• Send transmission type ((1 to 259-byte character string))

  Specifies the name of the output file at the remote system. If you have used a wildcard character in the local file name, specify a directory name. Note that the length of the expanded path name must not exceed 259 bytes.

• Receive transmission type ((1 to 259-byte character string))

  Specifies the name of the input file at the remote system.

  You can use wildcard characters (* and ?) to specify multiple files. Note that the length of the expanded path name must not exceed 259 bytes.

  If you receive multiple files, specify a directory for the local files. Files with the same names as the remote files will be created in the specified directory.

How wildcard characters are interpreted:

A wildcard is specified in the NLST command and then sent to the remote FTP server. The file that is transmitted is determined by the response from the FTP server. Therefore, interpretation of the wildcard depends on the remote FTP server.

JP1/FTP supports only * and ? as wildcard characters. Wildcard characters cannot be used in directory names. If a directory name contains a wildcard, set Single/Multiple-file transmission to Single.

When specifying a relative path:

For both sending and receiving, the specified path is relative to the current directory.

About the specification of remote files:

• Browse displays files as viewed from the local system. For the remote file name, specify a file name that is viewed from the remote system.

• If Japanese characters (double-byte characters) are specified for the remote file name, the remote FTP server might refuse access or the text might become garbled in some cases.

Program to start at normal end

((0 to 259-byte character string))

Specifies the full path name of a program to start automatically at the client when transmission terminates normally. You can also specify arguments to pass as transmission information to the program when the program starts. For details about the arguments, see 3.3.1(1) Parameter keywords.

Note that if the length of the converted parameter keywords exceeds 2,047 bytes, the specified auto-start program will not start.

Program to start at abnormal end

((0 to 259-byte character string))

Specifies the full path name of a program to start automatically at the client when transmission terminates abnormally. You can also specify arguments to pass as transmission information to the program when the program starts. For details about the arguments, see 3.3.1(1) Parameter keywords.

Note that if the length of the converted parameter keywords exceeds 2,047 bytes, the specified auto-start program will not start.

FTP command

((0 to 300-byte character string))

Specifies an FTP command to be executed prior to transmission after connection is established with the server. To specify multiple commands, separate them with the semicolon (;).

Example: CWD C:\users\user1;SITE xxxx

You can specify only commands that do not establish a data connection. Whether the specified commands can be executed at the FTP server depends on the FTP server.

When the FTP server is JP1/FTP:

• Major commands that can be specified:

  CDUP, CWD, DELE, HELP, MDTM, MKD, NOOP, PWD, RMD, SITE, SIZE, STAT, SYST, XCUP, XCWD, XMKD, XPWD, XRMD

• Commands that can reference the result by means of a protocol trace:

  HELP, MDTM, SIZE, STAT, SYST

About the specification of FTP commands:

• Some commands require consecutive command transmission. Before using commands, check the FTP specifications.

• If you use a command accompanied by an argument, note the following: If Japanese characters (double-byte characters) are specified for the argument, the remote FTP server might refuse access or the text might become garbled in some cases.

Comment

((0 to 80-byte character string))

Specifies any comment. Because the comment is displayed in the log information, this option is useful for setting a memo about the transmission. A comment is not passed to the transmission target.

FTPS enable

Specifies whether to use FTPS.

When FTPS is not used, the usual FTP is used.

Server certificate expiration check

Specifies whether to check the expiration date of the server certificate used with FTPS. If you enable the checking, the transmission of files with the expired server certificate ends in failure.

Path name of the CA certificate

((0 to 259-byte character string))

Specifies a full path to the file containing the CA certificate used with FTPS.

Path name of the CRL

((0 to 259-byte character string))

Specifies a full path to the file containing the CRL used with FTPS.