IDz Workbench Module 1 - Product and Eclipse Overview
IDz Workbench Module 1 - Product and Eclipse Overview
IDz Workbench Module 1 - Product and Eclipse Overview
DevOps
Jon Sayles, IBM - [email protected]
2
Notices and disclaimers continued
Information concerning non-IBM products was IBM, the IBM logo, ibm.com and [names of other
obtained from the suppliers of those products, referenced IBM products and services used in the
their published announcements or other publicly presentation] are trademarks of International
available sources. IBM has not tested Business Machines Corporation, registered in many
those products about this publication and cannot jurisdictions worldwide. Other product and service
confirm the accuracy of performance, compatibility names might be trademarks of IBM or other
or any other claims related to non-IBM products. companies. A current list of IBM trademarks is
available on the Web at “Copyright and trademark
Questions on the capabilities of non-IBM products
information” at:
should be addressed to the suppliers of those
www.ibm.com/legal/copytrade.shtml.
products. IBM does not warrant the quality of any
third-party products, or the ability of any such
third-party products to interoperate with IBM’s
products. IBM expressly disclaims all warranties,
expressed or implied, including but not limited to,
the implied warranties of merchantability and
fitness for a purpose.
The provision of the information contained herein
is not intended to, and does not, grant any right or
license under any IBM patents, copyrights,
trademarks or other intellectual property right.
3
Please Note
IBM’s statements regarding its plans, directions, and intent are subject to change
or withdrawal without notice and at IBM’s sole discretion.
The development, release, and timing of any future features or functionality described
for our products remains at our sole discretion.
"Smart people learn from experience - Very smart people learn from other people's experience."
5
Course Assumptions
1. You know ISPF and have used it for at least two years, doing
production work on z/OS with COBOL, PL/I or Assembler
Note that all of the workshops in this course are in COBOL – although
files exist that are Assembler and other languages for you to experiment
with – as time permits
2. You have:
No experience with Eclipse or IDz
Some experience with PC tools
▪ You have used MS-Windows applications for at least one year
IDz installed and running on your workstation at version 8.0 or later
6
Product Names and Releases
There are three separately named products:
1. RDz Released 2009
▪ RDz’s predecessor solutions (WSED/WSAD) went G.A. in 2003
2. IDz Released 2016
▪ Same client & server software
▪ With functional updates to IDz v9.5
3. ADFz Released 2016
▪ Same client & server software as IDz
▪ Also contains Problem Determination Tools:
– Debug Tool, File Manager
– Fault Analyzer and Application Performance Analyzer
You can use RDz v9.5 or IDz v14 or ADFz in this course. But the
instructor will be demonstrating with the latest release from IBM -
and the client menus you see may be slightly different.
7
Installing the Education Workspace – Needed for the hands-on labs/workshops
1. Download the Education Workspace:
Contact: [email protected] for the URL
3. When the unzip completes, use Windows to find the education_workspace folder
that contains the .metadata subfolder Remember this directory/location
When you launch ADFz/IDz you will be prompted for a Workspace location.
Browse to your folder: education_workspace – the parent folder of .metada
8
Launch IDz and Browse to the education_workspace
▪ From your desktop or the Windows launch IDz
▪ When you are prompted, Browse… to find your education_workspace (prev. slide)
9
Eclipse, IDz and the Custom Workspace
When IDz opens it should look like this screen capture. Of particular importance is the
IDz Tech Portal folder, which contains lab exercise files and other enablement files
10
Ensuring that the
If when you open IDz you see this Welcome Screen instead of the IDz Perspective shown on the
previous slide: 1. Either the custom workspace didn’t unzip correctly or 2. You selected the wrong
folder when you launched the product.
1. In either case, close IDz.
2. Using Windows/Explorer, search for the .metadata folder
3. Re-launch IDz, pointing to the folder directly above .metadata – see slide #6
11
UNIT IDz for ISPF Developers
Topics:
▪ The IDz Workbench and – Terms and Concepts
▪ IDz & Eclipse – IDE Navigation
12
Topic objectives
After completing this topic, you should be able to:
Describe the essential IDz terms and vocabulary – as they relate back to ISPF:
▪ View
▪ Perspective
▪ Menus
– Context menu
– Toolbar menus
Work with Views:
▪ Define "view"
▪ Maximize/Minimize/Open/Close/Resize different workbench views
Work with Perspectives:
▪ Define "perspective"
▪ Switch perspectives
▪ Reset (to their installation defaults)
Work with a graphical mouse
Access the help system
13
What is IBM Developer for System z (What is IDz)?
A modern z/OS IDE that breaks the barriers of green-screen technology
▪ Runs on Windows, Linux, or Mac
▪ Integration with TSO/ISPF Application Development tools
MVS Resources
IDz Listener
IDz Client Software Started Task • z/OS Datasets
• JES
• TSO
JDBC • CICS Region
• IMS Region
• SCM
Security/Authorization
• CLISTs/REXX
RACF/ACF-2/Top Secret
Data Resources
• DB2 Data Objects
• IMS Databases
SOA/Web Services
Enterprise Remote and Local Search
API Integration Application Analysis IDz Static Analysis Tooling
Continuous Integration Modernization
Parallel/Agile Lifecycle
Development
Language Sensitive Editors
Construction COBOL, PL/I, JCL, SQL,
Assembler, REXX/CLIST,
Access to your shop’s BMS,MFS Graphical Editors
custom ISPF Tools is Code Review
available from within IDz 15
What’s in it for me?
Work Made Easier
Graphical analytics – reveal program semantics
Instead of learning through laborious line-by-line code examination
Hyper-linked access to locations within a file – simplifies navigation
▪ Single click workflow - instead of: TypeType:F2/F9/TypeType:F7/F8/F7/TypeTypeTypeType:F2/F9 workflow
Generated of SOA and API application components
▪ Instead of complex manual development projects and tasks
Superfluous tasks simplified or reduced
▪ Auto-commenting code, SPUFI/SQL code-test eliminated, GUI-bookmarking, Content-Assist, multiple file
organization methods and dozens of other features reduce or eliminate mundane repetitive workflow
Manual tasks turned into “Declarative Development”
▪ Graphical BMS/MFS map development/maintenance
▪ DB2 Stored Procedures generated through wizards
▪ Career future-proofing
None of the z/OS software vendors are investing in green-screen tooling – but they’re all
investing heavily in Eclipse-based solutions
▪ IDz is IBM’s Eclipse-based IDE
Unless you’re planning to retire in the next 6 months you will likely run into projects that
require Eclipse skills & experience
Which you will obtain by learning/using IDz – Start now … Learn IDz and get a
jump on tomorrow’s Eclipse assignments, projects and tools
16
Learning IDz
To become productive using IDz:
1. Get good at using a mouse for code development
product navigation window manipulation and selection actions
2. Familiarize yourself with the IDz Workbench terms, concepts
& organization; Menus, Views, Perspectives, Toolbars
▪ Understand the differences between 3270-technology & IDz’s Eclipse
development patterns, terms, concepts, features, facilities
▪ Translate your existing development techniques to use IDz and learn some
new ones
“Hear and you forget; See and you remember; Do and you understand”
Confucius, circa 500 BC
17
How to take this class
Course
Workshops
1. Attend class:
- Ask questions 2. Do the exercises Application
- Follow the product workflow in Labs.pdf:
3. Apply the
- Identify the terms, concepts - Iterate thru the workflow
& vocabulary - and relate the and practice the tool navigation techniques to your
IDz tools/techniques to ISPF (build eclipse muscle memory) App-Dev projects:
- Discover the productivity - Commit the U.I. and product - Master the product workflow
features layout to memory & navigation
- Explore features both covered - Gain more productivity and
and not covered during class speed over time, and use the
features to improve application
quality
IMPORTANT NOTE:
If while you are taking this class your find that you do not have the time to complete the
workshops between sessions:
Do what you can to follow the instructor's demo during class - and ask questions
Show up 15 minutes early to each session - ask questions, listen to others' questions
At the end of each session we will take 15 minutes to cover additional productivity topics
FWIW - You can re-take any module in this course during a scheduled Entry Level training class
18
z/OS Development with 3270-Data Stream Tools
▪ 3270-based tools consist entirely of:
Typing
Familiarity with ISPF:
▪ Panels/Dialogs
▪ Commands
Do you know who the U.S. president was when ISPF was first released?
19
z/OS Development - with IDz
▪ Using IDz the development paradigm changes to:
Using a Graphical/Windowed IDE (Eclipse)
Cutting-edge tools – that scale to the complexity of modern z/OS development
tasks & standards
▪ When you launch IDz from your desktop it prompts you for a "workspace"
A "workspace" is the highest-level folder on your workstation that contains:
1. Development environment meta-data: ISPF Option 0
– Workbench “state” – how things looked when you last closed IDz
– Your development preferences and settings
– Your z/OS connection information and other “side files” (Property Groups, etc.)
Workstation
Hard-drive
C:\education_workspace C:\education_workspace
Education
Workspace
21
Terms and Concepts: Menus & Toolbars
In IDz you often use menus and menu shortcuts called Toolbars
Menu ➔
Toolbar ➔
A Toolbar is simply a Windows shortcut to useful IDz menu actions. Toolbars can
be customized to suit the functionality you access regularly
22
Terms and Concepts: “Context Menu”
You will frequently access the “Context Menu” by: 1. Selecting something then
2. Pressing the Right-Mouse button
Right-mouse or "Context"
Menu
Speedy access to the available actions
specific to the selected element:
▪ Delete
▪ Search
▪ Move
▪ Copy
▪ Rename
▪ …
23
Terms and Concepts: “View”
The workbench
is organized as a
collection of
tabbed resize- ASAMDRV.cbl
able windows
called z/OS
“Views” Projects Remote
Views
View Systems
View
Views display
information or
provide access to
IDz functionality
specific to the
View title (tab):
- Remote Systems
- Local projects
- Syntax errors
- Program Outline
- Dataset editors
- Analysis tools Outline View
- Debug Monitors
- DB2 Tables All the Views that you see above are
- SQL statement
organized into a “Perspective”
results
- etc.
24
Terms and Concepts: “Perspective”
A Perspective is a named collection of Views organized around a development task:
z/OS project work, Debugging programs, Writing/Testing Java, Writing/Testing SQL, etc.
26
Mouse-style GUI z/OS Development – for Veteran ISPF Developers
You will use Windows/GUI development techniques with IDz:
Type statements using the Editor and use Hot Keys to perform certain functions.
Navigate through wizards, through your source files and do other development
activities with your mouse – and you will make liberal use of the Context Menu
Left-mouse button
Right-mouse button
Select some thing
- Click – to set focus to or to select a field Opens the “Context menu”
- Select a file in the Editor - From a program in the Editor Area
Scroll-bar manipulation - Open a Declaration or Copybook
- Syntax Check
Double-click a file to open it in the Editor - Rename/factor
- Copy/Paste/Move/Delete code
Open a Workbench menu (at the top)
27
The location of your source code
▪ In the first few modules of this course you will learn Local
how to navigate the Workbench, and how to Files
And
analyze and edit COBOL source programs Datasets
Folders ➔
Files ➔
29
Navigating within a File
You can also select the bottom window border. Left-click and hold + drag to make the
window's height larger
▪ Note that if you’ve made any changes to a file in the editor, you will be
prompted to save
IDz view resizing is similar to but much more flexible than setting emulation screen
resolution/size (24X80, 32X80, etc.)
31
Maximize and Restore Views
It's often useful to maximize and
restore views for various
development tasks.
▪ Steps:
To maximize a view:
▪ Double-click in the middle of
the view tab
▪ You can also click the
Maximize icon in the top-right
hand corner of the view
32
Reset your Perspective
When you're first getting used to new software, it's easy to do things inadvertently –
like close views, or resize them – making the views too small or too big
To restore your workbench to the last-saved state access the Window menu and
Reset your perspective:
IDz v14.x
33
Work With Multiple Source Files - Split Screen
Using multiple Views you can begin to see the value of IDz’s GUI tech:
1. Double-click a program – to load it into the editor
2. Double-click another program – to load it into the editor
3. Double-click the View tab of one of the programs to Maximize the Editor View
With both programs open in maximized view:
4. Left-click.Hold.And drag the left mouse button to the right. You see a “Hand
Cursor” and your Editor view will split vertically
2. Select the tab and drag the View outside of the Workbench
3. Maximize IDz
4. When you’re
finished, click:
Reset Perspective
35
Outline View – Program Understanding and Navigation
Basically, a hyper-linked SXREF of variables, paragraphs and sections, you can use the
Outline view to navigate – as well as understand the layout of your code.
37
Host Connection Emulation (HCE)
Once you’ve connected to a mainframe, from Remote Systems:
Right-click over any option and select: Host Connection Emulator
Select your mainframe application; TSO, IMS, CICS, etc.
Login – as per normal
1. From Remote Systems
39
Host Connection Emulation + IDz Advanced Tools
You can keep one or more emulations sessions going – while using IDz’s
advanced functionality for: Program Analysis, Debugging, SQL/DB2 Coding,
Software Quality, etc.
40
Section Summary
What have you done so far?
1. Launched IDz and closed the Welcome tabs to access the z/OS Projects perspective
2. Created a new project – populated with example COBOL programs
3. Opened a program into the "COBOL editor"
4. Navigated up & down, right & left using
1. The scroll bars
2. The single-line-at-a-time arrows
5. Resized your editor window by dragging the window frame, making it:
1. Wider (width)
2. Deeper (height)
6. Maximized views and Restored them back to normal size in the
Workbench
7. Reset your z/OS Projects perspective to the IDz default
8. Opened views that might have been closed accidentally
9. Multiple program views, editing two programs at once
10. Split-screen - Editing in both screens on the same program
11. Outline view – For program navigation
12. Hover and Ctrl+Click Hyperlinks
13. Why IDz?
41
Split-Screen in a Single Source File: Ctrl+2
▪ It's even more common to view the same program in split screen
In ISPF you split screen and load the same program into Browse or View mode (=1)
In IDz it's simple to work in independent edit sessions on the same file – Press: Ctrl+2
43
Open Declaration (F3)
▪ You've already seen the Hover feature,
where you can view a variable's declaration
by simply hovering your mouse over the
variable.
▪ But what if you are interested actually
modifying the variable? That would require
you to navigate to the variable's declaration.
▪ IDz provides an immediate navigation
technique known as "Open Declaration"
▪ To use this technique:
Click your mouse in the variable name
Either:
▪ Press F3 …or…
▪ Right-click and select Open Declaration
▪ Considerations:
This technique works in COBOL and PL/I
You can open a variable or paragraph
declaration
If the declaration is in a copybook, IDz
will open the copybook (providing your
SYSLIB Property Group value is correctly set)
44
Back to/Forward to Arrows – File Navigation
IDz "remembers" your position in a source file during an edit session, and
allows you to return Back to – some previous line you were on - then
reposition Forward to the line you were editing before you clicked Back to
Back to Forward to
▪ Considerations:
Back to and Forward to are particularly useful when used in conjunction with
Open Declaration (F3)
The Back to/Forward to lists span source files – meaning that if the last thing you
did was in a different source you are currently editing, IDz will:
▪ Open that source file in the editor
▪ Reposition your cursor to the line you were editing
45
Hyper-links in your source code
▪ From within a program - use the Outline view to navigate into the PROCEDURE DIVISION
▪ Mouse-over some variables - or Paragraph names ... note how they turn into hyper-links
▪ Return to your place in the PROCEDURE DIVISION using the back arrow on the toolbar at the
top of the Workbench
How is this different than Right-click Context/Menu - or F3? It's not. But it can be one-click
easier - in that you don't have to hit F3 for the look-up on each field - or use the context menu,
just keep holding the Ctrl key down ... scroll ... click.
47
Hyper-links – continued
By holding down the Ctrl key when you hover over a variable or paragraph
name, IDz hyper-links the reference to its declaration - allowing you to Left-
Click and go directly to the declaration (variable or paragraph/section)
Net?
- Less typing
- Less mouse manipulation
- More productivity
48
Show In > Program Control Flow View – Static Analysis Tools
If you are maintaining
a program that
either, you didn't
code, or you
coded it so long
ago you no longer
understand its
structure,
you'll like the
Program Control
Flow view ➔
▪ Click a paragraph or
section name and the
editor will synchronize
with the graphical view
of the program
structure
▪ Giving you:
- Top-down view
- Bottom-up (code) view
49
Program Control Flow – Paragraph/Section Navigation Features
▪ Besides seeing the
entire Procedure
Division, options exist
to re-draw the diagram
showing program logic:
From the selected
Paragraph/Section
forward
And backward from the
beginning of the
Procedure Division
50
Program Control Flow – Additional Features
Text search for paragraph/section names ➔
▪ Zoom to fit ➔
▪ Save graphic
diagram to disk ➔
51
Drag the Program Control Flow View outside of the Workbench
Dragging the View to
the right of the
Workbench
You can drag the view to the left, right, above or below the current workbench to detach the view
53
Manipulating
Views Part 2
You can drag
any view - and
drop it next to
any other view
in your open
Perspective…
54
Optional Topics and Workshops For This Section
▪ If you have time, and are comfortable with the material just
covered, feel free to read through the Optional Topic slides –
and/or try out the techniques shown using IDz and the sample
programs.
55
Optional Topics - Bookmarks, Task Lists, Source Compare, History
▪ The next few slides cover:
Additional IDz Views
▪ Bookmarks
▪ Task List
▪ Remote Error List
Additional IDz technical features and facilities
▪ Annotating your programs with Bookmarks and Task Lists
▪ Comparing source files
▪ Comparing your source files against historical versions – and returning your source to a
prior version without typing
▪ If you are taking this course with an instructor, be sure to ask for help if you
get stuck
56
Open (Show) View
IDz has a lot of functionality – all of it accessed through views. And even though you're
not going to learn about every available view, you should know how to open a
specific view:
Do the following:
Close the Remote Systems view
Notes:
▪ These files can be in the same or in different
libraries - on the same or different LPARs
▪ You can compare files between column
boundaries
From Window > Preferences
LPEX Editor > Compare
Specify: Column Restricted Search
…or… Start and End boundaries
▪ If you're comparing two files on the mainframe and you've set
▪ Preferences->Remote Systems->File Cache->Clear on shutdown,
then there would be no local history after a shutdown.
58
Optional Topic - File Compare – Source Programs – 2 of 3
▪ Results are displayed in side-by-side windows (Maximized for best viewing). Notes:
Lines changed and new lines from either source file shown in different shades
Can click on the right-hand column border to navigate – and/or use the toolbar ➔
59
Optional Topic – File Compare - 3 of 3 (Explanation of Toolbar Functionality)
▪ Besides being
able edit in either
side of the File
Compare window
(and save
changes) the
toolbar provides
the following
actions ➔
60
Organizing Work-Items: Bookmarks
Bookmarks provide three functions:
1. Bookmarks are tags that allow you to quickly
navigate to specific lines in a file
2. Bookmarks also allow you to annotate source, like
Work-Items or electronic sticky pad notes
3. And by double-clicking a Bookmark from the
Bookmarks View you open the associated file
To create a Bookmark:
Double-click, or Right click
(From inside an edit session)
over the left-hand border, next to the line you want
the Bookmark on
- Select: Add Bookmark…
- (optionally) Overtype the name of the Bookmark
- Click OK A small vertical book icon appears in the border ➔
▪ To clear a Bookmark:
Right-click over an existing Bookmark
Select Remove Bookmark
63
Concept – Preference Filters Filter ➔
64
Prompt for Workspace on Startup
▪ When you launch IDz for the first time you will be
prompted for a Workspace
▪ But – if you checked the box labelled “Use this as the default and do not ask again” that’s the
last time you’ll be prompted
If you want the prompts back; From the Window menu, Preferences ➔ navigate to
General > Startup and Shutdown > Workspaces.
Check the box: Prompt for workspace on startup
65
Optional Topic – Named Marks
▪ Another way of supporting ISPF Labels is through the use of Named Marks
▪ This allows you to:
Set various named marks throughout your source code
Navigate back to the named marks
with minimal effort
(like ISPF labels but easier)
67
Customizing the number of “Most recently opened files”
Source Control Management: Extensibility and Integration with z/OS REXX/CLIST/3rd Party ISPF Tooling:
• IBM: Team Concert, SCLM, ClearCase • Menu Manager - HATS/RCP
• CA: Endevor, Panvalet, Librarian, • Java/Eclipse Plug-in Integration
• Serena: Changeman, Homegrown SCMs • Host Emulator included
• Git • Jenkins/Gira
69
• Subversion • Sonar
69 IDz ➔ TSO/ISPF Integration
IDz as a "GUI File Transfer" Tool
▪ When IDz is installed and working in your shop, Local
you can drag & drop source datasets and files between: Files
And
PC and mainframe Datasets
Mainframe and PC
Mainframe and mainframe (from one LPAR to another)
PC and PC
▪ Note that by "your PC" we mean "any networked drive"
Transfer
Steps (assuming the IDz mainframe components have been successfully installed Source
and configured on your host system): Files
Connect to a mainframe (see next section for how to)
From your PC drag & drop files to a mainframe source library
(see next section for how to)
From the mainframe:
▪ Open a library
▪ Select a few PDS members
▪ Drag & Drop them to one of your IDzClass folders
▪ Select an entire PDS (library)
▪ Drag & Drop the library to the IDzClass folder
– What happened?
70
Working With Copybooks – 1 of 2
Most of your programs contain copybook or Include
files. To open them using IDz:
1. Double-click to select a copybook name:
2. Right-Click
3. Select: Open Copy Member
71
Working With Copybooks – 2 of 2
You can make
seriously
good use of
IDz's multiple
window
development
paradigm
using this
technique.
Precisely how
IDz locates
your
copybooks is
a topic that
will be
covered in
the course
module:
"IDz Workbench
– Using Remote
Systems
Explorer"
The actual
feature is Recall that using
called a Version 9 you will
Property drag multiple
Group windows outside of
72
the IDz Workbench
Open a Program From a Static CALL Statement – 1 of 2
You can do the following (When your "Property Groups" are setup correctly):
Select a CALL statement:
Right-click on the program name
Select: Open, View or Browse Program <"program name">
73
Open a Program From a CALL Statement – 2 of 2
The same thing holds true for opening:
A dynamically called program – when a variable in Working Storage has a
hard-coded VALUE clause with the program name
A program referenced in CICS XCTL and LINK commands
74
Optimizing your use of Full Screen editing – 1 of 2
▪ After you get comfortable with the Eclipse tooling, you may wish to stay in Full Screen (Maximized) edit mode
as much as possible in order to take advantage of the significantly larger edit and browse presentation.
▪ However – while in Full Screen you will (very quickly) want to gain access to other IDz functionality:
Open other programs
Access Views (Outline, Properties, etc.)
75
Optimizing your use of Full Screen editing – 2 of 2
Minimized Views
▪ This is no problem – because all of the Views you can access in “normal” workbench mode,
are available as minimized icons on the extreme left and right-hand toolbar areas
Right-hand toolbar
Left-hand toolbar
▪ By clicking an icon you activate
the View
Right-mouse "Context" menu
access to Properties
So what’s a View?
78
Concept – Right-Mouse (Context Menu) as "What's available help"
79
Advanced Topic – File Compare (Setting Defaults to ignore Columns 1-6 and 73-80)
▪ The preferences for the Compare Editor are under Window > Preferences > COBOL > Compare/Patch.
▪ These preferences
control the
settings when a
new compare
editor is opened.
▪ Each can be
toggled on and off
for the individual
compare sessions
using either the
context menu or
toolbar button.
80
Opening Local (MS-Windows) PC Files From IDz
From Remote Systems
Local…
81
The IDz Product Help and Documentation
▪ IDz has a rich and easy-to-use help system,
with:
A global encyclopedia of topics (Help Contents)
Search
Index
List of hot-keys (Key Assist…)
List of web resources
Links to product and help
update processes
About (shows installed
version and release levels
along with information on
eclipse plug-ins)
82
IDz Context-Sensitive Help
▪ Any time you are presented with a wizard that contains a question mark in the bottom left-hand
corner you can click it, and learn about the topic that is "in context"
83
The Product Help – Tips & Techniques
▪ From: Help > Welcome – access recorded scripts
for learning specific technical topics
84
z/OS Access With IDz - a deeper dive
When you are connected to your LPAR, you interact with the IDz server-
side listener using Context Menu actions in Remote Systems Explorer
The IDz listener interacts with:
Your security package JES
Your MVS Resources Resources
MVS Datasets
JES (Batch Jobs and Spool files)
UNIX
IDz interacts with z/OS resources through a host-installed listener
File Manager
… and interacts through JDBC drivers to data sources Fault Analyzer
Application
Program Analyzer
IDz Listener
Started Task MVS Resources
z/OS Datasets + access to:
PD Tools • TSO
Listener
• CICS and IMS Test Regions
• Endevor
Unix • SCLM
System Security/Authorization • Changeman
Services RACF/ACF-2/Top Secret • Panvalet/Librarian/Alchemist
• CLISTs/REXX Execs
85
Advanced Topic – Getting to other views from Maximize
▪ In Maximized (full-screen edit) mode, all of the cool and
useful IDz views are available as miniaturized icons in the
sidebars
Mouse over the icons – to determine what view they represent
Click the icon – and the view "pops-up"
▪ You can use the view while it's visible
Click back in the source –
to return to full-screen edit mode
and "hide" (minimize) the view
86
Optional Topic/Workshop – Hyperlinked Program Documentation
The Ctrl key turns anything into a
legitimate hyperlink – including: internet
URLS, and files stored on a networked
drive. Think; Program documentation
process models, etc.
file:///c:\IDzwksp85\bnch.png
87
Optional Topic – Getting Product Help (and other assistance)
▪ From the IDz Tech Portal try out various options – by pressing Ctrl+Spacebar
Web based links
mailto: link
88
Summary – IDz Workbench Terms & Concepts and Navigation
Use Cases IDz Editing Tool Considerations
Open a program for edit or Browse Load the file into the editor from your SCM Browse is only available if you open a file
Double-click on the file to open it from either your PDS or z/OS Projects. from z/OS
To browse a file, from the mainframe, Right-click on the file and Browse
Re-open views closed by mistake Use Window > Reset Perspective Could also use Window > Show View
Scroll within the file Windows scrolling, PgUp/PgDn, Mouse scroll wheel In the next section you'll learn how to
setup PF8/PF7
Navigate to a variable's declaration Select the variable. Press F3 – or use the Context Menu Note that if the variable is in a copybook
Property Groups must be setup
Navigate back to where you Use the Back arrow on the toolbar
previously were in your source
Navigate throughout the Use the Outline view
PROCEDURE DIVISION
Discover (understand) your Use Program Control Flow (Context Menu > Show In > Program Can un-dock these diagrams for better
program's business logic Control Flow). Could also use the Perform Hierarchy tool use of screen "real estate"
Work with multiple programs/files – Open multiple programs or files (JCL and COBOL, COBOL program +
displaying them side-by-side Copybooks, etc.). Drag and drop the editing tab to the right
Split-screen on a single program, Press Ctrl+2 to split screen. Click the X in the top right-hand corner to Can also split horizontally, which works
enabling source edit on either split return to a single editing view well for editing data files
Understand data flow and the effect Use Occurrences in Compilation Unit (Select a variable, and from the
of various statements on a variable Context Menu > Show In > Occurrences in Compilation Unit)
Check your syntax Watch for the small-yellow triangles in the left-hand border (Real Time Can also use Local Syntax Check, which
Syntax Validation). is covered in Optional Topics
Create annotations (reminders – in a Utilize Bookmarks or Tasks. Bookmarks are created by double-clicking There are Tasks and Bookmark views –
file, like ISPF labels) in the left-hand margin of the Editor. also covered in Optional Topics
Open a called program's source file Double-click to select the variable (dynamic call) or literal (static call) and Property Groups must be setup for this to
from within the calling program select Open, View or Browse Program work
Open a copybook within a program Double-click to select the variable (dynamic call) or literal (static call) and Property Groups must be setup for this to
select Open, View or Browse Copy Member work
Return a source file to previously From the Context Menu select: Replace With > Local History Optional Topics covers Local History
saved state (outside of your SCM)
Compare two files for source Select both filenames and from the Context
89 Menu select: Optional Topics covers file Compare
Optional Topic - Terms and Concepts: “Properties” – ISPF
▪ The term “Properties” sounds very new-age. There’s nothing like this on the
mainframe, right?
Think again. There are
▪ Dataset “Properties”
90
Section Review
What have you done so far?
Learned a few of IDz's Workbench terms and concepts – and how they contrast and
compare with ISPF – including:
▪ Workspace, Perspective, View, Menu, Editor
Understood the role of your mouse (both left or "selection" button, and the right or
"context-menu" button in doing IDz development
Launched IDz and closed the Welcome tabs to access the z/OS Projects perspective
Created a new project – populated with example COBOL programs
Opened a program into the "COBOL editor"
Navigated up & down, right & left using Scroll bars
Resized your editor window
Maximized views and Restored them back to normal size
Reset your z/OS Projects perspective to the IDz default
Opened views that might have been closed accidentally
Worked in Split-screen mode
Learned a few other IDz editing techniques, utilizing:
▪ Outline view
▪ Back to/Forward to
▪ Bookmarks
▪ Task list
▪ Local History
▪ Remote Error List
▪ File Compare
91
Backup Slides
92
Eclipse UI "Freezes"
If your machine is underpowered (less than 8 Gigs RAM, etc.) or if you've got lots of memory-
hungry apps open, you might experience a lengthy UI (Eclipse) freeze.
Options:
▪ Turn on UI Responsiveness Monitoring - which will write debug information to an "Error Log" file -
which should be sent to your IDz
Rollout Administrator - or I/T team
93
Emulation Architecture
3270 Data Stream products
▪ Integration with TSO/ISPF Application Development tools
MVS Resources
Listener
3270 Emulation Product Started Task • z/OS Datasets
• JES
• TSO
• CICS Region
• IMS Region
• SCM
Security/Authorization
• CLISTs/REXX
RACF/ACF-2/Top Secret
94