Insert Segment panel

In an Edit session, FM/IMS displays the Insert Segment panel when you enter one of the following commands on the IMS Data panel:
  • The REPEAT primary command, and the current segment is not a root segment.
  • The INSERT primary command, and a nonroot segment is either specified in the INSERT primary command or selected on the Insert : Segment Selection panel.
  • The I, R, or RA line command against a nonroot segment.
You use this panel to:
  • Insert a nonroot segment (if it is invoked by the REPEAT or INSERT primary commands, or the I or R line commands).
  • Insert a nonroot segment and then duplicate all the dependent segments of the current segment under this new occurrence (if it is invoked by the REPEAT ALL primary command).
  • Insert a nonroot segment and then duplicate, under this new occurrence, all the dependent segments of the segment against which the line command was issued (if it is invoked by the RA line command).

Panel and field definitions

Figure 1. Insert Segment panel
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
FM/IMS                          Insert Segment
Database DJ2E     Segment  LETRBOX                          Insert Format SNGL
-------------------------------------------------------------------------------
Parent Keys                                                    Line  1  of  2
Lvl  Segment  Key field name          Type  Key value                    Occur
 1  SUBURB
    #2        2 SUBURB-NAME            AN   EAST PERTH




-------------------------------------------------------------------------------
Data                                                    Top Field is 1    of 4
Ref Field                  Typ  Len   Data
  1 1 LETTER-BOX           AN    34
  2  2 LETTER-BOX-KEY      AN     4 K
  3   3 POST-CODE          AN     4 K     
  4  2 LOCATION            AN    30                                 
***  End of record  ***


Command ===>                                                      Scroll CSR 
 F1=HELP      F3=Exit      F4=CRetriev  F5=RFind     F6=RChange  F7=Up
 F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel

The panel has three areas: a Header area, a Parent Keys area, and a Data area.

Header area
These details are displayed in the Header area:
Database
The name of the database you are editing.
Segment
The name of the segment type you are inserting, followed by the segment description (when available). The setting of this field depends on the command used to invoke this panel.
Insert Format
The display format for the Parent Keys area and Data area.

FM/IMS supports four display formats: CHAR, HEX, LHEX, and SNGL. SNGL is only supported when you are using a view.

The Insert Format used when the panel is first displayed depends on the current display format of the IMS Data panel.

When the current display format is CHAR, HEX, LHEX or SNGL, the Insert Format is set to the current display format.

When the current display format is TABL, the Insert Format is set to SNGL.

To change the display format of the Parent Keys area and Data area, update this field.
Note: The LHEX display format for the Parent Keys area is not currently supported. When you specify LHEX for Insert Format, FM/IMS displays the Parent Keys area in HEX display format.
Parent Keys area
In the Parent Keys area, you specify the parent segments of the segment you are inserting. The display format of this area depends on the value specified in the Insert Format field.

This is a scrollable area. To scroll it, place the cursor in the data portion of the area (below the column headers) and issue the UP (F7) or DOWN (F8) commands.

For each segment, type in the path to the segment that you are inserting. The following details are displayed:
Lvl
The hierarchical level of the segment type in the database.
Segment
The name of the segment type.
Key field name
When you are using the SNGL insert format and there is a layout that matches the key field of the segment type, the names of the fields in the segment layout that match the key field are displayed. If the key field is divided into several fields in the template, each subfield is displayed to form the whole key.

When you are not using the SNGL insert format or FM/IMS cannot find a layout to match the key field, the key field name specified in the DBD is displayed. Each key then only has one field associated with it.

Type
The data type of the key field. This can be:
AN
Alphanumeric (includes alphabetic and group items)
AX
Alphanumeric displayed in long hexadecimal.
BI
Binary
BT
Bit
DB
DBCS (PL/I)
FE
Floating point (external)
FP
Floating point (internal)
G
DBCS (COBOL)
PD
Packed decimal (internal decimal)
VB
Varying bit
VC
Varying character
VD
Varying DBCS (PL/I)
VG
Varying DBCS (COBOL)
ZA
Zoned Alphanumeric (COBOL & PL/I external edited) Edited picture definitions that do not fit the ZE definition
ZC
Z Character
ZD
Zoned Decimal (external decimal)
ZE
Zoned Edited (COBOL & PL/I external edited) Supports picture edit characters + - . V 9
ZG
Varying DBCS null terminated (COBOL)
Z2
Varying DBCS null terminated (PL/I)
U
Unformatted. The data type is unformatted when you are not using insert format SNGL, or when FM/IMS cannot find a layout that matches the key field of the segment type.

Use the following fields to specify the position in the database at which the segment is to be inserted. For each segment type in the path to the segment that you are inserting, you specify:

Key value
The key value of the segment. If the segment has no key, 'No key' is displayed and the field is protected.
Occur
The occurrence number of the segment. This field is only present when the segment type has a non-unique key or no key.
Data area
In the Data area, you specify the key and the data of the segment you are inserting. The display format of this area depends on the value specified in the Insert Format field.

This is a scrollable area. To scroll it, issue the UP (F7) or DOWN (F8) commands with the cursor outside the data portion of the Parent Keys area.

The key and the data that is initially displayed in this area depends on the command used to invoke this panel:

  • When the REPEAT primary command is used, the key and data of the current segment is displayed.
  • When the R or RA line command is used, the key and data of the segment that the line command is entered against is displayed.
  • When the INSERT primary command or the I line command is used, the initial display depends on whether or not you are using a view:
    • When you are not using a view, the key and the data is initialized to spaces.
    • When you are using a view, FM/IMS uses a segment layout when initializing the area. Numeric fields in the layout are set to zero and nonnumeric fields are set to spaces.

    For the I line command, FM/IMS uses the layout of the segment occurrence that the line command is entered against.

    For the INSERT primary command, FM/IMS uses the layout of the selected segment type or, if the segment type has multiple layouts, the selected segment layout.

When you have specified the parent segments of the segment you are inserting in the Parent Keys area and the key and data of the segment in the Data area, press the Exit function key (F3) to insert the segment and return to the IMS Data panel.

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

Parent panels

Child panels

  • None.