Application Specific Setting <appSettings>

The first tag is set to determine by which method you are connected to the host runtime system.

<add key="LINCEnvironmentProgId"     value=""/> 

The possible values are shown in the following table:

value=""

If you want to connect using the Component Enabler .NET Runtime.

value="LINCEnvironment.Bean.1"

If you want to connect using the Component Enabler Java Runtime

The following tag is set to define the protocol version and the corresponding value of a TLS Protocol:

<add key="SslProtocolVersion"    value="ProtocolValue"/>

The default version of the TLS Protocol is TLS1.2 and its corresponding value is 3072.

For example:

<add key="SslProtocolVersion"     value="3072"/>

The following table list the various other protocol versions and its corresponding values:

Protocol Version

Value

Default

240

None

0

Ssl2

12

Ssl3

48

TLS

192

TLS1.1

768

Refer to https://docs.microsoft.com/en-us/dotnet/api/system.security.authentication.sslprotocols?view=netframework-4.7.2 for more information.

Note: The value must match the protocol version of the Server.

The following tags have their values completed when you run the InitializeBundleView.vbs script using the entries which you provided at the script prompts, as the examples below show:

<add key="ApplicationName"          value="Sample"/>
<add key="BundleName"               value="WSCustomers"/>
<add key="PackagePrefix"            value="com.unisys"/>

The remainder of the "connection" tags must have their values completed manually by opening the Web.Config file in a text editor. The initial value is null. These tags consist of:

<add key="HostViewName"             value="" /> 
<add key="DisplayName"              value="" />

Tag to specify the connection details according to the required connection type.

<add key="HostURI"                  value="" />

For TCP/IP connections, the format is: "x-[Protocol]:[HostName or IP Address]:[Port Number]"

For example, x-ratl:ECCSJ:2889 or x-ratlssl:ECCSJ:2009

For MSMQ connections, the format is:

"x-msmq:[Format]:[HostName or IP Address of MSMQ server]:[Queue Name]

Notes:

  • For MSMQ Connections refer to the MSMQ documentation for all possible types for the "Format" tag. DIRECT queues are recommended as they avoid the overhead of a queue name lookup from directory services and MSMQ store and forward operations as messages are sent DIRECTLY to the machine hosting the queue.

    Valid direct formats are:

    DIRECT=OS – uses native machine naming convention

    DIRECT=SPX – connection-orientated SPX over IPX

    DIRECT=TCP– connection-orientated TCP over IP

  • For MSMQ Connections refer to the MSMQ documentation for all possible types for the "Queue Name". The queue name can be a public or private queue on the MSMQ server. Using private queues is recommend, as they have less overhead in processing, and should be faster.

Tag to specify to the host application what type of client is connecting to it.

<add key="ConnectionMode"           value=""/>

The possible values are shown in the table below

0
PCE (GLB.Style = NOFORM) (GLB.GUI = Y)
1
NOF (GLB.Style = NOFORM) (GLB.GUI = N)
2
Component Enabler (GLB.Style = ACTIVELINC) (GLB.GUI = N)

Tag to specify the root location of the IspecModel dll files. This is used when connecting via the CE .NET based runtime system

<add key="IspecModelRootDirectory"  value=""./>

Tags to specify login details and logging.

<add key="HostLogin"                value=""/>
<add key="HostPassword"             value=""/>
<add key="HostDomain"               value=""/>
<add key="LoggingEnabled"           value=""/>
<add key="LogFile"                  value=""/>
<add key="LogLevel"                 value=""/>

To mask sensitive data in the log file at runtime, the DataMaskingEnabled parameter should be true. This masks only those fields for which data masking has been enabled and defined in the model.

<add key="DataMaskingEnabled"       value="true"/>

The final tags in the appSettings section are concerned with object pooling, tracing, validation and errors. They are listed below with their initial default values identified.

Tag to enable /disable Object Pooling of the LINCEnvironment.

<add key="ObjectPoolingEnabled"     value="false" />
                                    Alternate value is "true"

Tag to identify the location to which the trace file should be written. Note that the Trace file cannot reside straight under C:.

<add key="TraceFile"                value="C:\Temp\CEdotNetWsLog.txt" />

Tag to enable validation against the schema of the Web Service.

<add key="EnableSchemaValidation"   value="true" />
                                    Alternate value is "false"

Tag to specify how to return transaction errors (Component Enabler error code 911) to the Client Application. When set to the default value of true, it is returned as a standard Soap Fault message. When false, it is returned as a normal response with the error(s) in the StatusMessages field. Some Client Applications, such as BizTalk, prefer application errors to be returned as a normal transaction response.

<add key="ReturnTransactionErrorAsSoapFault"    value="true" />
                                                Alternate value is "false"

Tag to specify whether WhiteSpace in Inquiry fields and list entries is preserved or compressed.

<add key="PreserveWhiteSpace"       value="true" />
                                    Alternate value is “false”
<!-- APPLICATION SPECIFIC SETTINGS. This section contains configuration parameters
specific to the host runtime system. -->

<appSettings>
<!-- The LINCEnvironmentProgId parameter specifies the CE Runtime system to use. The
possible values are:
Blank or parameter not specified (default), use CE .NET Runtime.
When using this option, IspecModel dll files for .NET are required.
"LINCEnvironment.Java.1", use CE Java Runtime with Oracle JRE.
When using this option, IspecModel class files for Java are required.
"LINCEnvironment.Bean.1", use CE Java Runtime with the Oracle JVM.
When using this option, IspecModel class files for Java are required. -->
<!-- <add key="LINCEnvironmentProgId"value="LINCEnvironment.Bean.1" /> -->

<add key="ApplicationName" value="Sample" />
<add key="BundleName" value="WSCustomers" />
<add key="HostViewName" value="SAMPLE" />
<add key="DisplayName" value="Display Name" />
<add key="PackagePrefix" value="com.unisys" />

<!-- The HostURI parameter specifies the connection details according to the
required connection type.
For TCP/IP connections, the format is:
"x-ratl:[HostName or IP Address]:[Port Number]"
For MSMQ connections, the format is:
"x-msmq:[Format]:[HostName or IP Address of MSMQ server]:[Queue Name]
Example of MSMQ HostUri value:
value="x-msmq:DIRECT=OS:[MSMQ Server]:PRIVATE$\[request queue name]" -->
<add key="HostURI" value="x-ratl:localhost:4323" />

<!-- The connection mode attribute is used to inform the host application what type of
client is connecting to it. The values can be:
<add key="ConnectionMode" value="0" />

<!-- The IspecModelRootDirectory parameter specifies the root location of the
IspecModel
dll’s. -->
<add key="IspecModelRootDirectory" value="[IspecModelRootDirectory]" />

<!-- Login details -->
<add key="HostLogin" value="ALPublic" />
<add key="HostPassword" value="ALPublic" />
<add key="HostDomain" value="." />

<!-- Component Enabler Logging -->
<add key="LoggingEnabled" value="false" />
<add key="LogFile" value="C:\Temp\CETraces.log" />
<add key="LogLevel" value="7" />

<!-- This specifies how to return transaction errors (CE error code 911) to
the Client Application
<add key="ReturnTransactionErrorAsSoapFault" value="true" />
<!--Data Masking enabled if the value is true -->
      <add key="DataMaskingEnabled" value="true" />
<!-- Enable Object Pooling of the LINCEnvironment.
Object pooling requires Ispecs to be stateless.
The object pool such as min/max pool size is further configured viaComponent
Services. -->
<add key="ObjectPoolingEnabled" value="false" />
<!-- ObjectPoolingAssembly specifies the fully qualified assembly name containing the
pool of objects. This does not need to be specified except in special circumstances.
When not specifed, the default value is:
"CEWindowsAPIPool, Version=1.0.1.0, Culture=neutral, PublicKeyToken=e780u100
?48c08ed6963" -->
<add key="ObjectPoolingAssembly" value="" />
<!-- ObjectPoolingType specifies the full name of the type within the assembly
containing the pool of objects. This is specified when a pool of LINCEnvironment
objects specific to this Web Service Aplication is required. The full type name is
specified as "Namespace.ClassName". For further information on how to set up an
application specific pool, see the CEWindowsAPIPool sub-directory located in
[CERoot]\Sample.
When not specifed, the default value is: "CEWindowsAPIPool.LINCEnvironmentPooled" -->
<add key="ObjectPoolingType" value="" />
<!-- Soap Request/Response tracing. -->
<add key="EnableSoapTrace" value="false" />
<!-- Soap Request/Response tracing. -->
<!-- Trace file cannot be straight under C:. Access is denied to write to C: -->
<!-- Enable validation against schema of the Web Service. -->
<add key="EnableSchemaValidation" value="true" />
<!-- Determines whether WhiteSpace in Inquiry fields and list entries is preserved or
compressed.-->
<add key="PreserveWhiteSpace"       value="true" />
</appSettings>

Refer to the example above of the <appSettings> section of a Web.Config file for Agile Business Suite ASP.NET Web Services.