cscresinfo (Displaying the resource information)

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 the resource information for HCSC servers 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.

-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
JavaVM 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
JavaVM 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 itemDescription
Information collection timeIndicates 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 nameIndicates the cluster name.
HCSC server nameIndicates the name of the HCSC server.
Maximum Java VM heap size#1Indicates 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 sizeIndicates 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. Note that the displayed value is the value obtained after excluding the size of one Survivor area from the value specified in the -Xmx option of Java VM.
Resource adapter nameIndicates the resource adapter name.
Maximum number of DB connections#1Indicates 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 connectionsIndicates 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 typeIndicates 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#1Indicates 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 countIndicates the upper limit of the queue retention count. If an attempt to obtain the information fails or if the information is not obtained#3, - is displayed.
Maximum number of executions#1Indicates 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 executionsIndicates the upper limit for executions. The value NA 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 receptionIndicates the reception ID of a user-defined reception.
Business process service IDIndicates the business process service ID.
Service ID of a service adapterIndicates the service ID of a service adapter.
HCSC server statusIndicates 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 valueMeaning
0The command terminated normally.
1The command terminated abnormally.
9An error occurred when checking the execution permission.