This documentation applies to the 8.1 version of Remedy Action Request System, which is in "End of Version Support."

To view the latest version, select the version from the Product version menu.

Setting administrative options

Use the Configuration tab to set administrative options.

To set configuration options

  1. In a browser, open the BMC Remedy AR System Administration Console, and click System > General > Server Information.
    The AR System Administration: Server Information form appears.
  2. Click the Configuration tab.

    AR System Administration: Server Information form — Configuration tab
    (Click the image to expand it.)
  3. Edit the options, as needed:

    Configuration tab fields

    Field Name Description
    Users Prompted For Login

    Specifies whether users are prompted for their log on credentials.

    • By Preference --- The prompt appears by preference.
    • Once Only — The prompt appears only once per session.
    • Always — The prompt appears every logon session.
    Max Entries Returned by GetList Limits how many database entries are returned from a search. For example, setting the maximum entries to 50 would return a maximum of 50 entries, even if more entries satisfied the search qualification. BMC Remedy AR System warns users that the search matched more entries than the administrator allows to be retrieved. If users specify a maximum in their preferences, the lesser value is used. A value of 0 (default) specifies no limit.
    Server Table Field Chunk Size For server-side table fields, determines the number of entries (or size of the chunk) that the server retrieves at one time from the database and stores in-memory to process during filter or filter guide actions. The server then retrieves, stores, and processes the next chunk until all the rows are processed. Entering a value of 0 causes the server to retrieve an unlimited number of rows. The default is 1000 rows. Entering a low value in this field causes the server to process smaller chunks, which keeps the server memory usage down, but results in slower processing because the server needs to access the database many times, especially for large tables. Entering a high value causes the server to retrieve and process large chunks of data and access the database fewer times. This results in higher performance at the cost of memory use.
    Server Language Displays the language and character set of the computer on which the server is running.
    User Email Notifies From Identifies the sender of email notifications. The default sender for email notifications is ARSystem. To specify another user name, enter that name in this field. The name must match the name you use in the BMC Remedy AR System Email Configuration Form for notifications. For more information about configuring a mailbox for notifications, see Sending notifications.
    Minimum API Version

    Specifies the oldest version of the C and Java APIs with which the server communicates. The corresponding API and BMC Remedy AR System versions are as follows:

    • API 20 and AR System 8.1.00
    • API 19 and AR System 8.0.00
    • API 18 and AR System 7.6.04
    • API 17 and AR System 7.6.03
    • API 14 and AR System 7.5.00
    • API 13 and AR System 7.1.00
    • API 12 and AR System 7.0.00
    • API 11 and AR System 6.3.00

    If you set the minimum API version to 14, clients earlier than version 7.5.00 cannot communicate with the BMC Remedy AR System 7.5.00 or later server. If you set the API version to 0 or none, all clients can communicate with the server. For information about setting passwords to increase security, see Configuring server groups.

    Default Home Form

    Specifies the path to a home page form to be used system-wide as the default home page for this server when a user logs in. This default Home form is only used if one of the following statements is true:

    • This server is designated as the server for the home page in the BMC Remedy AR System User Preference form.
    • This server is designated as the home page server on the General Settings page in BMC Remedy Mid Tier Configuration Tool. See Homepage Server.
    • No home page is specified in the BMC Remedy AR System User Preference form.

    Note

    If the home page form is deleted, this field is cleared and you must re-enter a default home page.

    Max Number of Password Attempts

    Specifies the maximum number of consecutive bad password attempts a user is allowed. If you enter 3, the user has 3 chances to log on. If all 3 attempts have bad passwords, the user account is marked INVALID. Values for this field are 0 (turns features off) and all positive integers. This option can also be set with the Max-Password-Attempts option in the ar.conf (ar.cfg ) file.

    This parameter can be used in conjunction with Display-General-Auth-Message. See ar.cfg or ar.conf options C-D. See also the description for error 624.

    Next Request ID Block Size Specifies whether to allocate Next-IDs in blocks rather than one at a time. Allocating in blocks increases performance during a create operation. To allocate in blocks, enter a positive number greater than 1 (up to 1000). The default value is 1 (Next-IDs are not allocated in blocks). If 0 or a negative number is used, the server uses the default value of 1. You do not need to restart the server for the change to take effect. The option is started immediately. Warning: The use of this configuration setting might result in unpredictably large Next-ID sequence gaps. The likelihood of this occurring increases with the use of multiple servers that share a database. The BMC Remedy AR System server does not malfunction because of this gap and should not be considered a defect.
    Allow Guest Users

    Specifies whether BMC Remedy AR System permits access to guest users, who are not registered users of the system, to log on. If the check box is selected (default), guest users can log on and perform the following tasks:

    • View all forms and fields for which the Public group has Visible permission.
    • Execute all active links for which the Public group has permission.
    • View all fields for which the guest user is the submitter or assignee, if the Submitter Group or Assignee Group has View permission for the field.
    • Submit new requests if the fields on a form have the Allow Any User to Submit check box selected. See Special submit setting.
    • Modify all fields for which the guest user is the submitter, if the Submitter Group has Change permission for the field and if the Submitter Mode is Locked, as described in Setting license options.
    Give Guest Users Restricted Read Defines whether guest users receive a restricted read license when they log on to BMC Remedy AR System. If this option is not selected, guest users receive a read license.
    Allow Unqualified Searches

    Defines whether the server accepts unqualified searches (searches for which no search criteria are specified). If the check box is

    • Selected (default) — All database searches are allowed.
    • Cleared — You force users to enter a search criteria when performing queries.

    Note

    Consider restricting unqualified searches to prevent the performance penalty of retrieving and returning large blocks of data because of accidental unqualified searches to the database.

    Administrator-Only Mode Enables only administrators and sub-administrators to access BMC Remedy AR System. Users who are not administrators or sub-administrators cannot perform any BMC Remedy AR System operations. This is useful during system maintenance. By default, this option is not selected. Only administrators (not sub-administrators) can set the Administrator-Only Mode. After an administrator sets this option, sub-administrators can access only forms for which they have permission.
    Disable Archive Disables the archive operations on the server. You can disable one server operating with one database, but in the case of multiple servers attached to the same database, you can disable all servers except one to prevent conflicts. By default, this option is not selected. See Archiving data. If the Server Group Member option is selected, this setting is ignored. Server groups can be configured in the BMC Remedy AR System Server Group Operation Ranking form to make sure that only one server performs the operation. See Configuring server groups.
    Development Cache Mode

    Turns on a cache mode optimized for application development. If the check box is not selected (the default), the server is in production cache mode.

    Notes

    In this mode the Sync Cache feature cannot be used. For more information about using this option see Using the sync cache option.

    Development cache mode is intended for a development server, not a production server. In this mode, any operation with an extended run time can cause blocking. In particular, administrative operations cannot begin until in-progress user operations are completed. Subsequent user operations are blocked until the administrative operation is completed. Due to this, the server often gives the false impression that it has stopped responding.

    See Configuring server groups.

    Server Group Member Indicates whether the server is a member of a server group. By default, this option is not selected.
    Disable Admin Operations

    Disables certain operations performed only by administrators and sub-administrators, which enable you to control changes to the database by disabling administrator (Developer Studio) operations. You can disable one server operating with one database, but in the case of multiple servers sharing same database, use this setting to disable all servers except one to prevent conflicts. If the check box is

    • Selected — Administrators cannot perform operations that affect the server's data dictionary.
    • Cleared (default) — Administrators can perform their usual operations including all data dictionary restructuring operations.

    If the Server Group Member check box is selected, this setting is ignored. Server groups can be configured in the BMC Remedy AR System Server Group Operation Ranking form to make sure that only one server performs these operations. See Configuring server groups.

    Disable Escalations Enables you to stop escalations running on the server. You can disable one server operating with one database, but in the case of multiple servers attached to the same database, use this setting to disable all servers except one to prevent conflicts. By default, this option is not selected. If the Server Group Member check box is selected, this setting is ignored. Server groups can be configured in the BMC Remedy AR System Server Group Operation Ranking form to make sure that only one server performs escalations. See Configuring server groups.
    Disable Alerts Enables you to prevent alert messages from being sent to users when an alert event is entered in to the system. No threads are run in the Alert Queue. This setting is acknowledged only at startup, so any changes do not take effect until the server is restarted. By default, this option is not selected.
    Verify Alert Users

    Indicates whether the server needs to check its list of registered alert clients to determine if they are listening and ready to receive alert messages. This setting is acknowledged only at server startup, so any changes do not take effect until the server is restarted. Selecting this option can result in a large amount of network activity at server startup. If the check box is

    • Selected — The server verifies the list of clients. If the clients are not listening, they are removed from the list of registered clients.
    • Cleared (default) — The server does not perform the verification.

    Regardless of the setting, if a subsequent alert message is sent to a client that is not listening, the client is removed from the list of registered clients.

    Enable Multiple Assign Groups Enables multiple roles, groups, and user names to be stored in the row-level security Assignee Group field (ID 112) and in dynamic group fields (ID 60000-60999). This enables multiple users, or users from multiple groups, to access the same entry (as in the sample qualification, 'Assignee Group' = ";50;51;-90;'Mary Manager';" ). If the check box is not selected (the default), only one role, group, or user name can be stored.
    Disallow Non Unicode Clients When selected, restricts server access to Unicode-safe clients. This option applies to all non-Unicode clients. This check box is visible only for AR System 7.0.00 servers or later. If the server uses a non-Unicode database, the check box is disabled.
    Record Object Relationships

    Determines whether the AR System server records the relationships between workflow objects. If the check box is

    • Selected — The server creates entries in a database table to track the relationships between many types of workflow objects.
    • Cleared(default) — The server does not record relationships.

      Note

      If using a server group, all servers within the same server group must have the same setting for this option. If they do not, the servers in the group inconsistently populate and un-populate the object relationship database should they be the highest ranked server for the Administration operation when they are restarted. Only the highest ranked server for the Administration operation in the server group will perform the required object relationship actions when restarted.

      When the server is recording relationships, it updates the relationship data whenever an object is created, modified, or deleted. You might notice that installing an application or importing a large number of objects takes longer because of additional database operations.

      Note

      You must restart the AR System server before a change to this setting takes place.

      • When you select the check box and restart the server, it records the relationships of all server objects before it accepts connections from clients. Therefore, the first time you restart the server after selecting this option, you cannot connect to the server with any client for a period of time, which depends on how many objects are defined on the server. With a large number of objects, such as with an ITSM application installed, this could take as long as an hour or more depending on the performance of the database. (Subsequent server startups are not affected by this setting.) When you can connect, the recording of object relationship data is complete.
      • When you clear the check box and restart the server, it removes all the recorded relationships from the database. This option must be selected on a development server to enable the following features of BMC Remedy Developer Studio:
    • Analyzer
    • Search
    • Show Relationships

    For more information about Analyzer, see Using Analyzer to find problems in your applications. For more information about Search and Show Relationships, see Relationships tab. Also, BMC Remedy Developer Studio uses that object relationship data, if available, to improve performance of some features, including object lists, related working lists, and exporting related objects. To view these relationships directly, use the BMC Remedy AR System Object Relationships form.

    Max Attach Size Specifies the maximum size of the attachment in bytes. The default is 0, which allows users to attach files of any size.
    Use Prompt Bar For

    Specifies whether system messages appear in the prompt bar or a pop-up box. The options are:

    • Notes and Warnings (default) — Notes and warnings appear in the prompt bar, but Errors appear in a pop-up box.
    • All System Messages — All system messages appear in the prompt bar.
    • None, Show in Popup — No messages appear in a prompt bar. Instead, all messages appear in a pop-up box.
    Recache Delay The number of seconds that the recache is delayed.
    Required Field Identifier

    Specifies the character to add to the label of a field whose entry mode is Required.

    • Prefix on Label — Add the character to the beginning of the label.
    • Suffix on Label (default) ---  Add the character to the end of the label.
    • Identifier — The character to add to the label. The default is an asterisk.

    For information about field entry modes, see Field Properties.

    Display Property Caching

    This option can be set to restrict the number of form display properties the server loads into memory at startup. The result of a restricted option (Cache Only Server Display Properties) is less memory use at start-up, and more memory available for the server process to grow. Form display properties are used for the background image of form views and the display properties of each form field. If an unloaded display property is needed, the server loads it on demand instead of caching it up front. Use the radio button to select one of these options: Restart the server after changing this setting.

    • Cache Only Server Display Properties— Only display properties associated with server workflow are cached. This setting does not decrease start-up time because the server still must read all properties for load selection. Reduced memory use impacts performance when data must be read from the database. It might also adversely affect server performance, database performance, or both when used with mid tier caching.

      Note

      This option is not useful in a 64-bit environment. Most 64-bit environments do not impose memory limitations and setting the option could unnecessarily impact performance.

    • Cache All Display Properties (default) — All display properties are loaded into the cache. This increases the memory requirement for the cache but can improve the performance of the server when a form is first opened by the client.

      Note

      To configure settings for individual forms, use the check boxes on the Basic page of the Form Properties dialog box. See Setting form properties.

    License Tracking Determines whether information is recorded in the AR System Current License Usage and AR System Historical License Usage forms. By default, this option is not selected (information is not recorded in the forms). For information about tracking license usage, see Displaying and Tracking server group license usage.
    Disable ARSignals Causes the system to disable ARSignals. By default, this check box is not selected.
    Disable Audit Only Changed Fields Causes the system to record all fields when auditing a record. By default, this check box is not selected, indicating that only those fields whose values have changed during a transaction are audited.


This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments

  1. Basil Webster

    Max Attachment Size - Is this in KB or MB?

    Sep 09, 2013 01:41
    1. Aparna Saxena

      Thank you for your comment Basil. The value for Max Attach Size is in bytes. I've updated the documented to reflect this.

      Thanks,

      Aparna

       

      Sep 11, 2013 06:12
  2. Joe Gorman

    The License Tracking entry seems to be missing a pharse or 2 ofter theword 'Determines'

    Jun 05, 2014 12:32
  3. Joe Gorman

    Make that after the word

    Jun 05, 2014 12:33
  4. Ashwini Mathad

    Hello Joe,

    Thank you for your comment. We have added the missing information to the License Tracking field description.

    Regards,

    Ashwini

    Jun 06, 2014 01:16
  5. Maheshwari L

    What is the equivalent of "Max Entries Returned by GetList" in ar.conf?

     

    May 12, 2016 11:42
    1. Prachi Kalyani

      Hello,

      The equivalent option for Max Entries Returned by GetList is Max-Entries-Per-Query. The details for this option is provided on ar.cfg or ar.conf options E-M topic.

      Thanks,

      Prachi

      May 13, 2016 12:06
      1. Maheshwari L

        Thanks Prachi

        May 13, 2016 12:16