Gateway Properties

The actual home community OID for the system using this instance of CONNECT

Required: This property requires a value for proper/stable gateway behavior

Format : urn:oid:<home community OID>

Pre-configured value: urn:oid:1.1 (must be changed)

System usage: localHomeCommunityId is used to identify the Gateway and its local services endpoints from internalExchangeInfo.xml and exchangeInfo.xml files. HomeCommunityMap will read the "localhomecommunityid" key value from the gateway.properties. localHomeCommunityId is one of the mandatory parameter in all the underlying connect services (PD,DQ,DR and DS) to process Gateway request and send the response to the requested localHomeCommunityId. This value is not stored in the database, if this is not provided correctly the Gateway will not function as expected.

R

Determines how patient correlation is performed during a patient discovery transaction

Required: This property requires a value for proper/stable gateway behavior

Acceptable values: verify, trust, passthrough

Pre-configured value: verify

System Usage: The Patient Discovery Service Specifications gives NHIEs the choice of trusting the Patient Discovery response or verifying that they agree that the response is a match. The mode configuration is handled using patientDiscoveryResponseMode property. These modes were introduced to help CONNECT adopters deal with the possibility of receiving false positive matches to patient demographic queries. ResponseFactory object will read the property value from the gateway properties file, based on the mode value, it checks whether the patient exists locally are not and then establishes the correlations. ResponseModeType is used in StandardInboundPatientDiscoveryDeferredResponse object to process the response. This value is not stored in the database.

The possible values are:

verify: This mode of response indicates to the responding gateway to verify the match before agreeing on the match and creating a patient correlation.

trust: This mode does not require the responding gateway to verify the match, but instead creates a patient correlation directly based on the responding message.

passthrough: The responding gateway sends the message directly to the agency without creating any patient correlation.

The secure endpoint URL for the UDDI Services Registry Inquiry service

Note: In CONNECT 5.1, this property is replaced by url and type in  ExchangeInfo

Required: This property requires a value for proper/stable gateway behavior

Format: URL

Pre-configured value: https://registry-vs.nhinonline.net/uddi/inquiry

System Usage: UDDIInquiryEndpointURL is the registry services URL for business entities. UDDIFindBusinessProxyBase will read the property value and make a webservice call to NHIN UDDI server. UDDIAccessor object is used to retrieve business entities, service details from UDDI server for the registry service URL.This value is not stored in the database

Required: This property requires a value for proper/stable gateway behavior

Format: <service1>;<service2>

Pre-configured value: uddi:replication:findbusiness;uddi:replication:findmodels;uddi:nhinregistry:node

System Usage: UDDI will send a list of business entities that should ignore. These are configured in UDDIBusniessesToIgnore property and will be used to eliminate some of the entries got back from the UDDI server. UDDIAccessor object is used to read the UDDIBusinessesToIgnore property value and it is used to eliminate from the UDDI business list. This property value is not stored in the database.

Note: In CONNECT 5.1, this property is replaced by disabled in ExchangeInfo

Required: This property requires a value for proper/stable gateway behavior

Acceptable values: true, false

Pre-configured value: false

System Usage: UDDIRefreshActive is a boolean flag which indicates whether are not a refresh of UDDI service Registry is enabled or not. UDDITimerTask object reads the UDDIRefreshActive property.If the property value is true, then it will read data from the UDDI server, update the exchangeInfo.xml file,and tell the connection manager to update its cache with the data. If the property value is false, then it will not pull the information from UDDI server.

Note: In CONNECT 5.1, this property is replaced by refreshInterval in ExchangeInfo

Required: This property requires a value for proper/stable gateway behavior

Format: Integer

Pre-configured value: 3600

System Usage: UDDITimer object read the UDDIRefreshDuration property value, this thread class is used to start UDDIUpdateManager timer, when it wakes up will read the UDDI data from the UDDI server, update the exchangeInfo.xml file with that data, and then tell the COnnectionManager to refresh the UDDI cache with it.

Determines whether or not a backup copy of exchangeInfo.xml will be created every time it is downloaded (refreshed)

Note: In CONNECT 5.1, this property is replaced by maxNumberOfBackups in ExchangeInfo

Required: This property requires a value for proper/stable gateway behavior

Acceptable values: true, false

Pre-configured value: false

System Usage: UDDIRefreshKeepBackups flag is to indicate whether the uddi file back up is required are not. UDDIUpdateManagerHelper object read the property value and based on configuration value it generate uddi backup file by renaming the current UDDI file to a newly generated filename. This value is not stored in the database.

Note: In CONNECT 5.1, this property is replaced by maxNumberOfBackups in ExchangeInfo

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 10

System Usage: UDDIMaxNumBackups property specifies maximum allowed number of uddi backups.UDDIUpdateManagerHelper object reads the UDDIMaxNumBackups property value, and it will check whether UDDIRefreshKeepBackup flag is set to "true" are "false". If the flag is true then it will create the uddi backup file.

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 200

System Usage: UDDIMaxResults property provide the ability to configure number of results returned in a UDDI query. UDDIFindBusinessProxyBase object reads the property value to return maxresults value. The maxresults value used in findBusinessfromUDDI() function to return list of businesses from UDDI after finding the business services. If there is no value specified, then it is default to unlimited results.

Not required

Acceptable values: TLSv1, TLSv1.1, TLSv1.2 (and other TLS versions supported by the application server)

Pre-configured valule: TLSv1

Not required

Acceptable values: TLSv1, TLSv1.1, TLSv1.2 (and other TLS versions supported by the application server)

Pre-configured valule: TLSv1.2

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: ConnectOpenSSO, jericho

Pre-configured value: ConnectOpenSSO

System Usage: PdpEntityName property provides information about which PDP the policy engine will use. AdapterPDPProxyOpenSSOClientImpl object will read this property selection value from the gateway properties file and it is used in processing the PDPRequest. It is only used by Consumer Preferences.

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer ( time value in milliseconds)

Pre-configured value: 120000

System Usage: webserviceproxy.timeout property provides a specific time value when a web service call will timeout if there is no activity. TimeoutServiceEndpointDecorator retrieve the property value and it is one of the value used in configuring the service endpoint. WebServiceProxyHelperProperties retrieve the property value, and this class is instantiated in WebServiceProxyHelper which is used as a helper in each of the Web Service Proxies.

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 2

System Usage: webserviceproxy.retryattempts provides information about how many times a web service call should retry if an exception occurs. If there is no value passed from the configuration then the default value 0 will be used. WebServiceProxyHelperProperties get the property value, and this value is being used in WebServiceProxyHelper to invoke operation on port. If the operation is success then it returns web service response, otherwise null response will be returned.

The amount of time delay, in milliseconds, between web service call retries

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer (time value in milliseconds)

Pre-configured value: 30000

System Usage: webserviceproxy.retrydelay property specifies a wait time for web service proxy class before it attempts to make another web service call. WebServiceProxyHelperProperties object retrieve the retry delay setting value from property file, and this value is being used in invoking port operations.

Required: This property requires a value for proper/stable gateway behavior.

Format: String

Pre-configured value: SocketTimeoutException

System Usage: webserviceproxy.exceptionstext specifies the text to look for when a web service exception occurs during a web service call. WebServiceProxyHelperProperties retrieves the property value and this text is used to scan for in the exception. This text value allows the exceptions to be considered for web service call retry which is configured in webserviceproxy.retryattempts property.

NOTE: This property is no longer supported in CONNECT release 4.0 and later, instead webserviceproxy.timeout property value is used.

NOTE: This property is no longer supported in CONNECT release 4.0 and later, Instead webserviceproxy.timeout property value is used.

Determines whether or not the SAML header will include <purposeForUse> or <purposeOfUse> attribute

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: true, false

Pre-configured value: false

System Usage: purposeForUseEnabled is a boolean flag which is used to determine whether to enable purseFor / purseOf setting for backward compatibility. PurposeUseProxyDefaultImpl class gets the purposeForUseEnabled property value and it is being utilized by PurposeOfForDecider object to decide whether to use purposeFor are purposeOf based on apilevel, hcid and Nhin spec service name.

Setting this value to "true" causes CONNECT to use <purposeForUse>

Determines whether or not "hl7" will be prefixed to the PurposeOfUse and Role attributes

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: true, false

Pre-configured value: false

System Usage: hl7PrefixForAttributes is a boolean flag and it is used to configure SAML assertion for HL7 attributes (Code, CodeSystemName and DisplayName) used in the PurposeOfUse and Role elements. OpenSAML2ComponentBuilder object gets the property value from gateway.properties file and it is used in createHL7Attribute() function to check weather to add HL7 prefix are not for SAML attributes.

Determines whether or not messages will be stored in the asyncmsgs.asynmsgrepo database for asynchronous responses

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: true, false

Pre-configured value: false

System Usage: DefferedQueueProcessActive is a boolean flag and it indicates whether the service is enabled are disabled for deferred queue message processing. Deffered request goes out and the responses might come and anytime later. Deferred queue message processing is used to match the response with the request that is used. All deferred messages are stored in Asyn table with messageID, servicename etc.,. Once the response is received the row gets deleted from the table. DeferredQueueTimerTask class gets the property value from gateway.properties file, and if the flag value is enabled then the outstanding deferred queue request messages get processed. It is added with CONNECT 3.2.

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer (time value in milliseconds)

Pre-configured value: 600

System Usage: DeferredQueueRefreshDuration specifies refresh time in seconds that the service will sleep between executions. DeferredQueueTimer class gets the property value from the gateway.properties file and the value is used by this thread class to start a timer and when it wakes up will process any deferred queue request messages. DeferredQueueTimer thread will throw an initializing error if the property value is less than "0".

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 100

System Usage: DeferredQueueGlobalThreshold specifies maximum size of deferred queue to process during a single execution. DeferredQueueManagerHelper class get the property value and it is set as global threshold value for defferred queue while processing the deferred request messages. DeferredQueueManageHelper classes checks whether this property value is less than "0" are not, if it is, then it will throw an error while setting it as global threshold value.

The amount of time messages will persist in the deferred queue before they expire (time unit defined in asyncDbRecExpUnits property below)

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 30

System Usage: asyncDbRecExpValue property specifies asynchronous database record expiration value and, along with asyncDbRecExpUnits setting, is used to determine when an asynchronous database entry is stale. AsyncMsgRecordDao object get the property value and it is used to examine asyncmsgrepo table records to determine if creation time has expired based on the asyncDbRecExpValue value setting. If expired records found, then all those records will be updated with an expired status. Currently it is used only for Deferred Patient Discovery Service.

Not Required: This property does not require a value for proper/stable gateway behavior.

Acceptable Values: true/false

Pre-configured value: false

System Usage: The flag will indicate whether Connect will remove expired archived message and mark processing message as archive in DB

The maximum number of Patient Discovery web service calls this CONNECT instance will process at one time

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 100

System Usage: ConcurrentPoolSize property specifies executor service thread pool size for services. ExecutorServiceHelper object get the property value from gateway.properties. In case of fanout, the pool size for the job is normally the size specified in concurrentpoolsize.

The maximum number of large task web service calls this CONNECT instance will process at one time

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 200

System Usage: If one single job will take more than 75% of the normal connection pool, the pool size is extended to the size of LargeJobPoolSize. ExecutorServiceHelper object read the LargeJboPoolSize property value to configure 75% using LargeJobSizePercent property. If task fanout count >= (LargeJobSizePercent / 100) * ConcurrentPoolSize then it is a large task.

Determines if a task will be executed using the large job executor

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 75

System Usage: Large Job executor is a thread pool, If the task is determined as large job, it goes into Queue and wait until the tread availability for job execution. If the job is identified and extended to LargeJobPoolSize, then largeJobSizePercent will be calculated as below:

If concurrent task count >= LargeJobSizePercent * ConcurrentPoolSize then it is a large job. Boundary: 0 < LargeJobSizePercent < 100.

Determines whether or not outbound request messages with an attached document will be converted to a file URI value as its payload and streamed as an object.

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: true, false

Pre-configured value: true

System Usage: The payload is in-line, but if file is too large to put in-line, use document field to point to a file on the file system and CONNECT will read the file, and use that file as the payload. LargeFileUtils object gets the property value from gateway.properties file and it is used to determine whether the gateway is configured to parse document payload as a URI pointing to the data rather than having actual data itself. If the property value is true, then gateway process document payload as a URI. Only the attached payload gets converted to file URI. If the value is false then it returns the actual payload document.

Determines whether or not the inbound streamed payload will be saved as a file

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: true, false

Pre-configured value: true

System Usage: LargeFileUtils object gets the property value from gateway.properties file and it is used to determine whether the gateway is configured to save incoming payload to the file system are not. If the value is true then it will save payload to the file system, otherwise not.

Required: This property requires a value for proper/stable gateway behavior.

Format: valid file path (Ex: c:/largepayload/inbound)

Pre-configured value: /nhin/tmp

System Usage: LargeFileUtils object gets the property value from gateway.properties file and this is where the attachment file will be created for large payload. If there is no specific payload directory exists then java tmp directory is used to create a file. When enabled, the gateway will save the document attachment from the inbound message to the file system and replaces the document in the message with the URI location of the file.

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: true, false

Pre-configured value: true

System Usage: TimeStampStrict property specifies whether Timestamp expiration should be enforced or not. TimestampValidator object gets the property value from gateway.properties file and it is used to validate whether the security semantics of the message has expired are not. This is applicable for Document Service and Admin Distribution services. If the value is not determined from gateway.properties file then the default value ("true") will be used.

The amount of time, in seconds, to append to the Creation value of an incoming timestamp to determine whether or not a timestamp is still valid

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 300

System Usage: TimeStampTimeToLive specified the value in seconds for the validity of the created time. TimestampValidator object gets the property value from gateway.properties file and it is used as one of the parameter to calculate the time that is allowed for the message to travel. This is applicable for Document Service and Admin Distribution services. If the value is not determined from gateway.properties file then the default value (300) will be used.

This setting is used to specify the time in seconds to append to the Creation value of an incoming Timestamp to determine whether to accept the Timestamp as valid or not. This value should be greater than or equal to 0.

The amount of time, in seconds, in the future within which the Created time of an incoming Timestamp is valid.

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 60

System Usage: FutureTimeToLive property specifies value in seconds for the future validity of the Created time. TimestampValidator object gets the property value from gateway.properties file and it is used as one of the parameter to validate whether the security semantics of the message has expired are not. This is applicable for Document Service and Admin Distribution services. If the value is not determined from gateway.properties file then the default value (60) will be used.

This property will allow the time in seconds in the future within which the Created time of an incoming Timestamp is valid. This value should be greater than or equal to 0.

Required: This property requires a value for proper/stable gateway behavior.

Acceptable values: true, false

Pre-configured value: true

System Usage: CoreX12GenericBatchTimeStampStrict property is specific to X12 generic batch request and batch response services. CoreX12GenericBatchTimestampValidator object reads the property from gateway.properties file and this class overwrites default CONNECT Core TimestampValidator.getTimeStampStrict() to get timestampstrict value specific to X12GenericBatch services.

The amount of time, in seconds, to append to the Creation value of an incoming timestamp to determine whether or not a timestamp is still valid.

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 300

System Usage: CoreX12GenericBatchTimeStampTimeToLive property is specific to X12 generic batch request and batch response services. CoreX12GenericBatchTimestampValidator object reads the property from gateway.properties file and this class overwrites default CONNECT Core TimestampValidator.getTimeStampTTL() to get TimeSTampTimeToLive value specific to X12GenericBatch services.

This property specify the time in seconds to append to the Creation value of an incoming Timestamp to determine whether to accept the Timestamp as valid or not. (analogous to ws-security.timestamp.timeToLive).

The amount of time, in seconds, in the future within which the Created time of an incoming Timestamp is valid.

Required: This property requires a value for proper/stable gateway behavior.

Format: Integer

Pre-configured value: 60

System Usage: CoreX12GenericBatchFutureTimeToLive property is specific to X12 generic batch request and batch response services. CoreX12GenericBatchTimestampValidator object reads the property from gateway.properties file and this class overwrites default CONNECT Core TimestampValidator.getTimeStampFutureTTL() to get FutureTimeToLive value specific to X12GenericBatch services.

This setting is used to identify the time in seconds in the future within which the Created time of an incoming Timestamp is valid.(analogous to ws-security.timestamp.futureTimeToLive)

Not Required: This property does not require a value for proper/stable gateway behavior

Format: String

Pre-configured value: postmaster

System Usage: PostmasterEmailIdPrefix property specifies prefix for domain emailid. MessageMonitoringUtil class gets the property value from gateway.properties file and if there is no value, then it will use default emailid prefix value as "postmaster". MessageMonitoringAPI class make use of this value to construct domains emailid for sending success/failed SMTP edge notifications.

The number of times CONNECT will re-attempt to send an outbound message if previous attempt failed

Not Required: This property does not require a value for proper/stable gateway behavior

Format: Integer

Pre-configured value: 1

System Usage: MessageMonitoringUtil class get the property value from gateway.properties file and if the value is greater than or equal to 0 then it uses property value as message retry count, if the value is less than 0 then it will use the default property value. It must be greater than or equal to 0.

The number of times CONNECT will re-attempt to send an outbound message if previous attempt failed.

Not Required: This property does not require a value for proper/stable gateway behavior

Format: Integer

Pre-configured value: 1

System Usage: MessageMonitoringUtil class get the property value from gateway.properties file and if the value is present, then it uses property value as message retry count, if the value is less than 0 then it will use the default property value.

Not Required: This property does not require a value for proper/stable gateway behavior

Acceptable values: true, false

Pre-configured value: true

Not Required: This property does not require a value for proper/stable gateway behavior

Acceptable values: true, false

Pre-configured value: true

System Usage: MessageMonitoringEnabled property specifies whether the message monitoring is enabled or disabled. MessageMonitoringUtil class get the property value from gateway.properties file, if the value is empty then it returns default value as 'true'. If the value is true, then the MessageMonitoringAPI will update incoming / outgoing message notifications, adding message notifications, building the message cache and to check and update message status.

The time limit, in milliseconds, before the Processed and Dispatched MDNs must be received from the Destination HISP before a timeout exception occurs

Not Required: This property does not require a value for proper/stable gateway behavior

Format: Integer (time in milliseconds)

Pre-configured value: 3600000

System Usage: MessageMonitoringUtil class get the property value from gateway.properties file, if the value is less than 0, then the default value will be used to set the time limit before the processed and dispatched MDNs received from the destination HISP. The value should be greater than or equal to 0.

The interval, in milliseconds, in which CONNECT will reload and make active new Direct agent settings from configdb.settings

Not Required: This property does not require a value for proper/stable gateway behavior

Format: Integer (time in milliseconds)

Pre-configured value: 300000

System Usage: CONNECT Direct caches all the SMTP agent settings during the server startup. The cache can be configured to refresh every 'n' milli seconds using the property "AgentSettingsCacheRefreshTime" which is defined in gateway.properties. The default value is 5 minutes. Whenever a Agent Setting Entity is changed/added/removed, the Direct Gateway will take 'AgentSettingsCacheRefreshTime' milli seconds to take effect.

 MessageMonitoringUtil class reads the property value from gateway.properties file. This class checks whether the agent settings cache refresh flag is enabled or disabled, if it is enabled then return AgentSettingsCacheRefreshTime value to update settings cache timeout value. AgentSettingsCacheRefreshTime value should be greater than 0 to update the settings timeout..

Enables or disables agent settings cache refresh

Not Required: This property does not require a value for proper/stable gateway behavior

Acceptable values: true, false

Pre-configured value: true

System Usage: MessageMonitoringUtil class reads the property value from gateway.properties file. In order to update agent settings cache timeout value, this property value need to be set as 'true', otherwise settings cache timeout value will not be updated.

Not Required: Optional property, CONNECT will default to false if missing. The property is pre-configured to true for testing  and development environments.

Acceptable values: true, false

Pre-configured value: true

System Usage: disableCNCheck when set to true, deactivates HostName verification done against hostname in url and Common Name in certificate. For production environments, it is highly recommended to use false.