Home : HACH_WIMS_CLIENT.ini Explained
Q10447 - INFO: HACH_WIMS_CLIENT.ini Explained

The Hach WIMS application settings are contained in an INI (initialization) file named hach_wims_client.ini.  This file contains all of the basic information the client application needs to attach to the Hach WIMS database, where all data and reports are stored, along with other initialization settings. The .ini file is stored in the client application's installation folder (Default: c:\HachWims\Client\).

SETTINGS:

The most important settings are the HACHWIMS_CONNECTION_ settings, which are all explained in the Hach WIMS Database Connection Settings article.  See Multi Server Login Hach_WIMS_Client.ini settings for support of multi server selection.

Beyond these settings, the Hach WIMS application can be customized with the following settings:

ALLOWMULTIRUN
(Optional : Default = False)

This setting can be used to allow multiple instances of the Hach WIMS Client Applications.  This is by default set to False to prevent people from accidentally running multiple copies of the Hach WIMS Client, which can greatly reduce system performance.  Also, each instance running will take up one of the Concurrent User Licenses.  To allow multiple instances, set equal to 'Yes' (True and 1 will not work).

DEBUGLOG
(Optional : Default = No)

Sets whether Debug log files should be created in the client log folder (i.e. c:\hachwims\client\log).  Log files can be created for MDE_LOAD, Lab Cal Display Cal and WO Gen, BOD Manager HQ reads, etc...  Set to 'Yes' or 1 to turn on debug logging.

DISABLE_DISPLAY_SETTINGS_CHECK
(Optional, Default = NO)

Set this to YES if you would like the client to skip checking for minimum required values of color depth, font size, and/or resolution.

DISABLE_TIMEZONE_WARNING
(Optional, Default = NO)

When set to "YES" the login warning message, "Hach WIMS detected that the server may be in a different time zone. The server time will be used in all audit trail transactions." will be disabled.  Users will no longer be notified that the server is in a different time zone.

HQ40D_USES_SERIAL_PORT
(Optional, Default = NO)

Set this to YES if you want WIMS to communicate to your Hach HQd Meter using Virtual Serial over USB. Otherwise WIMS communicates using Mass Storage USB method. See Q13423 for more info.
(NOTE: Available in WIMS 7.2.0 and later.)

GNRRESXOFFSET
(Optional : Default = 2)

Setting is used when client is used via GNR Server

GNRRESYOFFSET
(Optional : Default = 28)

Setting is taken into account when client is used via GNR Server

LOG_IA_MESSAGES
(Optional, Default = False)

This will cause the logging of XML communication between the IABroker and the client

MAILFROM, MAIL FROM, EMAILFROM
(Optional : Default = hachwims_client@opssys.com )

Any one of these can be used to specify what the default "From:" address is for outgoing email that is generated by Hach WIMS Client

Example: MAILFROM = sales@hach.com

OPTIMIZE_PORTABLE_SYNC
(Optional, Default = NO)

Set this to YES if you have only ONE WIMS Facility per WIMS Portable (Pocket OPS) Route and you would like to optimize the time it takes to synchronize routes. (NOTE: Available in WIMS 7.1.1 and later.)

PDFINIPATH
(Optional for Client Standalone, but Required for GNR to output to PDF)

Setting is taken into account when client is used via GNR Server

PDFINIFILE
(Optional for Client Standalone, but Required for GNR to output to PDF)

Setting is taken into account when client is used via GNR Server

PDFSYNCFILE
(Optional for Client Standalone, but Required for GNR to output to PDF)

Setting is taken into account when client is used via GNR Server

PDFSLEEPEXTRAMS
(Optional for Client Standalone, but Required for GNR to output to PDF)

Setting is taken into account when client is used via GNR Server.  Tells GNR server to wait the specified number of milliseconds before attempting to work with the file (i.e. email). 

PDFCOMBINESHEETS
(Not used for Client Standalone, optional for GNR: default = Yes)

Setting is taken into account when client is used via GNR Server.  Tells GNR Server to combine sheets into one (1) PDF when outputting multi sheet spread reports.  Set to No to create separate PDF files for each sheet. 

PRINTER_LIST_SOURCE
(Optional, Default = WMI)

Sets the method used to retrieve the printer list.  Set to WMI to use Windows Management Instrumentation (WMI) calls to provide the printers list.  Set to ENUM to use the EnumPrinters API call (winspool.drv) to provide the printers list.  The two techniques are provided to help in situations (typically in Citrix or Terminal Services) where the printer list in WIMS is detecting multiple instances of the same printer (one for each person logged onto the computer). The WMI value should handle this issue.  Set to VBPC to use the Visual Basic Printer Collection.

SCROLLDELAY
(Optional : Default = 400)

Setting specifies how fast spreadsheets scroll when interacting with them. the higher the value for the delay, the slower the spreadsheets scroll.

 TERMINALSERVICE_PRINT
(Optional, Default = No)

When set to 'Yes', this will set up key areas suspected of causing known problems when trying to print reports through terminal services redirection printing (see KB Aticle Q14184). (This option will be available in Hach WIMS Client version 7.5.0)


TERMINALSERVICE_DEFAULTPAPERSIZE
(Optional, Default = 1)

Specifies the default paper size when using TERMINALSERVICE_PRINT. In the event the server cannot reach out to get the paper size from the client printer, the paper size will default to this value. Consult the KB article Q14184 for more details on paper sizes. (This option will be available in Hach WIMS Client version 7.5.0)


DOMAIN_PASSWORD_CHECK=YES
DOMAIN_PASSWORD_CHECK_MSG=For help on changing your password/npaste the following link into your browser/nhttp://change password.  "/n" is a new line character.
DOMAIN_PASSWORD_CHECK_DOMAIN=HACH
DOMAIN_PASSWORD_CHECK_DAYS_MSG=10
DOMAIN_PASSWORD_CHECK_DAYS_LOCKOUT=4

USE_VB6_LICENSING
(Optional, Default=0)

Specifies how WIMS verifies the license file.  If the setting =0, WIMS will use .net dll to verify license info.  If the setting =1, WIMS uses and alternate licensing class to verify the licence info.  This setting is helpful in certain secure environments. If you are getting the following error when running the client: Could not initialize license information! Error reported: Please call OPS Systems for assistance!, you will need to added USE_VB6_LICENSING=1 to the HACH_WIMS_CLIENT.ini.

Related Articles
No Related Articles Available.

Article Attachments
No Attachments Available.

Related External Links
No Related Links Available.
Help us improve this article...
What did you think of this article?

poor 
1
2
3
4
5
6
7
8
9
10

 excellent
Tell us why you rated the content this way. (optional)
 
Approved Comments...
No user comments available for this article.
Created on 8/21/2007 9:22 AM.
Last Modified on 8/5/2022 8:46 AM.
Last Modified by Scott Dorner.
Skill Level: Advanced.
Article has been viewed 11072 times.
Rated 6 out of 10 based on 4 votes.
Print Article
Email Article