HP System Dictionary/XL SDMAIN Reference Manual (32256-90001)

4- 133
[;S[TART-]POS[ITION] = start-rel-position ]
[;INC[REMENT] = position-increment ]
.
Parameters
parent-entity-name Name of the parent entity of the relationships to be renumbered. For example, if the
type and class of the relationship to be renumbered is FILE contains RECORD, the
parent-entity-name is the name of the FILE.
entity-type-name(N) Name of the entity type involved in the relationship type.
relation-class-name Name of the relationship class.
start-rel-position Therelationship-positionto beassigned tothefirstrelationshipin thelist. Thedefault
is 1000.
position-increment The amount that the relationship-position attribute is incremented for each subse-
quent relationship. The default is 1000.
Description
Renumber allows you to assign values with equal intervals between them to the relationship-position
attribute of relationships. You can do your own renumbering by modifying the relationship-position
attribute value through the MODIFY RELATIONSHIP command. You need to use the RENUMBER
command when you want to create a relationship and have it ordered between two existing relationships
whose relationship-position attribute values are consecutive.
For example, a COBOL program has the following record layout:
01 SALES-DATA.
05 ACCOUNT PIC S9(9) COMP.
05 QUANTITY PIC S9(4) COMP.
05 PURCH-DATE PIC X(6).
To define the record layout, the following relationships of the relationship type RECORD contains
ELEMENT exist in the dictionary: sales-data contains account with byte-offset of 1 and relationship-
position of 1, sales-data contains quantity with byte-offset of 5 and relationship-position of 2, and sales-
data contains purch-date with byte-offset of 7 and relationship-position of 3.
The program changes to have the following record layout:
01 SALES-DATA.
05 ACCOUNT PIC S9(9) COMP.
05 QUANTITY PIC S9(4) COMP.
05 PRICE PIC S9(9) COMP.
05 PURCH-DATE PIC X(6).
To redefine the record layout, you need to modify the relationship sales-data contains purch-date to have a
byte-offset of 11. You also want to create the relationship sales-data contains price and have it ordered
between relationships sales-data contains quantity and sales-data contains purch-date. The relationships
would have to be renumbered since sales-data contains price needs its relationship-position value to be