IDMSRSTT Macro Statements › IDMSRSTT SETPTR › IDMSRSTT SETPTR Parameter

IDMSRSTT SETPTR Parameter

old-position:

Specifies the position of the pointer in the original record.

*:

Specifies that the pointer is new and it's being added to the owner record.

Note: If a new pointer is being added to the member record, do notspecify old-position or '*'; omit the parameter entirely.

new-position:

Specifies the new position for a new pointer or for a pointer being moved.

If the pointer is being deleted, do not specify a new position.

,set-name:

The name of an existing set for which prior pointers are being added.

Note: Do not use this parameter if owner pointers are being addedto an existing set.

ALL

Specifies that no pointers in the record are being added, deleted, or changed.

Usage

Accounting for all pointers

The IDMSRSTT SETPTR statements you code for a record must account for all the pointers in the record:

• If you are adding, modifying, or deleting any pointers in the record, code one IDMSRSTT SETPTR statement for each pointer in the record.
• If you are not adding, modifying, or deleting any pointers in the record, code a single IDMSRSTT SETPTR=ALL statement.

Calculating pointer positions

The first user pointer position in a record is 1.

Do not count system-maintained pointers (for example, those for the CALC set) when calculating pointer positions.

Order of changes

You can modify pointers in any order and with any sequence of modifications. For example, you can add a new pointer in position 4 before or after deleting an existing pointer in position 2.

Overwriting existing pointers

When you add a new pointer or copy an existing pointer to a position that already contains a pointer, the pointer in the position is overwritten.