Function UM - User Maintenance (Administrator)

The UM function of the UUTIL utility is designed for use at a control terminal to:

  • Maintain user data;

  • Maintain the COM-PASS environment;

  • Display Com-plete user ID definitions;

  • Display active users of Com-plete.

    Com-plete definitions of users who are authorized to access Com-plete are stored on the so-called system data container and are referenced by the ULOG utility program each time a user attempts to log on to the Com-plete system. Each user definition contains the following information:

  • User ID;

  • Account number or group number for the user ID;

  • Password for the user ID; number of invalid password attempts since the last successful logon;

  • Authorization code for the user ID;

  • Control status to be given the user ID;

  • Sending and receiving class codes to be assigned to this user ID for sending and receiving messages and for printout spooling;

  • Date and time of the most recent ULOG ON session;

  • COM-PASS defaults and PF key settings.

When a terminal user is identified to the Com-plete system with the ULOG utility program, the information from the user ID data set is used to create a logon information block (see CCUIT in the Com-plete source). After logging on successfully, this information is used to create the user ID accounting block. Statistical information for the user ID is accumulated and maintained by using the user ID accounting block, which in turn is written to the SMF data set. Each user ID accounting block is purged from the Com-plete system when either the associated user logs off or Com-plete terminates.

User Maintenance Functions

After invoking this function from the UUTIL main menu, the user maintenance menu is displayed. This menu enables the definition, control, and maintenance functions to be performed:

11:25:06        TID    10          COMTEST8          User SAG          06.01.06
                      ---  User ID Maintenance Menu  ---                       
Operation                Fc Operand         Operation                Fc Operand
------------------------ -- ---------       ------------------------ -- -------
Define a User Id........ AD 1,2,3,4,7       Display a User Id....... DS 1,2    
Update a User Id........ UP 1,2             Display selected Users.. DI 2,6    
Update selected User Ids UA 2,6             Display Active Users.... DA 6      
Delete User ID(s)....... DE 1,2,6                                              
Lock   User ID(s)....... LO 1,2,6           Maintain COM-PASS menu.. CM 5      
Unlock User ID(s)....... UN 1,2,6           Set Maintenance Password MA        
Fc:     (1) User Id..:           (2) System:       (6) Selection:              
        (3) copy from:           (4) System:       (7) copy PFKeys/LibIds:     
        (5) Language.:   1                                                     
                  End                                                   Quit

Most operations provided speak for themselves. The numbers listed in theOperand field following each operation relate to the relevant operands for the function, which can be specified in the bottom half of the screen. in the bottom half of the screen.

If you are creating user profiles for the first time, you should consider defining the COM-PASS environment first. See the description of function CM (Maintain COM-PASS menu) below.

Creating a New User Profile

To add a new user, select the AD operation and supply the new user ID and optionally system ID. You can also specify an existing user ID in the copy fromfield. If no copy from user ID is specified, $MODLSTD is implicitly used. You can modify the $MODLSTD user definition to set defaults for all subsequent ADDrequests.

The following screen illustrates an example user definition screen:

COMULM0052-* Please enter additional arguments...
 16:54:39        TID     5          COM-5.1.          User MBE          12.11.97
                         ---  User ID Maintenance  ---                      ULM3

 Add      User NEWBOY    System Global
 User Name....
                                                          Last update.: SKU
 This is a Model UserId  NO                                         on: 12:41:15
 Based on Model UserId.                                             at: *  ¥ Ø
 Control Status........  YES                                       Sys: 7
 Account Number........
 Authorization Code....       0
 User Password.........  PASSWORD
 Exempt from Autologoff  YES
 COM-PASS User.........  YES
 Suspend 9 Programs....  YES
 Non-Menu Programs.....  YES
 Start-Up Program......  USTACK
 Dispatch Priority.....  1
 Send Message Codes....  1   2   3   4 X 5   6   7 X
 Receive Message Codes.  1   2   3   4 X 5   6 X 7 X

                   End         Updat             fwd   MenuL             Quit

From this screen, PF9 takes you straight to the third user definition screen, namely the menu program selection screen (see below).

Having completed your modifications, press PF5 to save the profile.

Meaning of the options:

Option Meaning
This is a Model User ID YES means that this user ID can ONLY be used to serve as a model definition for a logon via one of the Com-plete facilities that use model IDs (applymod 57, NSC link,...).This user ID cannot be specified on the ULOG ON screen.
Based on Model User ID Enter an existing model user ID (optional). If the user logs on, the model user's definitions are taken. The advantage of using this option is that to change the definitions of a user group based on the same model, only the model User Profile need be changed.
Control Status Specifies CONTROL (YES) or NONCONTROL (NO) status. Control status is required to enable usage of the "control user" utilities. Administrator status is attained through knowledge of the maintenance password.
Account number Specifies a 1 to 12 digit account code or group number to be assigned to the user ID.
Authorization code Specifies the authorization code to be be assigned to the specified user ID. Represents an integer from -32768 to +32767.
User Password Specifies the password to be assigned to this user ID. Note that if the password option is selected at Com-plete initialization time, this password must be entered along with the user ID in order to gain access to the Com-plete system.
Exempt from A value of "YES" indicates that this user is not subject to autologoff the inactivity value supplied through the AUTOLOGOFF sysparm value. The default value is "NO".
COM-PASS user This option acts as a "COM-PASS switch". You may decide not to let a user become a COM-PASS user until all definitions are complete. The Profile can be updated to make the user (or all users) a COM-PASS user in one operation.
Suspend n is a value from one to nine, indicating the number of programs this user can suspend. The default value for n is nine (9).
At logon time, n is compared to the STACKMAXIMUM sysparm value. The number of programs the user can suspend is n or the STACKMAXIMUM value, whichever is the smaller.
This feature is used to convert Com-plete from a non-COM-PASS production system to a COM-PASS production system.
Non-menu programs A value of "NO" indicates that this user can only access those programs that appear in his COM-PASS menu. "YES" indicates that he can also access programs that do not appear in his COM-PASS menu.
Startup program This option acts as a "startup switch". If the user is to be automatically supplied with a startup transaction after logon, enter the name of the transaction here. If the user is to receive the COM-PASS menu, specify USTACK.
Send Message Codes Specifies the authorization class code(s) to be assigned to this user ID for sending messages and printout spooling. Authorization class code 4 (used for Com-plete messages) is always assigned even if not specified. The authorization class codes are fully described in the section UM - Message Switching/Printout Spooling Utility.
Receive Message Codes Specifies the authorization class code(s) to be assigned to this user ID for receiving messages and printout spooling.
The authorization class codes are full described in the section UM - Message Switching/Printout Spooling Utility.
If RMC=(0), this user ID is not allowed to receive messages or printouts.
If SMC=(0), this user ID is not allowed to send messages or printouts.

Press PF8 to proceed to the second screen:

16:51:22        TID    12          Com-plete          User MBE         13.11.00
System: Global          -- User Default Parameters --                      UDEF

----------------------------   Global  Defaults   -----------------------------

DSN                                               Volume        Device
Libid/Member     /
                                                PF01    PF02    PF03    PF04
                                                PF05    PF06    PF07    PF08
Language....   0   Case.......                  PF09    PF10    PF11    PF12
                                                PF13    PF14    PF15    PF16
Recallchar...                                   PF17    PF18    PF19    PF20
Suspendchar..      Suspendkey. PA1              PF21    PF22    PF23    PF24
Jumpchar.....      Jumpkey.... PF24
Printer DUMMY      HC Key..... PA2              PF 13-24 = 01-12 (Y/N): N
----------------------------   Utility Defaults   -----------------------------

UDS Function                              UPDS    Function
UQ  Function      Keywords  JB= SKU       SI= CC  DS= 1    LL= 80   PP= 1

                  End         Updat       bwd   fwd                     Quit

In this screen, you can:

  • Specify the short-ID of the library, as well as the member to be used as default when the UPDS utility is invoked;

  • Specify the default volume serial number and device type when the UDS utility is invoked;

  • Set the default language and case for screens;

  • Assign PF keys to levels on the COM-PASS menu by entering either a suspend level number (1 through 9) or a transaction Profile identity (A through I) next to the PF key;

  • Set COM-PASS characteristics;

  • Specify the default printer;

  • Specify an LPD print server. When this field is filled, all printouts from this user are routed to this server, using the printer name entered for the print queue name. Enter an asterisk (*) in the first position of this field to route printouts to the user's workstation. Note that this feature works only when the user connects to Com-plete's individuasl telnet tn3270 port, and an LPD server is active on the user's workstation.

  • Specify default functions when UPDS or UDS in invoked, as well as a default function and default keyword values when UQ is invoked.

The PF key and default settings can initially be defined on this screen and modified later by the user. PF keys can be modified on the main menu, and default settings can be modified with the UD function.

Press PF8 to display the menu program selection screen for the user. This screen lists the programs defined for the COM-PASS menu (see function CM, Maintain COM-PASS menu, below). Using the Page and ID fields, you can specify on which COM-PASS menu page the program is to appear and with which letter it can be called (the programs are also listed alphabetically according to the ID on the user's COM-PASS menu):

15:06:52                     User ID  Maintenance                     Page    1
 Sys Global Lang   1         Menu Program Selection                         ULMA

 PageID .... Menu Text .....  Program      PageID .... Menu Text .....  Program
  1  E  THE Editor            UEDIT                                     TESTCOK
  1  B  PDS functions         UPDS
  1  I  Map definition        UMAP
        Switch to lower case  LOW                                       TESTCOK1
        Switch to upper case  UP
        Online spooling       USPOOL
  1  F  Online dumps          UDUMP
  1  A  Storage display       USTOR
  1  D  JES functions et al   UQ
  1  C  Online control        UCTRL
        Utilities Menu        UUTIL
  1  G

       Used IDs -> Page1: ABCDEFG.I   Page2: .........   Page3: .........
                   Quit        Updat       bwd   fwd               Reset

When all the User Profile information has been entered, saved the profile by pressing PF5 until you see the message User userid successfully added.

Updating a User Profile

Existing User Profiles can be updated. Select function UA with a user ID to update a single user definition, or specify Y in the selection field to select a group of users according to the displayed criteria. The user definitions are then presented one by one.

Deleting a User Profile

Redundant user profiles can be deleted using option DE from the user ID maintenance menu. After the profile to be deleted is selected, the profile is displayed and you are asked to verify that the profile is to be deleted.

Locking/Unlocking Users

A user or group of users can be locked and subsequently unlocked from using Com-plete, for example, while maintenance is being carried out or while the user is away from the installation for a long period of time.

Select option LO/UN from the user ID maintenance menu to do this. You can specify a specific user ID, or specify Y in the selection field to lock/unlock all users belonging to a particular account.

Displaying Profiles and Users

The DS option enables individual User Profiles to be displayed and updated. The DI option enables all defined users (or selected groups) to be displayed. The DA option enables all active users (or selected groups) to be displayed. Specify Y in the selection field to specify selection criteria for the DI and DA functions.

Selection Criteria

Option Meaning
Control User (Y/N) See Control Status in the overview of options above.
Account number See the overview of options above.
Authorization code See the overview of options above.
Startup/Current program See Startup Program in the the overview of options above.
TID number Select a specific TID.
UserID See the overview of options above; may be generic (e.g. SYS*).
System ID As set on the Maintenance Menu when the userID was added.
Marked for Delete Records with this flag are leftovers from COM45 where only a logical delete was possible.
Last Logon before Refers to the Last Logon date saved during ULOG ON processing.

The selected records include those without a Last-Logon date.

Read all USERDEF records Besides the UserIDs added using UUTIL UM, there are other records added internally , e.g. if you assign models in ULOGX1 or by setting Applymod 57.
Show selected records N: the records agreeing with the other selection criteria are deleted.
Y: the selected records are shown one by one and you can decide if you really want to delete it or not.

Some of these options are not available for all functions.

Maintenance Password

You can change the maintenance password using option MA from the user ID maintenance menu.

Maintain COM-PASS Menu

The CM function allows you to set up the COM-PASS environment, which you can subsequently tailor for each User Profile or group of User Profiles (functions AD, UP, UA).

User-specific modifications (link/unlink) will be active after a re-logon.

You can define the program names and program descriptions to appear on the COM-PASS menu, a one-letter ID to be associated with each program, the menu page, as well as the conditions under which the program is to appear. Additionally, you can link or unlink specific menu lines to user IDs.

The COM-PASS menu definition function operates in two modes:

  • PROGRAM mode, used to define the program names to appear on the user's COM-PASS menu

  • TEXT mode, meaning there is only ONE set of program names, the program descriptions can be added in various languages, temporarily activated using the LANG command from COM-PASS, or perrmanently set for the user by the administrator using the UM UP function. The user can modify the language using UUTIL function UD.

When you select the CM option, the COM-PASS menu screen is displayed:

17:30:34              User ID Maintenance - COM-PASS Menu              Page   1
 System..: Global                                                           ULM0
 Language:   1                              Propagate into
 S Nbr  Menu Text...........  Programs      P/E  Ovw  Free   Message............
     1  THE Editor            UEDIT         0     N    N
     2  PDS functions         UPDS          0     N    N
     3  Map definition        UMAP          0     N    N
     4  Switch to lower case  LOW           0     N    N
     5  Switch to upper case  UP            0     N    N
     6  Online spooling       USPOOL        0     N    N
     7  Online dumps          UDUMP         0     N    N
     8  Storage display       USTOR         0     N    N
     9  JES functions et al   UQ            0     N    N
    10  Online control        UCTRL         0     N    N
    11  Utilities Menu        UUTIL         0     N    N
    12                                      0     N    N
    13                                      0     N    N
    14                                      0     N    N
    15                                      0     N    N
    16                                      0     N    N

                   End         Updat       bwd   fwd         Text        Quit

Initially the screen is clear; up to 240 programs (8 screen pages) can be added. Enter the menu text and program names in the appropriate columns as in the above example, using PF10 to toggle between text and program name input.

The other input fields have the following meaning:

Column Meaning
S Enter L (for LINK) or U (for UNLINK) for the entry to be linked or unlinked and specify one or more of the following parameters under the heading Propagate into:
P/E Specifies the Page/Entry number (1A to 3I) of the COM-PASS menu slot where the menu program is to appear.
Ovw Set to Y to force the selected menu program into the slot specified in P/E, otherwise it will be linked only if the selected slot is empty.
Free Specifies that the first empty slot on the user's COM-PASS menu will be used for the selected menu program.

For both the L and U selection, the following screen will be presented:

COMULM0052-* Please enter additional arguments...                              
15:03:11        TID    11          COMPLETE          User SAG          23.04.09
                         --- User ID Maintenance ---                           
                             Selection  criteria                               
Account number ..........:                                                     
Authorization code.......:     0                                               
Control User (Y/N).......:                                                     
Startup/current program..:                                                     
UserId ..................:                                                     
System Id ...............:                                                     
Exec              Aband                                                 EndIn  

Specify criteria to select the range of users the selected menu entry will be linked to/unlinked from and press ENTER or PF12. The User ID Maintenance - COM-PASS menu is is redisplayed with information about the number of user records updated. If you want to cancel the Link/Unlink press PF3 on the Selection menu.

To save changes for Text/Program press PF5 on the COM-PASS maintenance menu. Return to the user maintenance menu by pressing CLEAR or PF3.