Change User Profile Exit Program

  Required Parameter:

1

Change profile exit information

Input

Char(*)

 QSYSINC Member Name:  ECHGPRF1
 Exit Point Name:  QIBM_QSY_CHG_PROFILE
 Exit Point Format Name:  CHGP0100, CHGP0200

The Change User Profile exit programs are called when changing a user profile using one of the following commands or API:

• Change User Profile (CHGUSRPRF) command
• Change User Auditing (CHGUSRAUD) command
• Reset Profile Attributes (QSYRESPA) API

Other i5/OS commands and APIs call the interfaces listed above. As a result, they cause the Change User Profile exit programs to be called. A partial list of additional i5/OS interfaces that force calls to the exit programs are listed below:

• Change Profile (CHGPRF) command
• Change Password (CHGPWD) command
• Change Password (QSYCHGPW) API
• Configure System Security (CFGSYSSEC) command
• Analyze Profile Activity (ANZPRFACT) command

There are some i5/OS interfaces that make changes to the user profile object that do not cause the Change User Profile exit programs to be called. The most notable interfaces are listed below:

• Changing the user profile text description with the Change Object Description (CHGOBJD) command
• Granting or revoking private authority to an object
• Changing object ownership information
• Disabling a user profile during sign-on
• Setting the encrypted user password with the Set Encrypted Password (QSYSUPWD) API

The functions which do or don't cause the exit program to be called may change from release to release as commands and APIs are added.

When changing a user profile, as explained above, the operating system calls the user-written exit programs through the registration facility. Exit programs can register to be notified before the profile is changed, after the profile is changed, or both. The prechange notification is sent prior to actually changing the profile. The prechange notification is not a guarantee that the profile will actually be changed. The postchange notification is sent after the profile is changed.

It is also possible for a prechange notification to be sent for more than one profile before receiving a postchange notification. Therefore, an application that wants to keep a prechange view of the profile to compare to the postchange view of the profile needs to be able to handle prechange views for multiple profiles and be able to match those views with the correct profile during postchange processing.

For example, this could occur during CHGUSRPRF processing if the group profile or supplemental group list is changed. If a profile that is specified as a group profile or supplemental group does not already have a group ID (GID) assigned to the profile, then the CHGUSRPRF code will assign a GID to the profile. This involves a change to that profile, so a prechange notification will be sent for the profile having a GID assigned after the prechange notification for the profile specified on CHGUSRPRF, but before the postchange notification for the profile specified on CHGUSRPRF.

The exit point supports an unlimited number of exit programs. (For information about adding an exit program to an exit point, see the Registration Facility part.)

Note: The Change User Profile exit point ignores any return codes or error messages that are sent from the exit program.

Authorities and Locks

User Profile Authority

*ALLOBJ and *SECADM to add exit programs to the registration facility

Required Parameter

Change profile exit information

INPUT; CHAR(*)

Information needed by the exit program for notification of any profile changes. For details, see Format of Change Profile Exit Information.

Format of Change Profile Exit Information

The following table shows the structure of the change profile exit information for formats CHGP0100 and CHGP0200. For a description of the fields in the format, see Field Descriptions.

Field Descriptions

Exit point format name. The format name for the Change User Profile exit program. The possible format names are:

CHGP0100	The format name that is used after a user profile is changed.
CHGP0200	The format name that is used before a user profile is changed.

Exit point name. The name of the exit point that calls the exit program.

User profile name. The name of the user profile being changed.