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
Subsystem
The subsystem ID you specified on the Edit or Browse Entry panel.
Database
The name specified on the DBD statement in the DBDGEN for the database.
Segment
The name of the segment selected from the previous panel and the segment description if available.
Data area
Lvl
The level of the segment type in the database.
Segment
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.
Type
The data type of the field:
AN
Alphanumeric
AX
Alphanumeric displayed in long hexadecimal.
BI
Binary
BT
Bit string decimal (external decimal)
FP
Floating point (internal or external)
PD
Packed decimal (internal decimal)
VB
Varying-length (VARYING) bit string
VC
Varying-length (VARYING) character string
VG
Varying-length (VARYING) graphic string
ZC
Null-terminated varying-length (VARYINGZ) character string
ZD
Zoned decimal (external decimal)
ZE
Zoned decimal edited
ZG
Null-terminated varying-length (VARYINGZ) graphic string
U
Unformatted

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

RO
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.
UQ
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