Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


This document describes the layout of the Atrium database, and how to import users and menu items manually.

Widget Connector





Users and Groups

In Atrium, each user and group is assigned a unique identifier. The assigned id must be entirely unique. For example, a user id number must be unique not only among other users, but also among any and all groups.


This file controls display options in Atrium. Each user or group and have their own settings. Or, they can inherit from their parent groups, or from a set of global defaults.





This is the unique key for this file.

When the portal loads, Atrium looks for a record in this file with the user id number. This will be present if the user has his own settings.  If not, a record might not be present for the user. In this case, group settings will be checked using the user’s parent group id. This record also may not be present. In this case, prior parent group ids (if any) will be checked.

If nothing is found, the record with ACID = 0 (global settings) will be used.

(warning) This record must always be present, or an error will occur.

any unique user or group id


This controls the title displayed in the browser title bar and/or browser tab. Can be set to any desired text.

any valid text


Flag that controls whether a banner is displayed at the top of the portal.



Controls the height (in pixels) of the banner.

(info) If ACBAN = ‘0’,


this field is ignored .

any valid pixel value


Sets the URL of the external HTML file that provides the banner content. The URL can be either a fully qualified URL, or an absolute path to an HTML file within the Profound UI http server’s document root folder.

(info) If ACBAN = ‘0’,


this field is ignored .

fully qualified URL or absolute path


Sets the color theme.

‘blue’, ‘gray’, ‘olive’, or ‘slate’


Controls whether or not the user gets an option on the Settings menu to set their own color theme.



Controls whether or not a home page is shown automatically when the portal loads.



Sets the desired homepage.

any unique navigation item number

(field ANITEM in file ATNAVP)


Controls the text that is displayed in the title bar of the navigation panel.

any valid text


Sets the starting width (in pixels) of the navigation panel when the portal loads.

(info) The user can resize the navigation panel during the session.

any valid pixel value


Controls whether the navigation panel is shown in the Tree or Accordion style.



Controls whether navigation items will launch with single (1) or double (0) click.



Controls whether Menu Search feature is enabled.

default: 1


Controls whether Favorites system is enabled.

default: 1


Limit of number of Atrium sessions, per web browser.

any valid positive number value

0 = no limit


Minimum number of characters for menu search.

any valid positive number value


Specifies a job description to set the library list from.

(info) *USRPRF can be specified if the Atrium users are IBM i user profiles.

(warning) To use, the field ACLIBL must be blank.

any valid job description


Specifies the library for the job description.

(info) *LIBL or *CURLIB can be specified.

any valid library


Specifies the current library.

any valid library, *USRPRF, or *CRTDFT


Contains a set of libraries to use as the library list.

(warning)  To use, both ACJOBD and ACJOBDLIB must be blank.

any valid libraries



To use the Atrium defaults, ACJOBD, ACJOBDLIB, ACCURLIB, and ACLIBL must be blank.

Groups File (ATGROUPSP)

This file contains Atrium groups. Users and other groups can be assigned into a group to inherit display settings and/or menu permissions.





Specifies a unique group identifier.

(warning) Value 0 is reserved and must not be used as a group id in this file.

any unique and valid positive number value


Specifies a unique parent group identifier.

(warning) Value 0 is for a top-level group which is not a member of any other.

any unique and valid positive number value


Sets the display name for the group.

any valid text



Identifiers must be unique among users and groups.

Users File (ATUSERSP)

This file contains a repository of users who are capable of signing into Atrium.





Specifies a unique user identifier.

(warning) Value 0 is reserved and must not be used as a group id in this file.

any unique and valid positive number value


Specifies the unique parent group identifier of the user.

(warning) All users must be assigned to a valid group.

any valid parent group identifier


Sets the user's access role.

0 - user is a User with permission to sign in and use navigation items for which they were given permission to use.

1 - user is a Manager with permission to add, remove, or update users within their own groups and subgroups of their groups.

2 - user is an Administrator with permission to perform any function in the portal.


Controls whether user can access My Settings option in the Settings menu. My Settings allows the user to control some of their own



Sets the user's display name.

any valid text


Sets the user's profile name.

(warning) When IBM i profiles are used, this field must be set in uppercase. For all other types of users, the case used must match EXACTLY to the user profile name in the user repository.

any valid name that corresponds to the user repository used to authenticate with the HTTP server.

(i.e. IBM i operating system, Kerberos, LDAP, validation list, etc.)


Sets the user's language code. Is used as a key to find menu item translations in file ATNTRANSP .

(info) If the language code is left blank, or there are no matching records in ATNTRANSP, the normal menu item texts are used.

As of Profound UI Version 6 Fix Pack 1.0, if the language code matches a language defined for Atrium, such as de_DE, fr_FR, it_IT, then the Atrium user interface will use that language when pui["language"] is not set in an extensions/atrium/ JavaScript file (e.g. settings.js).


any valid language code



Identifiers must be unique among users and groups .

Supplemental Groups (ATSUPGRPP)

This file contains supplemental members of groups. Both ASUUSER and ASUGROUP are primary keys; so, a user can be a member of multiple groups.


AMAACTN: A single-character Action Id. Valid Actions are:

  • 0: Write a value into a field

  • 1: Press a key

  • 5: Close the browser window or tab

AMAROW: Field Row. Value is 0 unless the action is 0–write a value into a field. For action 0, this identifies the terminal row where the field exists.


AMAVARTYPE: Variable Type. A single-character Type Id. This field is ignored when action is 5. This describes the data in the AMAVAR field. Valid Types are:

  • 0: A literal value. When action is 0, the value of AMAVAR is to be entered literally. When action is 1, the value of AMAVAR is the key to be pressed.

  • 1: A variable value. Valid for action 0 or 1. When configuring a navigation item to use this macro, you will be prompted for the variable name. The value entered on the navigation item will be written into the field when the macro is run.

  • 2: The current user profile. Valid only for action 0. Indicates that the current user profile should be entered into a field.

  • 3: The result of a JavaScript expression. Valid only for action 0.

AMAVAR: Variable. This field is ignored when action is 5. This way this field's value is used depends on the Action (AMAACTN) and the variable type (AMAVARTYPE).