1 overview
=TITLE Overview of User Account Manager 
 User Account Manager (UAM) allows you to 
 add, delete, modify, and list user accounts.  

 UAM makes account management easier by 
 providing a graphical interface that allows you 
 to type information in text entry fields and to 
 select information from list boxes that you set 
 up.  You can also use templates to specify 
 predefined information for accounts with 
 common characteristics.
 
 For more information about using UAM, double 
 click on an item from the list of additional 
 topics below.

 For information about using help, choose Help 
 from the Help menu above.

2 custom
=TITLE Customizing UAM
=INCLUDE overview
 Before you can manage accounts with UAM, you
 must set up login shell and directory lists 
 that you can choose from.  

 You can also define actions that UAM performs when you
 create and remove an account, establish templates, and 
 select the option that warns you when you have not 
 saved account changes.
 
 If your machine serves YP or BIND accounts, you can 
 specify the service you want to use to manage accounts.  
 In addition, you can specify that the password and 
 group files be updated each time you create, modify, 
 or remove an account.

 To customize UAM, choose an item from the 
 Customize menu.

 The UAM window allows you to:
 
 - Click MB1 on a toggle button to change the setting.
 
 - Click MB1 on a text entry field to enter information.

 - Click MB1 on a push button to initiate the 
   action described by the label.

 - Click MB1 on an item in a list box to select it.

 - View the items in a list box by operating the 
   scroll bar.

 - Click MB1 on the Apply button to view your 
   changes without dismissing the dialog box.

 - Click MB1 on the OK button to apply your 
   changes and dismiss the dialog box.

 - Click MB1 on the Cancel button to cancel your  
   changes.

3 loginshelllist
=TITLE Setting Up the Login Shell List
=INCLUDE objects loginshell
=INCLUDE overview
 To set up the Login Shell list box that appears 
 when you click on the Other Shells... button, 
 choose the Login Shell List... item from 
 the Customize menu.  The Login Shell List dialog 
 box is displayed, and the available login shells 
 appear in a list box.  

 To add a login shell, enter the shell name and either 
 click on the Add button or press the Return key.
 
 To remove a login shell, select the shell in the list 
 box and click on the Remove button.
 
3 parentlist
=TITLE Setting Up the Home Directory Parent List
=INCLUDE objects parent
=INCLUDE overview
 To set up the home directory parent list that 
 appears when you click on the Other Directories... 
 button, choose the Home Directory Parent List... item 
 from the Customize menu.  The Home Directory Parent 
 List dialog box is displayed, and the available 
 directories appear in a list box.  

 To add a directory, enter the directory name in 
 the text entry field and either click on the 
 Add button or press the Return key. 

 To remove a directory, select the directory in 
 the list box and click on the Remove button.

3 newaccountdef
=TITLE Setting Up New Account Actions
=INCLUDE objects personal
=INCLUDE objects userid
=INCLUDE objects username
=INCLUDE objects name
=INCLUDE overview custom createtemp
=INCLUDE overview
 You can specify actions that UAM performs each 
 time you create a new account.  The actions are:
 
 - Clear the personal information

 - Display the next available user ID

 - Use the login name for the home directory name

 - Display a particular template
 
 To specify the actions, choose the New Account 
 Actions... item from the Customize menu.  

 Click on the actions you want.  You can choose any 
 combination of actions.  
 
 To specify a template, click on the Other Templates... 
 button; a pop-up menu appears, listing the available 
 templates.  Select the template you want to use each 
 time you create an account.

3 accountremoval
=TITLE Setting Up Account Removal Actions
=INCLUDE overview custom passgroupsource
=INCLUDE objects parent
=INCLUDE objects name
=INCLUDE overview
 You can specify actions that UAM performs each time 
 you remove an account.  The possible actions are:

 - Disable the account
 
 - Remove the account's entries in the password and 
   group files

 - Remove the account's home directory and files

 Specify the actions by choosing the Account 
 Removal Actions... item from the Customize menu; 
 the Account Removal Actions dialog box appears.  

 Click on the actions that you want.  You 
 can choose any combination of actions.  

3 unsavededits
=TITLE Enabling the Unsaved Edits Warning
=INCLUDE overview
 When you manage accounts with UAM, you must make sure 
 that you always save the changes.  To specify that you 
 want UAM to display a warning when you have not clicked 
 on the Create Defined Account or the Save Changes 
 button, choose the Display Unsaved Edits Warnings item 
 from the Customize menu.  

 The button next to the item appears if the option is 
 enabled.  To disable the warnings, click on the item; 
 the button disappears.

3 createtemp
=TITLE Working With Templates
=INCLUDE overview
 UAM allows you to establish templates that you can 
 use to specify values for an account.  Templates 
 allow you to quickly create accounts with common values 
 because the common information is part of the template.  

 You apply a template to an account by choosing the 
 template name from the Templates menu.  You can also 
 apply a template by specifying the template name in the 
 New Account Actions dialog box.  

4 created 
=TITLE Creating a Template
=INCLUDE overview
To create a template, perform the following steps:
 
 1. Enter the information you want contained in a template 
    in the UAM window fields.  

 2. Choose the Template List... item from the Customize 
    menu.  UAM displays the Template List dialog box.  

 3. Click on the text entry field and type a name for the 
    template.  Then, click on the Add button or press the 
    Return key.

 4. Click on the OK or the Apply button to apply the 
    changes. 

4 removet
=TITLE Removing a Template
=INCLUDE overview
 To remove a template, perform the following steps:
 
 1. Choose the Template List... item from the Customize 
    menu.  UAM displays the Template List dialog box.  

 2. Click on the name of the template you want to remove 
    and then click on the Remove button.  

 3. Click on the OK or the Apply button to apply the 
    changes. 

4 modifyt 
=TITLE Modifying a Template
=INCLUDE overview
 If you want to change the information contained in a 
 template, perform the following steps:

 1. Display the template that you want to modify by 
    deleting any information in the Username field.  Then, 
    either click on the Change/Define button or press the 
    Return key.  UAM displays a message box;  dismiss the 
    message box.  Now, choose the name of the template you 
    want to modify from the Templates menu.  The template 
    information is displayed in the UAM window.  
 
 2. Edit the fields in the UAM window as needed.  

 3. Once the template information is correct, choose the 
    Template List... item from the Customize menu.  UAM 
    displays the Template List dialog box.  Choose the 
    template name you want to modify and then click on the 
    Remove button to remove the template name from the 
    list box.  
 
 4. Add the modified template by clicking on the text entry 
    field and typing the name of the template.  The template 
    name can be the same as the one you deleted in step 3,  
    or it can be a different name.   Then, click on the Add 
    button or press the Return key.
 
 5. Click on the OK or the Apply button to apply the 
    changes.
 
3 selectsource
=TITLE Selecting a Service 
=INCLUDE overview
 If you do not want to manage a local account and your 
 machine serves YP or BIND/Hesiod accounts, you can 
 specify a service to manage accounts. 

 Choose the Password and Group Source... item from 
 the Customize menu.  The Password and Group Source 
 dialog box appears.

 If you click on the Service button, a pop-up menu 
 displays the available services.  Select the service 
 you want to use to manage accounts.

 Choose the Show... item from the Source Details
 menu to display a dialog box containing the 
 source file names and the commands used to update 
 the source files.

3 passgroupsource
=TITLE Updating Password and Group Source Files
=INCLUDE overview
 UAM uses the password and group files on a system to 
 manage accounts.  After you manage accounts with UAM,
 you must convert the password and group files into a
 database that the local, YP, or BIND/Hesiod service
 can use.  You must do this before you end a 
 management session.  However, you do not have to do 
 this each time you apply account changes.

 To update the files, choose the Update Password 
 and Group Source item from the Options menu. 

 You may want to wait until you have completed all 
 account changes before you update the files because 
 updating the files may take a long time.  

 If you want the files to be updated each time you 
 create, modify, or remove an account, choose the
 Password and Group Source... item from the 
 Customize menu.  The Password and Group Source 
 dialog box appears; click on the Update Password 
 and Group Source Automatically button.  

 To display the source file names and the commands 
 used to update the source files, choose the
 Password and Group Source... item from the 
 Customize menu and then choose the Show... item from 
 the Source Details menu.

2 logfile
=TITLE Using Log Files
=INCLUDE overview
 For each UAM session, a log file is created that 
 keeps track of your work. The name of the log 
 file is:
 
      $HOME/.uam_log
 
 If you begin a UAM session and the .uam_log file
 exists, UAM renames the file .uam_log.bak.

2 listing
=TITLE Listing Accounts
=INCLUDE overview managaccount creataccount
=INCLUDE overview managaccount removeaccount 
=INCLUDE overview managaccount modifyingacc
=INCLUDE overview managaccount renameacc
=INCLUDE objects
=INCLUDE overview
 To list the accounts, choose the List 
 Accounts... item from the Options menu.  The 
 Username List list box appears.

 If you want to display information for a 
 specific account, select the account name in 
 the list box.  The account information is 
 displayed in the UAM window.

2 managaccount
=TITLE Managing Accounts
=INCLUDE overview custom selectsource
=INCLUDE overview custom passgroupsource
=INCLUDE objects
=INCLUDE overview
 The UAM window allows you to specify account 
 information by using text entry fields, list 
 boxes, and dialog boxes.  
 
 After creating or modifying information for an 
 account or accounts, you must update the service
 password and group files.   

 You can:
 
 - Click MB1 on a toggle button to change the 
   setting.
 
 - Click MB1 on a text entry field to enter 
   information.

 - Click MB1 on a push button to initiate the 
   action described by the label.

 - Click MB1 on an item in a list box to select
   the item.

 - View the items in a list box by operating the 
   scroll bar.

 - Click MB1 on the Apply button to apply your 
   changes without dismissing the dialog box.

 - Click MB1 on the OK button to apply your 
   changes and to dismiss the dialog box.

 - Click MB1 on the Cancel button to cancel your 
   changes and to dismiss the dialog box.
 
3 creataccount
=TITLE Creating an Account
=INCLUDE overview custom newaccountdef
=INCLUDE overview managaccount modifyingacc changepersinfo
=INCLUDE overview listing
=INCLUDE objects 
=INCLUDE overview
 To create an account, enter the name of the 
 account in the Username text entry field and 
 click on the Change/Define button or press the 
 Return key.   
 
 If default new account actions were specified in
 the New Account Actions... dialog box, some 
 account information may be specified in the window.  

 Add or modify the account information if necessary.

 You can also do the following:
 
 - Use the next available user ID 

 - Clear the personal information 

 - Apply template information

 To create the account, click on the Create
 Defined Account button.  

 You must update the password and group files 
 to use the account.

4 usingnextid
=TITLE Using the Next Available User ID
=INCLUDE overview
 To enter the next available user ID, choose 
 the Display Next Available User ID item from 
 the Options menu. 

4 applytemp
=TITLE Using Templates
=INCLUDE overview
=INCLUDE overview custom createtemp
 To apply template information to an account, 
 choose the template you want from the Templates 
 menu.  Information that was previously specified
 in the window may be overwritten by the template 
 information.
 
3 removeaccount
=TITLE Removing an Account
=INCLUDE overview listing
=INCLUDE overview
 To remove an account, enter the name of the 
 account in the Username text entry field, and 
 then click on the Remove button.  A dialog box 
 appears, describing the account removal 
 actions.

 To remove the account, click on the Remove 
 button.

 You must update the password and group files.

3 modifyingacc
=TITLE Modifying an Account
=INCLUDE overview listing
=INCLUDE overview managaccount creataccount usingnextid
=INCLUDE overview managaccount creataccount applytemp
=INCLUDE objects
=INCLUDE overview
 To modify account information, enter the 
 username in the Username text entry field and 
 either click on the Change/Define button or 
 press the Return key.  You can also choose the 
 List Accounts... item from the Options menu and 
 select the account you want to modify.  
 Information about the account is then displayed 
 in the UAM window.  

 If you decide you do not want to modify the 
 account, click on the Change/Define button.  The 
 information that you changed will return to its 
 original values.

 Modify the account information and then click 
 on the Save Changes button.

 You must update the password and group files 
 to apply the changes.
 
4 changepersinfo
=TITLE Changing Personal Information
=INCLUDE objects personal
=INCLUDE overview
 If you want to change information in the 
 personal information fields, select the Clear 
 Personal Information Fields item from the 
 Options menu.

3 renameacc
=TITLE Renaming an Account
=INCLUDE objects username
=INCLUDE overview listing
=INCLUDE overview
 To rename an account, enter the username in the 
 Username text entry field and click on the 
 Rename button.  The account information is 
 displayed in the UAM window, and a dialog box
 appears, enter the new username.

 Click on the Rename button or press the 
 Return key to rename the account.

 You must update the password and group files 
 to apply the changes.

2 exit
=TITLE Exiting from UAM
=INCLUDE overview
 To exit from UAM, choose the Exit item from the 
 File menu.


