Customizing the z/OS UNIX directory list panel

Dialog developers can also provide a customized z/OS® UNIX directory list display panel for their dialogs. The name of the customized directory list display panel is passed as a parameter to the DIRLIST service.

A customized directory list panel must be modeled after the DIRLIST default directory list panel, ISRUUDL0.

Note: Panel ISRUUDL0 is shipped as both source code (written in Dialog Tag Language, or DTL) and as generated output. If you use this panel as a model for creating your own customized panel, you have the option of modifying a copy of the DTL source code and using this to generate the customized panel. The DTL source code can be found in one of the SISPGxxx libraries, where xxx is the designator for a specified language.

The customized panel must include a Command field named ZCMD and a dynamic area named ZDATA which is used to display the column headings. ISPF uses the TBDISPL service to display the directory list and dynamically builds a model line in the value of variable ZULMODL. Therefore, the customized panel must specify variable ZULMODL as a variable model line. The panel is designed to use the available screen width and both the model line and column heading line are required to expand for the width of the screen. ISPF dynamically builds a list of ZVARs for the panel in the value of variable ZULZVARS.

For information on variable model lines refer to the description of the TBDISPL service in the ISPF Services Guide, and the section titled "Requirements for Model Section" in the ISPF Dialog Developer's Guide and Reference.