cscsvcls (Displaying the service information)

Format

cscsvcls [-h]
-user login-user-ID
-pass login-password
[-detail]

Function

Outputs the service information to the standard output. This command outputs the names and the status of the definition files set up in the development or operating environments for the following receptions and service adapters. This command also checks the value specified in arguments of the cscsvcctl command.

ClassificationApplicable reception or service adapter
Receptions
  • SOAP reception
  • TP1/RPC reception
  • FTP reception
  • HTTP reception
  • Message Queue reception
  • Custom reception
Service adapters
  • DB adapter
  • TP1 adapter
  • File adapter
  • Object Access adapter
  • Message Queue adapter
  • FTP adapter
  • File operations adapter
  • Mail adapter
  • HTTP adapter
  • Custom adapter

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 the following locations in the uCosminexus Service Platform System Setup and Operation Guide according to the purpose of use:

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.

-detail

Specify this option to display the values set during development.

Output format

When -detail is not specified:

Command Edit Time: command-issuing-time
Cluster(name: cluster-name)
- ServiceAdapter(ServiceID: service-ID-of-service-adapter, ServiceType: service-adapter-type)
Attribute name: value
- ServiceAdapter(ServiceID: service-ID-of-service-adapter, ServiceType: service-adapter-type)
Attribute name: value
- ServiceAdapter(ServiceID: service-ID-of-service-adapter, ServiceType: Custom)
Definition file name: status
-UserDefinedReception(ReceptionID: reception-ID, ReceptionType: reception-type)
Definition file name: status

When -detail is specified:

Command Edit Time: command-issuing-time
Cluster(name: cluster-name)
- ServiceAdapter(ServiceID: service-ID-of-service-adapter, ServiceType: service-adapter-type)
Attribute name (def): value-specified-during-development
Attribute name (set): value
- ServiceAdapter(ServiceID: service-ID-of-service-adapter, ServiceType: service-adapter-type)
Attribute name (def): value-specified-during-development
Attribute name (set): value
- ServiceAdapter(ServiceID: service-ID-of-service-adapter, ServiceType: Custom)
Definition file name: status
Property key name: property-value
-UserDefinedReception(ReceptionID: reception-ID, ReceptionType: reception-type)
Definition file name: status
Property key name=: property-value

Description

Display itemDescription
Command Edit TimeIndicates the time when the command was issued.
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
  • SSS: Milliseconds
Cluster (name)Indicates the cluster name.
ServiceAdapter (ServiceID)Indicates the service ID of a service adapter.
ServiceTypeIndicates the service adapter type. One of the following is output:
  • SessionBean: Synchronous (SessionBean)
  • WebService: Synchronous (Web service)
  • MDB_WSR: Asynchronous (MDB (WS-R))
  • MDB_DBQ: Asynchronous (MDB (DB queue))
Attribute nameOutputs the service information that is currently valid.
Attribute name (def)Outputs the service information set up during development.
Attribute name (set)Outputs the service information specified in the service-information change definition.
Reception IDIndicates the reception ID.
Reception typeOutputs Custom.
Definition file name#1Indicates the definition file name.
StatusIndicates the definition file status. One of the following is output:
  • noChange: Status in which the self-defined file is not set in the operating environment
  • add: Status in which the self-defined file is added to the operating environment
  • changed: Status in which the definitions added to the operating environment are changed
Property key name#2If the extension of the definition file is *.properties, the property key name is output.
Property value#2If the extension of the definition file is *.properties, the property value is output.
#1
The name of HITACHI Application Integrated Property File might be displayed for a service adapter.
#2
This item is only displayed when the extension is *.properties.

The following table describes the output format for the service information. Note that the SOAP mode in the table represents the SOAP 1.1 mode and SOAP 1.1/ 1.2 combined mode.

Table 5-5 Output format of the service information

Service adapter typeSOAP modeOutput format (order of output)Corresponding attributes in the service-information change definition file
1.11.1/ 1.2 combined
WebServiceYYBasicAuthenticationIdbasic_authentication_id#1#2
YYBasicAuthenticationPassbasic_authentication_pass#1#2
YYBasicAuthenticationUsebasic_authentication_use#1
Y

SessionMaintainc4web.application.app_maintainsession#1
Y

NonProxyHostsc4web.application.non_proxy_hosts#1
Y

ProxyHostc4web.application.proxy_host#1
Y

ProxyPasswordc4web.application.proxy_password#1#2
Y

ProxyPortc4web.application.proxy_port#1
Y

ProxyUserc4web.application.proxy_user#1#2
Y

ConnectTimeoutc4web.application.socket_connect_timeout#1

Ycom.cosminexus.csc.connect.timeout#1
Y

ReadTimeoutc4web.application.socket_read_timeout#1

Ycom.cosminexus.csc.request.timeout#1
Y

WriteTimeoutc4web.application.socket_write_timeout#1
Y

PrfTraceLevelc4web.common.prf_trace_level#1
Y

ReceiveMaxSoapEnvelopeSizec4web.common.receive_max_soap_envelope_size#1
Y

SendMaxSoapEnvelopeSizec4web.common.send_max_soap_envelope_size#1

YSessionMaintaincom.cosminexus.csc.session.maintain#1
YYUrlurl
SessionBeanY

Timeoutc4web.application.ejb_timeout#1
Y

PrfTraceLevelc4web.common.prf_trace_level#1
Y

LookupNamelookupName
Y

Urlurl
MDB_WSRY

LocalCalllocal_call
Y

QueueNamequeue_name
Y

Urlurl
Y

MaxMessageNummax_message_num
Y

QosInOrderqos_in_order
Y

RdAreaNamerdarea_name
MDB_DBQYYQueueNamequeue_name
Legend:
Y: Indicates that the mode supports the output of the service information.
Blank column: Indicates that the mode does not support the output of the service information.
#1
If not specified, a space is displayed.
#2
If specified, the The value has already been set. text is displayed.

Return values

Return valueMeaning
0The command terminated normally.
1The command terminated abnormally.
3An exclusion error occurred.
9An error occurred when checking the execution permission.