Previous Topic: CA IDMS DMLO CommandsNext Topic: EDIT Command

Commands › CA IDMS DMLO Commands › DISPLAY Command

DISPLAY Command

 DISplay ┌ ┌ / record-name    \ ┐  ┌ / CONTINUE \ ┐ ┐
         │ │ < SUBSCHEMA-CTRL > │  │ │ HEX      │ │ │
         │ └ \ SSCTRL         / ┘  │ < NATive   > │ │
         │                         │ │ DUMP     │ │ │
         └                         └ \ NODUMP   / ┘ ┘

 DISplay field-name ┌ / OF     \  record-name ┐ ┌ / HEX    \ ┐
                    │ < WIthin >              │ │ │ NATive > │
                    │ │ IN     │              │ │ │ DUMP   │ │
                    └ \ NODUMP /              ┘ └ \        / ┘

The DISPLAY command displays a record, group, element within a record, or field. Each record has an I/O buffer that can be displayed independently of any CA IDMS DML command.

You can display a record or field in hex or native, or use the DUMP option to display a record or field in side-by-side hex and character formats. The DUMP option overrides, but does not replace, the current HEX/NATIVE setting for the specified record or field. The NODUMP option causes the display option to revert to HEX or NATIVE, whichever was active when DUMP was specified.

When using the DUMP display option, you can make updates in either format at the same time. Data changes are processed left-to-right as follows:

  1. Any changed hex data is applied to the record/field buffer.
  2. Any character data which differs from the original buffer contents is applied to the record/field buffer.
  3. The changed line is completely reformatted.

A group or element can be displayed to initialize a key field prior to obtaining a calc, indexed, or sorted record. CA IDMS DMLO assigns a unique number to each FILLER field (e.g., FILLER#004). The optional 'WITHIN record-name' clause can be used to request a non-unique element or group name. The DISPLAY command can also display the current contents of the Subschema-Control block. DISPLAY record-name CONTINUE allows you to begin formatting at the point in the record where storage was exhausted.

DISPLAY Command Rules
  1. Group and element names cannot be subscripted.
  2. A record display may exhaust available CA IDMS DMLO display storage before all fields (or occurrences) are formatted. A warning message is issued to inform you of this condition. DISPLAY CONTINUE allows you to begin formatting at the point in the record where storage was exhausted.
  3. CONTINUE may only be requested for the most recently OBTAINed or DISPLAYed record.
  4. If neither field-name nor record-name is specified, the most recently displayed record will be redisplayed according to and format parameter specified.