Administering the RPC Server for CICS Socket Listener using the Command Central Command Line

This document describes how to administer the EntireX RPC Server for CICS® Socket Listener, using the Command Central command-line interface. It covers the following topics:

Creating an RPC Server Instance
Configuring an RPC Server Instance
Displaying the EntireX Inventory
Viewing the Runtime Status
Starting an RPC Server Instance
Stopping an RPC Server Instance
Inspecting the Log Files
Changing the Trace Level Temporarily
Deleting an RPC Server Instance

Administering the RPC Server for CICS Socket Listener using the Command Central GUI is described under Administering the RPC Server for CICS Socket Listener using the Command Central GUI. The core Command Central documentation is provided separately and is also available under Guides for Tools Shared by Software AG Products on the Software AG documentation website.

Creating an RPC Server Instance

The following table lists the parameters to include when creating an EntireX RPC instance, using the Command Central create instances commands.

Command	Parameter	Value	Opt/ Req	Description
`sagcc create instances`	`node_alias`	`name`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`type`	`RpcServerCicsSocketListener`	R	Required. EntireXCore instance type of RPC server. Must be "`RpcServerCicsSocketListener`".
	`product`	`EntireXCore`	R	Required. Must be set to "`EntireXCore`".
	`instance.name`	`name`	R	Required. Name of the runtime component, for example "`MyRpcServer`".
	`install.service`	`true \| false`	O	Optional. Register Windows Service for automatic startup. Default is `false`. If this parameter is `true`, the RPC server can be controlled by the Windows Service Control Manager.
	`server.address`	`class/server/service`	R	Required. The case-sensitive RPC server address has the format: `CLASS/SERVER/SERVICE`.
	`server.adminport`	`1025-65535`	R	Required. The administration port in range from 1025 to 65535.
	`broker.transport`	`ssl \| tcp`	R	Transport over TCP or SSL. Default is `TCP`.
	`broker.host`	`name`	R	Required. EntireX Broker host name or IP address. See Using the Broker ID in Applications in the RPC Programming documentation.
	`broker.port`	`1025-65535`	R	Required. Port number in range from 1025 to 65535.
	`broker.user`	`user`	O	Optional. The user ID for secured access to the broker.
	`broker.password`	`password`	O	Optional. The password for secured access to the broker.
	`cics.sl.transport`	`ssl \| tcp`	R	Use TCP or SSL to communicate with CICS Socket Listener.
	`cics.sl.host`	`name`	R	Hostname of CICS Socket Listener.
	`cics.sl.port`	`1-65535`	R	CICS Socket Listener Port.
	`cics.sl.transaction`	`XRFE \| transaction`	R	Required. Transaction ID (1-4 characters) defined for the RPC CICS RFE. Default is `XRFE`.
	`cics.sl.encoding`	`cp037 \| codepage`	R	Specify the appropriate EBCDIC encoding used by your CICS Socket Listener. Default is codepage `cp037` with full Latin-1 character set.
	`cics.sl.user`	`user`	O	The user ID (max. 8 chars) as defined in your underlying mainframe security system (e.g. RACF).
	`cics.sl.password`	`password`	O	Password/passphrase as defined in your underlying mainframe security system (e.g. RACF).
	`cics.sl.user.transaction.id`	`user_transaction_id`	O	The CICS transaction identifier (max. 4 chars) that will be used to run CICS programs in separate user transactions. See User Transaction Support. Avoid names starting with "C" (reserved character in CICS). Permitted characters are letters, digits and the following special characters: $ @ # . / - _ % & ? ! : \| " = , ; < >. Note: If you use a double quote character (") on the command line, escape it with backslash ("\").

Example

To create a new instance for an installed EntireX of the type "RpcServerCicsSocketListener", with name "MyRpcServer", with server address "RPC/SRV1/CALLNAT", using administration port 5757, with broker host name "localhost", listening on broker port 1971, transmitting CICS request with the transport over "tcp", to host "cicsHost", via port "5822", with transaction ID "XRFE", encoding "cp037" and user transaction ID "myId", in the installation with alias name "local":

sagcc create instances local EntireXCore type=RpcServerCicsSocketListener instance.name=MyRpcServer server.address=RPC/SRV1/CALLNAT
                                    server.adminport=5757 broker.host=localhost broker.port=1971  cics.sl.transport=TCP cics.sl.host=cicsHost cics.sl.port=5822
                                    cics.sl.transaction=XRFE cics.sl.encoding=cp037 cics.sl.user.transaction.id=myId

Information about the creation job - including the job ID - is displayed.

Configuring an RPC Server Instance

Here you can administer the parameters of the RPC Server for CICS Socket Listener. Any changes to parameters will be used the next time you start the RPC server.

Broker
CICS
Configuration File
Monitoring KPIs
Server
Trace

Broker

Here you can administer the parameters used for communication between the RPC Server for CICS Socket Listener and EntireX Broker.

Parameters
Displaying the Broker Settings of the RPC Server
Updating the Broker Settings of the RPC Server

Parameters

Parameter	Value	Opt/ Req	Description
`BrokerTransport`	`TCP` \| `SSL`	R	Transport over TCP or SSL. Default is `TCP`.
`BrokerHost`	`name`	R	Required. EntireX Broker host name or IP address. See Using the Broker ID in Applications in the RPC Programming documentation.
`BrokerPort`	`1025-65535`	R	Required. Port number in range from 1025 to 65535.
`BrokerUser`	`user`	O	Optional. The user ID for secured access to the broker.
`BrokerPassword`	`password`	O	Optional. The password for secured access to the broker.
`BrokerEncoding`	`codepage`	R	Required. Encoding used for the communication between the RPC server and EntireX Broker.
`BrokerSslTrustStore`	`filename`	O	Optional. Specifies the location of the SSL trust store.
`BrokerSslTrustStorePassword`	`password`	O	Optional. The password of the SSL trust store.
`BrokerSslVerifyServer`	`true` \| `false`	O	Optional. The RPC server as SSL client checks the identity of the broker as SSL server.
`BrokerFipsMode`	`yes` \| `no`	O	Optional. Enable FIPS-140 compliant SSL communication. Default is `no`.

Displaying the Broker Settings of the RPC Server

Command	Parameter	Opt/ Req	Description
`sagcc get configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`BROKER`".
	`-o file`	O	Optional. Specifies the file where you want the output written.

Example 1

To display the Broker parameters of the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local":

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer BROKER

Example 2

To store the Broker parameters in the file broker.json in the current working directory:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer BROKER -o broker.json

Resulting output file in JSON format:

{
"BrokerHost":"localhost",
"BrokerPort":"1971",
"BrokerTransport":"TCP",
"BrokerUser":"testuser",
"BrokerPassword":"",
"BrokerEncoding":"Cp1252",
"BrokerSslTrustStore":"",
"BrokerSslVerifyServer":"true"
"BrokerFipsMode":"no"
}

Updating the Broker Settings of the RPC Server

Command	Parameter	Opt/ Req	Description
`sagcc update configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`BROKER`".
	`-i file`	O	Optional. Specifies the file from where you want the input read.

Example

To load the Broker parameters of the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" from the file broker.json in the current working directory:

sagcc update configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer BROKER -i broker.json

See Example 2 above for sample input file.

CICS

Here you can modify the CICS-specific configuration parameters. As a prerequisite, the CICS Socket Listener must be installed. See Preparing for CICS Socket Listener.

Parameters
Displaying the CICS Socket Listener Specific Parameters
Updating the CICS Socket Listener Specific Parameters

Parameters

Command	Parameter	Opt/ Req	Description
`CicsSocketListenerTransport`	`ssl \| tcp`	R	Use TCP or SSL to communicate with CICS Socket Listener.
`CicsSocketListenerHost`	`name`	R	Hostname of CICS Socket Listener.
`CicsSocketListenerPort`	`1-65535`	R	CICS Socket Listener Port.
`CicsSocketListenerTransaction`	`XRFE \| transaction`	R	Required. Transaction ID (1-4 characters) defined for the RPC CICS RFE. Default is `XRFE`.
`CicsSocketListenerEncoding`	`cp037 \| codepage`	R	Specify the appropriate EBCDIC encoding used by your CICS Socket Listener. Default is codepage `cp037` with full Latin-1 character set.
`CicsSocketListenerSslTrustStore`	`file_path`	O	Specifies the location of the SSL trust store.
`CicsSocketListenerSslTrustStorePassword`	`password`	O	The password of the SSL trust store.
`CicsSocketListenerVerifyServer`	`true \| false`	O	The RPC server as SSL client checks the identity of CICS Socket Listener as SSL server.
`CicsSocketListenerTimeout`	`20 \| n`	R	Socket timeout (in seconds).
`CicsSocketListenerUser`	`user`	O	The user ID (max. 8 chars) as defined in your underlying mainframe security system (e.g. RACF).
`CicsSocketListenerPassword`	`password`	O	Password/passphrase as defined in your underlying mainframe security system (e.g. RACF).
`CicsSocketListenerPassTicket` ^(1,2)	`true \| false`	O	Use PassTicket instead of password.
`CicsSocketListenerApplicationName`	`application_name`	O	Required if PassTicket is to be used instead of a password. Application name (1-8 chars) as defined in your RACF system. This property is ignored if RACF password is set.
`CicsSocketListenerSecuredSignonKey`	`key_name`	O	Required if PassTicket is to be used instead of a password. Secured signon key as defined in your RACF system. Must be exactly 16 characters long.
`CicsSocketListenerUserTransactionId`	`user_transaction_id`	O	The CICS transaction identifier (max. 4 chars) that will be used to run CICS programs in separate user transactions. See User Transaction Support. Avoid names starting with "C" (reserved character in CICS). Permitted characters are letters, digits and the following special characters: $ @ # . / - _ % & ? ! : \| " = , ; < >. Note: If you use a double quote character (") on the command line, escape it with backslash ("\").

Notes:

PassTicket is supported only when the CICS Socket Listener (remote connector) on z/OS is used. See Preparing for CICS Socket Listener and EntireX CICS® Socket Listener in the z/OS Installation documentation.

By default, PassTickets can only be used once during a one-second time interval. They are protected against replay. This limits the workload to one request per second.

Warning:
IBM provides a mechanism to bypass the PassTicket's replay mechanism, allowing higher workloads, but this introduces security risks. The option to bypass the PassTicket's replay mechanism should only be used in secure environments where access to generated PassTickets is limited to a secure or internal network. See your IBM documentation for more information.

Displaying the CICS Socket Listener Specific Parameters

Command	Parameter	Opt/ Req	Description
`sagcc get configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`CICS_SOCKET_LISTENER`".
	`-o file`	O	Optional. Specifies the file where you want the output written.

Example 1

To display the CICS Socket Listener specific parameters of the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local":

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer CICS_SOCKET_LISTENER

Example 2

To store the CICS Socket Listener specific parameters in the file cics.json in the current working directory:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer CICS_SOCKET_LISTENER -o cics.json

Resulting output file in JSON format:

{
    "CicsSocketListenerTransport": "TCP",
    "CicsSocketListenerHost": "ibm2",
    "CicsSocketListenerPort": "1234",
    "CicsSocketListenerEncoding": "cp037",
    "CicsSocketListenerSslTrustStore": "",
    "CicsSocketListenerSslVerifyServer": "true",
    "CicsSocketListenerTimeout": "20",
    "CicsSocketListenerUser": "",
    "CicsSocketListenerPassTicket": "",
    "CicsSocketListenerApplicationName": "",
    "CicsSocketListenerSecuredSignonKey": "",
    "CicsSocketListenerUserTransactionId": "myId",
    "CicsSocketListenerTransaction": "XRFE"
    }

Updating the CICS Socket Listener Specific Parameters

Command	Parameter	Opt/ Req	Description
`sagcc update configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`CICS_SOCKET_LISTENER`".
	`-i file`	O	Optional. Specifies the file from where you want the input read.

Example

To modify the CICS Socket Listener parameters, get the file cics.json with the get command. Edit the parameters in this file, and update the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" with the following command:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer CICS_SOCKET_LISTENER -i cics.json

See Example 2 above for sample input file.

Configuration File

Here you can administer the configuration file of the RPC Server for CICS Socket Listener. Any changes will take effect after the next restart.

Displaying the Content of the RPC Server Configuration File
Updating the Content of the RPC Server Configuration File

Displaying the Content of the RPC Server Configuration File

Command	Parameter	Opt/ Req	Description
`sagcc get configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`CONFIGURATION`".
	`-o file`	O	Optional. Specifies the file where you want the output written.

Example 1

To display the configuration file of the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local":

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer CONFIGURATION

Example 2

To store the contents of the configuration file in the text file configuration.txt in the current working directory:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer CONFIGURATION -o configuration.txt

Updating the Content of the RPC Server Configuration File

Command	Parameter	Opt/ Req	Description
`sagcc update configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`CONFIGURATION`".
	`-i file`	O	Optional. Specifies the file from where you want the input read.

Example

To load the contents of configuration file configuration.json in the current working directory:

sagcc update configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer CONFIGURATION -i configuration.json

Monitoring KPIs

Here you can administer margins of monitored key performance indicators (KPIs) available for the RPC Server for CICS Socket Listener: Active Workers and Busy Workers.

Parameters
Displaying the Monitoring KPIs
Updating the Monitoring KPIs

Parameters

Key performance indicators (KPIs) enable you to monitor the health of your RPC Server for CICS Socket Listener. The following KPIs help you administer, troubleshoot, and resolve performance issues:

KPI	Setting
Absolute number of Active Workers	`entirex.generic.kpi.1.max=20`
Critical alert relative to maximum	`entirex.generic.kpi.1.critical=0.95`
Marginal alert relative to maximum	`entirex.generic.kpi.1.marginal=0.80`
Absolute number of Busy Workers	`entirex.generic.kpi.2.max=20`
Critical alert relative to maximum	`entirex.generic.kpi.2.critical=0.95`
Marginal alert relative to maximum	`entirex.generic.kpi.2.marginal=0.80`

Do not change the other properties!

Displaying the Monitoring KPIs

Command	Parameter	Opt/ Req	Description
`sagcc get configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`EXX-MONITORING-KPIS`".
	`-o file`	O	Optional. Specifies the file where you want the output written.

Example 1

To display the monitoring KPI properties of RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" on stdout:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer MONITORING-KPI

Example 2

To store the monitoring KPI properties in the file my.properties in the current working directory:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer MONITORING-KPI -o my.properties

Resulting output file in text format:

entirex.entirex.spm.version=10.9.0.0.473
entirex.generic.kpi.1.critical=0.95
entirex.generic.kpi.1.id=\#1
entirex.generic.kpi.1.marginal=0.80
entirex.generic.kpi.1.max=20
entirex.generic.kpi.1.name=Active Workers
entirex.generic.kpi.1.unit=
entirex.generic.kpi.1.value=0
entirex.generic.kpi.2.critical=0.95
entirex.generic.kpi.2.id=\#2
entirex.generic.kpi.2.marginal=0.80
entirex.generic.kpi.2.max=20
entirex.generic.kpi.2.name=Busy Workers
entirex.generic.kpi.2.unit=
entirex.generic.kpi.2.value=0

Updating the Monitoring KPIs

Command	Parameter	Opt/ Req	Description
`sagcc update configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`EXX-MONITORING-KPIS`".
	`-i file`	O	Optional. Specifies the file from where you want the input read.

Example

To load the contents of file my.properties in the current working directory:

sagcc update configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer MONITORING-KPI -i my.properties

Server

Here you can administer the parameters defining the registration name, the administration port and the behavior of the RPC Server for CICS Socket Listener.

Parameters
Displaying the Server Settings
Updating the Server Settings

Parameters

Parameter	Value	Opt/ Req	Description
`ServerAddress`	`class/server/service`	R	Required. The case-sensitive RPC server address has the format: `CLASS/SERVER/SERVICE`.
`ServerAdminport`	`1025-65535`	R	Required. The administration port in range from 1025 to 65535.
`ReconnectionAttempts`	`n`	R	Required. Number of reconnection attempts to the broker. When the number of attempts is reached and a connection to the broker is not possible, the RPC Server stops.
`WorkerScalability`	`true \| false`	R	You can either have a fixed or dynamic number of workers. Default is `dynamic` (`true`). For more information see Worker Models.
`FixNumber`	`1-255`	R	Required. Fixed number of workers. Must be a number in range from 1 to 255.
`MinWorkers`	`1-255`	R	Required. Minimum number of workers. Must be a number in range from 1 to 255.
`MaxWorkers`	`1-255`	R	Required. Maximum number of workers. Must be a number in range from 1 to 255.

Displaying the Server Settings

Command	Parameter	Opt/ Req	Description
`sagcc get configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`SERVER`".
	`-o file`	O	Optional. Specifies the file where you want the output written.

Example 1

To display the server parameters of RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" on stdout:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer SERVER

Example 2

To store the server parameters in the file server.json in the current working directory:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer SERVER -o server.json

Resulting output file in JSON format:

{
"ServerAddress":"RPC/SRV1/CALLNAT",
"ServerAdminport":"4711",
"ReconnectionAttempts":"15",
"WorkerScalability":"true",
"FixNumber":"5",
"MinWorkers":"1",
"MaxWorkers":"10"
}

Updating the Server Settings

Command	Parameter	Opt/ Req	Description
`sagcc update configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`SERVER`".
	`-i file`	O	Optional. Specifies the file from where you want the input read.

Example

To load the server parameters from the file server.json in the current working directory:

sagcc update configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer SERVER -i server.json

See Example 2 above for sample input file.

Trace

Here you can set the trace level of the RPC Server for CICS Socket Listener.

Parameters
Displaying the Trace Level
Updating the Trace Level

Parameters

Command	Parameter	Opt/ Req	Description
`TraceLevel`	`0 \| 1 \| 2 \| 3`	R	One of the following levels: 0 - None - No trace output (default). 1 - Standard - Minimal trace output. 2 - Advanced - Detailed trace output. 3 - Support - Support diagnostic. Use only when requested by Software AG Support.

Displaying the Trace Level

Command	Parameter	Opt/ Req	Description
`sagcc get configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`TRACE`".
	`-o file`	O	Optional. Specifies the file where you want the output written.

Example 1

To display the trace level of RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" on stdout:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer TRACE

Example 2

To store the trace level in the file trace.json in the current working directory:

sagcc get configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer TRACE -o trace.json

Resulting output file in JSON format:

{
"TraceLevel":"0"
}

Updating the Trace Level

Command	Parameter	Opt/ Req	Description
`sagcc update configuration data`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`instanceid`	R	Required. Must be "`TRACE`".
	`-i file`	O	Optional. Specifies the file from where you want the input read.

Example

To load the trace level parameters from the file trace.json in the current working directory:

sagcc update configuration data local EntireXCore-RpcServerCicsSocketListener-MyRpcServer TRACE -i trace.json

See Example 2 above for sample input file.

Displaying the EntireX Inventory

Listing all Inventory Components

The following table lists the parameters to include, when listing all EntireX instances, using the Command Central list inventory commands.

Command	Parameter	Opt/ Req	Description
`sagcc list inventory components`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
`sagcc list inventory components`	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".

Example

To list inventory components of instance EntireX in the installation with alias name "local":

sagcc list inventory components local EntireXCore*

A list of all EntireX RPC Server runtime components will be displayed.

Viewing the Runtime Status

The following table lists the parameters to include when displaying the state of an EntireX component, using the Command Central get monitoring commands.

Command	Parameter	Opt/ Req	Description
`sagcc get monitoring state`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
`sagcc get monitoring state`	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".

Example

To display state information about the RPC Server for CICS Socket Listener:

sagcc get monitoring state local EntireXCore-RpcServerCicsSocketListener-MyRpcServer

Runtime status and runtime state will be displayed.

Runtime status indicates whether a runtime component is running or not. Examples of a runtime status are ONLINE or STOPPED.
Runtime state indicates the health of a runtime component by providing key performance indicators (KPIs) for the component. Each KPI provides information about the current use, marginal use, critical use and maximum use.

Starting an RPC Server Instance

The following table lists the parameters to include when starting an EntireX RPC Server for CICS® Socket Listener, using the Command Central exec lifecycle commands.

Command	Parameter	Opt/ Req	Description
`sagcc exec lifecycle start`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
`sagcc exec lifecycle start`	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".

Example

To start the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local":

sagcc exec lifecycle start local EntireXCore-RpcServerCicsSocketListener-MyRpcServer

Information about the job - including the job ID - will be displayed.

Stopping an RPC Server Instance

The following table lists the parameters to include when stopping an EntireX RPC Server for CICS® Socket Listener, using the Command Central exec lifecycle commands.

Command	Parameter	Opt/ Req	Description
`sagcc exec lifecycle stop`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
`sagcc exec lifecycle stop`	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".

Example

To stop the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local":

sagcc exec lifecycle stop local EntireXCore-RpcServerCicsSocketListener-MyRpcServer

Information about the job - including the job ID - will be displayed.

Inspecting the Log Files

Here you can administer the log files of the RPC Server for CICS Socket Listener. The following table lists the parameters to include when displaying or modifying parameters of the RPC server, using the Command Central list commands.

List all RPC Server Log Files
Getting Content from or Downloading RPC Server Log Files

List all RPC Server Log Files

Command	Parameter	Opt/ Req	Description
`sagcc list diagnostics logs`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
`sagcc list diagnostics logs`	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".

Example

To list the log files of RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" on stdout:

sagcc list diagnostics logs local EntireXCore-RpcServerCicsSocketListener-MyRpcServer

Getting Content from or Downloading RPC Server Log Files

Command	Parameter	Opt/ Req	Description
`sagcc get diagnostics logs`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`full \| tail \| head`	O	Optional. Shows full log file content, or only tail or head.
	`export -o file`	O	Optional. Creates a zip file of the logs.

Example 1

To list the tail of the log file content in the current working directory:

sagcc get diagnostics logs local EntireXCore-RpcServerCicsSocketListener-MyRpcServer server.log tail

Example 2

To create a zip file myfile.zip of the logs:

sagcc get diagnostics logs local EntireXCore-RpcServerCicsSocketListener-MyRpcServer export -o myfile.zip

Changing the Trace Level Temporarily

Here you can temporarily change the trace level of a running RPC server. The following table lists the parameters to include when displaying or modifying parameters of an EntireX component, using the Command Central exec administration command. The change is effective immediately; there is no need to restart the RPC server.

Note:
If you want to set the trace level permanently, see Trace under Configuring an RPC Server Instance.

Displaying the Trace Level of a Running RPC Server

Command	Parameter	Opt/ Req	Description
`sagcc exec administration`	`component`	R	Required. Specifies that a component will be administered.
	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`Trace`	R	Required. Specifies what is to be administered.
	`load tracelevel=?`	R	Required. Get the trace level.
	`-f xml\|json`	R	Required. Specifies XML or JSON as output format.

Example 1

To display the current trace level of the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" in JSON format on stdout:

sagcc exec administration component local EntireXCore-RpcServerCicsSocketListener-MyRpcServer Trace load tracelevel=? -f json

Example 2

To display the current trace level of the RPC Server for CICS Socket Listener "MyRpcServer" in the installation with alias name "local" in XML format on stdout:

sagcc exec administration component local EntireXCore-RpcServerCicsSocketListener-MyRpcServer Trace load tracelevel=? -f xml

Updating the Trace Level of a Running RPC Server

Command	Parameter	Opt/ Req	Description
`sagcc exec administration`	`component`	R	Required. Specifies that a component will be administered.
	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".
	`Trace`	R	Required. Specifies what is to be administered.
	`update tracelevel`	R	Required. Update temporarily the trace level of a running RPC server.
	`-f xml\|json`	R	Required. Specifies XML or JSON as output format.

Example

To change the current trace level of the running RPC Server with the name "MyRpcServer" in the installation with alias name "local":

sagcc exec administration component local EntireXCore-RpcServerCicsSocketListener-MyRpcServer Trace update tracelevel=2 -f
                                    json

Deleting an RPC Server Instance

The following table lists the parameters to include when deleting an EntireX RPC Server instance, using the Command Central delete instances commands.

Command	Parameter	Opt/ Req	Description
`sagcc delete instances`	`node_alias`	R	Required. Specifies the alias name of the installation in which the runtime component is installed.
`sagcc delete instances`	`componentid`	R	Required. The component identifier. The prefix is "`EntireXCore-RpcServerCicsSocketListener-`".

Example

To delete an instance of an EntireX RPC Server for CICS® Socket Listener with the name "MyRpcServer" in the installation with alias name "local":


                                        sagcc delete instances local EntireXCore-RpcServerCicsSocketListener-MyRpcServer

Information about the deletion job - including the job ID - is displayed.