ftsregc - registers, changes, deletes, and displays transmission information
- Organization of this page
Format
- Registering:
ftsregc /N [transmission-card-name] [transmission-information-option transmission-option-parameter]
- Changing:
ftsregc /C transmission-card-name [transmission-information-option transmission-option-parameter]
- Deleting:
ftsregc /D transmission-card-name
- Displaying:
ftsregc /L transmission-card-name
Function
The ftsregc command registers, changes, deletes, or displays transmission information.
Arguments
/N [transmission-card-name] [transmission-information-option transmission-option-parameter]
There are two ways to register transmission information. One is by registering new transmission information that has been set on a transmission card. The other is by using an existing transmission card as a model and editing its contents in order to register it as a separate transmission card.
-
Registering new transmission information onto a transmission card
ftsregc /N [transmission-information-option transmission-option-parameter]
This method creates new transmission information based on the information specified with the transmission information options. Among the available transmission information options, you must always specify /TC, /TH, /TU, /TT, /TY, /TL, and /TR. You must use the /TC transmission information option to specify a name for the transmission card.
-
Registering transmission information using an existing transmission card
ftsregc /N [transmission-card-name] [transmission-information-option transmission-option-parameter]
This method specifies the name of a transmission card to use as a model and then specifies transmission information options to change. You must specify in /TC a name for the new transmission card that you are registering.
The table below lists and describes the transmission information options.
|
Option name |
Transmission option parameter |
Value |
|---|---|---|
|
/TC |
Card name |
((1 to 20 bytes)) |
|
/TH |
Connection-target host name |
((1 to 256 bytes)) |
|
/TP |
Connection-target port number |
((1 to 65,535)) |
|
/TU |
Login user name |
((1 to 50 bytes)) |
|
/TW |
Login password |
((1 to 50 bytes)) |
|
/TT |
Send/receive type:
|
SEND|RECV|APPE |
|
/TY |
Transmission mode:
|
ASCII|BINARY |
|
/TM |
Compression mode:
|
STREAM|COMPRESS |
|
/TK |
Size check:
|
CHECK|UNCHECK |
|
/TL |
Local file name |
((1 to 259 bytes)) |
|
/TR |
Remote file name |
((1 to 259 bytes)) |
|
/TS |
Name of the program to start when transmission ends normally |
((1 to 259 bytes)) |
|
/TF |
Name of the program to start when transmission ends abnormally |
((1 to 256 bytes)) |
|
/TX |
FTP command |
((1 to 300 bytes)) |
|
/TO |
Comment |
((1 to 80 bytes)) |
|
/TA |
Single-file or multiple-file transmission during reception:
|
AUTO|MULTIPLE|SINGLE |
|
/TSS |
Use FTPS
|
CHECK|UNCHECK |
|
/TSE |
Check the expiration date of the server certificate
|
CHECK|UNCHECK |
|
/TSA |
Path to the CA certificate |
((1 to 259 bytes)) |
|
/TSR |
Path to the CRL |
((0 to 259 bytes)) |
For details about each transmission option parameter, see 3.4.1 Registering transmission information onto a transmission card.
/C card-name [transmission-information-option transmission-option-parameter]
Changes from the specified card the transmission information that is specified by the transmission information options.
/D card-name
Deletes the transmission information identified by the specified card name.
/L card-name
Displays the transmission information for the specified card.
Notes:
-
As a transmission information option, you can specify a single-file or multiple-file transmission when receiving transmissions. Specify AUTO when sending transmissions.
-
Do not execute the ftsregc command so that multiple instances are running at the same time. If you execute multiple instances of the command at the same time, an error will occur, and even if an error message is not output, you might not get the expected results. However, when displaying transmission information, multiple instances of the ftsregc command can be executed at the same time.
Return values
|
0 |
Normal termination |
|
6100001 |
Omission of card name specification during registration |
|
6100002 |
Omission of remote host name specification during registration |
|
6100003 |
Omission of login user name specification during registration |
|
6100004 |
Omission of send/receive type specification during registration |
|
6100005 |
Omission of transmission mode specification during registration |
|
6100006 |
Omission of local file name specification during registration |
|
6100007 |
Omission of remote file name specification during registration |
|
6100008 |
Abnormal termination when an existing card name is specified |
|
6100009 |
Omission of card name specification during registration |
|
6100010 |
Abnormal termination during registration of card information |
|
6200001 |
Omission of card name specification during change |
|
6200002 |
Abnormal termination during acquisition of card information before change |
|
6200003 |
Abnormal termination during acquisition of card information after change |
|
6200004 |
Abnormal termination during deletion of card information before change |
|
6200005 |
Abnormal termination during change of card information |
|
6300000 |
Abnormal termination when ftsregc /D is specified |
|
6400000 |
Abnormal termination when ftsregc /L is specified |
|
6900000 |
Command line syntax error |
|
9000001 |
Abnormal termination common to ftsregc |
|
9900001 |
Abnormal termination (not executed by the administrator) |
For details about the messages that are displayed, see 8.3.2 Messages displayed during execution of the ftsregc command.