Skip to content

Working with Long Fields

Component names in USS file systems can be 256 characters long, and path names can be 1024 characters long.

In the ChangeMan ZMF ISPF interface, there are three ways users can see a long component or path name on a panel whose total width is limited to 80 characters.

  • Scroll in the panel field

  • Zoom in on the field with EXPAND

  • Display an alternate panel

    In this section, example package ACTP000052 contains these components:

Staging Library (Path) Name Component Name
/cmntp/s6/ACTP/#000052/d/JVS hellow.java
/cmntp/s6/ACTP/#000052/d/JCT hellow.jct
/cmntp/s6/ACTP/#000052/d/JVS org/dom/xpath/jhfhth30long.java
/cmntp/s6/ACTP/#000052/d/JTH org/jdom/xpath/jhfhth30long.jth
/cmntp/s6/ACTP/#000052/d/JTH testfile.jth

Important

In USS file systems, a "component name" may include a partial directory path because the actual name of the file is unique only within a hierarchy that includes it.

When line command S2 is entered by package JZFS000004 on the Change Package List

panel, the STAGE: package COMPONENTS panel is displayed in this format.

CMNSTG01     STAGE: ACTP000052 Components        Row 1 to 5 of 5
Command ===>___________________________________ Scroll ===> CSR
    Name              + Type Status Changed       Procname User Request
____hellow.java         JVS ACTIVE 20150305 145828 CMNJAVA USER016
____hellow.jct          JCT ACTIVE 20150309 184115 CMNJAR  USER016
____org/dom/xpath/jhfh  JVS ACTIVE 20150309 200446 CMNJAVA USER016
____org/jdom/xpath/jhf  JTH ACTIVE 20150309 192827         USER016
____testfile.hth        JTH ACTIVE 20150309 192103         USER016

*********************** Bottom of data *****************************

When a data field is longer than the panel field used to display it, a + (plus) is shown to the right of the panel field. If the panel field is in a list, the + is shown over the panel field column, as shown in the example above.

Notice that the full names of the first two and last components fit in the Name field. However, the names of the third and fourth components appear to overflow the Name field.

Scrolling LEFT and RIGHT

To see more of a long name that is truncated by a short panel field, you can scroll to the right, and then scroll back to the left.

  • To scroll to the right in a field, place your cursor in the field and press PF11. (You can also type RIGHT in the Command line, place your cursor in the field, and press ENTER.)

  • To scroll to the left in a field, place your cursor in the field and press PF10. (You can also type LEFT in the Command line, place your cursor in the field, and press ENTER.)

This panel shows the Name field after scrolling right one time.

CMNSTG01    STAGE: ACTP000052 Components        Row 1 to 5 of 5
Command ===>__________________________________ Scroll ===> CSR

Name        -+  Type Status   Changed          Procname User  Request
__              JVS ACTIVE   20150305 145828  CMNJAVA  USER016
__              JCT ACTIVE   20150309 184115  CMNJAR   USER016
fhth30long.java JVS ACTIVE   20150309 200446  CMNJAVA  USER016
hfhth30long.jth JTH ACTIVE   20150309 192827           USER016
                JTH ACTIVE   20150309 192103           USER016

*********************** Bottom of data*****************************

Rules for scrolling in long panel fields:

  • The SCROLL amount at the upper right of the panel determines the scroll amount for long panel fields.

  • You might have to scroll right more than once to see the end of a long field.

  • When you have scrolled to right end of a long field, a - (minus) replaces the + (plus) to indicate that you can only scroll left from that point

  • Both -+ (minus plus) are displayed when you can scroll both right and left from your current position in a long field.

  • If you type M (MAXIMUM) on the Command line before you position your cursor in a long field, when you press PF11 or PF10 the field scrolls all the way to the end or the beginning respectively.

Long Field Zoom - EXPAND

Rather than pressing PF11 or PF10 multiple times to scroll through a long field, you can zoom in on the field by placing your cursor over the field and pressing PF4 to execute the ISPF EXPAND command. EXPAND displays the entire field in a pop-up panel.

If you place the cursor on the NAME field of the fourth component listed on the STAGE: package COMPONENTS (CMNSTG01) panel above and you press PF4, the pop-up (ISPEXPND) panel is displayed.

+----------------------------- CMPNAME+0 -----------------------------+
| ISPEXPND                                        Line 1 of 4         |   
| Command ===> _______________________________    Scroll ===> CSR     |
| org/jdom/xpath/jhfhth30long.jth                                     |
|                                                                     |
|                                                                     |
|                                                                     |
|                                                                     |
+---------------------------------------------------------------------+

Zoom panel rules:

  • The pop-up panel has the same attributes as the original panel field. If the original panel field is display-only, then the pop-up panel is also display-only. If the original panel field is available for input, you can type on the pop-up panel.

  • If the original panel field is available for input, you can type up to 256 characters on multiple pop-up panel lines for a component name, or 1024 characters on multiple lines for a path name.

  • Press PF3 to exit the pop-up long name panel and return to the original panel.

Note

Most ZMF panels in the ISPF interface follow this rule: "Press ENTER to Process; Enter END or CANCEL command to exit." However, the pop-up panel for expanded long name fields requires END or PF3 to save data entered or changed on the panel.

Clearing Long Names From Panel Input Fields

If a long name extends beyond the visible end of an input field on a ChangeMan ZMF panel, you must take care to:

  • Clear the entire long name before pressing ENTER to display a selection list.

  • Clear any parts of the old name that extend beyond a shorter name that you type over the original name.

If you only clear the visible part of a long name input field, the rest of the name remains in the ISPF variable, and it will interfere with the processing of subsequence input until you exit the panel. (This is an ISPF behavior, not a ZMF shortcoming.)

Tips

The quickest way to ensure that you have cleared a long name input field is to press PF4 to display the entire long name in a pop-up panel, erase all lines that contain parts of the long name, and press PF3 to return to the original panel.

Alternate Panel - LONG and XLONG

In many ChangeMan ZMF functions that display a list of components, you can invoke an alternate panel that displays the component name on a separate line so there is room to show more characters of a long component name.

For example, if you specify an zFS library type in a package, then Stage Package Components (CMNSTG01) is displayed.

CMNSTG01         STAGE: ACTP000057 Components       Row 1 to 3 of 3
Command ===>______________________________________ Scroll ===> CSR
Name                + Type Status Changed         Procname User    Request
__averylongnamegoesh  JVS  ACTIVE 20150315 161850 CMNJAVA  USER016
__hw001.java          JVS  ACTIVE 20150315 152357 CMNJAVA  USER016
__org/jdom/xpath/jhf  JVS  ACTIVE 20150315 165512 CMNJAVA  USER016

*********************** Bottom of data ********************************

Panel CMNSTG01 shows only 18 characters of each component name. The panel permits scrolling left and right via PF10 and PF 11, and Expand (PF4) in the Name field so you can see the rest of the component name.

However, if you type LONG on the Command line and press ENTER, the STAGE: package Components (CMNSTG14) panel is displayed, which shows each component zFS path, up to 44 characters, on a line below the rest of the component information.

CMNSTG14     STAGE: ACTP000057 Components      Row 1 to 3 of 3
Command ===>_________________________________ Scroll ===> CSR
Name               + Type Status Changed        Procname User   Request
                     Org  Input dataset name              + Target lib
__averylongnamegoesh JVS ACTIVE 20150315 161850 CMNJAVA USER016
                     JFS /cmntp/s6/ACTP/#000057/d/JVS            JVL
__hw001.java         JVS ACTIVE 20150315 152357 CMNJAVA USER016
                     JFS /cmntp/s6/ACTP/#000057/d/JVS            JVL
__org/jdom/xpath/jhf JVS ACTIVE 20150315 165512 CMNJAVA USER016
                     JFS /cmntp/s6/ACTP/#000057/d/JVS            JVL
*************************** Bottom of data****************************

This panel shows up to 18 characters of a long component name. This panel also offers scrolling and zoom in the Name field if you still cannot see the entire component name.

To return to the original component list panel, type SHORT on the Command line and press ENTER.

Prior to the release of ChangeMan ZMF 7.1 with long names, some panels already responded to the LONG command by displaying a panel with additional information. In some of these cases, you can type XLONG in the Command line and press ENTER to display a special panel for long names.

If you type XLONG on the Command line and press ENTER, panel CMNSTG24 is displayed. This panel shows each component name on a line above the component information, with the staging directory path on a third line.

CMNSTG24          STAGE: ACTP000057 Components       Row 1 to 3 of 3
Command ===>_______________________________________ Scroll ===> CSR
Name           + Type Status    Changed        Procname User    Request
                 Org Input dataset name                   + Target lib
averylongnamegoeshereforjava.java
                JVS  ACTIVE   20150315 161850 CMNJAVA USER016
                JFS /cmntp/s6/ACTP/#000057/d/JVS                  JVL
hw001.java
                JVS  ACTIVE   20150315 152357 CMNJAVA USER016
                JFS /cmntp/s6/ACTP/#000057/d/JVS                  JVL
org/jdom/xpath/jhfhth40long.java
                JVS  ACTIVE   20150315 165512 CMNJAVA USER016
                JFS /cmntp/s6/ACTP/#000057/d/JVS                  JVL
*********************** Bottom of data ********************************

This panel shows up to 75 characters of a long component name. This panel also offers scrolling and zoom in the Name field if you still cannot see the entire component name. You can scroll and zoom on the staging directory path.

On this panel you can use the LONG command to display the CMNSTG14 panel or SHORT to display the CMNSTG01 panel.

You can use the DCD command on some panels to display the first line of the component general description in addition to the fields displayed on the SHORT, LONG and XLONG panels. This is available on package component lists in the Checkout, Stage and Query functions and on baseline/promotion component lists in the Browse Baseline and Checkout functions.

Tip

If you want to see the component name on a separate line, try XLONG first. If short message INVALID SELECTION CODE is displayed, try command LONG.