User-initiated REXX EXECs

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 a 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 of the 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 that you specify to bring online. For example, this termid value could be BS4000. The command would look as follows:

%START BS4000

Example

The following example shows an EXEC that would be scheduled:

User-initiated REXX EXEC example

/* REXX EXEC */
ARG 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 ARG statement of the user-initiated EXEC are shown in the following table:

Positional parameter

Variable name

Variable value

Description of variable value

1

START

START

EXEC name

2

TERMID

BS4000

name of the terminal

3

.

.

period pads the positional parameters

Example description

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

Refer to CMD (Issue IMS command without response) and CMD (Issue MVS command without response) for more information about the IMFEXEC CMD command and MVS commands.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments