1 LIST

 This command enables the user to "list" information about users on the 
 system.  The information is listed by username, user's full name, group 
 and their work phone.

!
2 all  

 To list all users recorded, type a "*".  They will be displayed by 
 username.

 Example:

 $ LIST *
  
 USERNAME     NAME                             GROUP           PHONE
 --------     ----                             -----           -----
  
 BJACKSON     JACKSON, BO                      RAIDERS         (234)535-6723
 BPOLE        POLE, BEAN                       GREEN           (234)987-3647
 BSIMPSON     SIMPSON, BART                    NO WAY MAN      (123)456-7890
 CHUCK        HUCKSTABLE, CLIFF                DOCTOR          (234)576-3123
 CROAST       ROAST, CHUCK                     STEAK           (234)587-6547
 JSCHMOE      SCHMOE, JOE                      BONE HEAD       (703)663-1234
 JSNAKE       SNAKE, JAKE THE                  WRESTLER        (123)987-1982
    :                 :                               :               :
 NPETERSON    PETERSON, NORM                   BEER            (345)123-9876
 NSCHWARZ     SCHWARZKOPF, "STORMIN" NORMAN    GENERAL         (987)654-3210
 SHUSSIEN     HUSSIEN?, NOT THIS CRAZY JERK!   STUPID          (666)666-6666
 YSCHMUCK     SCHMUCK, YOU                     BONE HEAD       (345)756-2345
  
!
2 username  

 This qualifier enables the user of LIST to type in a username and find 
 out all the owners of usernames that start out with the specified input 
 as well as their group and their work phones.  The command becomes more 
 accurate by specifying more letters of the username.  For example, if you
 specify to list on A, all usernames that start with A will be displayed.
 If you specify AB, then all usernames that start with AB will be displayed.

 Example:

 $ LIST b
  
 USERNAME     NAME                             GROUP           PHONE
 --------     ----                             -----           -----
  
 BJACKSON     JACKSON, BO                      RAIDERS         (234)535-6723
 BPOLE        POLE, BEAN                       GREEN           (234)987-3647
 BSIMPSON     SIMPSON, BART                    NO WAY MAN      (123)456-7890
  
!
2 name  

 This command enables the user to enter the user's real name.  The command 
 becomes more accurate by specifying more of the user's name.  In other 
 words, if you specify to list on  B, you will get all users who's last 
 names start with B.  If you specify to list on SCH, you will get all users 
 who's last names start with SCH and so on.

 To use this command, use the backslash, "\",  before entering the name.

 Example:

 $ LIST \sch
  
 NAME                           USERNAME       GROUP           PHONE
 ----                           --------       -----           -----
  
 SCHMOE, JOE                    JSCHMOE        BONE HEAD       (703)663-1234
 SCHMUCK, YOU                   YSCHMUCK       BONE HEAD       (345)756-2345
 SCHWARZKOPF, "STORMIN" NORMAN  NSCHWARZ       GENERAL         (987)654-3210
  
!
2 /ADD

 Allows the addition of a new user and information concerning that user
 into the user list.  If information is not provided, you will be prompted.
 The order of information is:

       1)  Username  [15 characters]

       2)  User's name in the order of last, first, middle.  A comma, ",",
           must be used between the last and first names.  [30 characters]
           (if supplied on the command line, must be enclosed in quotes)

           "SCHMOE, JOE USER"

       3)  Work phone in the order of area code (in parentheses),
           exchange (followed by a dash), and number or just specify 
           the numbers and the program will format appropriately.

           "(123) 456-7890"    or     1234567890

 Group information is pulled from the system authorization files auto-
 matically.  [15 characters] 

 You must have SYSPRV enabled to use this qualifier to add other usernames.  
 If you do not have SYSPRV enabled, then your own username is used and only 
 items 2 and 3 are requested.

 Example:

 $ LIST /ADD bjackson  "jackson, bo"  (765)234-2345
 %LIST-I-USRADD, User successfully added.

!
2 /COMPRESS

 Utilizes the VMS convert utility to compress the indexed file.  The 
 listing file becomes fragmented and the secondary keys will be out of
 order when there are several additions and deletions.  Must have SYSPRV
 to use this qualifier.  This qualifier can only be used with the
 /LISTING qualifier.

!
2 /DELETE

 Allows a user to be deleted from the user list.  Username is supplied as
 a parameter.  If no parameter is given, you will be prompted for one.  You 
 must have SYSPRV enabled to use this qualifier.

 Example:

 $ LIST /DELETE shussien
 %LIST-I-USRDEL, User is now a gonner.

!
2 /GROUP

 Allows a user to display users by group.  If no group is specified, all 
 groups will be displayed.  When specifying a group the command becomes 
 more accurate by specifying more of the group's name.  In other words, if 
 you specify to list on  B, you will get all groups that start with B.  If 
 you specify to list on SCH, you will get all groups that start with SCH 
 and so on.

 Example:

 $ LIST /GROUP=S
  
 GROUP          USERNAME      NAME                             PHONE
 -----          --------      ----                             -----
  
 STEAK          CROAST        ROAST, CHUCK                     (234)587-6547
 STUPID         SHUSSIEN      HUSSIEN?, NOT THIS CRAZY JERK!   (666)666-6666
  
!
2 /LISTING

 /LISTING=file.name

 Allows the use of multiple listing files.  This qualifier is used with a
 default file.  If a file does not exist and the user has SYSPRV, the file
 is created as a phone listing file.

!
2 /MODIFY

 Allows a user to modify their own information in the user list.  The 
 information that a user is able to modify is:

       1)  User's name to be entered in the form:  last, first middle.
           This is up to 30 characters.
           (if supplied on the command line, must be enclosed in quotes)

           "SCHMOE, JOE USER"

       2)  Work phone in the order of area code (in parentheses),
           exchange (followed by a dash), number, or just specify the 
           numbers and the program will format.

           "(123)456-7890"    or   1234567890

 Any time a user runs with this option, the GROUP field is checked and 
 modified automatically if there is new GROUP information. [15 characters]

!
3 /USER
  /USER=username

 Will allow you to specify another user when modifying the name or 
 phone number.  Must have SYSPRV enabled to use this qualifier.

!
2 /OUTPUT
  /OUTPUT=file.name

 Will allow you to write all information to a specified file.

!
2 /RENAME

 Allows the user to rename a username.  User must have SYSPRV enabled.

 Example:

 $ LIST /RENAME  old_name  new_name

 The GROUP field will be checked from the SYSUAF files and modified auto-
 matically when this qualifier is used.
