Sterling Commerce


Glossary

Print this page

Bookmark

http.properties

The http.properties file describes HTTP adapter properties.

This file should not be edited. Override property settings, if needed, using the customer_overrides.properties file.

Configuration Settings

The following table describes properties used to configure the http.properties file in Gentran Integration Suite:

Property
Description
bp_response_timeout
Time in milliseconds that the request waits for the initiated business process to respond. This setting only applies to requests reaching URLs that invoke business processes (not those delegated to web applications).
Example: 3600000
adapterdirectconnect
Flag indicating whether to allow direct connections to the ConduitStream Listener (bypassing perimeter services).
Parsed during Gentran Integration Suite startup only.
Example: false
adapterdirectportmod
Additive port modifier for direct connections (bypassing perimeter services), if enabled.
Parsed during Gentran Integration Suite startup only.
Example: 1000
conduitbuffersize
Buffer size, in bytes.
Parsed during Gentran Integration Suite startup only.
Example: 4096
conduitreservebuffersize
Reserve buffer size, in bytes.
This value must be less than the buffer size. It is the amount of space that Jetty's ByteBufferOutputStream preallocates for the headers of the HTTP request.
Parsed during Gentran Integration Suite startup only.
Example: 1024
conduitfinishsleep
Delay for connections to finish, in milliseconds.
Parsed during Gentran Integration Suite startup only.
Example: 1000
servletinbuffersize
Buffer for streaming in the input stream/request, in bytes.
Parsed during Gentran Integration Suite startup only.
Example: 8192
servletoutbuffersize
Buffer for streaming out the output stream/response, in bytes.
Parsed during Gentran Integration Suite startup only.
Example: 4096
httpuserrealm
Name for HTTP custom Jetty user realm.
Parsed during Gentran Integration Suite startup only.
Example: HttpBasicAuthentication
httplogsinkname
HTTP Jetty custom logSink URL.
Parsed during HTTP Jetty server startup.
Example: *.services.pshttp.jetty.PSHttpLogSink
httplogsinkfile
HTTP Jetty custom logSink file name.
Parsed during HTTP Jetty server startup.
Example: http.log
httplogsinkoptions
Flag indicating what to show in the log.
Values:
L = Show labels (method/file name, thread)
T = Show tag
Parsed during HTTP Jetty server startup.
Example: LT
transferUpdateIntervalInMillis
Frequency with which to update Gentran Integration Suite with activity monitoring progress data.
Parsed during Gentran Integration Suite startup only.
Example: 30000
enableActivityMonitoring
Overriding switch to disable activity monitoring within the HTTP adapter. This is intended for use in debugging and performance testing only.
Parsed during Gentran Integration Suite startup only.
Example: true
extractWarFiles
Flag indicating whether Jetty extracts WAR files (applies to all WAR files + URI contexts).
Parsed during Gentran Integration Suite startup only.
Example: true
preextractWars
Flag indicating whether Gentran Integration Suite extracts WAR files for Jetty (applies to all WAR files + URI contexts). Overridden to false in the code if extractWarFiles is set to false.
Parsed during Gentran Integration Suite startup only.
Example: false
extractWarTempDir
Temporary directory to use other than the system default. If left blank/unset or commented out, then the system default is used.
On win32 systems, the path must be in the proper short DOS 8.3 format.
If extractWarFiles is set to true on a win32 system, extractWarTempDir generally needs to be set so the default system temporary directory is not used. If extractWarFiles is set to false, this property is not used.
Parsed during Gentran Integration Suite startup only.
Example: /sv_local/share/username/Gentran Integration Suite/tmp
numOfminThread
Default number of minimum thread pools allowed for Perimeter Services to accept HTTP request and pass to HTTP Server adapter immediately.
Parsed during HTTP Server adapter startup.
Example: 1
numOfmaxThread
Default number of maximum thread pools allowed for Perimeter Services to accept HTTP request and pass to HTTP Server adapter immediately.
Parsed during HTTP Server adapter startup.
Example: 10
surpressServerHeader
Indicates whether the server header in the response message will be supressed.
This is used for security purposes, if you don't want to reveal the server software (jetty) that you are using in the HTTP Server adapter.
Example: false
useSecureCookie
Indicates whether the secure cookie is turned on when communicating through HTTPS/SSL.
Example: false
conduit_read_timeout
Data Conduit read timeout value to clear idle connection.
Example: 600000

Example

# HTTP Adapter properties. 
# PSHttpAdapterImpl - The classpath used for the compilation of JSPs. 
# No classes are actually loaded from these jars during execution 
# (they are only loaded by the java compiler to compile generated 
# Java sources). 
# The time in milliseconds for which the request will wait the 
# initiated BP to respond.  This setting only applies to requests 
# reaching URLs that invoke BPs (not those delegate to 
# webapplications).  This commented value is close to a year, much 
# longer than any HTTP connection will remain alive. 
#  bp_response_timeout=31536000000 
# This value however is 1 hour. 
bp_response_timeout=3600000 
# PSHttpAdapterImpl - allow direct connections to the ConduitStream Listener 
(bypassing perimeter services) 
# Parsed during GIS startup only 
adapterdirectconnect=false 
# PSHttpAdapterImpl - the additive port modifier for direct connections (bypassing 
perimeter services), if enabled 
# Parsed during GIS startup only 
adapterdirectportmod=1000 
# ConduitStreamListener - buffer size, in bytes 
# Parsed during GIS startup only 
conduitbuffersize=4096 
# ConduitStreamListener - reserve buffer size, in bytes. 
# Note, this value must be less than the buffer size.  It is the amount of space that 
Jetty's ByteBufferOutputStream 
# preallocates for the headers of the HTTP request. 
# Parsed during GIS startup only 
conduitreservebuffersize=1024 
# ConduitStreamListener - delay for connections to finish, in ms 
# Parsed during GIS startup only 
conduitfinishsleep=1000 
# PSHttpServletHandler - buffer for streaming in the input stream/request, in bytes 
# Parsed during GIS startup only 
servletinbuffersize=8192 
# PSHttpServletHandler - buffer for streaming out the output stream/response, in 
bytes 
# Parsed during GIS startup only 
servletoutbuffersize=4096 
# PSHttpUserRealm - Name for Http custom Jetty user realm 
# Parsed during GIS startup only 
httpuserrealm=HttpBasicAuthentication 
# PSHttpAdapterImpl - Properties for Http Jetty custom logSink. 
# The httplogsinkoptions specified what to show in the log: L - Show labels 
(method/file name, thread), T - Show tag 
# Parsed during Http Jetty server startup 
httplogsinkname=*.services.pshttp.jetty.PSHttpLogSink 
httplogsinkfile=http.log 
httplogsinkoptions=LT 
# PSHttpServletHandler, ActivityMonitorRequestStream, ActivityMonitorResponseStream 
- 
# Frequency with which to update Gentran Integration Suite with activity monitoring 
progress data. 
# Parsed during GIS startup only 
transferUpdateIntervalInMillis=30000 
# PSHttpServletHandler, ActivityMonitorRequestStream, ActivityMonitorResponseStream 
- 
# Overriding switch to disable activity  monitoring within the http adapter. This 
# is intended for use in debugging and performance testing only. 
# Parsed during GIS startup only 
enableActivityMonitoring=true 
# PSHttpAdapterImpl - specify Jetty to extract WAR files or not (applies to all 
# WAR files+URI contexts) 
# Parsed during GIS startup only 
extractWarFiles=true 
# PSHttpAdapterImpl - specify if GIS is to extract WAR files for Jetty or not 
# (applies to all WAR files+URI contexts). Overridden to false in the code if 
# extractWarFiles is set to false 
# Parsed during GIS startup only 
preextractWars=false 
# PSHttpAdapterImpl - specify a temporary directory to use other than the 
# system default. If left blank/unset or commented out, then the system 
# default is used. 
# NOTE: on win32 systems, the path must be in proper short DOS 8.3 format. 
# Additionally, if extractWarFiles is set to true on a win32 system, the 
# extractWarTempDir generally needs to be set so the default system temp 
# dir is not used. finally, if extractWarFiles is set to false, this 
# property is not used. 
# Parsed during GIS startup only 
extractWarTempDir=/sv_local/share/username/Gentran Integration SuiteinstallDir/tmp 
# The default number of minimum/maximum thread pool allowed for Perimeter Services to 
# accept Http request and pass to Http Server Adapter at once. 
# Parsed during Http Server adapter startup 
numOfminThread = 1 
numOfmaxThread = 10 
# NoAppServer - when this flag is true, the "Server" header in response message will 
be surpressed 
surpressServerHeader=false 
# PSHttpAdapterImpl - when this flag is true, the secure cookie is turned on when 
communicating through HTTPS/SSL 
useSecureCookie=false 
# Data Conduit read timeout value to clear idle connection - used by 
ConduitStreamListener 
conduit_read_timeout=600000 

Copyright Notice