Previous Topic: LOCATE StatementNext Topic: When to Use the LOCATE Statement


LOCATE Syntax

             ┌┌                ┐┌                 ┐          ||
│LOCATE name1 ││< LEFT > number ││ < UP   > number |FROM name2||
└             └└ \ RIGHT /      ┘└ \ DOWN /        ┘          ||
 name1

identifies, by REC-NAME, the record block you want to position in the diagram with a LOCATE statement. You cannot position the same record block twice during the same run of CA IDMS Schema Mapper.

 < LEFT  > number
 \ RIGHT /
 number

specifies how many record blocks to the left or right of record name2, the record block identified by name1 is to be positioned. You can use this parameter alone or with an UP or DOWN parameter. The number must be an integer between 1 and 10,000, inclusive.

 < UP   > number
 \ DOWN /
 number

specifies how many record blocks up or down from record name2, the record block identified by name1 is to be positioned. You can enter this parameter alone or with a LEFT or RIGHT parameter. The number must be an integer between 1 and 10,000, inclusive.

 FROM name2
 name2

specifies which record block is to be used as a reference for positioning the record block identified by name1. name2 must be the REC-NAME of a record block that was used as name1 in a previous LOCATE statement.