Preattention Program Exit Program

The Preattention Program exit program is called when the user presses the System Attention key.

When a user presses the System Attention key, the operating system calls the user-written exit program through the registration facility. There are no input or output parameters. After the exit programs from the registration facility are called, the system attention program is called.

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

Before any of the exit programs in the registration facility are called, the user profile for each user intending to use this function will need to be updated. The Set Profile Exit Program (QWTSETPX) API will need to be called. This API will set for the requested user profile which of the eight allowed exit programs to call. The user can have none or all eight possible exit programs called. No exit programs will be called until the QWTSETPX API is called to set the values in the user profile. To display which exit programs will be called for a particular user, the Retrieve Profile Exit Program (QWTRTVPX) API can be called. (For more information about both of these APIs, see the Work Management APIs.)

Notes:

1. The Preattention Program exit point ignores any return codes or error messages that are sent from the exit programs.
   
   
2. It is recommended that the Preattention Program exit program exist in a library in the system auxiliary storage pool (ASP) or in a basic user ASP. It might not be found if it exists in a library in an independent ASP.

Authorities and Locks

User Profile Authority

All object (*ALLOBJ) and security administrator (*SECADM) special authorities are needed to add exit programs to the registration facility or to remove exit programs from the registration facility.

Required Parameter

None.