☰
Navigation :

FoxApp

FOX Application Configuration

The N2SVCD FOX Application is a protocol gateway application which can perform client requests using the FOX protocol. The FOX protocol is the proprietary protocol used for real-time communication by the Oracle NCC VWS nodes.

The following configuration is used to create a FOX Application instance to act as a protocol gateway to all VWS nodes in an NCC installation.

If you need to connect to more than one NCC installation (e.g. if your site has separate Production and Model SMS nodes), then you must configure multiple FOX Application instances (one for each NCC SMS node).

<?xml version="1.0" encoding="utf-8"?>
<n2svcd>
  ...
  <applications>
    ...
    <application name="FOX" module="FoxApp">
      <include><lib>../apps/fox/lib</lib></include>
      <parameters>
        <parameter name="db_app_name_smf" value="DB-PROD-SMF"/>
      </parameters>
    </application>
    ...
  </application>
  ...
</n2svcd>

Configuration Details

In addition to the common Application configuration parameters and common TCP Application Configuration parameters, the application element attributes for a FOX Application instance may include the below. For details of the various parameter types used, refer to Common Configuration.

Parameter Name Type XML Type Description
module String Attribute [Required] FoxApp
include.lib String Element [Required] ../apps/fox/lib
parameters Array Element [Required] As per Common Configuration Application parameters.
.edr_enabled - - This value is ignored; the FOX Application does not support writing EDRs.
.socket_mode - - The FOX Application supports only connect (TCP Client).
(Default = connect)
.remote_host - - This parameter is not used by the FOX Application; its remote host to connect to is taken from the OCNCC database. Refer to Connection to VWS Nodes.
.remote_port - - This parameter is not used by the FOX Application; its remote port to connect to is taken from the OCNCC database. Refer to Connection to VWS Nodes.
.db_app_name_smf String Attribute Name for DBApp instance to query for the VWS (BE) Domain Node configuration.
This DBApp instance must be connected to an OCNCC SMF node.
(Default = DB-SMF)
.client_name String Attribute The name by which the FOX Client will identify itself when connecting to NCC.
Each client connecting to the NCC BE must use a unique string for this purpose.
(Default = N2FOX-<short-hostname>)

Connection to VWS Nodes

At startup, the FoxApp Application will connect to the specified DB connection and will read all of the VWS nodes from the CCS_DOMAIN_NODES database table. It will create one permanent, re-usable connection for each configured node.

If the CCS_DOMAIN_NODES table is modified, the changes will not be applied until the n2svcd process is restarted.

Message Handling

In addition to the common Application management messages, the FoxApp uses the following messages: