Working With Lists

ChangeMan ZMF makes extensive use of lists to help you work efficiently with packages, components, and the data required on ISPF panels.

Common List Commands

Common list commands for ChangeMan ZMF are itemized below. To use one of these commands, type it in the Command line of a list panel and press Enter. You may be able to abbreviate the command by typing the first one or two characters.

REFRESH reads ChangeMan ZMF database and updates the displayed data.
CANCEL leaves the list without processing any line commands you have entered.
SORT [heading] sorts the list on the data under the column heading you specify.
LOCATE finds the first occurrence of a value you specify in the column you last sorted. If you have not sorted the list, LOCATE looks in the first column.

Building Lists Using Patterns

You can use a pattern with wildcard characters in some data entry fields to select a subset of list items. The subset displays in a new list panel.

Important

Assume that ISPF panel fields are case sensitive when you enter patterns to build selection lists. Support for zFS requires case sensitive fields.

Wildcard Characters

Wildcard characters have these functions in patterns in ChangeMan ZMF.

Wildcard	Function
\	Represents any string of characters from this position to the end.
?	Represents any character in this one position.

Package ID Pattern Examples

A package ID is composed of a three- or four-character application mnemonic and a six- character package number. When a three-character application mnemonic is used, a blank is valid in the fourth character of the package ID. On panels where a pattern can be used for package ID, patterns operate independently on the two parts of the package ID.

Starting with the following group of package IDs:

ABC 000001
ABC 000002
ABCD000001
ABCD000002
ABCE000001
ABCE000002
AXYD000001
AXYD000002
WXYZ000021
WXYZ000022

The following table shows the package IDs that are selected with each sample pattern.

Pattern	Package IDs Selected
ABC* or ABC?	ABC 000001
	ABC 000002
	ABCD000001
	ABCD000002
	ABCE000001
	ABCE000002
A??? or A\	ABC 000001
	ABC 000002
	ABCD000001
	ABCD000002
	ABCE000001
	ABCE000002
	AXYD000001
	AXYD000002
ABC*000001	ABC 000001
	ABCD000001
	ABCE000001
?XY?00002\	WXYZ000021
	WXYZ000022
?XY?0000?1	AXYD000001
	WXYZ000021

Note

If you omit the leading zeros in the package number, ChangeMan ZMF often assumes that zeros precede the package number. For example, if you type ABCD1 in some package ID fields, package ABCD000001 is selected or displayed. When you use a pattern, zero fill does not apply.

Using Selection Lists

When you leave a panel field blank, ChangeMan ZMF may display a selection list from which you can choose a value to fill the field. When you execute a ChangeMan ZMF function and there are multiple objects that are eligible for action, ChangeMan ZMF may display a list for you to select one or more of the objects.

There are three types of selection lists in ChangeMan ZMF: single-item selection lists, multiple-item selection lists, and extended multiple-item selection lists.

Single-Item Selection

Only one selected item is processed from a single-item selection list. To select an item, type S in the line command for the selected item, then press Enter. If you select multiple items, only the first item is processed. After you press Enter, processing continues with the panel where the selection list was called.

Example:

CMNSTG07 ------------------ LANGUAGE SELECTION LIST ---------- Row 1 to 5 of 5
COMMAND ===>--------------------------------------- SCROLL ===> HALF
LANGUAGE
_ ASM
_ COBOL
_ COBOL2
_ PLI
_ SQL
*********************** Bottom of data*****************************

Multiple-Item Selection List

You can select multiple items for processing from a multiple-item selection list. To select one or more items, type S in the line command for each of the items you want, then press Enter. If the list is longer than one panel, you can usually page down and up to make additional selections before you press Enter.

On some multiple-item selection lists, the selected items are processed and the list is redisplayed with a status shown for each selected item. In other cases, processing continues with the panel where the selection list was called.

Example:

CMNSTG01        STAGE: ACTP000001 Components       Row 61 to 68 of 68
Command ===>---------------------------------------Scroll ===> PAGE

Name      + Type Status     Changed         Procname User    Request
__ACPSRC99  SRC ACTIVE      20141119 030722 CMNCOB2  JPRIMER LOCKED
__PLICPYX0  CPY ACTIVE      20141118 190724          JPRIMER LOCKED
__PLICPY01  CPY ACTIVE      20141118 190727          JPRIMER LOCKED
__PLICPY02  CPY ACTIVE      20141118 190731          JPRIMER LOCKED
__PLIPGM01  SRC ACTIVE      20141119 030701 CMNPLIE  JPRIMER
__PLIPGM1   SRC ACTIVE      20141119 030633 CMNPLIE  JPRIMER
__SAMCPY1A  CPY ACTIVE      20141118 190734          JPRIMER LOCKED
__SAMCPY1B  CPY ACTIVE      20141118 190738          JPRIMER LOCKED
************************** Bottom of data **************************

Extended Multiple-Item Selection

With an extended multiple-item selection list, you select one or more items, then exit the list to initiate processing for the selected items.

To select one or more items, type S in the line command of each item, then press Enter. If the selection list panel contains a Status (or Request) column, *SELECT* displays in the Status field for each selected item. Deselect items by typing D in the line command of selected items and press Enter. *DE-SEL* may display in the Status (or Request) column for each deselected item. You can select and deselect items from multiple pages of the list by scrolling down and up.

To initiate processing for the selected items, exit the panel by typing End on the Command line and pressing Enter, or by pressing PF3. Processing usually continues with the panel where the selection list was called.

Example:

CMNRPM05 PROMOTE TO: SERT6 Lvl 10 (S6P1UT) Row 1 to 1 of 1 
Command ===>------------------------------ Scroll ===> PAGE
       Package: ACTP000002 Status: DEV Install date: 20141231
Name   +   Type Status Promotion      Date   Time  User    REQUEST
__TESTCO01 LOD         0 STAGING 2014/11/19  13:41 USER001 *SELECT*
__TESTCO02 LOD         0 STAGING 2014/11/19  13:41 USER001 *SELECT*
__TESTCO03 LOD         0 STAGING 2014/11/19  13:41 USER001 *SELECT*
******************** Bottom of data*******************************

Scrolling Through Lists

When ChangeMan ZMF builds a selection that is too long to display on one panel, use the UP and DOWN keys on your keyboard — usually PF7 and PF8 — to scroll up and down through the list. The scroll amount for UP and DOWN is specified in the SCROLL field in the upper right of the list panel. Options are PAGE, HALF, and CSR (cursor).

To move up or down a specific number of lines, type a number of lines on the Command line and press PF7 to go up that number of lines, or PF8 to go down that number of lines.

To move to the top or bottom of the list, type the command TOP or BOTTOM on the Command line and press Enter. You can also type M (maximum) in the Command line and press PF7 or PF8.