Change User Profile Exit Program


  Required Parameter:


 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:

Other IBM® i 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 IBM i interfaces that force calls to the exit programs are listed below:

There are some IBM i 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:

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.

Start of change Note: When running in a system job, subsystem job, or SCPF job the Change User Profile exit programs are not called. End of change


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:

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.


Exit program introduced: V3R7

[ Back to top | Security APIs | APIs by category ]