Set Profile Exit Programs (QWTSETPX) API


  Required Parameter Group:

1 Number of entries Input Binary(4)
2 Exit program flags Input Array(*) of Binary(4)
3 Format Input Char(8)
4 User ID Input Char(10)
5 Error code I/O Char(*)

  Default Public Authority: *EXCLUDE

  Threadsafe: No

The Set Profile Exit Programs (QWTSETPX) API sets for the specified user ID the profile exit programs to call based on the format value. The value ATTN0100 sets the exit flags for attention key processing. The value SREQ0100 sets the flags for system request processing. For the specified user ID, each of the eight exit program flags may be set to the following:

0 No, do not call this exit program.
1 Yes, call this exit program.
-1 Same, do not change the value.

If all the values are set to 0 (No), no new actions are taken during the attention key processing or system request processing.

Each exit program flag that is set to 1 (Yes) by this API corresponds to the exit program number of the exit programs that are registered in the registration facility for the QIBM_QWT_PREATTNPGMS exit point or the QIBM_QWT_SYSREQPGMS exit point.

When attention key processing is activated by a job that is running under the specified user ID, only the exit programs that have a 1 (Yes) for that exit program flag are called.

When system request key processing is activated by a job that is running under the specified user ID, only the exit programs that have a 1 (Yes) for that exit program flag are called.


Authorities and Locks

None.

Required Parameter Group

Number of entries
INPUT; BINARY(4)

The number of exit program flags that are being passed in. The maximum number of flags is 8, and the minimum number of flags is 1.

Exit program flags
INPUT; ARRAY(*) of BINARY(4)

An array of a number of elements. The number of array elements must match the number of entries. The valid values for the array elements are as follows:

0 No, do not call this exit program.
1 Yes, call this exit program.
-1 Do not change the value.

The first element of the array corresponds to exit program number one for the exit point that is in the registration facility. The second array element corresponds to exit program number two and so on.

Format
INPUT; CHAR(8)

The format that is to be updated. Valid values are as follows:

ATTN0100 The preattention program processing flags are to be updated.
SREQ0100 The presystem request program processing flags are to be updated.

User ID
INPUT; CHAR(10)

The user ID name being updated. Valid values are as follows:

*CURRENT The user ID of the job that is currently running is used.
User ID name The 10-character name that is entered is used.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF1666 E Number of entries not in valid range.
CPF2204 E User profile &1 not found.
CPF2213 E Not able to allocate user profile &1.
CPF2217 E Not authorized to user profile &1.
CPF24B4 E Severe error while addressing parameter list.
CPF3C90 E Literal value cannot be changed.
CPF3CF1 E Error code parameter not valid.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V3R6

[ Back to top | Work Management APIs | APIs by category ]