OA29856: ISPF EDIT HIDE X DOCUMENTATION UNCLEAR

APAR status

• Closed as documentation error.

Error description

• ISPF Edit HIDE X documentation needs improvement
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All ISPF Edit users.                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: EDIT HIDE X command requires            *
  *                      clarification.                          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  ISPF EDIT HIDE X functionality was enhanced in ISPF for z/OS 1.9
  to allow HIDE X to be used in customized Edit panels as well as
  those Edit panels distributed with ISPF (see OA17879). The
  following documentation updates describe the requirements for
  customized Edit panels to be able to exploit this enhanced
  functionality, and to avoid attribute byte conflicts.
  

Problem conclusion

• ISPF EDIT HIDE X (HIDEX) macro and primary command functionality
  at ISPF for z/OS 1.9 and above require the following
  documentation amendments:
  
  --------- Start of documentation changes -----------------------
  
  Edit and Edit Macros                     (SC34-4820-08)
  ----------------------------------------------------------------
  The following statement is added to sections
  3.2.25 HIDEX - Hide Excluded Lines Message
  and replaces the similar statement in section 3.3.36.
  
  The HIDE function has dependencies on the value of the ISPF
  variable ZHIDEX, panel attributes, and extended highlighting
  support of the terminal.  These dependencies are described in
  the section  Providing customized Browse and Edit panels  in the
  ISPF Planning and Customisation Guide.
  
  
  Planning and Customizing                 (GC34-4814-08)
  ----------------------------------------------------------------
  Section 3.8.8.1 Providing a customized Browse and Edit panels
  Paragraph that begins "The HIDE EXCLUDED command uses" is
  replaced by the following:
  
  The HIDE EXCLUDED command uses reserved attribute characters to
  underscore the number field of the line preceding the excluded
  message line.  As some customized Edit panels might already use
  these attribute characters, ISPF uses the dialog variable ZHIDEX
  to determine whether the attribute characters are available and
  correctly defined in the Edit panel. An example of setting
  ZHIDEX and providing the reserved attribute bytes 13, 16, 17,
  and 1D is shown in Figure 67.
  
  If the HIDE command is used in an initial macro, then the macro
  must set the ISPF dialog variable ZHIDEX to a value of Y and the
  Edit panel in use must contain the required attribute character
  definitions as previously described.
  
  Note, even when the HIDE EXCLUDED command is enabled using the
  ZHIDEX variable, the number field of the line preceding the
  excluded message is only underscored on ISPF-supported terminals
  with the extended highlighting feature available.
  
  --------- End of documentation changes -------------------------
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels