Exit 3: SELECT service start exit

In addition to providing information you can use to monitor ISPF, this user exit lets you restrict access to applications selected through ISPF. ISPF invokes the exit routines when the SELECT service is invoked. The SELECT service is invoked by:

ISPSTART command
SPLIT command (not when already in split-screen mode)
SPLIT NEW command
START command
ISPSTRT program interface
Selection menu entry
Command table entry
SELECT dialog service

The exit routines are given control after the SELECT request has been parsed and syntax checking is complete.

Changes you make to the Screen name are not reflected in the SCRNAME value passed in this exit.

Exit parameters

In addition to the standard exit parameters described in Exit parameter list, the exit routines at this user exit receive these parameters. ISPF ignores any changes the exit routines make to these parameters.

Flags

4 bytes of bit flags defined as follows:

0: 1 = PGM keyword specified
1: 1 = CMD keyword specified
2: 1 = PANEL keyword specified
3-4: Reserved
5: 1 = ADDPOP keyword specified
6: 1 = BARRIER keyword specified
7: 1 = NEST keyword specified
8: 1 = NEWAPPL keyword specified
9: 1 = NEWPOOL or NEWAPPL keyword specified
10: 1 = PASSLIB keyword specified
11: 1 = Lang (CREX) keyword specified
12: 1 = Lang (APL) keyword specified
13: 1 = MODE(FSCR) specified
14: 1 = MODE(LINE) specified
15: Reserved
16: 1 = PARM value passed to the exit was truncated to 258 bytes, which include a halfword length field and 256 bytes of data.
17: 1 = SUSPEND specified
18: 1 = LOGO keyword specified
19-31: Reserved.

elemname

An 8-character field that contains the name of the element (PGM, CMD, or PANEL) to be selected.

APPLID

A 4-character field that contains the current application ID. If NEWAPPL was specified on the SELECT request, this field contains the new APPLID as specified. If APPLID field is blank, the previously specified application ID is implied. The value is left justified and padded with blanks.

PARM

Input parameters being passed to a program dialog in the same format as when passed to the program; single character string preceded by a halfword containing its length (the length value does not include itself). FLAGS bit 16 is set when this parameter represents a truncated PARM value. The Length field is not affected by truncation.

logoname

An 8-character field that contains the name of the LOGO panel if it was specified.

Screen name

Screen name as set by the SCRNAME command and shown by the SCRNAME ON function.

Return codes

0: Normal completion; ISPF continues processing.
8: Authorization failure; The SELECT request is not processed. Instead, ISPF issues a line mode message stating that the user exit indicated an authorization failure and terminates the select service, but allows the active application to continue.
16: Authorization failure; the SELECT request is not processed. Instead, ISPF issues a message indicating that the user exit indicated an authorization failure and terminates the SELECT service processing with a severe error (RC=20).
Other: ISPF treats the error as severe and issues a message indicating that the exit routine returned an incorrect return code.