Configuring the ARS.CFG file

When you run the various Content Manager OnDemand programs, they obtain information from the ARS.CFG file about a variety of configuration settings.

About this task

The information includes the language setting for the database and the location of configuration and temporary work space directories, for example. Before you begin using Content Manager OnDemand, you should review the parameters in the ARS.CFG file. Most of the values that IBM® provides are sufficient for many customers. However, you might need to change some of the values for your environment. If you make changes to the ARS.CFG file while the system is running, you must stop and restart the server before Content Manager OnDemand can use any values that you modify.

To change the ARS.CFG file, log on as QSECOFR. Issue the WRKLNK command and change to the /QIBM/UserData/OnDemand/instance directory, where instance is the name of your Content Manager OnDemand instance. The default instance name is QUSROND. Make a backup copy of the file provided by IBM. Edit the ARS.CFG file by using Option 2 (Edit) on the WRKLNK screen.

  • ARS_AUTOSTART_INSTANCE parameter
    Defaults to 1 (which means YES, autostart this instance's server) for instance QUSROND. Defaults to 0 (which means NO, do not autostart this instance's server) for all other instances.
  • ARS_DISABLE_ARSLOG parameter
    The national language environment used to create the database. Content Manager OnDemand uses a three-character language code to derive the locale and code set for the server operating system.
  • ARS_LANGUAGE parameter
    The national language environment used to create the database. Content Manager OnDemand uses a three-character language code to derive the locale and code set for the server operating system.
  • ARS_LDAP_ALLOW_ANONYMOUS parameter
    Specifies whether or not anonymous bind connections are allowed on this LDAP server. Valid values are TRUE and FALSE. If FALSE, you must also specify an LDAP user ID and password in the stash file.
  • ARS_LDAP_BASE_DN parameter
    Specifies the base distinguished name to use.
  • ARS_LDAP_BIND_ATTRIBUTE parameter
    Specifies the attribute being bound and is the attribute name to be searched on the LDAP server.
  • ARS_LDAP_BIND_MESSAGES_FILE parameter
    Specifies the location of a file containing the LDAP message strings the Content Manager OnDemand server looks for during login.
  • ARS_LDAP_IGN_USERIDS parameter
    This parameter specifies the user IDs that Content Manager OnDemand ignores when you enable LDAP for authentication. If the parameter does not exist or you do not specify a value, Content Manager OnDemand defaults to ADMIN.
  • ARS_LDAP_MAPPED_ATTRIBUTE parameter
    Specifies the attribute being returned to Content Manager OnDemand as a user ID.
  • ARS_LDAP_PORT parameter
    Specifies the port on which LDAP is listening. The default value is 389. This parameter is optional.
  • ARS_LDAP_SERVER parameter
    Specifies the IP address or the fully-qualified hostname of the LDAP server. This parameter is required for LDAP authentication.
  • ARS_MESSAGE_OF_THE_DAY parameter
    Use to specify the message of the day for the Content Manager OnDemand client. Set to the full path name of a file that contains the message that you want the client to show.
  • ARS_MSGS_LANGUAGE parameter
    If you want something other than English for server messages, change this parameter in the ars.cfg file for the instance and specify the three-character language id that you want to use.
  • ARS_NUM_DBSRVR parameter
    Determines the number of processes that Content Manager OnDemand starts on the server to handle connections to the database.
  • ARS_PRINT_PATH parameter
    The location where the Content Manager OnDemand server print function temporarily stores print data.
  • ARS_SUPPORT_CFSOD parameter
    To use Content Federation Services for Content Manager OnDemand, you must set this parameter to 1.
  • ARS_SUPPORT_HOLD parameter
    Enables the Enhanced Retention Management feature, a separately priced feature.
  • ARS_TMP parameter
    The location where Content Manager OnDemand programs temporarily store data.
  • ARSSOCK_RESOLVE_CLIENT_NAME parameter
    If you are experiencing longer than normal logon response times in a DHCP environment, adding the following line to the ARS.CFG file might correct the problem: ARSSOCK_RESOLVE_CLIENT_NAME=0