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.