Initial program

You can specify the name of a program to call when a user signs on. Such a program is called an initial program. An initial program runs before the initial menu, if any, is displayed.

Add User prompt:: Sign on program
CL parameter:: INLPGM
Length:: 10 (program name) 10 (library name)
Authority:: *USE for program *EXECUTE for library

If the Limit capabilities field in the user's profile is *YES or *PARTIAL, the user cannot specify an initial program on the Sign On display.

The initial program is called only if the user's routing program is QCMD or QCL. See Starting an interactive job for more information about the processing sequence when a user signs on.

Initial programs are used for two main purposes:

To restrict a user to a specific set of functions.
To perform some initial processing, such as opening files or establishing the library list, when the user first signs on.

Parameters cannot be passed to an initial program. If the initial program fails, the user is not able to sign on.

Table 1. Possible values for INLPGM:
*NONE	No program is called when the user signs on. If a menu name is specified on the initial menu (INLMNU) parameter, that menu is displayed.
program-name	The name of the program that is called when the user signs on.

Table 2. Possible values for INLPGM library:
*LIBL	The library list is used to locate the program. If the job description for the user profile has an initial library list, that list is used. If the job description specifies *SYSVAL for the initial library list, the QUSRLIBL system value is used.
*CURLIB	The current library specified in the user profile is used to locate the program. If no current library is specified, QGPL is used.
library-name	The library where the program is located.