STARTING Phrase
The STARTING phrase specifies the starting line number for the record formats that use the variable starting line keyword. This phrase is only valid for display devices.
Actual-line = Start-line + DDS Start-line - 1
- Actual-line is the actual line number
- Start-line is the starting line number specified in the program
- DDS Start-line is the line number specified in positions 39 through 41 of the Data Description Specifications form.
- The result of the above equation is positive and less than or equal to the number of lines on the workstation screen.
- The value specified for the STARTING phrase is 0. In this case, a value of 1 is assumed.
- The result of the above equation is greater than the number of lines on the workstation screen.
- The value specified for the STARTING phrase is negative.
If the value specified for the STARTING phrase is within the screen area, any fields outside of the screen area are ignored.
Literal-3 of the STARTING phrase must be a numeric literal. Identifier-4 must be an elementary numeric item.
To use the STARTING phrase, the DDS record level keyword SLNO(*VAR) must be specified for the format being written. If the record format does not specify this keyword, the STARTING phrase is ignored at execution time.
The DDS keyword CLRL also affects the STARTING phrase. CLRL controls how much of the screen is cleared when the WRITE statement is executed.
For further information on SLNO(*VAR) and CLRL, see the DB2® for i section of the Database and File Systems category in the IBM® i Information Center at this Web site - http://www.ibm.com/systems/i/infocenter/.