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.
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
ULM1
--- 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
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
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.
Note:
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.
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
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
End Updat fwd MenuL Quit |
Note:
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 to save the profile.
Press 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
Server.
---------------------------- Utility Defaults -----------------------------
UDS Function UPDS Function
UQ Function Keywords JB= SKU SI= CC DS= 1 LL= 80 PP= 1
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
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 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: .........
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Quit Updat bwd fwd Reset |
When all the User Profile information has been entered, saved the profile by pressing 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. Note:
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.
You can change the maintenance password using option MA from the user ID maintenance 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).
Note:
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
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
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
ULM7
--- User ID Maintenance ---
Selection criteria
Account number ..........:
Authorization code.......: 0
Control User (Y/N).......:
Startup/current program..:
UserId ..................:
System Id ...............:
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Exec Aband EndIn
|
Specify criteria to select the range of users the selected menu entry will be linked to/unlinked from and press or . 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 on the Selection menu.
To save changes for Text/Program press on the COM-PASS maintenance menu. Return to the user maintenance menu by pressing or .