Modifying the Natural Access configuration file

This topics describes:

• The services typically used by a NaturalFax application

• A sample Natural Access configuration file

Define all services that the application uses by specifying the service and service manager names in the Natural Access configuration file (cta.cfg). For more information, refer to the Natural Access Developer's Reference Manual.

To develop and run a NaturalFax application without specifying its services in cta.cfg, but you must explicitly define the services and service managers in your application code. For more information, refer to Initializing NaturalFax.

NaturalFax services

A NaturalFax application typically uses the following services:

The default cta.cfg file includes the ADI and OAM services. Ensure that cta.cfg also includes the NFX, FAX, and FXM services. cta.cfg is located in the following directories:

An application performing only fax file image conversions, and not fax transmission or reception, does not require the FAX or FXM services.

Sample Natural Access configuration file

The following sample Natural Access configuration file shows the references to the NaturalFax services in bold:

#==========================================================================
# cta.cfg
#
# This is an example of a file that specifies Natural Access configuration.
# It allows you to:
#   - Specify generic operational settings that apply to Natural Access
#     Server, ctdaemon, and all Natural Access applications.
#     Note: these settings can be overwritten by a Natural Access
#     application via ctaInitialize.
#   - Specify application specific settings
#   - Specify Natural Access Server and ctdaemon specific settings
#   - Redefine service specific parameter defaults
#
#==========================================================================



#==========================================================================
#  Natural Access System Configuration (ctasys)
#
# Valid options are:
#   Service = name, dll        - Tells ctdaemon about available "services"
#                              - Tells the Natural Access Server what
#                                "services" to export
#
# Note: NCC should always precede ADI when both services are listed.
#==========================================================================
[ctasys]
Service = ncc, adimgr
Service = adi, adimgr
Service = dtm, adimgr
Service = ppx, ppxmgr
Service = swi, swimgr
Service = vce, vcemgr
Service = oam, oammgr

Service = nfx, nfxmgr  # add this line for NaturalFax
Service = fax, faxmgr  # add this line for NaturalFax

Service = fxm, adimgr  # add this line for NaturalFax with
                       # AG boards or CG boards
Service = fxm, qdimgr  # add this line for NaturalFax with
                       # QX 2000 boards

#==========================================================================
# Natural Access application configuration (application)
#
#==========================================================================
[application]
# DefaultServer = {inproc | localhost | server_name}
DefaultServer = inproc 

# ContextNameUniqueness = {0|1}  - Specification of responsibility for 
#                                  the context name uniqueness
#                                  (application or Natural Access Server)
# 0 - Natural Access Server is responsible for the context name uniqueness.
#     Allow context name modification by Natural Access Server to ensure 
#     name uniqueness (default)
# 1 - Application is responsible for the context name uniqueness.
#     Disallow context name modification by Natural Access Server, 
#     uniqueness error expected from Natural Access Server
ContextNameUniqueness = 0

SessionTimeout = 3

#==========================================================================
# Natural Access Server configuration (server)
#
#==========================================================================
[server]
# ParmFlags = {0|1|2}   -  Natural Access Server parameter flags
# 0 - Parameter management done by Natural Access Server, ignore parameters 
#     in ctdaemon (default).
# 1 - Parameter management done by ctdaemon 
#     (requires ctdaemon is running, otherwise Natural Access Server exits).
# 2 - Parameter management done by ctdaemon if running, otherwise done by 
#     Natural Access Server.
ParmFlags = 0

# TraceMode = {0|1|2}   -  Natural Access Server trace mode
# 0 - Tracing is disabled is default mode  
# 1 - Enable tracing, immediate write to trace memory  (default mode) 
#     (requires ctdaemon to be running)
# 2 - Write trace memory on error only, keep local trace memory for each
      context  
TraceMode = 1

# Remote tracing parameters
#   TraceMask = mask           - Defines the default tracing mask
#   TraceFile = filename       - Defines trace file name
#   StartCtaServer = {0|1}     - 0 disables starting of built-in 
#                                Natural Access Server
TraceMask = 0
# TraceFile = cta.log
StartCtaServer   = 1            

#
# DaemonAutoRestart parameter
#  0 - Do not automatically restart daemon after crash
#  1 - Automatically restart daemon after crash
#
DaemonAutoRestart = 0

# OAM Parameter
#  0 Configuration is not for an autonomous board
#  1 Assumes configuration is for autonomous board
AutonomousBoard = 0

#==========================================================================
# Natural Access Default Parameter Changes (ctapar)
#
# Valid syntax for changes is:
#   service[.x].category.field = value
#
#==========================================================================
[ctapar]

# by default, no changes are made


#==========================================================================
[eof]