Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Language Reference Manual

SKIP format item

The SKIP format item specifies that a new line is to be defined as the current line.

Read syntax diagramSkip visual syntax diagram>>-SKIP--+-----------------+-----------------------------------><
         '-(relative-line)-'
 
relative-line
Specifies an expression, which is evaluated and converted to an integer value, n, each time the format item is used. The converted value must be nonnegative and less than 32,768. It must be greater than zero for non-PRINT files. If it is zero, or if it is omitted, the default is 1.

The new line is the nth line after the present line.

If n is greater than one, one or more lines are ignored on input; on output, one or more blank lines are inserted.

The value n can be zero for PRINT files only, in which case the positioning is at the start of the current line. Characters previously written can be overprinted.

For PRINT files, if the specified relative-line is beyond the limit set by the PAGESIZE option of the OPEN statement (or the default), the ENDPAGE condition is raised.

If the SKIP format item is the first item to be executed after a file has been opened, output commences on the nth line of the first page. If n is zero or 1, it commences on the first line of the first page.

For example:

  get file(In) edit(Man,Overtime)
       (skip(1), A(6), COL(60), F(4,2));

This statement positions the data set associated with file In to a new line. The first 6 characters on the line are assigned to Man, and the 4 characters beginning at character position 60 are assigned to Overtime.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)