Restore User Profile Exit Program


  Required Parameter:

1 Restore profile exit information Input Char(*)

 QSYSINC Member Name:  ERSTPRF1
 Exit Point Name:  QIBM_QSY_RST_PROFILE
 Exit Point Format Name:  RSTP0100

The Restore User Profile exit program is called when a user profile is restored on the iSeries server.

When a user profile is restored to the iSeries server, the operating system calls the user-written exit programs through the registration facility.

During a restore operation of the entire system, all required objects are not installed at the time user profiles are being restored. Therefore, this exit point is not active during a restore operation of the entire system.

This exit point supports up to 20 exit programs. (For information about adding an exit program to an exit point, see the Registration Facility part.)

Note: The Restore User Profile exit program 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

Restore profile exit information
INPUT; CHAR(*)

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


Format of Restore Profile Exit Information

The following table shows the structure of the restore profile exit information for format RST0100. For a description of the fields in this format, see Field Descriptions.

Offset Type Field
Dec Hex
0 0 CHAR(20) Exit point name
20 14 CHAR(8) Exit point format name
28 1C CHAR(10) User profile name


Field Descriptions

Exit point format name. The format name for the Restore User Profile exit program. The possible format name is:

RSTP0100 The format name that is used after a user profile is restored.

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

User profile name. The name of the user profile that was restored.



Exit program introduced: V3R7
Top | Security APIs | APIs by category