@ (position)

<< Click to Display Table of Contents >>

Navigation:  Reference > Commands >

@ (position)

The form of the position command is:

@position,

This represents a position (label) within the CL script. It is specified as a name of 1-8 alphanumeric characters. When a position is referred to, its name should always be preceded by @.

The name may be any string of characters. Names may be the same as variable names or table names if desired.

Only the name FINISH is reserved, to mean the FINISH of the present stage. Note that you do not precede the FINISH command with @.

Any positions to which you refer must be defined in the present stage. In a Data or Manip Stage the definition may occur before or after the reference. But in Tables Stages, the definition must follow the reference, never precede it. Any backward references in a Data or Manip Stage will be flagged as a warning by CL unless F=NWBJ.

The position command is not executable. As its name implies, it defines a position or a label in the code which can be referenced in other commands, usually GO TO commands.

Position commands are command labels and have no other significance; the name has been chosen since "labels" have another meaning in CL.

A position command may not appear:

In a block IF construction (between IF ... THEN and ENDIF)

Immediately following a simple IF command.

Before the START command.

There is no limit to the number of positions in a CL script.

Examples of position commands:

@101,

@blazes,

@p[i][j],

Example of position command usage:

ul $jim/1, goto @notjim,

d $jimplus=$121/1-7,

d $jimplus2=$122/1-9,

@notjim,