3.1.6 Changing the service information
When a service adapter is developed in the development environment, you set up the connection destination information, timeout values, and so on for the service adapter. In the operating environment, these set values are considered as the service information and you can change the values to environment-appropriate values.
The changed service information is not applied to the repository. The changed service information is stored in the operating environment, and is applied when the service adapter is deployed in the execution environment. Therefore, you can manage the service information independent of the development environment.
Note that the service information set up in the operating environment is valid as long as the service information is not deleted. Even if the service adapter information is changed in the development environment, unless you delete the service information set up in the operating environment, the service information set up in the operating environment is applied to the service adapter.
The following figure shows the handling of the service information in each environment.
|
|
![[Figure]](GRAPHICS/ZC030400.GIF)
This subsection describes the preconditions for changing the service information and explains how to change the information.
- Organization of this subsection
(1) Preconditions
To change the service information, the following conditions must be satisfied:
-
The repository is not shared
-
In all the HCSC servers in the cluster, the service adapter that changes the service information is in an un-deployed state
(2) How to change the information
To change the service information, execute the cscsvcctl command in the operating environment.
For details on the cscsvcctl command, see "cscsvcctl (Managing the service information) " in "Service Platform Reference Guide".
The execution format of the command differs depending on whether the service information is changed in a batch or whether the specified service information is changed individually.
(a) To change the service information in a batch
To change the service information in a batch:
-
In the -getfile option, specify the file name (any) to output the service information and then execute the command.
cscsvcctl -user <login user ID> -pass <login password> -getfile <name of the service-information change definition file>
-
Define the change contents in the obtained service-information change definition file.
The values set for the proxy server user ID/ password, and basic authentication user ID/ password are output to the obtained service-information change definition file, as follows:
-
If the values are specified: The value has already been set.
-
If the values are not specified: Blank
Note that if you do not want to change the proxy server user ID/password and basic authentication user ID/password, define the obtained value as is in the -getfile option. To use basic authentication, set up all the basic authentication-related parameters (usability, user name, and password).
For details on the service-information change definition file, see "6.5.10 Service-information change definition file" in "Service Platform Reference Guide".
-
-
Specify the service-information change definition file in the -setfile option and execute the command.
cscsvcctl -user <login user ID> -pass <login password> -setfile <name of the service-information change definition file>
(b) To change the specified service information individually
To change the specified service information individually, specify the service information you want to change in the -props option, and then execute the command.
cscsvcctl -user <login user ID> -pass <login password> -cluster <cluster name> -name <Service ID of the service adapter> -props <Property>
To use basic authentication, set up all the basic authentication-related parameters (usability, user name, and password) of the service-information change definition file.
For details on the service-information change definition file, see "6.5.10 Service-information change definition file" in "Service Platform Reference Guide".
(3) Deleting the service information
The service information changed with the cscsvcctl command is deleted in the following cases:
-
When a line is commented out by coding "#" at the beginning of the service information line to be deleted, and then the service information is overwritten by specifying the -setfile option in the cscsvcctl command
-
When all the HCSC servers in the cluster are unset
-
When the service adapter that changed the service information with the cscsvcctl command is deleted or set to private# in the development environment, and imported into the operating environment
However, the service information is not deleted if a service adapter, which has the same service ID and type as the service adapter deleted in the development environment, is imported.
- Note#
-
Means that the HCSC components are deleted (deployment definition is deleted) from the HCSC server, and the system configuration definition is updated.