INCLUDE
COBOL | PL/I | Assembler | C Language |
Description
The INCLUDE command executes a predefined test script member. The command stream in the test script is executed as the commands are read in, just as if they had been entered serially. INCLUDE test scripts can be nested without limit.
A record of the command is written to the session log.
Input
The following is the parameter description for the INCLUDE command:
test-script-name
A member of the test script library (LRECL=80) specified in the XINCLUDE DD Setup screen, or the site-wide PDS, if defined.
Usage Notes
ALL Languages |
- Within the script:
- A Code Debug TSO command cannot exceed 61 characters.
- Only one Code Debug TSO command can occur on a single line.
- Any Code Debug TSO command can be continued beyond a single line without the requirement of a continuation character.
- A quoted string must be contained on one line.
- Comment lines can be included by entering an asterisk (*) in column 1.
- When used within inserted code, the INCLUDE command will be executed when the inserted code is executed.
Example
ALL Languages |
The following is an example of commands entered in a test script member named TEST1:
KEEP INREC
GPREGS
MOVE '345' TO INRECTo execute TEST1 during your debugging session, enter:
INCLUDE TEST1
Valid Commands in a Test Script
The following tables list the commands that can or cannot be included in a test script for each language. Command usage follows the rules described in each command section.
COBOL |
The following commands can be included in a test script.
ACCEPT EXCLUDE INCLUDE MONITOR SET WS
AFTER EXIT IF MOVE SHOW
AT GEN INSERT ONETIME SKIP
BEFORE GO INTERCEPT PAUSE SOURCE
BROWSE GOBACK KEEP PEEK TRACE
COUNT GOTO LINE PSEUDOSOURCE USE
The following commands cannot be included within a test script.
BOTTOM DRIGHT LOCATE REVERSE TSO
CCHILITE END LOG RIGHT UP
CONNECT FADB2 MEMORY RUN WHEREIS
DLEFT FIND NOLINES STATUS XCHANGE
DLI HELP RESUME TEST XPED
Assembler |
The following commands can be included in a test script:
AFTER EXCLUDE IF MOVE SET WHEN
AT EXIT INCLUDE ONETIME SHOW
BEFORE GEN INSERT PAUSE SKIP
BROWSE GETMAIN INTERCEPT PEEK SOURCE
COUNT GO KEEP PSEUDOSOURCE TRACE
DELETE GOTO LINE RESET USING
The following commands cannot be included within a test script:
BOTTOM DRIGHT LOCATE RUN WHEREIS
CCHILITE END LOG STATUS XCHANGE
CONNECT FADB2 MEMORY TEST XPED
DLEFT FIND NOLINES TOP
DLI HELP RETEST TSO
PL/I | C Language |
The following commands can be included in a test script:
AFTER EXCLUDE INTERCEPT PAUSE SHOW
AT EXIT KEEP PEEK SKIP
BEFORE GO LINE PSEUDOSOURCE SOURCE
BROWSE GOTO LOAD RESET TRACE
COUNT GPREGS MOVE RETURN WHEN
The following commands cannot be included within a test script:
BOTTOM DRIGHT LOCATE RUN WHEREIS
CCHILITE END LOG STATUS XCHANGE
CONNECT FADB2 MEMORY TEST XPED
DLEFT FIND NOLINES TOP
DLI HELP RETEST TSO