Hitachi

uCosminexus Service Platform Reference Guide


cscresinfo (Displaying the resource information)

Organization of this page

Format

cscresinfo [-h]
 -user login-user-ID
 -pass login-password
 -csc HCSC-server-name

Function

Displays the resource information for the HCSC server. This command displays only the information for the running resource adapters, standard receptions, and HCSC components. If the HCSC server is not running, no information is displayed.

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 5.3.16 Checking Resource Operation Information of the HCSC Server in the uCosminexus Service Platform 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.

-csc HCSC-server-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))

Specifies the name of the HCSC server whose information you intend to display.

Output format

(1) When the HCSC server, standard reception, and HCSC components are all running

Information Get Time: information-collection-time
[HCSC-Server]
cluster-name.HCSC-server-name:active
 Java VM Heap Size(MB) maximum-Java-VM-heap-size/ upper-limit-for-Java-VM-heap-size
 
[DBConnector]
 resource-adapter-name maximum-number-of-DB-connections/ upper-limit-for-DB-connections
 
[StandardReception]
reception-type
 queue maximum-queue-retention-count/ upper-limit-of-queue-retention-count
 instance maximum-number-of-executions/ upper-limit-for-executions
 
[UserDefinedReception]
reception-ID-of-user-defined-reception
 queue maximum-queue-retention-count/ upper-limit-of-queue-retention-count
 instance maximum-number-of-executions/ upper-limit-for-executions
 
[BusinessProcess]
business-process-service-ID maximum-number-of-executions/ upper-limit-for-executions
 
[ServiceAdapter]
service-ID-of-service-adapter maximum-number-of-executions/ upper-limit-for-executions

(2) When the HCSC server is running and the standard reception and HCSC components are not running

Information Get Time: information-collection-time
[HCSC-Server]
cluster-name.HCSC-server-name:active
 Java VM Heap Size(MB) maximum-Java-VM-heap-size / upper-limit-for-Java-VM-heap-size
 
[DBConnector]
 resource-adapter-name maximum-number-of-DB-connections/ upper-limit-for-DB-connections
 
[StandardReception]#
 
[UserDefinedReception]#
 
[BusinessProcess]#
 
[ServiceAdapter]#
#

Only the heading is displayed.

(3) When the HCSC server is not running

[HCSC-Server]
cluster-name.HCSC-server-name:HCSC-server-status#
#

A status other than active is displayed.

Description

Display item

Description

Information collection time

Indicates the time when the information was collected. The time is output in the format YYYY/MM/DD hh:mm:ss.SSS defined with java.text.SimpleDateFormat.

  • YYYY: Year

  • MM: Month

  • DD: Date

  • hh: Hour

  • mm: Minutes

  • ss: Seconds

Cluster name

Indicates the cluster name.

HCSC server name

Indicates the name of the HCSC server.

Maximum Java VM heap size#1

Indicates the maximum Java VM heap size in megabytes. If an attempt to obtain the information fails or if the information is not obtained#2, - is displayed.

Upper limit for the Java VM heap size

Indicates the upper limit for the Java VM heap size in megabytes. If an attempt to obtain the information fails or if the information is not obtained#2, - is displayed.

Resource adapter name

Indicates the resource adapter name.

Maximum number of DB connections#1

Indicates the maximum number of DB connections. Also, in the following cases, NA/NA (invalid value) is displayed along with the upper limit for DB connections:

  • The relevant resource adapter is a root resource adapter or the DB connector for integration with Reliable Messaging

  • When the upper limit for the connection pool is set at 0

Upper limit for DB connections

Indicates the upper limit for DB connections. When only the upper limit for DB connections is displayed as NA, it indicates unlimited. For details on the display of NA/NA along with the maximum number of DB connections, see the description for Maximum number of DB connections.

Reception type

Indicates the reception type of the standard reception. One of the following values is displayed:

  • WebService (SOAP 1.1)

  • WebService (SOAP 1.2)

Maximum queue retention count#1

Indicates the maximum queue retention count. If an attempt to obtain the information fails or if the information is not obtained#3, - is displayed.

Upper limit of the queue retention count

Indicates the upper limit of the queue retention count. If an attempt to obtain the information fails, if the information is not obtained#3, or in the case of a user-defined reception (other than SOAP reception), - is displayed.

Maximum number of executions#1

Indicates the maximum number of executions. If an attempt to obtain the information fails or if the information is not obtained#3, - is output to the standard output.

Upper limit for executions

Indicates the upper limit for executions. When NA or 0 is displayed, it indicates unlimited. If an attempt to obtain the information fails or if the information is not obtained#3, - is displayed.

Reception ID of a user-defined reception

Indicates the reception ID of a user-defined reception.

Business process service ID

Indicates the business process service ID.

Service ID of a service adapter

Indicates the service ID of a service adapter.

HCSC server status

Indicates the HCSC server status. One of the following is displayed:

  • active: Running status

  • inactive: Stopped status

  • startfailed: Start failed

  • stopfailed: Stop failed

  • starting: Starting

  • stopping: Stopping

  • unknown: Collection failed

#1

The maximum value indicates the maximum value in the data collected during a period of 60 seconds.

#2

If the command is executed in the time period from the start of the HCSC server until the information is collected (60 seconds by default), the information is not obtained.

#3

If the command is executed in the time period from the start of target receptions or HCSC components until the information is collected (60 seconds by default), the information is not obtained.

Return values

Return value

Meaning

0

The command terminated normally.

1

The command terminated abnormally.

9

An error occurred when checking the execution permission.