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:
Finally, you also can use the EXEC Manager application to issue a user-initiated EXEC. See Managing-EXECs-by-using-the-EXEC-Management-application.
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:
where termID is the name of the VTAM node that you specify to bring online. In the following example, the termID value is BS4000:
Example
The following example shows an EXEC that would be scheduled:
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.
See CMD-Issue-IMS-command-without-response and CMD-Issue-MVS-command-without-response for more information about the IMFEXEC CMD command and MVS commands.