[?29h[0"z




            

































































          UIF330 Update User List File
           
           
          Purpose:
           
             Maintain the user list file of the User Interface System which
             was written to be run easily from inside a VMS command
             procedure; that is why it is not screen oriented.
           
          Options:
           
             None.
           
          Logic:
           
             o  ADD
                1)  Get name of user to add or RETURN to end.
                2)  If user name is blanks, then, go back to the menu,
             else, continue.
                3)  If user name is already in the file, then, display an
             error message and go to step 1, else, continue.
                4)  Get the generic name to assign to this user (each user
             can have exactly one generic name) or RETURN to abort.
                5)  If the generic name is blanks,then , go back to the
             menu, else, continue.
                6)  Look for a record in the file with the generic name for
             both the user name and the generic name.  This record
             indicates that the generic name is valid and will be set up
             and maintained at Enterprises.  This program cannot enter a
             generic name validation record.
                7)  If the generic name is invalid (see above), then,
             display an error message and go to step 4, else, continue.
                8)  Get the top level menu name.
                9)  Make sure that the top level menu name is in the master
             file.  If it is not, display an error message and go to step
             8, else, continue.
                10)  Write out the record which we just built.
           
             o  CHANGE
                1)  Get the name of the user to change or RETURN to abort.
                2)  If the user name is blanks, then, go back to the menu,
             else, continue.
                3)  Read the user name record from the file.  If the user
             name record does not exist, display an error message and go
             back to the menu, else, continue.
                4)  Get new values for any fields that the user wants to
             change.
                5)  Confirm that the user does want to change the record.
             If he does, then, change it, else, don't change it.





          Revised:  09-May-84











                6)  Go back to the menu.
           
             o  DELETE
                1)  Get the name of the user to delete or RETURN to abort.
                2)  If the user name is blanks, then, go back to the menu,
             else, continue.
                3)  Read record from file.  If the record is not in the
             file, display an error message and go back to the menu, else,
             continue.
                4)  Display the record and get confirmation from the user.
                5)  If the user wants to delete the record, then, delete
             it, else, don't delete it.
                6)  Go back to the menu.
           
             o  INQUIRE
                1)  Get the name of the user for the inquiry.
                2)  Read the record.  If the record is not in the file,
             display an error message and go back to the menu, else,
             continue.
                3)  Display the record.
                4)  Go back to the menu.
           
          Subprograms:
           
             None.
           
          Files:
           
             File Id       File Name                    Usage
           
             UIF340.MAS    MASTER-FILE                  INPUT
             UIF330.USR    USERNAME-FILE                I-O
           
          Display Messages:
           
             Message:
           
                Type A to add, C to change, D to delete, I to inquire, or E
                to end:
           
             Response:
           
                Type the letter corresponding to the function you wish to
                perform.
           









          Revised:  09-May-84











             Message:
           
                Invalid choice, try again...
           
             Response:
           
                None.
           
             Message:
           
                Enter user's name or RETURN to abort:
           
             Response:
           
                Enter a user name.
           
             Message:
           
                >>>> Internal error - Duplicate username <<<<
           
             Response:
           
                This error should only occur during debugging.  It
                indicates that the program attempted to enter a duplicate
                user name into the user name file.
           
             Message:
           
                Enter user's generic name or RETURN to abort:
           
             Response:
           
                Enter the generic name for the user you are adding.
           
             Message:
           
                Enter user's top level menu name or RETURN to abort:
           
             Response:
           
                Enter the name of the top level menu for the user you are
                adding.
           











          Revised:  09-May-84











             Message:
           
                Enter new generic name or RETURN to leave it xxxxxx:
           
             Response:
           
                Enter the new generic name for the user you are adding or
                press RETURN to leave it unchanged.
           
             Message:
           
                Enter top level menu or RETURN to leave it xxxxxx:
           
             Response:
           
                Enter the new top level menu name for this user or press
                RETURN to leave it unchanged.
           
             Message:
           
                >>>> Internal error - Illegal rewrite <<<<
           
             Response:
           
                This message should only be displayed during debugging.  It
                indicates that the program attempted to rewrite a user name
                record that did not previously reside in the file.
           
             Message:
           
                Please answer Y for yes or N for no
           
             Response:
           
                None.
           
             Message:
           
                Generic name   => xxxxxx
           
             Response:
           
                None.
           










          Revised:  09-May-84











             Message:
           
                Top level menu => xxxxxx
           
             Response:
           
                None.
           
             Message:
           
                >>>> Internal error - Illegal deletion <<<<
           
             Response:
           
                This error should only occur during debugging.  It
                indicates that the program attempted to delete a record
                that was not in the file.





































          Revised:  09-May-84