Invoking ICQAMLI0

Invoke ICQAMLI0 from your application program using either ISPEXEC SELECT or ISPSTART. To invoke ICQAMLI0 using ISPEXEC SELECT, a valid ISPF environment must exist. Otherwise, you must use ISPSTART. For information on ISPEXEC SELECT and ISPSTART, see z/OS ISPF User's Guide Vol Iand z/OS ISPF User's Guide Vol II.

The syntax of ICQAMLI0 and a description of each operand follows:

ISPEXEC SELECT
   CMD(ICQAMLI0

      [APPLNAME(application-name) ]
      [KEYWORD(keyword)           ]

       [INIT(init-command)]

       [NEXTOPT(option)]

       [TUTORIAL]

       [NOERRPAN]

       [PARM(parameters)] )

   NEWAPPL(application-id)

   PASSLIB

APPLNAME

specifies the name of the application to be invoked. The maximum length of the name is 12 characters. The first character must be alphabetic and the remaining characters must be alphanumeric or the special characters $, #, @.

KEYWORD

specifies the keyword that identifies the application to be invoked. If more than one application matches the specified keyword, ICQAMLI0 displays a selection panel to the user, who can then choose the application to be invoked.

INIT

specifies a command string used to invoke an initialization routine. You can use INIT instead of, or in addition to, defining a start-up routine. Use INIT for initialization that is required only under special circumstances, such as the first time an application is invoked. The routine specified by INIT is executed before the start-up routine specified in the application definition.

The command string specified by INIT must be a quoted string with a maximum length of 256 bytes. Its format must be suitable for use with an ISPEXEC SELECT statement.

NEXTOPT

specifies the next option for fast path processing. The maximum length of the string is 80 characters. This string is passed to the dynamic panel display or the application function to support fast path processing. The default is blanks.

TUTORIAL

specifies that the tutorial (if one exists) for the application is to be invoked instead of the application itself.

NOERRPAN

specifies that error messages and panels should not be displayed for error conditions other than a severe error (return code 20). If ICQAMLI0 issues a return code of 20, an error message and an error panel are displayed, regardless of whether NOERRPAN is specified.

The default is to display an error message and panel whenever ICQAMLI0 encounters a error.

PARM

specifies a list of invocation parameters to be passed to the application. The maximum length of this string is 256 bytes. The default is null.

Note: PARM must be the last operand specified.

NEWAPPL

specifies a 1- to 4-character code for the application being invoked. The application ID can be one of the following:

The ISPF application ID assigned by the Information Center Facility administrator to the application being invoked.
The application ID of the application that is currently in effect. Use the same application ID as the current application because the setting of PF keys and variables common to ISPF and PDF are not copied from one profile pool to another. To retrieve the current application ID, examine the ISPF shared pool variable ZAPPLID.
ICQ, the application ID for the Information Center Facility.

For information on ISPF application IDs, see z/OS ISPF User's Guide Vol I and z/OS ISPF User's Guide Vol II.

PASSLIB

specifies that the current set of application-level ISPF libraries, if any exist, are to be used by the application being invoked. You should specify PASSLIB to insure that any library allocated using the ISPF LIBDEF service is available to the application being invoked.