|
Operand |
Description |
|---|---|
|
/ |
The character that delimits the search string. You must use the same character consistently in a command. You can use any special character except the currently defined command delimiter (installed default is a semicolon (;)) or comment character (installed default is a colon (:)), an asterisk (*), an at sign (@), a pound sign (#), or a dollar sign ($). |
|
string |
Character or string of characters to find. If you do not specify a string, the string specified on the previous FIND, INCLUDE, EXCLUDE, FIRST, NEXT, PREVIOUS, or LAST command is used as a default value. The string cannot include the string delimiter character or the current command delimiter. |
ERROR (Procedure definition only.) Locates a line that the compiler marked as an error (using the MEL=YES operand of the COMPILE command and SET EDIT HIGHLIGHT ERRORS). You cannot specify column ranges.
start‑line Line where the search for string begins. You can specify it as:
num Sequence number of the start line. When you specify a single line with a sequence number, the keyword LINE is required.
TOP Indicates the first line of the member. If you do not specify a start line, TOP is the default.
CURSOR Indicates the position where the cursor is located.
offset Position relative to the top line displayed:
* Top line displayed.
*+n Line n number of lines below the top line displayed.
*‑n Line n number of lines before the top line displayed.
end‑line Line where the search for string ends. You can specify it as:
BOTTOM Default. The last line of the member.
num Sequence number.
CURSOR Indicates the position where the cursor is located.
offset Position relative to the top line displayed:
* Top line displayed.
*+n Line n number of lines below the top line displayed.
*‑n Line n number of lines before the top line displayed.
start‑column Column where the search for the string begins.
end‑column Column where the search for the string ends.
MAX Default. Farthest right‑hand column.
The INCLUDE command applies to the components listed next. Default column boundaries for each component are also shown.
|
|
Column Edited |
Column Boundaries |
|---|---|---|
|
Member |
Data area |
1‑72 |
|
Report |
|
|
|
Detail |
Field name |
1‑25 |
|
Heading |
Field name |
1‑56 |
|
Column |
Field name |
1‑25 |
|
Program |
|
|
|
Procedure |
Data area |
1‑72 |
|
Parameter |
Field name |
1‑19 |
|
Working data |
Field name |
1‑19 |
|
Dataview |
|
|
|
Field |
Field name |
1‑19 |
|
Key (VSAM) |
Field name |
1‑32 |
|
Plan |
|
|
|
DBRM |
DBRM |
1‑8 |
|
Resource |
Program name |
1‑8 |
Specifying lines or columns is optional. You can specify line and column clauses in either order. For example,
INCL /DISPANEL/ LINES 16500 17500 COLUMNS 10 40
or,
INCL /DISPANEL/ COLUMNS 10 40 LINES 16500 17500
Example
In the following example, INCLUDE searches for the string NUMBER, from the cursor position (line 300) through the last line of the member.
=> INCL /NUMBER/ CURSOR BOTTOM ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+.... IDEAL: PROCEDURE DEFINITION PGM CRTEST (001) TEST SYS: $ID FILL-IN Command....+....1....+....2....+....3....+....4....+....5....+....6....+....7.. ====== ================================ T O P ================================= 000100 FOR EACH EMPLOYEE 000200 WHERE STATE_ADDRESS = 'CA' OR 'IL' 000300_ AND NUMBER > 125 AND < 150 000400 FOR PAYROLL 000500 WHERE NUMBER = EMPLOYEE.NUMBER 000600 AND NUMBER > 100 AND < 150 000700 SET SALARY = YTD_WAGES + YTD_COMMISSION - YTD_TAX 000800 SET STATE1 = 'CA' 000900 SET STATE2 = 'IL' 001000 PRODUCE CARM1 001100 ENDFOR 001200 ENDFOR 001300 FOR EACH EMPLOYEE 001400 ORDERED BY STATE_ADDRESS CITY_ADDRESS EMPLOYEE.NAME 001500 WHERE STATE_ADDRESS = 'CA' OR 'IL' 001600 AND NUMBER > 125 AND < 150
INCLUDE displays all lines in this range containing the string.
=>
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+.... IDEAL: PROCEDURE DEFINITION PGM CRTEST (001) TEST SYS: $ID FILL-IN INCL /NUMBER/ Command....+....1....+....2....+....3....+....4....+....5....+....6....+....7.. 000300 AND NUMBER > 125 AND < 150 000500 WHERE NUMBER = EMPLOYEE.NUMBER 000600 AND NUMBER > 100 AND < 150 001600 AND NUMBER > 125 AND < 150
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|