5.4.14 Checking and changing the user information of the FTP adapter
This subsection describes how to check and change the user information of the FTP adapter during operations.
The user information of FTP adapters is managed by using FTP adapter account definition files.
The FTP adapter account definition files can be managed by using either of the following two methods. How to view and change the user information differs depending on which method is used for management.
-
Using an account definition file in any path of the user's choice to manage user information on a user-defined basis
If you use this method for management, you must set the ftpadp.account-inf-filepath property in the runtime-environment property file.
-
Using an account definition file in a product-specific path to manage user information on an FTP adapter basis
If you use this method for management, you do not need to set the ftpadp.account-inf-filepath property in the runtime-environment property file.
- Organization of this subsection
(1) Checking the user information of the FTP adapter
To check the user information of the FTP adapter, execute the csaftpuserls command in the operating environment.
Execution format for checking the user information of the FTP adapter is as follows:
For using an account definition file in any path of the user's choice on a user-defined basis:
csaftpuserls -f <FTP adapter account definition file path>
For using an account definition file in a product-specific path on an FTP adapter basis:
csaftpuserls -name FTP-adapter's-service-ID
For details, see "csaftpuserls (Displaying FTP adapter users)" in "Service Platform Reference Guide".
(2) Changing the user information of the FTP adapter
The following describes the prerequisites and procedure for changing the user information of an FTP adapter.
(a) Prerequisites
To check the user information of the FTP adapter, the following conditions must be fulfilled:
-
FTP reception and FTP adapter are in stopped state
For details on how to check the status of the HCSC server, see "5.3.15 Checking the HCSC server information".
(b) Changing method
To change the user information of the FTP adapter, execute the csaftpuseradd command in the operating environment.Furthermore, ifaccounting information is set even in the request message of the FTP adapter, the accounting information changed with the csaftpuseradd command is ignored, and the request message settings of the FTP adapter are enabled.
Execution format for adding, deleting users of the FTP adapter, and changing the user password is as follows:
For using an account definition file in any path of the user's choice on a user-defined basis:
- (i) Command line for adding a user
csaftpuseradd -user <user name> -pass <user password> -f <FTP adapter account definition file path>
When you add multiple users, execute command for the number of times equal to the number of users.
Execution format for registering the user set in the accounting information is as follows:
csaftpuseradd -user <user name> -pass <user password> -account <accounting information> -f <FTP adapter account definition file path>
- (ii) Command line for deleting a user
csaftpuserdel -user <user name> -f <FTP adapter account definition file path>
When you delete multiple users, execute command for the number of times equal to the number of users.
- (iii) Command line for changing the password of a user
csaftpuseradd -user <user name> -pass <user password> -r -f <FTP adapter account definition file path>
To change the passwords of multiple users, execute the preceding command for each user.
The execution format for adding the accounting information to the user and deleting the accounting information set in the user is as follows:
-
Command line for adding accounting information to a user
csaftpuseradd -user <user name> -pass <user password> -account <accounting information> -r -f <FTP adapter account definition file path>
-
Command line for deleting the accounting information from a user
csaftpuseradd -user <user name> -pass <user password> -r -f <FTP adapter account definition file path>
-
For using an account definition file in a product-specific path on an FTP adapter basis:
- (i) Command line for adding a user
csaftpuseradd -user user-name -pass user's-password -name FTP-adapter's-service-ID
To add multiple users, execute the preceding command for each user.
The command line for adding a user with accounting information set is as follows:
csaftpuseradd -user user-name -pass user's-password -account accounting-information -name FTP-adapter's-service-ID
- (ii) Command line for deleting a user
csaftpuserdel -user user-name -name FTP-adapter's-service-ID
To delete multiple users, execute the preceding command for each user.
- (iii) Command line for changing the password of a user
csaftpuseradd -user user-name -pass user's-password -r -name FTP-adapter's-service-ID
To change the passwords of multiple users, execute the preceding command for each user.
If you execute a command that changes the password for a user for whom accounting information is set, the accounting information is deleted. For such a user, use the following command line.
-
Command line for changing the user's password or accounting information
csaftpuseradd -user user-name -pass user's-password -r -account accounting-information -name FTP-adapter's-service-ID
-
For details, see "csaftpuseradd (Registering and updating FTP adapter users)" or "csaftpuserdel (Deleting FTP adapter users)" in "Service Platform Reference Guide".