.UTIL ADD USER

This subroutine adds a user to the Appx User file.

Usage:

      PASS         <error_msg>                FIELD            SHARE? Y
      PASS     0SA USER RECORD                FIELD            SHARE? N
      GOSUB    --- .UTIL ADD USER
      *        Check for errors
      IF       --- .UTIL ADD USER             NE

Description:

This subroutine adds a user to the Appx User file. All parameters are required, if any required parameters are missing, the subroutine will CANCEL.

<error_msg> will contain a detailed error message if the user was not able to be added (Required). This must be PASSed Share "Y" to return the value.

0SA USER RECORD is the record structure containing the user information (Required).

The rules for required fields are different depending on whether the current user is an Appx System Administrator or not. If they are not a System Admin, then some fields must either be blank or they must contain the same information as the current user. In other words, they can only set up new users that will have the same settings. For example, they cannot set up a System Administrator unless they are also a System Administrator.

The fields are:

USER ID: The 3 character Appx User Id

USER SA: Y if the new user is a System Admin, N if not. Can only be Y if the current user is an Appx System Administrator.

USER NAM: The user's name.

USER PROF: The security profile. If the new user is not a System Admin leave this blank, or set it to the same profile as the current user.

USER INIT DB: The startup database.

USER INIT AP: The startup application.

USER INIT TYPE: The startup process type.

USER INIT NAM: The startup process name.

If the current user is not a System Admin, then the above fields should either be blank, or the same as the current user. If the current user is a System Administrator, then these can be filled in as required. Valid combinations are USER INIT DB only, or USER INIT DB and USER INIT AP only, or all 4 fields.

USER RPT PRTR: The user's default printer for reports (optional).

USER RPT FORM: The user's default form for reports (optional).

USER LOG PRTR: The user's default log printer (optional).

USER LOG FORM: The users's defaul form for logs (optional).

Comments:

Read what other users have said about this page or add your own comments.

-- JeanNeron - 2012-02-22