This documentation supports the 20.02 version of Remedy Action Request (AR) System.

To view an earlier 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


    Edit the options, as needed:

    Configuration tab fields

    Field NameDescription
    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.

    Note:

    This field is not required for BMC Remedy Mid Tier.

    Max Entries Returned by GetList

    Limits how many database entries are displayed on one page from search result.

    For example, setting the maximum entries to 50 shows 50 entries on each subsequent pages for the given search result.

    If you specify a maximum in their preferences, the lesser value is used. 0 (default) specifies 2000 entries per page.

    Server Table Field Chunk SizeFor 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 LanguageDisplays the language and character set of the computer on which the server is running.
    User Email Notifies FromIdentifies 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:

    Remedy AR System
    version
    Minimum API version
    19.0226
    18.0826
    18.0526
    9.1.0425
    9.1.0324
    9.1.0223
    9.1.0023
    9.0.0021
    8.1.0020
    8.0.0019
    7.6.0418
    7.6.0317
    7.5.0014
    7.1.0013
    7.0.0012
    6.3.0011

    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 allowed for a user after which the user account is marked INVALID.

    For example, if the value is set to 3, the user has 3 chances to log on. If all 3 attempts have bad passwords and the user enters a bad password in the fourth attempt, then 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 AR System Configuration Generic UI form.

    This parameter can be used in conjunction with Display-General-Auth-Message. See Configuration settings C-D. See also the description for error 624.

    Next Request ID Block SizeSpecifies 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 ReadDefines 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 ModeEnables 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 ArchiveDisables 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. 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.
    Server Group MemberIndicates whether the server is a member of a server group. By default this option is selected and is not changeable.
    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 AlertsEnables 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 GroupsEnables 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 ClientsWhen 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.

      • When you select the check box, it records the relationships of all server objects before it accepts connections from clients. Therefore, the first time you set the value to T, you cannot connect to the server by using any client temporarily. The more the number of objects defined on the server, the more time it takes to connect to the server. With a large number of objects, such as with an ITSM application installed, and depending on the performance of the database, this could take up to an hour. When you can reconnect to the server, the recording of object relationship data is complete.
      • When you clear the check box, 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 SizeSpecifies 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.
    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 TrackingDetermines 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 Recording and tracking license usage.
    Disable ARSignalsCauses the system to disable ARSignals. By default, this check box is not selected.
    Disable Audit Only Changed FieldsCauses 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.

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Alexander Korolev

    Hello. "Recache Delay The number of seconds that the recache is delayed." - I don't see this option on the picture above, and in my 20.02 environment too. Is this parameter still used in version 20.02?

    Jul 07, 2020 12:18
    1. Anagha Deshpande

      Hello Alexander,

      Thanks for your feedback on the documentation. We are working on your query.

      Regards,

      Anagha

      Jul 07, 2020 10:41
      1. Anagha Deshpande

        Hello Alexander,

        Thanks for bringing this to our notice.

        The Recache Delay field is deprecated. We have updated the topic.

        Regards,

        Anagha

        Jul 08, 2020 11:05