cscsvcctl (Managing the service information)
Format
cscsvcctl [-h]
-user login-user-ID
-pass login-password
{-getfile name-of-service-information-change-definition-file
|-setfile name-of-service-information-change-definition-file
|-cluster cluster-name
-name service-ID-of-service-adapter
-props property}
Function
The cscsvcctl command has the following functions:
By setting up default values for mandatory options, such as the login user ID, in the HCSC-Manager command definition file, you can omit the specification of these values in this command.
For details on how to use this command, see 3.1.6 Changing the service information in the uCosminexus Service Platform System Setup and Operation Guide.
Arguments
-h
Displays the usage of commands. When you specify this option, all other options are ignored even if specified.
-user login-user-ID ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))
Specifies the user ID that is used to log in to HCSC-Manager.
-pass login-password ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))
Specifies the password that is used to log in to HCSC-Manager.
-getfile name-of-service-information-change-definition-file ((1 to 200 bytes))
Specifies the name of the service-information change definition file to be output as an absolute or relative path. If there is no directory for the specified file, the command terminates abnormally. If the specified file already exists, the file is overwritten. If a directory with the same name as the specified file name exists, the command will terminate abnormally.
Note that the values set for the proxy server user ID and password and the basic authentication user ID and password are displayed as follows in the output service-information change definition file:
-setfile name-of-service-information-change-definition-file ((1 to 200 bytes))
Specifies the name of the service-information change definition file to be entered as an absolute or relative path. If the specified file does not exist, the command terminates abnormally.
Note that when you set the service-information change definition file, specify the value obtained with the -getfile option as is if you do not want to change the proxy server user ID and password and the basic authentication user ID and password.
-cluster cluster-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the name of the cluster that contains the service adapter for changing the service information.
-name service-ID-of-service-adapter ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the service ID of the service adapter for changing the service information.
-props property ~ ((at least 1 character))
Specifies the information passed on to the operation target in the format key=value. In key, use the key name displayed with the service information display command (cscsvcls). Enclose the specified value within double quotation marks ("). Also, you can specify multiple items of the service information related to the service adapter specified in the -name option. To specify multiple items, demarcate the specified values with commas (,) (example: -props "a=b,c=d"). Note that if the LocalCall value checked with the service information display command (cscsvcls) is false, do not change the value to true.
Examples of input
cscsvcctl -getfile service_info.txt
cscsvcctl -setfile service_info.txt
cscsvcctl -cluster Cluster -name adapter1 -props "Url=aaa,ReadTimeout=60"
Return values
Return value | Meaning |
---|---|
0 | The command terminated normally. |
1 | The command terminated abnormally. |
3 | An exclusion error occurred. |
9 | An error occurred when checking the execution permission. |
Notes
When the options -setfile or -name are specified, and if the service adapter whose service information is to be changed, is being deployed (the service adapter is being deployed on one of the HCSC servers in the cluster in an HCSC server cluster configuration), the cscsvcctl command results in an error.