Key Specification panel

The Key Specification panel provides an alternative to the Database Positioning panel for specifying the position in the database at which you want to start editing.

This panel is displayed when:
  • You enter K in the Cmd field of a segment type on the Database Positioning panel.
  • You enter K in the Cmd field of a segment occurrence on the IMS data panel.
  • You enter the KEY primary command on the IMS data panel.

You use this panel to specify the key of the segment type you have implicitly or explicitly selected.

Enter a key field value and relational operator to specify the starting point for a Database Browse or Database Edit.

Panel and field definitions

Figure 1. Key Specification panel
 Process   Options   Help
FM/IMS                   Edit : Key Specification

Subsystem IF52  Database DJ1E
Segment  LINKSUB

Lvl Segment   Key field name          Type  RO  Key value
 1  SHIRE                                   =
    #2        2 SHIRE-KEY              AN
    #3         3 SHIRE-NAME            AN       BROOME
 2  LINKSUB                                 =
    #1        1 SHIRE-SUBURB           AN
    #2         2 SHIRE-SUB-KEY         AN
              **** End of data ****

Command ===>                                                        Scroll PAGE 
  F1=Help      F2=Split     F3=Exit      F4=CRetriev  F7=Backward  F8=Forward
  F9=Swap     F10=Actions  F12=Cancel
Panel heading
The subsystem ID you specified on the Edit or Browse Entry panel.
The name specified on the DBD statement in the DBDGEN for the database.
The name of the segment selected from the previous panel and the segment description if available.
Data area
The level of the segment type in the database.
The name of the segments in the path down to the selected segment. This column also includes reference numbers for the key fields in each segment.
Key field name
The name of the key field if you are using a view and FM/IMS can match a layout to the key field. Otherwise, the database field name is displayed.
The data type of the field:
Alphanumeric displayed in long hexadecimal.
Bit string decimal (external decimal)
Floating point (internal or external)
Packed decimal (internal decimal)
Varying-length (VARYING) bit string
Varying-length (VARYING) character string
Varying-length (VARYING) graphic string
Null-terminated varying-length (VARYINGZ) character string
Zoned decimal (external decimal)
Zoned decimal edited
Null-terminated varying-length (VARYINGZ) graphic string

The field type is unformatted if you are not using a view or if FM/IMS cannot match a layout to key fields.

The relational operator. Possible values are:
> or GT
Greater than.
>=, => or GE
Greater than or equal to.
= or EQ
Equal to.
< or LT
Less than.
<=, => or LE
Less than or equal to.
¬=,or NE
Not equal to.
FM/IMS uses an unqualified SSA at this level (if the Key value field does contain a value, it is ignored).
Key value
You enter the value of the key field. FM/IMS starts the display from the first segment occurrence that matches the expression formed by the relational operator and the key value.
Note: The function used from this panel is Get Unique. As such, accessing a (P)HDAM database with a relational operator of '>' or '<' may not always give the expected result."

Parent panels

Child panels