User-initiated CLISTs

A user-initiated EXEC (also known as a command-initiated EXEC) is scheduled when a user enters the EXEC name from the BBI terminal session (TS) command line with the command prefix of % or ¢.

You also can schedule user-initiated EXEC by issuing a MVS MODIFY command against a BBI PAS subsystem (BBI-SS PAS); for example

F SYSB,%EXECB

Finally, you also can use the MainView AutoOPERATOR EXEC Manager application to issue a user-initiated EXEC. Refer to the MainView AutoOPERATOR Basic Automation Guide, Volume 1: Using Rules for more information.

Potential use

Use user-initiated EXECs when you want to schedule an EXEC from a TS or an MVS console.

The example in this section shows how to schedule an EXEC named START for execution. This EXEC is used to vary a VTAM node online.

Parameters passed to the EXEC

The first positional parameter is the one- to eight-character EXEC name (in this case, START).

Any following positional parameters are optional.

Example of Input

To use the EXEC named START, enter the following command on any TS command line:

%START termid

where termid is the name of the VTAM node you specify to bring online. For example, this termid value could be BS4000. The command would look like

%START BS4000

Example

Example shows an example of an EXEC that would be scheduled:

Figure 1. User-Initiated CLIST example

PROC 2 START TERMID
/*********************************************************************/
/* DOC GROUP(MVS) FUNC(VTAM) CODE(VT)                                */
/* DOC DISP(YES) AUTHOR(B&B)                                         */
/* DOC DESC(ACTIVATE THE NODE)                                       */
/*-------------------------------------------------------------------*/
IMFEXEC CMD #VARY NET,ACT,ID=&TERMID
EXIT

The positional parameters passed to the PROC statement of the user-initiated EXEC are shown in the following table:

Positional Parameter	Variable name	Value passed	Description of value passed
1	START	START	is the EXEC name
2	TERMID	BS4000	is the name of the terminal

Describing the example

In this example, the IMFEXEC CMD statement is used to issue a VTAM command to vary a terminal online.

Refer toCMD for more information about the IMFEXEC CMD command and MVS commands.