5.3.17 Checking the service adapter information
The server adapter information that you can reference differs in case of screens and commands. For details on the information that you can reference, see the contents of corresponding screens and commands in "Service Platform Reference Guide".
This subsection describes the prerequisites and methods for referencing the service adapter information.
- Organization of this subsection
(1) Prerequisites
You can reference the server adapter information only when the HCSC server is in running state.
For details on how to check HCSC server status, see "5.3.15 Checking the HCSC server information".
(2) Reference method
The methods for referencing server adapter information are as follows:
(a) When using screens
In the Tree view, double-click the service adapter. Information on the double-clicked service adapter is displayed in the editor area. You can reference the service adapter information on the Operations page in the editor area.
For details on the Operations page for service adapters, see "4.4 Operations Page" in "Service Platform Reference Guide".
You can also check the operating status of service adapter by icons displayed in the Tree view. For details on the icons displayed, see "4.1 Window structure (Operating environment)" in "Service Platform Reference Guide".
(b) When using commands
To reference the service adapter information, execute the cscstatus command or cscutil command.
You can execute the cscstatus and cscutil commands from the operating environment. Use respective commands in the following cases:
-
cscstatus command
Use this command to reference the service adapter dynamic information (running status), service ID, and update time.
-
cscutil command
Use this command to reference the service adapter static information (definition information).
The description of how to execute each command is as follows:
- When using cscstatus command
-
Execute the cscstatus command in the operating environment. Execute the command by specifying the -csc and -type options. In the -type option, specify "compo".
For details on the cscstatus command, see "cscstatus (Displaying the status)" in "Service Platform Reference Guide".
The execution format of the cscstatus command is as follows:
cscstatus -user <login user ID> -pass <login password> -csc <HCSC server name> -type compo
- When using cscutil command
-
Execute the cscutil command in the operating environment. Specify compo in the -target option and specify get_adapter_info in the -operation option.
For details on the cscutil command, see the "cscutil (Various operations)" in "Service Platform Reference Guide".
The execution format of the cscutil command differs depending on whether you use property definition file.
- When you do not use property definition file
-
In the -props option, specify the HCSC server name and the service ID of the service adapter.
cscutil -user <login user ID> -pass <login password> -mng <Manager name> -target compo -operation get_adapter_info -props "CSCSrvName=<HCSC server name>, AdapterName=<Service ID of the service adapter>"
You can use the cscrepls command to check the Manager name, HCSC server name, and the service ID of the service adapter specified in the cscutil command. For details on the cscrepls command, see "cscrepls(Displaying the repository information)" in "Service Platform Reference Guide".
- When you use the property definition file
-
Specify the name of the property definition file name in the -propfile option. You must create the property definition file beforehand in the J2SE property file format.
cscutil -user <login user ID> -pass <login password> -mng <Manager name> -target compo -operation get_adapter_info -propfile <property definition file name>
- Important note
-
-
If you acquire information of an undeployed service adapter, the character string "null" is displayed.
-
If you execute the cscutil command without the specifying the service ID of the service adapter, information of all the service adapters managed by the HCSC server is output.
-
- Information output during command execution
-
The following table lists and describes the output information during command execution. The output information that is not listed in this table is the maintenance information for troubleshooting.
Table 5‒2: Information output by the command for referencing service adapter information Output item
Output information
serviceName.<serial number>
Outputs Service component name.
adapterName. <serial number>
Displays the adapter distinguished name.
cscServerName. <serial number>
Displays the HCSC server name.
ownerCluster name. <serial number>
Displays the cluster name.
serviceKind. <serial number>
Outputs the HCSC component type.
In the case of a service adapter, outputs "ServiceAdapter".
serviceProtocolKind. <serial number>
Outputs the protocol of the service component:
-
WebService (synchronous service (Web Services) call)
-
SessionBean (synchronous service (SessionBean) call)
-
MDB_WSR (asynchronous service (MDB (WS-R) call)
-
MDB_DBQ (asynchronous service (MDB (database queue) call)
-
Custom (service adapters other than those mentioned above)
serviceStatus. <serial number>
Outputs the service adapter status:
-
active (active status)
-
inactive (inactive status)
-
starting (during startup processing)
-
startfailed (startup error)
-
stopping (during stop processing)
-
stopfailed (stopping error)
-
deleting (during deletion processing)
-
null (undeployed)
entryTime. <serial number>
Outputs the time at which the service adapter is deployed.
adapterQueueName. <serial number>
Outputs the queue name.
The service adapter type is output only in case of MDB(WS-R) or MDB ((DB queue).
modifiedTime. <serial number>
Outputs the time at which the service adapter is updated (total time in milliseconds since 1970-01-01 at 00:00:00).
lcVersion. <serial number>
Outputs the location version number.
lcRevision. <serial number>
Outputs the location revision number.
-