Version 4.6.2
 —  Administration  —

Maintaining User Profiles

The user profile system provides a series of menus to help you generate user profiles that define access rules for Adabas Review users. You may create profiles for new users, change access rules for existing users, and purge user profiles that are no longer required.

This document covers the following topics:


The Default User Profile Definition

Adabas Review provides a default profile to allow access for users who do not have a profile defined for them. When a user logs on, Adabas Review looks for a group profile first and then for an individual user profile. It uses the first profile found (group profiles take precedence over individual user profiles). If neither a group nor individual user profile is found, the provided default profile is used.

Note:
The default profile initially provides unrestricted access to Adabas Review functions. Software AG recommends that you first create a new user profile for the system administrator and other privileged users; then modify the default profile so that it conforms to the needs of the majority of users.

The default profile cannot be deleted. In addition, Adabas Review will not allow you to turn the default profile or any administrator profile into a non-administrator profile if another administrator profile is not available.

Top of page

Administrator Profiles

An administrator profile is a user profile that has access to everything. Adabas Review determines automatically whether a user profile is an administrator profile, based on the access rule settings specified for the profile.

To create an administrator profile, make sure that all the access rules for the user are set to "Y" (except optionally the Group Profile? and Confirm Purge/Save Requests? access rules, which can be set to "N" even for administrator profiles.

Note:
We recommend that the first user profile you create be another administrator profile (the default profile is distributed as an administrator profile). Then modify the default profile so that it conforms to the needs of the majority of your users.

Adabas Review will not allow you to turn the default profile or any administrator profile into a non-administrator profile if another administrator profile is not available.

Top of page

Group Profiles

You can set up group profiles, based on the groups set up by your Natural Security administrator. When a user logs on, Adabas Review looks for a group profile first and then for an individual user profile. It uses the first profile found (group profiles take precedence over individual user profiles). If neither a group nor individual user profile is found, the provided default profile is used.

Note:
Natural Security is only required if you want to use group IDs, but not otherwise.

To create a group profile, be sure to set the Group Profile? setting to "Y".

Administrators can be members of a group.

Top of page

Accessing the User Profile System

Start of instruction setTo access the user profile system:

  1. Enter UP on the command line of the Adabas Review main menu and press ENTER.

    The User Profile System menu appears as shown below:

     14:47:41                  A D A B A S  -  R E V I E W                2012-08-23
                                   User Profile System                              
                                                                                    
                                                                                    
                       Code              Description                                
                       ----     ----------------------------------                  
                        EU          Edit User Profile                               
                        LU          List User Profiles                              
                       ----     ----------------------------------                  
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
     Command: ______________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit                                                  Menu   
Code Description
EU Edits a profile for a new or existing user.
LU Displays a list of existing user profiles, including the default profile.

From the list of existing user profiles, you can select a particular profile to be edited or purged.

Top of page

Migrating User Profiles

When you access the user profile system, Adabas Review verifies that your profiles follow all current Adabas Review profile conventions and standards. If they do not, Adabas Review attempts to migrate them to the most current standard. The following screen appears:

14:58:25                  A D A B A S  -  R E V I E W                2012-08-02
                            User Profile Migration                             
                                                                               
                                W e l c o m e                                  
                                                                               
+-----------------------------------------------------------------------------+
|                                                                             |
|             Review has detected that the user profiles must be              |
|             migrated to the current level before Review can be              |
|             started.                                                        |
|                                                                             |
|             Press ENTER to begin migration or PF3 to exit.                  |
|                                                                             |
|             Note: Pressing PF3 will terminate Review.                       |
|                                                                             |
|                                                                             |
|                                                                             |
+-----------------------------------------------------------------------------+

Press ENTER to migrate your profiles to the current standard. Press PF3 to exit Adabas Review without performing the migration.

Top of page

Listing User Profile Definitions

The List User Profiles (LU) function displays a list of the user profiles that have been defined.

Start of instruction setTo access a list of defined user profiles:

  1. From the User Profile System menu, enter the code LU on the command line and press ENTER.

    A User Profiles screen, similar to the one shown below, is displayed:

     14:47:03                  A D A B A S  -  R E V I E W                2012-08-23
                                      User Profiles                                 
                                                                                    
       Sel  Userid    Description              Sel  Userid    Description           
     +-----------------------------------------------------------------------------+
     | __ > DEFAULT   Default User Profile     __   USR00010  Generated Prof 00010 |
     | __ > REVIEW    Review Administrator     __   USR00011  Generated Prof 00011 |
     | __ > TESTME    TEST PROFILE             __   USR00012  Generated Prof 00012 |
     | __   USR00001  Generated Prof 00001     __   USR00013  Generated Prof 00013 |
     | __   USR00002  Generated Prof 00002     __   USR00014  Generated Prof 00014 |
     | __   USR00003  Generated Prof 00003     __   USR00015  Generated Prof 00015 |
     | __   USR00004  Generated Prof 00004     __   USR00016  Generated Prof 00016 |
     | __   USR00005  Generated Prof 00005     __   USR00017  Generated Prof 00017 |
     | __   USR00006  Generated Prof 00006     __   USR00018  Generated Prof 00018 |
     | __   USR00007  Generated Prof 00007     __   USR00019  Generated Prof 00019 |
     | __   USR00008  Generated Prof 00008     __   USR00020  Generated Prof 00020 |
     | __   USR00009  Generated Prof 00009     __   USR00021  Generated Prof 00021 |
     +-----------------------------------------------------------------------------+
                            > Admin   > Group   > Admin+Group                       
                                                                                    
                                                                                    
     Command: ______________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit                     -     +                      Menu   

    Note the cursor (>) before each user ID on this screen. This cursor and its presence identify the profile type:

    Cursor Present? Cursor Color Description
    Yes yellow (>) The user profile is an administrator profile.
    Yes blue (>) The user profile is a group profile.
    Yes pink (>) The user profile is both an administrator and a group profile.
    No --- The user profile is a regular profile. It is neither an administrator profile nor a group profile.
  2. From this screen, you may edit or purge a particular user profile.

    If you enter a question mark (?) or an invalid value on the selection line preceding a profile name and press ENTER, the Available Functions window appears displaying a list of the available commands:

    Command Description
    EU Edit the selected profile.
    PU Purge the selected profile.
    . Exit the window without selecting any command.

Top of page

Creating a New User Profile

Start of instruction setTo create a new user profile:

  1. From any screen in Adabas Review, type the following string on the command line and press ENTER:

    UP EU userid

    Or:
    From any screen in the user profile system, type the following string on the command line and press ENTER:

    EU userid

    Or:

    EU

    Adabas Review creates a profile for the user by copying the default profile and displays it for editing on the Edit Profile screen.

    The Edit Profile is actually a series of several screen pagess. You can navigate between these pages using your PF11 (forward) and PF10 (backward) keys.

     14:51:07                  A D A B A S  -  R E V I E W                2012-08-23
                                      Edit Profile                                  
                                                                                    
             General Settings                      Specific DBIDs to Monitor        
     +-----------------------------------------------------------------------------+
     | User ID / Group ID ..... ________        _____  _____  _____  _____  _____  |
     | Group Profile? ................ N        _____  _____  _____  _____  _____  |
     | Description: ____________________        _____  _____  _____  _____  _____  |
     | Access User Profiles? ......... Y        _____  _____  _____  _____  _____  |
     | Access Review? ................ Y        _____  _____  _____  _____  _____  |
     | Monitor All Targets? .......... Y        _____  _____  _____  _____  _____  |
     | Default Nucleus Target .... LFILE        _____  _____  _____  _____  _____  |
     | Default Repository DBID ... LFILE        _____  _____  _____  _____  _____  |
     | Default Repository File ... LFILE        _____  _____  _____  _____  _____  |
     |                                          _____  _____  _____  _____  _____  |
     | Confirm Purge/Save Requests? .. Y        _____  _____  _____  _____  _____  |
     |                                          _____  _____  _____  _____  _____  |
     |     Press PF11 to scroll right           _____  _____  _____  _____  _____  |
     +------------------------ (Administrator Privileges) -------------------------+
                                                                                    
     REV00101 - NEW USER PROFILE                                                    
     Command: ______________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit        Save  Reset                         ===>  Menu   
  2. Customize the user's profile, as required.

  3. When the profile provides appropriate access privileges, press PF5 to save the profile.

Top of page

Editing an Existing User Profile

Start of instruction setTo edit an existing user profile:

  1. List the available user profiles as described in Listing User Profile Definitions.

  2. Enter the command EU on the selection line preceding the profile name you want to edit and press Enter.

    The profile is displayed and may be edited. Read for additional information.

  3. When the profile provides appropriate access privileges for the user, press PF5 to save the profile.

    If you are editing your own user profile, the changes you make take effect as soon as you save your profile. If you are editing a profile other than your own, the changes do not take effect until the next time the user changes screens.

Top of page

User Profile Access Rules

The Edit Profile screen contains several pages of user access rules. Use the PF11 (forward) and PF10 (backward) keys to scroll between the pages.

 14:51:07                  A D A B A S  -  R E V I E W                2012-08-23
                                  Edit Profile                                  
                                                                                
         General Settings                      Specific DBIDs to Monitor        
 +-----------------------------------------------------------------------------+
 | User ID / Group ID ..... ________        _____  _____  _____  _____  _____  |
 | Group Profile? ................ N        _____  _____  _____  _____  _____  |
 | Description: ____________________        _____  _____  _____  _____  _____  |
 | Access User Profiles? ......... Y        _____  _____  _____  _____  _____  |
 | Access Review? ................ Y        _____  _____  _____  _____  _____  |
 | Monitor All Targets? .......... Y        _____  _____  _____  _____  _____  |
 | Default Nucleus Target .... LFILE        _____  _____  _____  _____  _____  |
 | Default Repository DBID ... LFILE        _____  _____  _____  _____  _____  |
 | Default Repository File ... LFILE        _____  _____  _____  _____  _____  |
 |                                          _____  _____  _____  _____  _____  |
 | Confirm Purge/Save Requests? .. Y        _____  _____  _____  _____  _____  |
 |                                          _____  _____  _____  _____  _____  |
 |     Press PF11 to scroll right           _____  _____  _____  _____  _____  |
 +------------------------ (Administrator Privileges) -------------------------+
                                                                                
 REV00101 - NEW USER PROFILE                                                    
 Command: ______________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help        Exit        Save  Reset                         ===>  Menu   
14:51:57                  A D A B A S  -  R E V I E W                2012-08-23
                             Edit Profile:                            
                                                                               
                               Profile Settings                                
+---------------------------------------------------------------------------+  
|  List Report Definitions? ....... Y   List History Reports? .......... Y  |  
|  Edit Reports? .................. Y   View History Reports? .......... Y  |  
|    Edit Database Reports? ....... Y   Compress History Reports? ...... Y  |  
|    Edit Client Reports? ......... Y   Purge History Reports? ......... Y  |  
|    Edit Bufferpool Reports? ..... Y   List Targets? .................. Y  |  
|    Edit Pulse Reports?  ......... Y   Edit Targets? .................. Y  |  
|    Edit Cluster Reports? ........ Y   Purge Targets? ................. Y  |  
|  Purge Report Definitions? ...... Y   List Available Hubs? ........... Y  |  
|  Start Reports? ................. Y   Access AA Menu? ................ Y  |  
|  List Started Reports? .......... Y   Transfer to AOS? ............... Y  |  
|  View Started Reports? .......... Y   Change Review Nucleus? ......... Y  |  
|  Change Report Status? .......... Y   Change Repository? ............. Y  |  
|  Purge Started Reports? ......... Y   Change LFILE Info? ............. Y  |  
+---------------------------------------------------------------------------+  
                                                                               
                                                                               
Command: ______________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Save  Reset                   <===  ===>  Menu   
14:52:16                  A D A B A S  -  R E V I E W                2012-08-23
                             Edit Profile:                           
                                                                               
                               Profile Settings                                
+---------------------------------------------------------------------------+  
|  Restrict lists to allowed DBIDs? N                                       |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
|                                                                           |  
+---------------------------------------------------------------------------+  
                                                                               
                                                                               
Command: ______________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit        Save  Reset                   <===        Menu   

Start of instruction setTo modify access rules:

  1. Type over the access rule setting displayed on the screen.

  2. When you have made all of the changes to a particular group of access rules, either:

The following table describes all of the access rules available in alphabetic order, whether they are required, their valid values, and the Adabas Review screen page (1, 2, or 3) on which the rule can be found.

Access Rule Name Page Required? Valid Values (Defaults are underlined) Description
Access AA Menu? 2 No Y | N Indicates whether users assigned the profile are allowed access to the Available SVCs screen.
Access Review? 1 No Y | N Indicates whether users assigned the profile are allowed to access Adabas Review.
Access User Profiles? 1 No Y | N Indicates whether users assigned the profile are allowed to access the user profile system. Before setting this access rule to "N" in the default profile, you must first create a user profile that allows you to access the user profile system. Otherwise, you will not be able to maintain user profiles.
Change LFILE Info? 2 No Y | N Indicates whether users assigned the profile are allowed to run the LFILE command.
Change Report Status? 2 No Y | N Indicates whether users assigned the profile are allowed to suspend or reactivate reports from the Started Reports (LS) screen.
Change Repository? 2 No Y | N Indicates whether users assigned the profile are allowed to change the repository DBID or file using the SETA command.
Change Review Nucleus? 2 No Y | N Indicates whether users assigned the profile are allowed to change the hub ID or DBID for reporting using the SETA, DBID, or HUB commands.
Compress History Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to request history report compression.
Confirm Purge/Save Requests? 1 No Y | N Indicates whether users assigned the profile are prompted to confirm a purge or save request before it is executed.
Default Nucleus Target 1 No nnnnn | 0 |AUTO|LFILE In hub mode, specify the number of the hub ID that should be used. "AUTO", "LFILE", or "0" can also be specified:
  • If "0" is specified, the value is determined as if "LFILE" were specified.

  • If "LFILE" is specified, the value is determined from the LFILE setting of the current Natural session. This is primarily useful in local mode.

  • If "AUTO" is specified, the value is determined from the SVC (or IDTNAME) of the current Natural session. If a single hub is running under the current SVC (or IDTNAME), that hub ID is used. If more than one hub ID is active, the first hub ID found under the SVC is used. If no hub is running, the value is determined as if "LFILE" were specified.

    Note:
    Support for the "AUTO" value executes module ADATMZ in the Natural environment, which dynamically loads CCSTCK and ADALNKR. If CCSTCK or ADALNKR cannot be loaded, subsequent calls to ADATMZ might lead to problems. Be sure that the modules ADATMZ, ADALNKR, and CCSTCK, which are available in the Adabas or WAL load libraries, are also available for the TP monitor.

In local mode, specify the number of the database ID (DBID) that should be used or specify "LFILE" or "0". "AUTO" can be used but the value is determined as if "LFILE" were specified.

Default Repository DBID 1 No nnnnn | 0|LFILE The database ID where theAdabas Review repository (history) file resides. "LFILE" or "0" can also be specified.
  • If "0" is specified, the value is determined as if "LFILE" were specified.

  • If "LFILE" is specified, the value is determined from the LFILE setting of the current Natural session.

Default Repository File 1 No nnnnn | 0|LFILE The file number of the Adabas Review repository (history) file. "LFILE" or "0" can also be specified.
  • If "0" is specified, the value is determined as if "LFILE" were specified.

  • If "LFILE" is specified, the value is determined from the LFILE setting of the current Natural session.

Description 1 Yes Twenty alphanumeric characters A description of the profile.
Edit Bufferpool Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to edit buffer pool reports.
Edit Client Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to edit client reports.
Edit Cluster Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to edit cluster reports.
Edit Database Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to edit database reports.
Edit Pulse Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to edit pulse reports.
Edit Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to use the Edit Report (ER) function.
Edit Targets? 2 No Y | N Indicates whether users assigned the profile are allowed to create or edit target definitions.
Group Profile? 1 No Y | N Indicates whether the profile is a group profile.
List Available Hubs? 2 No Y | N Indicates whether users assigned the profile are allowed to list the available hubs.
List History Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to list history reports.
List Report Definitions? 2 No Y | N Indicates whether users assigned the profile are allowed to list report definitions.
List Started Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to list started reports.
List Targets? 2 No Y | N Indicates whether users assigned the profile are allowed to list target definitions.
Monitor All Targets? 1 No Y | N Indicates whether users assigned the profile are allowed to monitor all targets. If this is set to "N" (no), you are prompted to list the specific DBIDs that can be monitored by the user profile in the Specific DBIDs to Monitor list. If this access rule is to "Y", all database targets can be monitored.
Purge History Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to delete historical data from the Adabas Review repository.
Purge Report Definitions? 2 No Y | N Indicates whether users assigned the profile are allowed to delete report definitions.
Purge Started Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to delete data collected by started reports.
Purge Targets? 2 No Y | N Indicates whether users assigned the profile are allowed to delete target definitions.
Restrict lists to allowed DBIDs? 3 No Y | N Indicates whether lists produced by users assigned the profile should be limited to the DBIDs allowed by the profile.
Specific DBIDs to Monitor 1 No Valid database IDs This is really a list of fields in which you can specify database IDs that can be monitored by users with the user profile when the Monitor All Targets? access rule is set to "N".
Start Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to initiate data accumulation by starting a report.
Transfer to AOS? 2 No Y | N Indicates whether users assigned the profile are allowed to use Adabas Online System.
User ID / Group ID 1 Yes Up to eight alphanumeric characters long beginning with either a letter or a national ($, @, or #) character. The user ID or group ID name of the profile.
View History Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to view the results of history reports online.
View Started Reports? 2 No Y | N Indicates whether users assigned the profile are allowed to view the results of started reports online.

Top of page

Copying a User Profile

Start of instruction setTo copy a user profile:

  1. Enter the command EU on the selection line preceding the profile name you want to edit and press Enter.

    The profile is displayed and may be edited. Read for additional information.

  2. Enter the command EU on the selection line preceding the profile name you want to copy.

  3. Type the new user ID or group ID in the User ID / Group ID field.

  4. Press PF5 to save the new user profile.

Top of page

Purging a User Profile

Start of instruction setTo delete a user profile:

  1. List the defined user profiles on the User Profiles screen, as described in Listing User Profile Definitions.

  2. Enter the command PU on the selection line preceding the profile name you want to delete and press Enter.

    Depending on the setting in your profile, you may or may not be prompted to confirm the purge request as shown in the following screen:

    2:26:58                  A D A B A S  -  R E V I E W                2012-04-24
                                     User Profiles                                 
                                                                                   
      Sel  Userid    Name                     Sel  Userid    Name                  
    +-----------------------------------------------------------------------------+
    ! __   DEFAULT     DEFAULT PROFILE                                            !
    ! __   USER1       REVIEW ADMIN                                               !
    ! __   USER2       SMITH                                                      !
    ! pu   USER3       JONES                                                      !
    ! __   USER4       ADAMS       +-------------------------------------+        !
    ! __   USER5       GREENE      !                                     !        !
    !                              ! Please confirm PURGE request for:   !        !
    !                              !                                     !        !
    !                              !              USER3                  !        !
    !                              !                                     !        !
    !                              !             (Y or N) Y              !        !
    !                              !                                     !        !
    !                              +-------------------------------------+        !
    !                                                                             !
    +-----------------------------------------------------------------------------+
                                                                                   
    Command: ______________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                           +                      Menu   

Top of page