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.
To register transmission information, you need superuser permissions.
The table below lists and describes the transmission information options. For details about the transmission option parameters, see 3.4.1 Registering transmission information onto a transmission card.
|
Option name |
Transmission option parameter |
Value |
|---|---|---|
|
-TC |
Transmission 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 80 bytes)) |
|
-TW |
Login password |
((0 to 80 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 256 bytes)) |
|
-TR |
Remote file name |
((1 to 256 bytes)) |
|
-TS |
Name of the program to start when transmission ends normally |
((0 to 256 bytes)) |
|
-TF |
Name of the program to start when transmission ends abnormally |
((0 to 256 bytes)) |
|
-TX |
FTP command |
((0 to 300 bytes)) |
|
-TO |
Comment |
((0 to 80 bytes)) |
|
-TA |
Single/multiple-file transmission:
|
AUTO|MULTIPLE|SINGLE |
-C transmission-card-name [transmission-information-option transmission-option-parameter]
Changes from the specified transmission card the transmission information that is specified by the transmission information options.
To change transmission information, you need superuser permissions.
-D transmission-card-name
Deletes the transmission information identified by the specified transmission card name.
To delete transmission information, you need superuser permissions.
-L transmission-card-name
Displays the transmission information for the specified transmission card.
Return values
|
0 |
Normal termination |
|
61 |
Abnormal termination during registration |
|
62 |
Abnormal termination during change |
|
63 |
Abnormal termination during deletion |
|
64 |
Abnormal termination during display |
|
91 |
Abnormal termination due to a syntax error in a command parameter |
For details about the messages that are displayed, see 8.11 Messages issued by the ftsregc command (KDJF52xx).
Note
To specify zero characters in an option argument, specify the null character string.
Example: Delete the name of the program that is started when transmission ends normally:
ftsregc -C card1 -TS ""