Access Service User's Guide DirectConnect for AS/400

Home

Access Service User's Guide DirectConnect for AS/400

Chapter 2 Configuring the DirectConnect Access Service Library

Configuration file

You create and modify access services using the access service library configuration file, a simple text file named as400.cfg. Use your text editor to change any access service property by editing and saving this configuration file. To find the location of this file within the DirectConnect directory structure, see the DirectConnect Installation Guide for Enterprise Connect IPS.

Each access service has a specific set of configuration properties. To configure an access service:

Enter site-specific values for all required properties.
When you make changes to access service properties that are not required, enter only the values that differ from the default values.

The following principles apply to properties:

Service library properties apply to the service library as a whole.
Access service properties apply to specific access services.
Configuration properties are not case sensitive.

Configuration file format

A service library configuration file consists of:

A primary section [Service Library] that groups access service library properties. The name is hard-coded and cannot be changed.
Access service sections [Service Name], shown in brackets.
Subsections {Subsection Name}, shown in braces. Subsections group the properties by type.
Configuration properties and values.

You can include comments. Each comment must be on a separate line and begin with a semicolon (;) or crosshatch (#) in column one.

Sample configuration file

Following is an example of an access service library configuration file:

[Service Library]
 {Logging}
 LogSvclibStatistics=60
 
 #The configuration for the first service
 [ServiceA]
 {ACS Required}
 ASCIICodeset=850
 ConnectionProtocol=lu62
 ConnectionSpec1=LOCALA
 ConnectionSpec2=BLANCO
 ConnectionSpec3=QPCSUPP
 DatabaseName=S10A0031DefaultClientCodeset=850
 DefaultTargetCodeset=500
 EBCDICCodeset=500
 TPName=\x7F6DB
 {Client Interaction}
 EnableAtStartup=yes
 {Logging}
 LogReceivedSQL=yes
 
 #The configuration for the second service
 [ServiceB]
 {ACS Required}
 ASCIICodeset=850
 ConnectionProtocol=lu62
 ConnectionSpec1=LOCALB
 ConnectionSpec2=BLANCO
 ConnectionSpec3=QPCSUPP
 DatabaseName=S10A0031DefaultClientCodeset=850
 DefaultTargetCodeset=500
 EBCDICCodeset=500
 TPName=\x7F6DB
 {Client Interaction}
 EnableAtStartup=yes
 {Datatype Conversion}
 DateTimeResults=char_iso
 {Logging}
 LogReceivedSQL=yes
 LogTransformedSQL=yes

You can create an initial access service using the template provided in the installation. The template file also provides an example of each configuration property.

For more information about installing the initial access service, see the DirectConnect Installation Guide for Enterprise Connect IPS.

Guidelines for access service names

Access service names must conform to the following rules:

Service names must be unique (without regard to case).
Service names must not exceed 31 characters in length for Windows NT or UNIX operating systems.
The initial character must be an alphabetic character (a-z, A-Z).
Subsequent characters can be alphabetic characters, numbers, or the underscore (_) character.

Installing a sample access service

Unless you already have a set of working configuration files, you can choose to install a sample access service within the access service library configuration file. After installing the sample access service, you can modify it for your site.

For information about installing the sample access service, see the installation instructions for your platform in the DirectConnect Installation Guide for Enterprise Connect IPS.


	Expand Search