Editor Options panel

The editor options control various options used to format the display or print of data when viewing, editing, or printing.

Note: The editor options are displayed on 3 panels ("Editor Options (1 of 3)" through to "Editor Options (3 of 3)").

To navigate from one panel to the next, press F11 (NxtPage) or F10 (PrvPage).

For simplicity, the contents of all 3 panels are shown together in Figure 1.

Panel and field definitions

Figure 1. Editor Options panel
  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 Z Data Tools               Editor Options (all 3 panels combined)

 Related command if applicable, shown in ()
 Initial Display
 1  1. Previous
    2. Table
    3. Single
    4. Character
    5. Hex
    6. LHex

 Miscellaneous:     Enter "/" to select option
 /  Recognize and interpret ISPF packed data
    CAPS initially ON - translate changed data to uppercase (CAPS)

 Maximum virtual storage allowed for Edit and View   0      

 Related command if applicable, shown in ()
 Grouping and Hiding options:     Enter "/" to select option
 Expose (do not group) records of types:            (SHOW)
 /  Not selected  /  Suppressed  /  Length error
 See shadow lines (deselect to hide) for groups of: (SHADOW)
 /  Not selected  /  Suppressed  /  Excluded

 Multi-line display format options:  (TABL/CHAR/HEX/LHEX)
 /  Display prefix area                             (PREFIX on/off)
    Display prefix area on the right                (PREFIX RIGHT)
 A  Prefix area width  (A,6,7,8,9)                  (PREFIX _)
    Display record length                           (RECL on/off)
    Display record length on the right              (RECL RIGHT)
 A  Record length width  (A,3,4,5,6)                (RECL _)
    Display RBA and Length when browsing VSAM       (RBALEN on/off)


 Related command if applicable, shown in ()
 Formatted display options:
 /  Field reference number (REF) /  Field type and length values (TYPE)
    Picture clause         (PIC)    Start location               (SLOC)
    Structure              (STR)    Left justify numeric fields  (JUST)
 /  Redefined fields       (RDF) /  CCSID                       (CCSID)


 Command ===>                                                                  
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F10=PrvPage  F11=NxtPage  F12=Cancel
Initial Display
1. Previous
At the start of an editor session, the display format field (Format) on the View or Edit panel is pre-filled with the value specified in the previous editor session. This is default.
2. Table
At the start of an editor session, the View or Edit panel is displayed in TABL display format.

For data that has not been formatted with a template, the View or Edit panel is displayed in CHAR display format.

3. Single
At the start of an editor session, the View or Edit panel is displayed in SNGL display format.

For data that has not been formatted with a template, the View or Edit panel is displayed in CHAR display format.

4. Character
At the start of an editor session, the View or Edit panel is displayed in CHAR display format.
5. Hex
At the start of an editor session, the View or Edit panel is displayed in HEX display format.
6. LHex
At the start of an editor session, the View or Edit panel is displayed in LHEX display format.
Recognize and interpret ISPF packed data
When this option is selected, Z Data Tools checks the data in the data set or member being edited (or viewed) to determine if it has been written with the ISPF PACK option. If it had, Z Data Tools then unpacks the data to allow it to be edited or viewed in the normal fashion. If the data set is too large to be contained in memory, Z Data Tools cannot edit or view the data set in unpacked form, but instead provides the data set in its packed form. If this option is deselected, Z Data Tools does not check the data and edit or view operates on the record data in its “as is” state.
Note: This option allows you to work with packed data in PDS or PDSE data sets. Z Data Tools does not support working with packed data in VSAM data sets.
CAPS initially ON - translate changed data to uppercase (CAPS)
Translates data entered in input fields into uppercase.
Maximum virtual storage allowed for Edit and View
The maximum number of kilobytes of storage that the editor can use when reading in data. If the initial read of the data would require more storage than this value, other editing techniques (for example, using an auxiliary file, or an inplace edit) are substituted instead.
The amount of storage that the editor uses to hold records is at least
   (Number of records * (112 + record length)) 

To allow edit to use as much storage as is available, set the value to 0.

The default is 0, unless otherwise set in Z Data Tools0POPI during customization. As the editor typically obtains storage in 512KB blocks, if this number is greater than zero, the actual usage may be adjusted to a minimum of 512 or rounded up to the next 512.

Expose (do not group) records of types:
Not selected
Exposes or shows not-selected records. Selecting this option has the same effect as if the SHOW NOT ON command has been entered. If a SHOW command is entered during a Z Data Tools session, it resets this option for the session.
Suppressed
Exposes or shows suppressed records. Selecting this option has the same effect as if the SHOW SUP ON command has been entered. If a SHOW command is entered during a Z Data Tools session, it resets this option for the session.
Length error
If a record matches the record identification criteria for a record type in the template, but the record length is outside the valid range for the record type, then match the record with that type anyway.

If no record identification criteria are defined, and the length of a record does not fall within the valid range of any record type in the template, then match the record with the first record type in the template anyway.

In Edit, display =LGTH in the record prefix area.

If you do not select this option, then records whose length do not match a record type in the template are not selected, even if they match the record identification criteria for a record type.

There is no equivalent primary command for this option.

See shadow lines (deselect to hide) for groups of:
Not selected
Show shadow lines for not-selected records. Equivalent to the SHADOW NOT ON primary command.

For a definition of not-selected records, see Filtering record display using templates.

Suppressed
Show shadow lines for suppressed records. Equivalent to the SHADOW SUP ON primary command.

For a definition of suppressed records, see Filtering record display using templates.

Excluded
(Edit only.) Show shadow lines for excluded records (records that you have excluded from display using the X prefix command or the EXCLUDE primary command). Equivalent to the SHADOW EX ON primary command.
Multi-line display format options: (TABL/CHAR/HEX/LHEX)
Display prefix area
(Edit only.) Display the prefix area. Equivalent to the PREFIX ON or PREFIX OFF primary commands.
Display prefix area on the right
Place the prefix area (if it is displayed; see Display prefix area, above) on the right of the Edit panel. Otherwise, place the prefix area on the left. Equivalent to the PREFIX RIGHT primary command.
Prefix area width (A,6,7,8,9)
Sets the length of the prefix area displayed in the editor session. The prefix length can be from 6 to 9, or you can set it to A to automatically adjust the prefix area length as required in order to display the record numbers (when applicable) for your data set. A is the default value. You can also control the display and positioning of the prefix area with the PREFIX primary command.
Display record length
Turns on the display of record lengths in multiple line formats (TABL,CHAR,HEX,LHEX). If the Display record length on the right option is not selected, displays the record length on the left side of the panel. Enter any character to enable the display, or remove or overtype with a blank to disable. You can also control the display of the record length with the RECLEN primary command.

This option also controls whether the record length is printed when printing TABL and SNGL formatted records.

Display record length on the right
Displays the record length area in the Z Data Tools Edit data display on the right side of the panel. If this option is not selected and Display record length is selected, the record length area is on the left side of the panel. This option is only effective when either the Display record length option is selected, or when you issue the RECLEN ON command during an editor session. You can also control the display and positioning of the record length area with the RECLEN primary command.
Record length width (A,3,4,5,6)
In multiple line formats (TABL,CHAR,HEX,LHEX), sets the width of the record length area displayed in the editor session. You can set the record length width from 3 to 6, or you can set it to A to automatically adjust the record length area width as required in order to display the record lengths for your data set. A is the default value. You can also control the display and positioning of the record length area with the RECLEN primary command.
Display RBA and Length when browsing VSAM
When you browse a VSAM file, the leftmost side of the multiline displays contain the RBA and the length of the record being displayed.

If you deselect this option, Z Data Tools does not display this information, allowing more of the record data to be displayed on each panel.

Formatted display options:
Field reference number (REF)
Changes the session default to show the field reference (for example, #2) next to each field, in SNGL display or print format. In an editor session, this display can also be turned on or off temporarily, by using the REFS command.
Field type and length values (TYPE)
Changes the session default to show the field data type and length next to each field, in SNGL display or print format. In an editor session, this display can also be turned on or off temporarily, by using the TYPE command.
Picture clause (PIC)
Changes the session default to show the Picture clause when in SNGL display or print mode. Also shows the length and scale (if non zero) for binary and packed fields and the bit length for bit fields. In an editor session, this display can also be turned on or off temporarily, by using the PIC command.
Start location (SLOC)
Changes the session default to show the start location of each field, when in SNGL display or print mode. In an editor session, this display can also be turned on or off temporarily, by using the SLOC command.
Structure (STR)
Changes the session default to show the full structure of the template when using SNGL display or print mode. In an editor session, this display can also be turned on or off temporarily, by using the STR command.
Left justify numeric fields (JUST)
Changes the session default to show numeric fields as left justified, when using SNGL display or print mode. In an editor session, this display can also be turned on or off temporarily, by using the JUST command.
Redefined fields (RDF)
Changes the session default to show the redefined information as part of the field name, when in SNGL display or print mode and display or print the redefined fields when in SNGL or TABL display or print mode. In an editor session, this display can also be turned on or off temporarily, by using the RDF command.
CCSID (CCSID)
Change the session default to display the CCSID assigned to each field, if applicable, when in SNGL display or print mode. In an editor session, this display can also be turned on or off temporarily, by using the CCSID command.

Child panels

  • None.

Equivalent functions

  • None.