.UTIL CHG USER

This subroutine changes fields on the Appx User file.

Usage:

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

Description:

This subroutine changes fields on 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 changed (Required). This must be PASSed Share "Y" to return the value.

0SA USER RECORD is the record structure containing the user information (Required). You only need to fill in the USER ID and the field(s) you want to change, all others can be blank.

The rules for editing are different depending on whether the current user is an Appx System Administrator or not. If they are not a System Admin, then you cannot turn on the USER SA flag, and some fields must either be blank or they must contain the same information as the current user. In other words, a non System Admin cannot change security settings except to make them match their existing settings.

The fields are:

USER ID: The 3 character Appx User Id. This is required, and identifies which Appx user you want to change.

All remaining fields are optional, and only need to be filled in if you want to change it.

USER TYPE: Anonymous, Limited or Standard

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 SYS ID: The O/S user id.

USER NAM: The user's name.

USER ALPHA SORT: A character string for sorting the User file.

USER PROF: The security profile.

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 4 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 INIT SRC VER: For designers, the version to start App Design with. If specified, you must also supply the previous field.

USER EM CACHE LEVEL: The Em Cache Level.

USER EM MAX CACHE: The maximum number of cached Ems.

USER LOGPROF: If you want to track the activity of this user, supply a valid Log Profile name.

USER DEF LANG ID: The default Language Id.

USER RPT SCR: Default value for view reports on screen (Y/N).

USER RPT HCPY: Default value for printing reports on the printer (Y/N).

USER RPT NOTIFY: Default value for notifying the user when the report is printed (Y/N) (not implemented).

USER RPT MODE: Default value for Report Print Mode (HOLD, KEEP, SPOOL).

USER RPT DISP: Default value for Report Disposition (REQUEUE, SAVE, SCRATCH).

USER RPT CPYS: Default value for number of copies.

USER RPT PRIOR: Default value for print priority.

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

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

USER LOG SCR: Default value for view logs on screen (Y/N).

USER LOG HCPY: Default value for printing reports on the printer (Y/N).

USER LOG NOTIFY: Default value for notifying the user when the log is printed (Y/N) (not implemented).

USER LOG MODE: Default value for Log Print Mode (HOLD, KEEP, SPOOL).

USER LOG DISP: Default value for Log Disposition (REQUEUE, SAVE, SCRATCH).

USER LOG CPYS: Default value for number of copies.

USER LOG PRIOR: Default value for print priority.

USER LOG PRTR: The user's default printer for reports.

USER LOG FORM: The user's default form for reports.

Also see .UTIL ADD USER and .UTIL CHG AUX PASS.

Comments:

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

-- JeanNeron - 2012-02-27