How To Fix HH004 - Edit the Informix ONCONFIG file

SAP Error Message - Details

• Message type: E = Error

• Message class: HH - (Long) text for check tool 'infcfgcheck'

• Message number: 004

• Message text: Edit the Informix ONCONFIG file

What causes this issue?

The specified ONCONFIG parameter is not configured as recommended.

System Response

How to fix this error?

To set it to the recommended value, edit (as user 'informix') the file
'$INFORMIXDIR/etc/$ONCONFIG'.
CAUTION: The change will only become active when the database is
started up.

Error message extract from SAP system. Copyright SAP SE.

Smart SAP Assistant

• What is the cause and solution for SAP error message HH004 - Edit the Informix ONCONFIG file ?

  The SAP error message HH004, which indicates "Edit the Informix ONCONFIG file," typically arises in environments where SAP applications are using Informix as the database management system. This error suggests that there is a configuration issue with the Informix ONCONFIG file, which is crucial for the proper functioning of the Informix database.
  Cause:
  The error can be caused by several factors, including:
  
  Missing or Incorrect Configuration Parameters: The ONCONFIG file may lack necessary parameters or have incorrect values that do not meet the requirements of the SAP application.
  Database Initialization Issues: If the database has not been properly initialized or configured, it can lead to this error.
  Resource Limitations: The ONCONFIG file may not be configured to allocate sufficient resources (like memory or disk space) for the database operations required by SAP.
  Version Compatibility: There may be compatibility issues between the version of Informix being used and the SAP application.
  
  Solution:
  To resolve the HH004 error, follow these steps:
  
  
  Locate the ONCONFIG File: Find the ONCONFIG file, which is usually located in the Informix installation directory. The file is typically named ONCONFIG or may have a specific name defined during the installation.
  
  
  Edit the ONCONFIG File:
  
  Open the ONCONFIG file in a text editor.
  Review the configuration parameters. Common parameters to check include:
  
  DBSPACENAME: Ensure that the database space is correctly defined.
  LOGFILE: Check that the log file paths are correct and accessible.
  SHMVIRTSIZE: Ensure that the shared memory size is sufficient for your application.
  NUMCPUVPS: Verify that the number of virtual processors is set appropriately.
  
  
  Make necessary adjustments based on the requirements of your SAP application.
  
  
  
  Validate Configuration: After making changes, validate the configuration to ensure that there are no syntax errors or misconfigurations.
  
  
  Restart Informix: After editing the ONCONFIG file, restart the Informix database server to apply the changes.
  
  
  Check SAP Notes: Consult SAP Notes or documentation for any specific recommendations or configurations related to the version of SAP and Informix you are using.
  
  
  Monitor Logs: After making changes and restarting, monitor the Informix and SAP logs for any further errors or warnings that may indicate additional issues.
  
  
  Related Information:
  
  Informix Documentation: Refer to the official Informix documentation for detailed information on the ONCONFIG parameters and their implications.
  SAP Notes: Check the SAP Support Portal for any relevant notes or updates regarding compatibility and configuration with Informix.
  Community Forums: Engage with SAP and Informix community forums for shared experiences and solutions from other users who may have encountered similar issues.
  
  By following these steps, you should be able to resolve the HH004 error and ensure that your SAP application can communicate effectively with the Informix database.