Chicago Interface Group, Inc.

FastLIST

ISPF User Guide

Release 3.0
Chicago Interface Group, Inc.
368 West Huron, #2N
Chicago, IL 60610 USA

Phone: (312) 337-3709

Fax: (312) 255-0124
Internet: www.cigi.net
Email: [email protected]

Release Date: March, 1998

Updated: January, 2000

FastLIST release 3.0

Copyright © 1998 Chicago Interface Group, Inc. All Rights Reserved

FastLIST is a registered trademark of Chicago Interface Group, Inc.

CICS, DB2, and IMS are registered trademarks of IBM
IDMS and CA-ENDEVOR are registered trademarks of Computer Associates
International

FastLIST ISPF User Guide

 Table of Contents
CHAPTER 1: ................................................................................................. OVERVIEW 1-1
Introduction .............................................................................................................. 1-3
FastLIST’s ISPF Interface ........................................................................................ 1-4
Impact Analysis ........................................................................................................ 1-6
Duplicate Element Prevention .................................................................................. 1-9
FastLIST Usage Scenario #1: Identifying Changes in a Date Range .................... 1-11
FastLIST Usage Scenario #2: Modifying Processors............................................. 1-14
FastLIST Usage Scenario #3: Release Management Using CCIDs ...................... 1-16
Usage Scenario #4: Implementing mass changes through search and replace .... 1-18

CHAPTER 2: ................................................................................THE ISPF INTERFACE 2-1

How to Display Listings to the FastLIST ISPF Front end .......................................... 2-3
The Main Panel ........................................................................................................ 2-4
Main Panel Query Area ............................................................................................ 2-6
Main Panel Query Area with SOJOURN................................................................... 2-8
Query Prompt Panels: ENDEVOR Filters ............................................................... 2-10
Query Prompt Panel: External Datasets................................................................. 2-14
Result Area ............................................................................................................ 2-15
Line Command Example: Editing an Element ........................................................ 2-17
Print Support .......................................................................................................... 2-21
Other Line Command Examples: ........................................................................... 2-22
Browsing ENDEVOR Listings................................................................................. 2-23
Action Area: Performing ENDEVOR Group Actions .............................................. 2-25
User Action Support ............................................................................................... 2-27
Running Actions in Batch ....................................................................................... 2-28
JCL and Job Card Setup ........................................................................................ 2-30
Setting Your Preferences from the Action Area...................................................... 2-31
Requesting FastLIST Reports from the Action Area............................................... 2-33
Using the Package Interface .................................................................................. 2-34

FastLIST ISPF User Guide

 FastLIST 3.0

Chapter 1: Overview

This chapter contains:

• A conceptual explanation of FastLIST.

• A discussion of the FastLIST components.

• Using FastLIST to perform impact analysis.

• Usage scenarios.
1-2 Overview
FastLIST ISPF User Guide
Introduction

What is FastLIST?

FastLIST is a programmer’s workbench integrated with the CA-ENDEVOR environment.

FastLIST consists of five interrelated product components:

! A simple-to-use ISPF front-end allowing for fast access to ENDEVOR data;

programmer functions such as editing elements and performing actions are accessible
through a single ISPF panel.

" Impact analysis facilities which are integrated with the ISPF front-end, available
through batch utilities or accessible via ENDEVOR processors.

# Controls and customizable rule sets to prevent the introduction of duplicate elements
into an incorrect ENDEVOR inventory location.

$ Package processing integration, which allows you to build or re-use a package from
the FastLIST front–end. This feature also provides seamless integration with CIG
Package Utilities and Greenhouse products.

% The ability to invoke the ENDEVOR Text Search and Replace Function from the
FastLIST front-end.

FastLIST is:

EASY to install,
EASY to implement, and
EASY to use.

Overview 1-3
FastLIST ISPF User Guide
FastLIST’s ISPF Interface

Programmers can use the FastLIST ISPF interface to perform a variety of ENDEVOR and
non-ENDEVOR functions including:

• Editing an ENDEVOR element or PDS member

• Performing where used impact analysis
• Batch SCL generation
• Performing ENDEVOR actions in either batch or foreground
• Report submission
• Package creation
• Text Search and Replace

FastLIST's easy to use front-end allows programmers to perform all of the above
functions from just a few panels. FastLIST pop-up panels guide users through more
advanced functions, such as performing date searches and “where used” CCID queries,
and FastLIST CUA compliant pop-up panels make selecting various line actions and
group actions quick and easy.

Figure 1.1 illustrates the easy-to-use FastLIST ISPF workbench. In the figure, a request to
display a list of all programs which reference a copybook (i.e. an Input Component)
called $TIME was issued.

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. $TIME COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
$$DATE1 ASM SPAIN 2 FASTLIST R2M0 (01.34)
$$MSG ASM SPAIN 2 FASTLIST R2M0 (01.00)
$$REPORT ASM SPAIN 2 FASTLIST R2M0 (01.05)
CIGFLIN6 ASM SPAIN 2 FASTLIST R2M0 (01.03)
CIGPISPF ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGPKDEL ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGPKRMK ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGPKRMK ASM SPAIN 2 FASTLIST R2M0 (01.02)
CIGPKUT3 ASM SPAIN 2 FASTLIST R2M0 (01.07)
Figure 1.1
ISPF Interface

1-4 Overview
FastLIST ISPF User Guide
 Single Panel Interface

The FastLIST Primary Panel consists of three areas: the query area, the action area, and
the result area.

Query Area
---------------------------- FASTLIST WORKBENCH ----------------------------
OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)

===============================================================================
Action ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
Area ===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------

Figure 1.2
Result Area The Main Panel

Query Area Search criteria are specified in the Query Area, while advanced
searches (e.g., date ranges, CCID usage) are accessible via the
Filter panel. The FastLIST ISPF interface combines the traditional
batch “where used” capabilities with an interactive, real-time on
line panel for list generation and action processing.

Result Area The Result Area shows a list of all elements or PDS members
which match your search criteria. Standard ENDEVOR line
commands and actions can be performed on elements listed in the
Result Area using standard Endevor action characters (such as G
for generate, A for add, etc) or through the use of the CUA
standard ‘/’ selection character.

Action Area The Action Area allows you to perform Group Mode Actions (such
as package submission) view messages, submit reports, and modify
JCL settings.

Overview 1-5
FastLIST ISPF User Guide
Impact Analysis

Impact analysis can be performed online via the FastLIST ISPF front-end. You will see an
increase in overall system quality and reduction in the time required to make application
changes through the impact analysis capabilities of FastLIST.

Impact Analysis and Configuration Management

Configuration management is the tracking of component relationships and the ability to

make quality decisions based on data and tools that perform "where used" analysis. The
goal of this analysis is that (1) the impact of a change is always known in advance, and
(2) you always know what components make up the existing outputs.

A typical configuration management problem involves trying to determine the impact of

an improvement in a macro or processor. ENDEVOR provides information on input
components, output components, and objects per element, as well as processor used by
element. Through FastLIST you can access this data on-line, real-time, to make decisions
and do planning.

Prior to making a change to a copybook you can perform an online query to identify all
programs impacted by a change to the copybook. Your approach and possible decision in
making the copybook change may be affected by the results of your analysis. FastLIST
provides the ability to perform such impact analysis quickly, easily, and in an
environment where the changes can be quickly made.

FastLIST's configuration management information is accessed through a set of functions

built to work with CA-ENDEVOR ACM data, CCID data, and user-defined object
relationships, allowing the full potential of configuration management to be achieved.

1-6 Overview
FastLIST ISPF User Guide
 Accessing configuration management data

There are three methods for accessing configuration data through FastLIST:

• First, access is provided through the FastLIST ISPF front-end.

• Second, the FLIST utility can be executed either as a stand-alone batch utility or
integrated into an ENDEVOR processor. (The FLIST utility is a high-speed
replacement for the ENDEVOR LIST action.) The FLIST utility also allows FastLIST
configuration data to be written to a sequential file.
• Third, access is provided through a series of FastLIST configuration reports.
“Tell me all programs
that use the copybook
$TIME.”
---------------------------- FASTLIST WORKBENCH ----------------------------
OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. $TIME COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
$$DATE1 ASM SPAIN 2 FASTLIST R2M0 (01.34)
$$MSG ASM SPAIN 2 FASTLIST R2M0 (01.00)
$$REPORT ASM SPAIN 2 FASTLIST R2M0 (01.05)
CIGFLIN6 ASM SPAIN 2 FASTLIST R2M0 (01.03)
Query CIGPISPF ASM SPAIN 2 FASTLIST R2M0 (01.00)
Results CIGPKDEL ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGPKRMK ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGPKRMK ASM SPAIN 2 FASTLIST R2M0 (01.02)
CIGPKUT3 ASM SPAIN 2 FASTLIST R2M0 (01.07)
Figure 1.3
Impact analysis request

FastLIST's online access to configuration data is illustrated in Figure 1.3. In the example,
a programmer has requested FastLIST to identify all programs which use a copybook
called $TIME.

Overview 1-7
FastLIST ISPF User Guide
Indirect References

FastLIST provides the ability to identify indirect references between elements. The figure
below shows that CUSTREC, a copybook included in PGMA source, has an indirect
reference to the PGMA executable. Consequently, a change to CUSTREC will require
that a new PGMA executable be created.

SHIPREC
DATEREC

Copy books PGMA DATEPGM

CUSTREC source source

PGMA
executable
(TYPE=LINK)

Figure 1.4
Indirect reference example

Some ENDEVOR installations may define CUSTREC as a type COPYBOOK, PGMA

source as a type COBOL, and the creation of PGMA executable through a type LINK.

The Indirect Option, available through the ISPF front-end or FLIST utility, allows the
PGMA (TYPE=LINK) to be listed as one of the modules impacted by a change to the
CUSTREC copybook.

1-8 Overview
FastLIST ISPF User Guide
 Duplicate Element Prevention

Integrated with FastLIST is the ability to control "duplicate" elements. A duplicate

element is an element which was accidentally introduced into an incorrect ENDEVOR
inventory location. For example, an element could be added to the incorrect subsystem or
with the wrong type identifier. An element with the same name in an incorrect inventory
location can be problematic. Such a mistake could result in an incorrect executable being
moved into your production environment resulting in a serious production outage.

Controlling Duplicate Elements

Your environment is dynamic: it is different from other IT organizations and within your
organization requirements and controls vary on an application-by-application basis. For
one particular system, no duplicate element names may be allowed. In a second
application system, you may allow duplicate names for certain element types. In a third
system, you may need to allow duplicates within a particular subsystem.

The Duplicate Element Prevention feature allows you to defines rules controlling the
creation of elements with the same name (i.e., duplicate elements).

Duplicate Element Rule Set

The FastLIST Duplicate Element Control Facility allows you to define a rule set to control
duplicate elements. The rule set is identified in the FastLIST Control File (CIGINI file)
and is referenced when an ENDEVOR action is performed. The rules are simple to
specify and provide all the power you need to ensure your environment is secure from the
introduction of duplicate element names. The following figure illustrates duplicate
element rules:
! ******** START OF RULES *****

" IF CURRENT ELEMENT NAME IS SYSTEM FINANCE

THEN GOTO FINCHECK
IF CURRENT ELEMENT NAME IS TYPE BMS
# THEN GOTO BMSCHECK
FOR DUPLICATE ELEMENT NAME IN TYPE (ASM, JCL)
THEN IGNORE DUPLICATE

$ ISSUE WARNING

FINCHECK
% FOR DUPLICATE ELEMENT NAMES IN SAME SUBSYSTEM
THEN FAIL ACTION
IGNORE DUPLICATE

& BMSCHECK
FOR DUPLICATE ELEMENT NAMES IN SAME SYSTEM ANY SUBSYSTEM
THEN FAIL ACTION
IGNORE DUPLICATE
Figure 1.5. Duplicate Element Rules

Overview 1-9
FastLIST ISPF User Guide
 ! In statement 1, a check for elements being added to the FINANCE system is
requested. For those elements, duplicate checking will be handled in the logic
associated with the FINCHECK label.

" In statement 2, a check for elements of the BMS type is requested. Duplicate element
checking will be handled in the logic associated with the BMSCHECK label.

# In statement 3, duplicate element names are ignored when the element type is either
ASM or JCL.

$ Statement 4 is the default: A warning will be issued when a duplicate element name is
detected which does not match the criteria specified in the prior IF statements.

% The processing in the “Fincheck” Section states that any duplicate element in the
same subsystem (across any system or type) will be rejected If the condition is not
met (i.e, same element in different subsystems) then the duplicate is ignored.

& The processing in the “BMScheck” section will fail the action if the same element
name is found in the same system (and type), but in any subsystem. Duplicate names
across systems will be ignored.

Usage Example: Conversion Project

Many IT organizations are now upgrading their legacy applications, a task that requires
that a large number of programs be changed and extensive testing be performed. You
may even establish a testing environment to ensure the changed applications run
correctly.

If changes are being implemented by programmers and consultants unfamiliar with your
ENDEVOR configuration then you may experience elements with the same name being
introduced into incorrect ENDEVOR locations. This could result in a costly clean up.
But, fortunately, with FastLIST’s impact analysis capabilities, you will be able to quickly
identify all components which were added into ENDEVOR during a specified date range.
You can prevent further damage from occurring by utilizing duplicate element rules.

Refer to the FastLIST Administrator Guide for an explanation on

implementing the FastLIST Duplicate Element Prevention feature.

1-10 Overview
FastLIST ISPF User Guide
FastLIST Usage Scenario #1: Identifying Changes in a Date
Range

In this scenario, you can identify all elements that have changed during the range June 1
through August 1. In this example you would want to retrieve those elements into a
partitioned dataset to be shipped for release distribution.

Step 1: Access the FILTERS panel.

To request a date range search, you first must access the FILTERS panel. From the
FastLIST primary panel, type a ‘/’ in the Show Filters field and press <Enter>. The
enhanced ENDEVOR Filter Settings panel will be displayed (Figure 1.10), from which
you can access the date range panel.

---------------------------- FASTLIST WORKBENCH -----------------------------

O ENDEVOR FILTER SETTINGS SCROLL ==> PAGE

OPTION ==>
ENTER “/” TO SELECT OPTION:
ENVIRONMENT. . . . . _SHOW FILTERS _APPEND
SYSTEM . . . . . . .
SUBSYSTEM. . . . . . ============================
TYPE . . . . . . . .
_PREFERENCES
ELEMENT. . . . . . . ============================
STAGE NUMBER . . . . SYSTEM SUBSYS (VV.LL)
----------------------------
WHERE: FASTLIST R2M0 (01.34)
SIGNOUT USER ID. . . FASTLIST R2M0 (01.00)
PROCESSOR GROUP. . . FASTLIST R2M0 (01.05)
PACKAGE . . . FASTLIST R2M0 (01.03)
CCID. . . . . FASTLIST R2M0 (01.00)
CCID TYPE . . C LVLS?. . . . N FASTLIST R2M0 (01.01)
VERSION . . . LEVEL. . . . FASTLIST R2M0 (01.01)
GENFAIL?..... N FASTLIST R2M0 (01.02)
ENTER DATE FILTERS. . . . . . Y FASTLIST R2M0 (01.07)
* INCLUDE INDIRECT COMPS? . . . N ****************************

END = CANCEL ENTER = PROCESS PFK1 = HELP

Figure 1.6 The ENDEVOR Filter panel
Accessing the Date
Range Panel

Overview 1-11
FastLIST ISPF User Guide
 Step 2: Specify a date range.

From the Date and Time Search pop-up panel, you would specify the date range.

---------------------------- FASTLIST WORKBENCH ----------------------------

O DATE AND TIME SEARCH oll ==> CSR
OPTION ==> lect option:
_ Append
ENTER THE DATE, TIME AND TYPE.
ONLY DATE AND TYPE ARE REQUIRED.
= =============
DATE FORMAT IS YY/MM/DD.
rences
= WHERE DATE. . . THROUGH DATE. . . =============
" s (VV.LL)
- TIME FORMAT IS HH:MM. -------------
* *************
WHERE TIME. . . THROUGH TIME. . .

DATE TYPE . . . . G (C,G,L,D)

(CUR,GEN,LAST,OR DELTA)

END = CANCEL ENTER = PROCESS PFK1 = HELP

Figure 1.7
Accessing the Date-Range Filter panel

Year 2000 Compliance:

FastLIST now supports century windowing on date range queries and date processing.
The ISPF and batch interfaces have been modified to include a 52 based windowing
technique, meaning that all two-digit year fields below 52 will be processed as 21st
century dates, and all two-digit year fields above 52 will be processed as 20th century
dates.

1-12 Overview
FastLIST ISPF User Guide
Step 3: RETRIEVE listed programs

After initiating a date range search, only those programs which match the date range
criteria will be shown in the result area on the FastLIST Main Panel.

To retrieve the programs, type a ‘/’ in the Group Action Area, which will display the
Group Mode Action panel. Select Option 3, Retrieve.

---------------------------- FASTLIST WORKBENCH --------- Row 1 to 13 of 88

O Group Mode Action Request Scroll ==> CSR
Option ==> to select option:
rs _ Append
Actions: Execution Options:
= ==================
__ 1. Add...........A 2 1. Batch
2. Update........U 2. Batch packages Preferences
= 3. Retrieve..... R 3. Foreground ==================
" 4. Generate..... G 4. SCL only Subsys (VV.LL)
- 5. Move......... O ------------------
6. Delete....... # Enter "/" to select option: TESTCASE (01.00)
7. Transfer..... T / Edit SCL TESTCASE (01.02)
8. Signin........SI / Option Prompt CIBC (01.00)
9. Search........SR / Edit JCL TESTCASE (00.45)
10. Print.........P TESTCASE (00.03)
11. User Action...UA TESTCASE (00.03)
CIBC (00.04)
Select an action and other optional settings CIBC (01.03)
and then press ENTER to process. TESTCASE (00.45)
BETACCCC TESTDATA GREEN 1 INTERNAL TESTCASE (00.45)
BETADDDD TESTDATA GREEN 2 INTERNAL TESTCASE (01.00)
BETADDDD TESTDATA GREEN 1 INTERNAL TESTCASE (00.45)

Figure 1.8
Retrieving listed programs

FastLIST 3.0 provides users with the ability to execute actions via an ENDEVOR
package. To utilize this feature select Execution option 2, Batch packages.

Overview 1-13
FastLIST ISPF User Guide
FastLIST Usage Scenario #2: Modifying Processors

When a company decides to upgrade to the newest version of the COBOL compiler,
ENDEVOR processors may need to be modified.

Step 1: Edit the processor.

In this example, the processor ASMCP must be modified to support the latest COBOL
compiler.

#1. Issue query request

for processor ASMCP.

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . ASMCP LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
E ASMCP ASM PROD FASTLIST R2MO (01.00)
Figure 1.9
Editing a processor from the Main Panel
#3. Edit #2. Results of
the query request.
processor.

1-14 Overview
FastLIST ISPF User Guide
Step 2: Utilizing package processing, generate all programs that use the
impacted processor.

After the processor has been edited, you can use the impact analysis capabilities of
FastLIST to build and execute Endevor generate actions, via package processing, for all
programs which use the changed processor.

To generate the affected programs, type a ‘/’ in the Group Action Area of the main panel,
which will display the Group Mode Action panel. Select Option 4, Generate, and
Execution Option 2, Batch packages.

---------------------------- FASTLIST WORKBENCH --------- Row 1 to 13 of 88

O Group Mode Action Request Scroll ==> CSR
Option ==> to select option:
rs _ Append
Actions: Execution Options:
= ==================
__ 1. Add...........A 2 1. Batch
2. Update........U 2. Batch packages Preferences
= 3. Retrieve..... R 3. Foreground ==================
" 4. Generate..... G 4. SCL only Subsys (VV.LL)
- 5. Move......... O ------------------
6. Delete....... # Enter "/" to select option: TESTCASE (01.00)
7. Transfer..... T / Edit SCL TESTCASE (01.02)
8. Signin........SI / Option Prompt CIBC (01.00)
9. Search........SR / Edit JCL TESTCASE (00.45)
TESTCASE (01.00)
Select an action and other optional settings CIBC (01.00)
and then press ENTER to process. TESTCASE (00.45)
TESTCASE (01.01)
TESTCASE (00.45)
TESTCASE (01.00)
BETACCCC TESTDATA GREEN 1 INTERNAL TESTCASE (00.45)
BETADDDD TESTDATA GREEN 2 INTERNAL TESTCASE (01.00)
BETADDDD TESTDATA GREEN 1 INTERNAL TESTCASE (00.45)
Figure 1.10
Retrieving listed programs via package processing

Overview 1-15
FastLIST ISPF User Guide
FastLIST Usage Scenario #3: Release Management Using
CCIDs

In this scenario, a program correction was made to several programs earlier this year. In
making these changes the CCID 'TEST002' was assigned to the programs being changed.
You need to identify all programs which were assigned this CCID, even if additional
changes (using different CCIDs) were made. FastLIST allows Delta level CCIDs to be
searched in addition to current levels.

Step 1: Access the FILTERS panel.

To request a CCID search, you first must access the FILTERS panel. As shown below,
the FILTERS panel is accessible by typing ‘/’ in the Show Filters field on the FastLIST
Workbench primary panel. After pressing <Enter>, the FILTER SETTINGS panel will
be displayed, where you can specify filtering options, such as CCID.

#1. Request to display the

ENDEVOR Filter Settings
panel.
---------------------------- FASTLIST WORKBENCH -----------------------------

O ENDEVOR FILTER SETTINGS SCROLL ==> PAGE

OPTION ==>
ENTER “/” TO SELECT OPTION:
ENVIRONMENT. . . . . / SHOW FILTERS _APPEND
SYSTEM . . . . . . .
SUBSYSTEM. . . . . . ============================
TYPE . . . . . . . .
_PREFERENCES
ELEMENT. . . . . . . C* ============================
STAGE NUMBER . . . . SYSTEM SUBSYS (VV.LL)
----------------------------
WHERE: FASTLIST R2M0 (01.34)
SIGNOUT USER ID. . . FASTLIST R2M0 (01.00)
PROCESSOR GROUP. . . FASTLIST R2M0 (01.05)
PACKAGE . . . FASTLIST R2M0 (01.03)
CCID. TEST002 FASTLIST R2M0 (01.00)
CCID TYPE . . D LVLS?. . . . N FASTLIST R2M0 (01.01)
VERSION . . . LEVEL. . . . FASTLIST R2M0 (01.01)
GENFAIL?..... N FASTLIST R2M0 (01.02)
ENTER DATE FILTERS. . . . . . N FASTLIST R2M0 (01.07)
* INCLUDE INDIRECT COMPS? . . . N ****************************

END = CANCEL ENTER = PROCESS PFK1 = HELP

Figure 1.11 ENDEVOR Filter Settings

#2. Show me all programs using

CCID=TEST002, regardless of the
level to which the change was made.

1-16 Overview
FastLIST ISPF User Guide
Step 2: Display a list of programs.

After specifying the CCID search criteria, those programs which have delta levels
associated with TEST002 are displayed. CCID search criteria includes current levels,
delta levels, last action, generate, retrieve or all of the above.

Number of
programs using
CCID=TEST002
---------------------------- FASTLIST WORKBENCH ----------------ROW 1 TO 4 OF 4
OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
CIGGHSCL ASM PROD 2 FASTLIST R2M0 (01.03)
CIGISPF1 ASM PROD 2 FASTLIST R2M0 (01.01)
CIGI@CMD ASM PROD 2 FASTLIST R2M0 (01.00)
CIGIALLO ASM PROD 2 FASTLIST R2M0 (01.00)

Figure 1.12 Displaying a list of programs.

Results from date
query.

Overview 1-17
FastLIST ISPF User Guide
Usage Scenario #4: Implementing mass changes through
search and replace

In this scenario, we want to change all references to “$QSAM”.

Step 1. Drive a list of all elements that contain references to $QSAM.

“Show me all components which

reference $QSAM.”

--------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT.$QSAM COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
Figure 1.13 Implementing Mass Changes through Search and Replace

1-18 Overview
FastLIST ISPF User Guide
Step 2. Invoke the Group Mode Action Request panel.

Once FastLIST returns the list of components, invoke the Group Mode Action Request
panel by entering a ‘/’ in the Group Action field. Select Option 9, Search, to build search
SCL for all references to $QSAM.

After pressing <Enter>, you will be prompted with an input panel for the search string, a
replace string, and search attributes. Figure 1.18 below shows the Group Scan and
Replace panel. After exiting this panel, a job will be submitted to perform the search.

---------------------------- FASTLIST WORKBENCH ----------- Row 1 to 5 of 5

O GROUP SCAN AND REPLACE OPTION PROMPT
OPTION ==>

YOU ARE IN GROUP PROCESSING MODE. ALL ELEMENTS ON THE CURRENT LIST
WILL BE INCLUDED IN THE SEARCH AND REPLACE SCL AS PER THE OPTIONS
= BELOW: =

SCAN.. $QSAM
= REPLACE. . N (Y/N) =
" WITH . $QSAM1
- -
OPTIONS:
PERMIT DATA TRUNCATION?. N BYPASS GENERATE PROCESSOR. Y
LIST DETAILS?. . . . . . N OVERRIDE SIGNOUT . . . . . Y
SEARCH ENVIRONMENT. . . N (N/M/O)
CCID. . . . TESTING PROCESSOR GROUP EQ . . . .
* COMMENT . . *
SCL DSN . . 'CIGT.TEST.PDS'
SCL MEM . . REPLACE

END = CANCEL ENTER = PROCESS OPTION PFK1 = HELP

Figure 1.14 Group Scan and Replace Option Prompt

Overview 1-19
FastLIST ISPF User Guide
 FastLIST 3.0

Chapter 2: The ISPF Interface

This chapter contains a detailed explanation of how to use the FastLIST ISPF
front end, including how to:

• Produce a list and how to create SCL.

• Perform impact analysis.
• Use Line Edit commands to edit elements and other members.
• Build and submit FastLIST report requests.
• Use Action Line commands.
• Build a package.
• Build and submit Search and Replace commands.
2-2 ISPF Interface
FastLIST ISPF User Guide
How to Display Listings to the FastLIST ISPF Front end

ISPF Front end Capabilities

With the ISPF front end, you can:

1. Create a list of elements meeting your search criteria. FastLIST allows searches based
on CCIDs, components, date and time stamps, or other element information.

2. Edit elements or members.

3. Perform ENDEVOR line command actions and browse listings from a single panel.

4. Produce SCL from your list and submit it to ENDEVOR or store it for later use.

5. Build and submit report requests.

6. Build and submit packages.

7. Build and submit search and replace commands

FastLIST ISPF functions interactively, so you see search results instantly from search
criteria that has traditionally only been available through the ENDEVOR batch LIST
action. The FastLIST impact analysis screen accepts criteria such as "where CCID equals"
and "where component equals." FastLIST also explicitly searches delta level CCIDs.
Results from all of these searches are immediately written to the ISPF screen.

Panels

The ISPF front end has been designed as a workbench. All functions and prompts come
from and return to the same main panel. This approach eliminates time consuming, multi-
panel select and return sequences. The majority of the panels are pop-up panels that will
prompt the user through an input process. When the input process is complete the panel
disappears. In addition to the main panel, there are several CUA compliant panels which
prompt the user with available options.

ISPF Interface 2-3

FastLIST ISPF User Guide
 The Main Panel

The FastLIST Primary Panel consists of three areas:

• The Query Area

• The Action Area
• The Result Area
Query Area

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)

===============================================================================
Action ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
Area ===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------

Figure 2.1
Result Area The Main Panel

Query Area Search criteria is specified in the Query Area. Advanced searches (e.g.,
date ranges, CCID usage) are available via the pop-up filter panel. The
FastLIST ISPF interface combines the traditional batch “where used”
capabilities with an interactive, real-time online panel for list generation
and action processing.

Action Area The CUA compliant Action Area allows you to call up several additional
pop-up panels which allow you to perform:

• Group Mode Actions, which allow you to perform standard

ENDEVOR actions in Batch or Foreground, and against a package.
• View and Edit the current settings for ENDEVOR job cards and
additional JCL variables.
• View a log of informational and error messages
• Request reports. The menu for reports will include the field and lines
of code reports.
• Check or update user preferences.

2-4 ISPF Interface

FastLIST ISPF User Guide
Result Area The Result Area shows a list of all elements or PDS members which
match your search criteria. In addition to being able to perform standard
ENDEVOR line commands against elements listed in the Result Area, this
area also supports the CUA ‘/’ convention. To get a selection list of
options, or to select an option, enter a ‘/’ character in a field and press
enter.

ISPF Interface 2-5

FastLIST ISPF User Guide
Main Panel Query Area

FastLIST performs an element search based on a combination of information from the

Preferences Panel and the query area of the Main Panel. In addition, prior to list creation,
the user will be prompted with the current ENDEVOR inventory search settings.
FastLIST will use all the criteria from ENDEVOR Filter Setting Panel, as well as the
criteria from the LIST section of the Preferences Panel to generate a list. The following is
a display of the search section of the main ISPF panel and a description of each search
related field.

Query Area

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)

===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
Figure 2.2
The Search Section

Field Description

List Element Element name or mask of 10 characters or fewer.

List Type ENDEVOR (E), External dataset (X), or Both (B)

Where Component Component name of 10 characters or fewer. A component can be a

copybook, macro, processor or ENDEVOR object.

Comp Type One character Component type. Choices are:

I - Input Component (copybook or macro)

O - Output Component
P - Processor Component
X - ENDEVOR Object

Comp type is related to ‘where component’ described above.

2-6 ISPF Interface

FastLIST ISPF User Guide
Show Filters Accepts a ‘/’.
Prompts the user with ENDEVOR Filter Settings panel.

Append Accepts a ‘/’.

Allows the user to either append elements to a current list or to
generate a new list.

If not selected, the existing list of elements appearing in the Result

Area will be erased and any new elements found will be displayed.
If no elements are found from the search, the list in the Result Area
will be empty.

If selected, any new elements generated from a search will be

added to the existing list of elements in the Result Area.

ISPF Interface 2-7

FastLIST ISPF User Guide
Main Panel Query Area with SOJOURN

For FastLIST customers who have purchased SOJOURN, three additional fields will
appear in the query area:

• Name Field
• Edit Macro
• Database Switch

---------------------------- FASTLIST WORKBENCH------------------------------

Option ==> Scroll ==> CSR
Enter "/" to select option:
List Element. . BETA* List Type. E (E/X/B) / Filters _ Append
Where Component. Comp Type. I (I/O/P/X) _ SOJOURN DB Switch
Field Name . . . E-MAC. . .
===============================================================================
Enter "/" to select function below or line command:
_ Group action | _ Msgs _ JCL _ Reports _ Preferences
===============================================================================
"/" Element Type Environ S System Subsys (VV.LL)
--- ---------- ------------ ---------------------------------------------------
******************************* Bottom of data ********************************
Figure 2.3
Main Panel with SOJOURN Implemented

Field Description

Field Name For users of SOJOURN only, request a list of elements based on a
field name in the SOJOURN database. This option is not
displayed if SOJOURN is not installed.

E-Macro User developed ISPF Edit macros can be invoked when editing a
member or element. The macro name is specified in the E-MAC
field.

Database Switch Allows the user to specify which SOJOURN database when using
multiple databases.

2-8 ISPF Interface

FastLIST ISPF User Guide
Performing Field Level Queries

Field Level Query is available through an interface to the SOJOURN data base. This
database is a field-level database that correlates field, dataset, and ENDEVOR footprint
data for general configuration management. The amount and currency of the data is
dependant upon the implementation strategy.

To perform a query based on a field name or partial field name, enter the value in the
FIELD NAME entry on the main panel. Press <Enter>. FastLIST will first perform a
search based on regular FastLIST data and/or PDS data, depending on the LIST TYPE
value. After FastLIST returns a list of elements, the same search request is sent to the
field level database, including the field name. For a record to qualify for display, the
element or member must exist on both the FastLIST database and the SOJOURN
database list.

ISPF Interface 2-9

FastLIST ISPF User Guide
Query Prompt Panels: ENDEVOR Filters

If the user requests an ENDEVOR List Type from the main panel, the following prompt
panel will be displayed. The fields in this panel are ENDEVOR-specific.
---------------------------- FASTLIST WORKBENCH ----------------------------
O ENDEVOR FILTER SETTINGS Scroll ==> PAGE
OPTION ==> Enter "/" to select option:
/ Filters _ Append
ENVIRONMENT. . . . . / )
= SYSTEM . . . . . . . ============================
SUBSYSTEM. . . . . . :
TYPE . . . . . . . . rts _ Preferences
= ELEMENT. . . . . . . ============================
" STAGE NUMBER . . . . System Subsys (VV.LL)
- ----------------------------
* WHERE: ****************************
USER ID. . . . . . .
PROCESSOR GROUP. . .
PACKAGE . . .
CCID. . . . .
CCID TYPE . . C LVLS?. . . . N
VERSION . . . LEVEL. . . .
GENFAIL?..... N
ENTER DATE FILTERS. . . . . . N
INCLUDE INDIRECT COMPS? . . . N

END = CANCEL ENTER = PROCESS PFK1 = HELP

Figure 2.4 ENDEVOR Filter Settings Panel.

From the ENDEVOR Filter panel, if you enter a ‘/’ in any of the inventory or processor
group fields, you will be provided with an inventory selection table, shown below.

---------------------------- FASTLIST WORKBENCH --------------------------

O ENDEVOR FILTER SETTINGS Scroll ==> PAGE

OPTION ==> Enter "/" to select option:
Inventory Selection Table ilters _ Append
Option ==> Scr Row 1 of 231
= ==============
Enter "/" to select an inventory location: :
------------------------------------------- _ Preferences
= Type Environ System Subsys ==============
" --- -------- -------- -------- -------- (VV.LL)
- TESTLOC SPAIN INTERNAL XIF2000 --------------
* TESTDATA SPAIN INTERNAL XIF2000 **************
TESTCODE SPAIN INTERNAL XIF2000
STEVE80 SPAIN INTERNAL XIF2000
STEVE255 SPAIN INTERNAL XIF2000
STEVEDLA SPAIN INTERNAL XIF2000
JCL SPAIN INTERNAL XIF2000
ISKELS SPAIN INTERNAL XIF2000
IPGMS SPAIN INTERNAL XIF2000

END = CANCEL ENTER = PROCESS PFK1 = HELP

Figure 2.5 ENDEVOR Inventory Selection Table

2-10 ISPF Interface

FastLIST ISPF User Guide
Environment ENDEVOR inventory location. Accepts 1-8 characters or '/' for
prompt

System ENDEVOR inventory location. Accepts 1-8 characters or '/' for

prompt

Subsystem ENDEVOR inventory location. Accepts 1-8 characters or '/' for

prompt

Type ENDEVOR inventory location. Accepts 1-8 characters or '/' for

prompt

Element ENDEVOR inventory location. Accepts 1-10 characters.

Stage number ENDEVOR inventory location.

Stage number is limited to a 1, 2 or ‘*’.

Where User ID Accepts 1-8 characters.

Processor Group One to Eight character processor group name.

Package Accepts up to 16 characters.

CCID CCID associated with the element. CCID is related to the CCID
type field.

CCID Type One character CCID type. Valid values are:

C - Current CCID
R - Retrieve CCID
G - Generate CCID
L - Last CCID
D - Delta CCID
A - Any CCID

Delta CCID works the same even if you are using the Reverse
Delta ENDEVOR format.

Version and level

Version Current element version. Accepts values from 1-99. accept either one
or two character
Level Current element level. Accepts values from 0-99. numeric values.

ISPF Interface 2-11

FastLIST ISPF User Guide
 LVLS? Accepts a Y or N value.

Y” will cause all element levels that match the search criteria to be
displayed on the main panel. “N” will cause only the current level
to be displayed.

Dates? Accepts a Y or an N value.

If set to "Y", you will be prompted with the following options

panel (Figure 2.6). Use this panel to enter "where date equals"
search criteria. Use of this criteria requires specifying date and time
fields and identifying the date/time type. The variables on this
panel are reset to blanks and the DATES? field will be set to N
every time you initialize FastLIST.

GenFail Accepts a Y or an N value.

“Y” will cause only those elements assigned the Generate Failed
status to be displayed on the main panel. “N” will result in the
search ignoring the Generate Failed status when performing the
FastLIST database search.

Include Indirect
Comps? Accepts a Y or an N value.

“Y” will cause components indirectly related to an element to be

displayed on the main panel. “N” will cause only those elements
which satisfy search criteria to be displayed on the main panel. See
chapter 1 for a discussion of indirect components.

2-12 ISPF Interface

FastLIST ISPF User Guide
---------------------------- FASTLIST WORKBENCH ----------------------------
O DATE AND TIME SEARCH oll ==> CSR
OPTION ==> lect option:
_ Append
ENTER THE DATE, TIME AND TYPE.
ONLY DATE AND TYPE ARE REQUIRED.
= =============
DATE FORMAT IS YY/MM/DD.
rences
= WHERE DATE. . . THROUGH DATE. . . =============
" s (VV.LL)
- TIME FORMAT IS HH:MM. -------------
* *************
WHERE TIME. . . THROUGH TIME. . .

DATE TYPE . . . . G (C,G,L,D)

(CUR,GEN,LAST,OR DELTA)

END = CANCEL ENTER = PROCESS PFK1 = HELP

Figure 2.6
Where Date and Time Equals Panel

FastLIST supports century windowing on date range queries and

date processing. The ISPF and batch interfaces have been
modified to include a 52 based windowing technique, meaning that
all two-digit year fields below 52 will be processed as 21st century
dates, and all two-digit year fields above 52 will be processed as
20th century dates.

Field Description

Date The start of range date or only date. YY/MM/DD format.

Thrudate Optional. End of date range. YY/MM/DD format.

Time Optional start of range time or only time. HH:MM format.

Thrutime Optional. End of date range. HH:MM format

Datetype One character date type. The choices are as follows:

G - Element Generate Date/Time

D - Element DELTA Date/Time (includes current source)
L - Last Element Modification Date/Time
C - Current Date/Time for the element

ISPF Interface 2-13

FastLIST ISPF User Guide
Query Prompt Panel: External Datasets

If the user requests an External Dataset List Type (or a combination list of Endevor
elements and External Dataset members) and the Filters option is selected on the main
panel, then the following prompt panel will be displayed. Instead of seeing ENDEVOR
inventory information in the result area the dataset will be displayed. By selecting the
Append option the content of multiple datasets can be displayed together. Note that
Component searches and Endevor filter criteria do not apply to External Dataset lists.

---------------------------- FASTLIST WORKBENCH ----------------------------

O EXTERNAL DATASET FILTER SETTING oll ==> CSR
OPTION ==> lect option:
_ Append
DSN. . . 'CIGT.TEST.PDS'

= =============
END = CANCEL ENTER = PROCESS OPTION PFK1 = HELP
rences
= =============
"/" Element Type Environ S System Subsys (VV.LL)
--- ---------- ------------ ---------------------------------------------------
******************************* Bottom of data ********************************
Figure 2.7
External Dataset Prompt Panel

Field Description

Dsn Dataset name for member list. If not in quotes, then the user id will
be added to the front of the dataset name.

2-14 ISPF Interface

FastLIST ISPF User Guide
Result Area

The Area shows a list of all Endevor elements or PDS members which match your search
criteria. Search criteria are specified in the Query Area of the main panel as well as in the
ENDEVOR Filter Setting and External Dataset Filter Setting panels.

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . B (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)

===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
CIGRLOCM ASM TEST 2 FASTLIST R2M0 (01.01)
CIGR2000 ASM TEST 2 FASTLIST R2M0 (01.03)
CIGVARS ASM TEST 2 FASTLIST R2M0 (01.07)
CIGVINIT ASM TEST 2 FASTLIST R2M0 (01.00)
CIGVUPDT ASM TEST 2 FASTLIST R2M0 (01.03)
CIGBSCL CIGT.SOJR01.SRCLIB
CIGFBDAT CIGT.SOJR01.SRCLIB

Figure 2.8
Result Area Result Area of the Main Panel

There are several line commands supported by FastLIST. The following is a brief
description of each one.

PDS Line Commands

• E - Edit a PDS Member

• B - Browse a PDS Member.

ISPF Interface 2-15

FastLIST ISPF User Guide
 ENDEVOR Display Line Commands - The standard set of ENDEVOR Display line
commands are supported.

• B - Browse ENDEVOR element.

• S - Browse element summary of levels.
• H - Browse element history.
• C - Browse element changes
• M - Browse master record.
• BX - Browse component list.
• CX - Browse component changes.
• HX- Browse component history.
• S - Browse component level summary.
• BL - Browse ENDEVOR listing.

Entering any of these line commands in the field to the far left of an element and pressing
<Enter> will perform the desired command.

In addition to the ENDEVOR display functions, FastLIST supports the following actions
at the element level:

• E - Edit an element
• A - Add
• U - Update
• G - Generate
• R - Retrieve
• # - Delete
• O - Move
• T - Transfer
• SI - Signin

These commands are invoked by selecting the element to process from the list with the
appropriate ENDEVOR action character, or by selecting the element with a '/' to display
the Line Action Prompt panel. These actions can be processed in batch, foreground, or
used to build SCL for later use. The actions can be used in any combination. Add and
Update can be invoked on PDS members.

List Content Line Commands - There are two line commands used to control the scope
of Group Actions.

• X - EXCLUDES the element from SCL processing.

• I - INCLUDES the element in SCL processing, resetting a previous EXCLUDE.

By default, Group Actions apply to the full content of the current list. The Exclude
command prevents an element from being included in the Group Action processing.

2-16 ISPF Interface

FastLIST ISPF User Guide
 Line Command Example: Editing an Element

The following figure (Figure 2.9) depicts a line command request to edit an element.
After pressing <Enter>, you will be prompted with the line edit retrieve pop panel.

Step 1: Place an E in front of the Element to Edit.

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
Edit --- ---------- ------------ ---------------------------------------------------
E CIGGHJ04 JCL SPAIN 2 FASTLIST R2M0 (01.34)
action CIGISPF1 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF2 ASM SPAIN 2 FASTLIST R2M0 (01.05)
CIGISPF3 ASM SPAIN 2 FASTLIST R2M0 (01.03)
CIGISPF4 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF5 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF6 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF7 ASM SPAIN 2 FASTLIST R2M0 (01.02)
CIGISPF8 ASM SPAIN 2 FASTLIST R2M0 (01.07)
Figure 2.9
Edit Request Example

ISPF Interface 2-17

FastLIST ISPF User Guide
Step 2: Fill in Line Edit Retrieve Options

---------------------------- FASTLIST WORKBENCH ----------- Row 1 to 5 of 5

O LINE EDIT RETRIEVE OPTIONS oll ==> CSR

OPTION ==> lect option:

RETRIEVE OPTIONS: PROMPT AGAIN? . . . Y

OVERRIDE SIGNOUT . . Y REPLACE MEMBER. . . N
= COPY ONLY. . . . . . N EXPAND INCLUDES . . N =============
SEARCH MAP . . . . . N RETRIEVE TO DSN . . N
CCID. . . . rences
= COMMENT . . =============
" s (VV.LL)
- TODSN . . . 'CIGT.TEST.PDS' -------------
E (01.06)
SCL DSN . . 'CIGT.TEST.PDS' (01.10)
SCL MEM . . RETRIEVE (01.11)
(01.08)
END = CANCEL ENTER = PROCESS OPTION PFK1 = HELP (01.01)
* *************

Figure 2.10
Line Edit Prompt

From this prompt panel, users can set various ENDEVOR retrieve options. These options
are fully documented in the CA-ENDEVOR for MVS documentation. Users should set
CCIDs and all other appropriate values for the retrieve.

One default option is to retrieve to a temporary dataset. If the user wants to retrieve to a
permanent dataset, then they must fill in the TODSN value.

The SCL dataset name (DSN) and member name

(MEM) must be filled in with valid information, since
this SCL is used to perform the ENDEVOR action.

2-18 ISPF Interface

FastLIST ISPF User Guide
Step 3: Edit the Element

Once all values are entered, press END. The element will be retrieved and presented to
the user in edit mode, as seen in the following diagram.

CIGEDIT--- CIGGHJ04/SPAIN/FASTLIST/R2M0/JCL/2 (01.00)-------- COLUMNS 000 000

COMMAND ===> SCROLL ===> PAGE
****** ***************************** Top of Data ******************************
000001 //**JOBCARD
000002 //**
000003 //* ----------------------------------------------------------------- *
000004 //* NAME: CIGGHJ04 *
000005 //* PURPOSE: RUN THE TRANSLATE AND ADD BACK UTILITY *
000006 //* ----------------------------------------------------------------- *
000007 //* MODIFY THE JCL IN THE FOLLOWING WAYS: *
000008 //* 1) ADD A VALID JOB CARD *
000009 //* 2) MAKE SURE THE STEPLIB POINTS TO THE CIGINI AND THE *
000010 //* CIGFEXEC LOADMODS. IF THESE MODULES ARE IN THE LINKLST *
000011 //* THEN A STEPLIB IS NOT NEEDED. *
000012 //* 3) MODIFY DUNIT TO POINT TO A VALID UNIT VALUE FOR TEMPORARY *
000013 //* WORK FILES. IF YOU WANT TO SAVE THE ENDEVOR OR PDM SYNTAX *
000014 //* THEN MODIFY THE ALLOCATIONS TO POINT TO PERMANENT FILE. *
000015 //* ----------------------------------------------------------------- *
000016 //STEP1 EXEC PGM=CIGFEXEC,PARM='CIGXLATE'
000017 //STEPLIB DD DSN=FLHQ1.FLHQ2.LOADLIB,DISP=SHR
000018 //* ----------------------------------------------------------------- *
000019 //* ENDEVOR SYNTAX DDNAME. *
000020 //* BSTIPT01 IS THE DDNAME USED TO BUILD ENDEVOR SCL. *
000021 //* THE ADD ACTION IS THE DEFAULT. *
Figure 2.11
Element Edit Example

Once the user has completed the updates, press END to add the element back into
ENDEVOR. A CANCEL command will cancel the update. The following panel will be
displayed prior to adding the element back.

ISPF Interface 2-19

FastLIST ISPF User Guide
Step 4: Save (Add back) the element into ENDEVOR

---------------------------- FASTLIST WORKBENCH ----------- Row 1 to 7 of 7

O LINE EDIT ADD BACK OPTIONS oll ==> CSR

OPTION ==> lect option:
_ Append
ADD BACK OPTIONS: PROMPT AGAIN?. . . . . Y Switch
TO ENV. . . SPAIN OVERRIDE SIGNOUT . . . Y MAC
= SYS. . . FASTLIST GENERATE ELEMENT . . . Y =============
SBS. . . R2M0 DELETE SOURCE. . . . . Y
TYPE . . JCL UPDATE IF PRESENT. . . Y rences
= PROCESSOR GROUP. . . . =============
" CCID. . . . GENERATE IN BATCH. N. . s (VV.LL)
- COMMENT . . -------------
E (01.06)
SCL DSN . . 'CIGT.TEST.PDS' (01.03)
SCL MEM . . RETRIEVE (01.10)
(01.11)
END = CANCEL ENTER = PROCESS OPTION PFK1 = HELP (01.08)
(01.04)
(01.01)
******************************* Bottom of data ********************************
Figure 2.12
Add Back Prompt

The CA-ENDEVOR Add options are fully documented in the CA-ENDEVOR for MVS
documentation.

All FastLIST edit actions result in a foreground ADD action in ENDEVOR. The
“GENERATE IN BATCH” option controls whether to submit the associated generate
action separately as a batch job. After entering desired options, press <Enter> to process
and return to the main panel. Pressing END at this panel will cancel the ADD action
completely.

The SCL Dataset name (DSN) and member name

(MEM) must be filled in with valid information, since
this SCL is used to perform the ENDEVOR action.

2-20 ISPF Interface

FastLIST ISPF User Guide
Print Support

The Print Action

The Print action is a batch-only action. To perform print-type commands in the
foreground, the user should use line commands 1 through 10 from the line command
prompt panel, shown previously. The print command can be used with execute modes
batch, SCL, and batch packages.

The prompt panel for the Print command is as follows:

---------------------------- FASTLIST WORKBENCH --------------- Row 1 of 15

O .------------------- PRINT COMMAND PROMPT --------------------. oll ==> PAGE
| OPTION ==> | lect option:
| | _ Append
| Select one of the print options below and press enter: |
= | | =============
| __ B. Print element source ( DEFAULT ) |
| M. Print element master | rences
= | H. Print element history | =============
" | S. Print element summary | s (VV.LL)
- | C. Print element changes | -------------
| BX. Print component list | (01.00)
| HX. Print component history | (01.03)
| SX. Print component summary | (01.01)
| CX. Print component changes | (01.00)
| | (01.00)
| SCL Dsn . . 'CIGT.XIFR01.JCLLIB' | (01.00)
| SCL Mem . . DDDDD | (01.00)
| | (01.01)
| End = Cancel Enter = Process option PFK1 = Help | (01.00)
| | (01.03)
| | (01.00)
'-------------------------------------------------------------' (01.00)
ZTEST7 ASM TEST 1 SYSA SUBA (01.01)

Figure 2.13 Print command prompt panel

ISPF Interface 2-21

FastLIST ISPF User Guide
 Other Line Command Examples:

In the example below, the user has requested Generate, Delete, Retrieve, Transfer, and
Move actions on five elements, all from one panel. Each action will be processed in
sequence. If any action encounters an error, processing of subsequent actions will be
stopped and appropriate error messages will be displayed.

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
Generate “/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
action G CIGISPF ASM SPAIN 2 FASTLIST R2M0 (01.34)
CIGISPF1 ASM SPAIN 2 FASTLIST R2M0 (01.00)
Delete # CIGISPF2 ASM SPAIN 2 FASTLIST R2M0 (01.05)
CIGISPF3 ASM SPAIN 2 FASTLIST R2M0 (01.03)
Action R CIGISPF4 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF5 ASM SPAIN 2 FASTLIST R2M0 (01.01)
Retrieve T CIGISPF6 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF7 ASM SPAIN 2 FASTLIST R2M0 (01.02)
action O CIGISPF8 ASM SPAIN 2 FASTLIST R2M0 (01.07)
Figure 2.14 Multiple Actions
Transfer Move
action action

2-22 ISPF Interface

FastLIST ISPF User Guide
Browsing ENDEVOR Listings

To browse an ENDEVOR listing, the user enters a BL next to an element name on the
table list. The following figure shows an example of a listing request.

Step 1: Specify Browse Listing on the line action area.

---------------------------- FASTLIST WORKBENCH ----------------------------
OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. . LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
BL CIGISPF ASM SPAIN 2 FASTLIST R2M0 (01.34)
CIGISPF1 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF2 ASM SPAIN 2 FASTLIST R2M0 (01.05)
CIGISPF3 ASM SPAIN 2 FASTLIST R2M0 (01.03)
CIGISPF4 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF5 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF6 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF7 ASM SPAIN 2 FASTLIST R2M0 (01.02)
CIGISPF8 ASM SPAIN 2 FASTLIST R2M0 (01.07)
Figure 2.15 Example of Browse Listing Request

If you have coded your processor to monitor the listing as an output component, the
system will query the FastLIST database for an output component that is a listing. If a
listing component type is sent back, then the dataset associated with the component
record will be used. If the listing is not monitored, then you will be prompted to enter in
an ENDEVOR dataset name as in Figure 2.15.

Compressed listings stored in CA-ENDEVOR E-Lib

datasets cannot be viewed through this facility.

ISPF Interface 2-23

FastLIST ISPF User Guide
Step 2: Specify the ENDEVOR Listing Dataset

---------------------------- FASTLIST WORKBENCH ----------- Row 1 to 7 of 7

O .---------------- LINE EDIT ADD BACK OPTIONS -----------------. oll ==> CSR
| -------------- LISTING DATASET ENTRY PANEL --------------- | lect option:
| OPTION ==> | _ Append
| | Switch
| ENTER IN THE NAME OF THE ENDEVOR LISTING DATASET. | MAC
= | | =============
| DSN ==> 'CIGT.LISTING.DATASET' |
| | rences
= | | =============
" | END = CANCEL ENTER = PROCESS OPTION PFK1 = HELP | s (VV.LL)
- | | -------------
B '-------------------------------------------------------------' (01.06)
CIGFIELD ASM SPAIN 1 FASTLIST R2M0 (01.03)
CIGFLOD1 ASM SPAIN 1 FASTLIST R2M0 (01.10)
CIGFLOD2 ASM SPAIN 1 FASTLIST R2M0 (01.11)
CIGFLOD2 ASM SPAIN 2 FASTLIST R2M0 (01.08)
CIGIJSAV ASM SPAIN 1 FASTLIST R2M0 (01.04)
CIGQDBSW IPANELS SPAIN 2 FASTLIST R2M0 (01.01)
******************************* Bottom of data ********************************
Figure 2.16 Listing Dataset Entry Panel

This panel is processed somewhat differently than the other dataset prompt panels. Like
the other panels, the system will append the user id in front of the dataset, if there are no
quotes. However, the system will not attempt to allocate or validate the file, because the
dataset is usually owned by ENDEVOR and not available to non-ENDEVOR access.

The system will take this dataset name and access the listing through an ENDEVOR print
action. The result of the action will be displayed in a standard ISPF browse session. When
done with the listing, press END to return to the main FastLIST menu.

2-24 ISPF Interface

FastLIST ISPF User Guide
Action Area: Performing ENDEVOR Group Actions

In addition to being able to perform all major Endevor actions against individual elements
listed in the Result Area, you can also perform Group actions, by typing a ‘/’ in the Group
Action field as shown below.

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. CIG*. LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
/ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
CIGISPF ASM SPAIN 2 FASTLIST R2M0 (01.34)
CIGISPF1 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF2 ASM SPAIN 2 FASTLIST R2M0 (01.05)
CIGISPF3 ASM SPAIN 2 FASTLIST R2M0 (01.03)
CIGISPF4 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF5 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF6 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF7 ASM SPAIN 2 FASTLIST R2M0 (01.02)
CIGISPF8 ASM SPAIN 2 FASTLIST R2M0 (01.07)
Figure 2.17 ENDEVOR Group Actions

ISPF Interface 2-25

FastLIST ISPF User Guide
Example: Generate Actions

When the user selects the GENERATE command in the group action field, the following
prompt panel is displayed. There are some special functions on the generate panel that
should be pointed out. The set copyback location option will allow the user to specify a
target location for copyback. If the user specifies COPY BACK = Y, and they specify
SET COPYBACK LOC = Y, then the system will override the current inventory values
for the elements.

O
LINE COMMAND GENERATE OPTION PROMPT oll ==> CSR
OPTION ==> lect option:
_ Append
FROM ENV. . . SPAIN Switch
SYS. . . FASTLIST MAC
= SBS. . . R2M0 =============
TYPE . . JCL
STG# . . 2 rences
= ELEMENT. CIGDBJ01 =============
" s (VV.LL)
- REGULAR OPTIONS: COPYBACK LOCATION: -------------
G OVERRIDE SIGNOUT . . Y ENV. . . (01.06)
SEARCH MAP . . . . . N SYS. . . (01.03)
PROCESSOR GROUP. . . SBS. . . (01.10)
COPY BACK. . . . . . N TYPE . . (01.11)
SET COPYBACK LOC . . N (Y/N) STG. . . (01.08)
(01.04)
CCID. . . . (01.01)
* COMMENT . . *************

END = CANCEL ENTER = PROCESS OPTION PFK1 = HELP

Figure 2.18 Explanation of Copyback Feature

Prior to displaying the panel, the system, subsystem, and type fields will always be
cleared. It is advised that you not use these fields unless generating all elements of the
same type and the target inventory definitions change lower in the map. A typical usage
of this feature would be to create a list of elements that use a macro/copybook. Once that
list is available, you would request a GENERATE with copyback, setting the location to
stage 1 in the test regions.

2-26 ISPF Interface

FastLIST ISPF User Guide
User Action Support

The User Action

The purpose of the User Action is to extend FastLIST to support user-built functionality.
Once a list of Endevor elements has been built, the users can enter the name of a user
function (an ISPF skeleton name) provided by their systems administrator. The model
User Action skeleton is called CIGUSER0. This skeleton has no functionality, is it used
only as a model. Examples of User Action processing would include FDELETE, FLIST,
FLOAD, and more.

The User Action is supported only in Batch mode. If the User Action is selected then
FastLIST automatically sets the execution mode to batch, regardless of the prompt panel
setting.

The prompt panel for the User Action command is as follows:

CIG@PRM0 ------------------- FASTLIST WORKBENCH --------------- Row 1 of 15

O .-------------- User Defined Action Panel ---------------. Scroll ==> PAGE
| CIGUSER4 => | to select option:
| | rs _ Append
| Enter a qualified User Action skeleton name below |
= | and press enter. You will then be prompted to Edit | ==================
| and Submit the JCL. |
| | Preferences
= | User Action skeleton name. . . DDDUSER1 | ==================
" | | Subsys (VV.LL)
- | | ------------------
| Press PFK1 for more information on User Actions. | SUBA (01.00)
| | SUBA (01.03)
| | SUBA (01.01)
| End = Cancel Enter = Process PF1 = Help | SUBA (01.00)
| | SUBA (01.00)
| | SUBA (01.00)
| | SUBA (01.00)
| | SUBA (01.01)
| | SUBA (01.00)
'--------------------------------------------------------' SUBA (01.03)
ZTEST6 ASM TEST 1 SYSA SUBA (01.00)
ZTEST6 ASM TEST 2 SYSA SUBA (01.00)
ZTEST7 ASM TEST 1 SYSA SUBA (01.01)

Figure 2.19 User Defined Action panel

The model User Action skeleton, CIGUSER0, is included in the FastLIST Batch User
Guide and is meant only as a starting point for building other User Actions.

ISPF Interface 2-27

FastLIST ISPF User Guide
Running Actions in Batch

Submitting actions for multiple elements is as simple as specifying the action desired,
confirming the options to be used in the actions, and allowing the job to submit. The
process of steps for performing these actions are:

Step 1: Set Your Job card.

Select the JCL function in the Group Action area to display the JCL Setup panel. Space
is provided for four jobcards that will be used for batch job execution. Depending on
how the product has been installed, these may be filled with the same values used by
ENDEVOR. More information on this option is available in the “JCL and Job Card
Setup” section below.

Step 2: Build the list of elements to be processed.

Using the LIST ELEMENT option on the FastLIST main panel, identify the elements you
wish to invoke the action on. The content of the list is important because the Group
Action selected will apply to all elements listed unless they are specifically excluded.

---------------------------- FASTLIST WORKBENCH ----------------------------

OPTION ==> SCROLL ==> PAGE

ENTER “/” TO SELECT OPTION:

LIST ELEMENT. .CIG* LIST TYPE . E (E/X/B) _ SHOW FILTERS _ APPEND
WHERE COMPONENT. COMP TYPE . X (I/O/P/X)
===============================================================================
ENTER “/” TO SELECT FUNCTION BELOW OR LINE COMMAND:
_ GROUP ACTION _ JCL _ MSGS _ REPORTS _ PREFERENCES
===============================================================================
“/” ELEMENT TYPE ENVIRON S SYSTEM SUBSYS (VV.LL)
--- ---------- ------------ ---------------------------------------------------
CIGISPF ASM SPAIN 2 FASTLIST R2M0 (01.34)
CIGISPF1 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF2 ASM SPAIN 2 FASTLIST R2M0 (01.05)
CIGISPF3 ASM SPAIN 2 FASTLIST R2M0 (01.03)
CIGISPF4 ASM SPAIN 2 FASTLIST R2M0 (01.00)
CIGISPF5 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF6 ASM SPAIN 2 FASTLIST R2M0 (01.01)
CIGISPF7 ASM SPAIN 2 FASTLIST R2M0 (01.02)
CIGISPF8 ASM SPAIN 2 FASTLIST R2M0 (01.07)
Figure 2.18 Building an element list

2-28 ISPF Interface

FastLIST ISPF User Guide
Step 3: Type ‘/’ in the Group Action field.

Entering this action signals FastLIST to bring up the Group Mode Action Request panel,
where you will select an action. The Execution Options control whether the job will be
submitted in Batch, Foreground, or Not submitted at all.

To submit the action in batch, after specifying the action to be performed, Select
Execution Option 1, Batch, and press <Enter>.

---------------------------- FASTLIST WORKBENCH --------- Row 1 to 13 of 88

O Group Mode Action Request Scroll ==> CSR
Option ==> to select option:
rs _ Append
Actions: Execution Options:
= ==================
__ 1. Add...........A 2 1. Batch
2. Update........U 2. Batch packages Preferences
= 3. Retrieve..... R 3. Foreground ==================
" 4. Generate..... G 4. SCL only Subsys (VV.LL)
- 5. Move......... O ------------------
6. Delete....... # Enter "/" to select option: TESTCASE (01.00)
7. Transfer..... T / Edit SCL TESTCASE (01.02)
8. Signin........SI / Option Prompt CIBC (01.00)
9. Search........SR / Edit JCL TESTCASE (00.45)
10. Print.........P TESTCASE (00.03)
11. User Action…..UA TESTCASE (01.00)
CIBC (01.00)
Select an action and other optional settings CIBC (01.03)
and then press ENTER to process. TESTCASE (00.45)
BETACCCC TESTDATA GREEN 1 INTERNAL TESTCASE (00.45)
BETADDDD TESTDATA GREEN 2 INTERNAL TESTCASE (01.00)
BETADDDD TESTDATA GREEN 1 INTERNAL TESTCASE (00.45)

Figure 2.19 Selecting an Action in batch

ISPF Interface 2-29

FastLIST ISPF User Guide
JCL and Job Card Setup

Step 1: Set Your Job Card.

Actions submitted in batch from the FastLIST screens utilize three file tailoring
skeletons:

1. C1SB3000
2. CESSRCH
3. C@SBATPK

Any variables required by ENDEVOR to expand these skeletons are available in

FastLIST. To include the message and trace ddnames from FastLIST into any of
these skeletons, modify the "additional JCL" variables from the JCL panel as in
the example below.

Additional JCL is always included in job submissions,

so remember to comment out any DD statements that
are not regularly needed.

---------------- JCL SETTING FOR FILE TAILORING ----ROW 1 TO 8 OF 20

COMMAND ===>

END = RETURN AND SAVE PFK1 = HELP

JOB CARDS FOR ALL FILE TAILORING:

======> //CIG01A JOB (810001),'CIG-,CLASS=4,MSGCLASS=H,NOTIFY=CIG01,
======> // REGION=0M
======> //*
======> //*

SCL DSN: 'CIGT.TEST.PDS'

MEMBER: TEMP

ADDITIONAL JCL FOR ALL FILE TAILORING:

======> //CIGOUT DD SYSOUT=*
======> //CIGTRACE DD DUMMY
======> //*IGINI DD DISP=SHR,DSN=CIGT.XIFR01.LOADLIB(BIGDATA)
======>
======>
======>
======>
======>

Figure 2.20
JCL Skeleton

2-30 ISPF Interface

FastLIST ISPF User Guide
Setting Your Preferences from the Action Area

The Preferences Panel contains many of the user defaults for option settings, default
inventory locations for searches, sources, and more.

--------------------- FASTLIST OPTION DEFAULT SETTINGS --------------------

OPTION ==>

THIS PANEL DISPLAYS THE CURRENT SETTING FOR EACH OF THE ENDEVOR AND FASTLIST
OPTIONS. USERS CAN MODIFY VALUES ON THIS PANEL, OR WAIT UNTIL PROMPTED.

FASTLIST OPTIONS:
LIST TYPE ==> B FILTER PROMPT ==> Y OPTION PROMPT ==> Y EXEC MODE ==> B

LINE EDIT OPTIONS:

BATCH GENERATE ==> Y RETRIEVE TO DSN ==> N PROMPT AGAIN? ==> Y

ENDEVOR OPTIONS:
OVERRIDE SIGNOUT ==> Y SEARCH MAP ==> N SYNC ==> N
COPY ONLY ==> Y COPYBACK ==> N JUMP ==> N
REPLACE MEMBER ==> N GENERATE ELEMENT ==> Y WITH HISTORY ==> N
EXPAND INCLUDES ==> N DELETE SOURCE ==> N UPDATE IF ==> N
SIGNIN ==> Y DELETE ELEMENT ==> Y RUN DEL PROC ==> Y
RETAIN SIGNOUT ==> N IGNORE GEN FAIL ==> N DEL COMP ONLY ==> N
SIGNOUT TO USER ==> PROCESSOR GROUP EQ ==>

SCL REQUEST DATASET: 'CIGT.TEST.PDS'

SCL REQUEST MEMBER: TEMP

Figure 2.21
The Preferences Panel

FastLIST Options

List Type The default list type for FastLIST. Options are E (ENDEVOR), X
(external dataset), or B (both).

Filter Prompt The default value for the filter flag.

Option Prompt The default value of the Option prompt.

Exec Mode The default submission mode for actions.

ISPF Interface 2-31

FastLIST ISPF User Guide
 Line Edit Options

Batch Generate The default value for the Batch Generate option on the Add action
options panel.

Retrieve to DSN The default value for what type of dataset to retrieve into,
temporary or permanent.

Prompt Again? The default value for the Prompt Again option on the Line Edit
options panel. This option controls whether the same options are
to be used when multiple elements are selected for editing.

ENDEVOR Options

The ENDEVOR options are identical to the options available in the ENDEVOR product
and are fully described in the CA-ENDEVOR for MVS documentation.

2-32 ISPF Interface

FastLIST ISPF User Guide
Requesting FastLIST Reports from the Action Area

The user can also request FastLIST reports from the ENDEVOR ISPF Interface. Select
the Reports function in the Group Action area and press <Enter>. The FastLIST reports
selection screen will be displayed. If the user has also installed the SOJOURN product, an
additional report selection menu will be displayed.

The following figure displays the FastLIST Report Selection Panel. Enter 'S' on one or
more of the report selections and set inventory filters.

---------------------------- FASTLIST WORKBENCH ---------------------------

O STANDARD FASTLIST REPORT SELECTION OLL ==> PAGE

OPTION ==>
==> Y (Y/N)
XREF REPORTS: CURRENT ENDEVOR FILTERS: ==> N (Y/N)
ELEMENT ==>
= _ COMPONENT XREF ENVIRONMENT ==> TEST ============
_ CCID XREF SYSTEM ==> SYSA EDIT? ==> N
_ DATASET XREF SUBSYSTEM ==> SUBA )
= _ OBJECT XREF TYPE ==> MAC ============
_ PROCESSOR GROUP XREF STAGE NUMBER ==>
- PROCESSOR GROUP ==> ------------
* CCID ==> ************
CCID TYPE ==> L (C/G/R/L/D/A)
COMPONENT ==>
COMP TYPE ==> P (I/O/P)

SCL DSN ==> 'CIGT.TEST.PDS'

SCL MEM ==> BETAASM

END = CANCEL ENTER = PROCESS OPTION PKF1 = HELP

Figure 2.22
FastLIST Report Submission Panel

Multiple report requests will be built and submitted in one job. The job card values setup
on the JCL screen will be used for the JCL. Skeleton CIGSKL03 will be used for the file
tailoring. This skeleton should have been modified during implementation.

XREF Reports

Field Description

Current ENDEVOR Filters The fields in this section of the panel control the scope
of the reports by ENDEVOR inventory information. All
options under this heading can be masked or wildcarded.

Summaries Only This option will suppress the detailed content of the
report and produce summary information only.

SCL DSN and Member A valid dataset name and member name are required for
submitting the report request.

ISPF Interface 2-33

FastLIST ISPF User Guide
Using the Package Interface

From the Group Mode Action Request Panel, select Execution Option 2, Batch Package.
You will be prompted with the Create or Modify Package panel shown below in Figure
2.23. Note that unless cancelled, this execution mode will always submit a job to invoke
Batch Package functions to define the package. Additional package functions are
controlled by the package execution options on this prompt panel.

From this panel, you would enter:

! a package ID
" package description, and
# specify which package actions to invoke.

---------------------- CREATE OR MODIFY PACKAGE -------------------

COMMAND ===>

ENTER THE PACKAGE NAME AND DESCRIPTION TO BE USED TO CREATE

! OR MODIFY THE PACKAGE:

PACKAGE ID. . PKG000010

DESCRIPTION . First Quarter Upgrade
"
SET THE FOLLOWING OPTIONS TO CONTROL THE EXTENT OF
PACKAGE EXECUTION:
# _ / TO RESET IF EXISTING PACKAGE.
_ / TO CAST PACKAGE.
_ / TO APPROVE PACKAGE.
_ / TO EXECUTE PACKAGE.
Figure 2.23 Build Package Panel

Package ID: Package name. Accepts up to 16 characters.

Description: Package description. Accepts up to 50 characters.

Package Execution Options:

Reset: Resets an existing package to Endevor IN-EDIT status.

Cast: Locks package to prevent further element modifications.

Approve: Invoke an Approve action on the package after the case

Execute: Invoke a Execute action for the package

2-34 ISPF Interface

FastLIST ISPF User Guide
 ISPF Interface 2-35
FastLIST ISPF User Guide
Table of Figures

Figure 1.1 ISPF Interface..................................................................................................... 1-4

Figure 1.2 The Main Panel................................................................................................... 1-5
Figure 1.3 Impact analysis request ...................................................................................... 1-7
Figure 1.4 Indirect reference example.................................................................................. 1-8
Figure 1.5 Duplicate Element Rules ..................................................................................... 1-9
Figure 1.6 The ENDEVOR Filter panel............................................................................... 1-11
Figure 1.7 Accessing the Date-Range Filter panel ............................................................. 1-12
Figure 1.8 Retrieving listed programs ................................................................................ 1-13
Figure 1.9 Editing a processor from the Main Panel........................................................... 1-14
Figure 1.10 Retrieving listed programs via package processing .......................................... 1-15
Figure 1.11 ENDEVOR Filter Settings ................................................................................. 1-16
Figure 1.12 Displaying a list of programs. ............................................................................ 1-17
Figure 1.13 Implementing Mass Changes through Search and Replace.............................. 1-18
Figure 1.14 Group Scan and Replace Option Prompt .......................................................... 1-19
Figure 2.1 The Main Panel................................................................................................... 2-4
Figure 2.2 The Search Section ............................................................................................ 2-6
Figure 2.3 Main Panel with SOJOURN Implemented ........................................................... 2-8
Figure 2.4 ENDEVOR Filter Settings Panel. ...................................................................... 2-10
Figure 2.5 ENDEVOR Inventory Selection Table ............................................................... 2-10
Figure 2.6 Where Date and Time Equals Panel ................................................................. 2-13
Figure 2.7 External Dataset Prompt Panel ......................................................................... 2-14
Figure 2.8 Result Area of the Main Panel........................................................................... 2-15
Figure 2.9 Edit Request Example....................................................................................... 2-17
Figure 2.10 Line Edit Prompt ............................................................................................... 2-18
Figure 2.11 Element Edit Example....................................................................................... 2-19
Figure 2.12 Add Back Prompt .............................................................................................. 2-20
Figure 2.13 Multiple Actions ................................................................................................. 2-22
Figure 2.14 Example of Browse Listing Request.................................................................. 2-23
Figure 2.15 Listing Dataset Entry Panel ............................................................................... 2-24
Figure 2.16 ENDEVOR Group Actions................................................................................. 2-25
Figure 2.17 Explanation of Copyback Feature ..................................................................... 2-26
Figure 2.18 Building an element list ..................................................................................... 2-28
Figure 2.19 Selecting an Action in batch .............................................................................. 2-29
Figure 2.20 JCL Skeleton..................................................................................................... 2-30
Figure 2.21 The Preferences Panel ..................................................................................... 2-31
Figure 2.22 FastLIST Report Submission Panel .................................................................. 2-33
Figure 2.23 Build Package Panel ......................................................................................... 2-34
FastLIST ISPF User Guide