POSITION

Syntax

POSITION position [@document_marker[COLUMNS{num_lit|_var|_col} [num_lit|_var|_col]...]]

Description

Sets the current position on a page.

Parameters

Parameter	Description
position	A position qualifier consisting of (line, column, width), where column and width are numbers that denote characters and spaces. Line, column, and width are all optional. If line or column is omitted, the print position is set by default to the current position, which is the position following the last printed item. Width is set by default to the width of the text that is being printed. A plus sign or minus sign indicates relative positioning in SQR. A plus sign moves the print position forward from the current position, and a minus sign moves it back.
@document_markerg	References a location defined in a document paragraph . In this case, the position used is the location of that marker in the text of the document.
COLUMNS	Defines columns beginning at the location of the document marker. The columns defined are relative to the position of the document marker. When COLUMNS is used, the entire command cannot be broken across more than one program line.

Parameter

Description

position

A position qualifier consisting of (line, column, width), where column and width are numbers that denote characters and spaces. Line, column, and width are all optional. If line or column is omitted, the print position is set by default to the current position, which is the position following the last printed item. Width is set by default to the width of the text that is being printed. A plus sign or minus sign indicates relative positioning in SQR. A plus sign moves the print position forward from the current position, and a minus sign moves it back.

@document_markerg

References a location defined in a document paragraph . In this case, the position used is the location of that marker in the text of the document.

COLUMNS

Defines columns beginning at the location of the document marker. The columns defined are relative to the position of the document marker.

When COLUMNS is used, the entire command cannot be broken across more than one program line.

Example

The following example shows the POSITION command:

position  (12,5)          ! Set current position to line 12, column 5.
position  (+2,25)         ! Set position 2 lines down, at 25th column.
position  ()  @total_location               ! Set position to document
print #total  ()  edit  999,999,999         ! marker @total_location.
position  ()  @name_loc  columns 1 30
print name  ()            !  Columns are defined at @name_loc and
next-column               !  29 characters to the right of @name_loc
print title ()

See The COLUMNS command for more information