SET POINT

Purpose

Use the POINT option to define a symbolic name for the current line. You can define more than one name for a line by issuing separate SET POINT subcommands. You can use these names to refer to the line in subsequent target operands of XEDIT subcommands.

Operands

.symbol: is a symbolic name for the current line. The name must begin with a period and be followed by 1 - 8 alphanumeric or special characters, for example, .AAA.
OFF: deletes the specified symbol, without moving the line pointer. The symbol to be deleted must be specified before this operand.

Initial Setting

No names are initially defined.

Usage Notes

The POINT option makes it unnecessary for you to remember or to look up the line number of a line. You can reference a line by its name at any time during the editing session. For example, if you enter the following subcommand:
```
set point .XAVIER
```
the current line is assigned the specified name.
You can then reference the name at any time during the editing session. For example:
```
move 3 .XAVIER
```
moves three lines, beginning with the current line, after the line named .XAVIER.
The line number of a line can change during an editing session; for example, adding lines before a particular line increments its line number. The symbolic name, however, stays with a line for the entire editing session.
The .xxxx prefix subcommand can also assign a symbolic name to a line. In this case, the symbolic name is limited to four characters.
You can delete a symbolic name for a line by using .xxxx to assign that name to another line.
You can use the QUERY POINT subcommand to display the symbolic name(s) of the current line. You can use QUERY POINT * to display all symbolic names and their line numbers.

Notes for Macro Writers

The EXTRACT/POINT/ subcommand returns the symbolic name(s) and line number of the current line, and EXTRACT/POINT */ returns the symbolic names and their line numbers in the file.

Examples

For more information, see z/VM: XEDIT User's Guide.

Messages and Return Codes

520E: Invalid operand: operand [RC=5]
539E: Named line not found [RC=2]
540E: Name already defined on line nn [RC=1]
541E: Invalid name [RC=5]
545E: Missing operand(s) [RC=5]

where return codes are:

0: Normal
1: Duplicate name defined
2: Name does not exist for OFF function
5: Invalid or missing operand(s)
6: Subcommand rejected in the profile due to LOAD error, or QUIT subcommand has been issued in a macro called from the last file in the ring