REPEAT primary command (Edit only)

The REPEAT primary command inserts a single segment occurrence or an entire substructure into the database.

Syntax


1 REPeat ?ALL

Use the REPEAT command with no parameter to insert a single occurrence of the current segment type into the database.

Use the REPEAT ALL command to insert an occurrence of the current segment type into the database and to duplicate all of the dependent segments of the current segment under this new occurrence.

When the REPEAT or REPEAT ALL command is issued, and an insert of the current segment type is permitted, FM/IMS displays either the Insert Root Segment panel (if the current segment is a root segment) or the Insert Segment panel (if the current segment is not a root segment).

On the Insert Segment panel, the Key value fields in the Parent Keys area are displayed with the keys of the parents of the current segment.

On the Insert Segment panel and the Insert Root Segment panel, the key and data of the current segment are displayed in the Data area.

Update the key and data fields with the values required for the segment you want to insert, then press the Exit function key (F3). FM/IMS:
  • Calls IMS to insert the specified segment occurrence
  • If it is a REPEAT ALL, duplicates all of the dependents of the current segment under the new occurrence
  • Returns to the IMS Data panel, redisplaying the page that was previously displayed

To return to the IMS Data panel without inserting any segment occurrences, press the Cancel key (F12).

You cannot insert a segment when:
  • The PCB being used to edit the database does not have the necessary processing option to insert the segment, or
  • The PCB being used to edit the database uses a secondary index and the segment is either the target of the secondary index or a parent of the target segment, or
  • The segment is a concatenated segment that does not have data sensitivity for both the logical child and the destination parent, or
  • The insert may result in a duplicate segment in a unique secondary index and a duplicate segment would cause a U0828 abend.

If any of the above conditions hold true for the current segment type, the REPEAT command issues a diagnostic and does not display the Insert Root Segment panel or the Insert Segment panel.

Availability

Related tasks and examples