Develop > Tailoring > Data management > Global lists > Build lists on startup

Build lists on startup

The Build List on Startup option, if enabled for a global list, does not initiate a "rebuild" of the list at user login, but simply makes the current list available to a new logged-in user.

  • Prior to version Service Manager 9.41, all global lists with the Build List on Startup option enabled were loaded at user login by applications, which might cause significant login delays. As of version 9.41, this functionality is optimized so that these global lists are not loaded into memory unless they are needed.
  • For a newly added global list, a restart of the Service Manager Server is required unless the name of the list variable starts with "$".

If a global list has a "Filename" and "Limiting SQL" defined, to automatically rebuild the list when something is changed in the source file, the lister background process must be running.

A global list is rebuilt on either of these actions:

  • A user clicks the Rebuild Global List option (the current and new user sessions get the new list)
  • The lister process is running against this global list (whose expiration time must be in the past)

Caution If you have created a Global List variable without the Build List on Startup option enabled, you need to manually rebuild the contents of the variable to make the variable ready for use. For example, if you create a global list $G.test without selecting the Build List on Startup option and you do not rebuild it manually, when you go to the RAD Debugger and type d $G.test, the RAD Debugger returns a NULL value.

Tip To avoid memory problems, you are recommended to enable the Build List on Startup option only for global lists that have less than 250 items.

Use the following procedure to set the globallists record to build on startup.

  1. Click Tailoring > Database Manager.
  2. Type globallists in the Table field of the Database Manager dialog box, and then click Search.
  3. In the List Name field, type the name of the list you want to view. For this example, type time.zones.
  4. Click Search.

    The time.zones file opens.

  5. Select Build List on Startup?.
  6. Click Save.
  7. Open an incident record to view the new field.

Related concepts

Global lists
Global initer considerations
Returning a list to your client
Configuring lists with Format Control

Related tasks

Access a list record
Bind a list to a form
Configure lists with Format Control
Determine if a scheduler record exists
Determine if the regen cycle is realistic
Determine when a list was last regenerated
Move a Global List to a client
Regenerate all lists
Regenerate obsolete lists
Start the server side component of the global initer
See a complete list of all the global lists on my system
Verify lister status and configuration
View changes to a list

Related references

Troubleshooting: lister