CA File Master Plus Eclipse UI User Guide

CA File Master Plus Eclipse UI User Guide
CA File Master™ Plus
Eclipse UI User Guide
Version 9.0.00
This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to
as the “Documentation”) is for your informational purposes only and is subject to change or withdrawal by CA at any time. This
Documentation is proprietary information of CA and may not be copied, transferred, reproduced, disclosed, modified or
duplicated, in whole or in part, without the prior written consent of CA.
If you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make
available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with
that software, provided that all CA copyright notices and legends are affixed to each reproduced copy.
The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable
license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to
certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY
KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE,
DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST
INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE
POSSIBILITY OF SUCH LOSS OR DAMAGE.
The use of any software product referenced in the Documentation is governed by the applicable license agreement and such
license agreement is not modified in any way by the terms of this notice.
The manufacturer of this Documentation is CA.
Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions
set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or
their successors.
Copyright © 2013 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to
their respective companies.
CA Technologies Product References
This document references the following CA products:
■
CA Librarian®
■
CA Panvalet®
Contact CA Technologies
Contact CA Support
For your convenience, CA Technologies provides one site where you can access the
information that you need for your Home Office, Small Business, and Enterprise CA
Technologies products. At http://ca.com/support, you can access the following
resources:
■
Online and telephone contact information for technical assistance and customer
services
■
Information about user communities and forums
■
Product and documentation downloads
■
CA Support policies and guidelines
■
Other helpful resources appropriate for your product
Providing Feedback About Product Documentation
If you have comments or questions about CA Technologies product documentation, you
can send a message to techpubs@ca.com.
To provide feedback about CA Technologies product documentation, complete our
short customer survey which is available on the CA Support website at
http://ca.com/docs.
Contents
Chapter 1: CA File Master Plus Introduction
9
Use Dynamic Help ........................................................................................................................................................ 9
Chapter 2: Understanding Your Workspace
11
Main Window ............................................................................................................................................................. 11
Restore the Default Layout ................................................................................................................................. 11
Views .......................................................................................................................................................................... 12
Open a View ........................................................................................................................................................ 12
Rearrange Tabbed Views .................................................................................................................................... 13
Import a View ...................................................................................................................................................... 14
Export a View ...................................................................................................................................................... 15
View Types .......................................................................................................................................................... 16
Manage Shortcut Keys ............................................................................................................................................... 20
Customize Shortcut Key Definitions .................................................................................................................... 21
Restore Default Shortcut Key Settings ................................................................................................................ 22
Modify Shortcut Key Settings .............................................................................................................................. 23
Set Your Preferences .................................................................................................................................................. 23
Set Eclipse UI Preferences ................................................................................................................................... 24
Set Startup Preferences ...................................................................................................................................... 26
Set Preferences for Text Editors.......................................................................................................................... 28
Set Shortcut Key Preferences .............................................................................................................................. 30
Set Help Preferences ........................................................................................................................................... 32
Help Content Preferences ................................................................................................................................... 33
Chapter 3: Servers
35
Add a New Server Connection ................................................................................................................................... 35
Configure Mainframe Settings ................................................................................................................................... 36
Allocate a New Parm PDS .................................................................................................................................... 40
Log On to the Mainframe ........................................................................................................................................... 40
Reconfigure a Server .................................................................................................................................................. 41
Reset Server Password ............................................................................................................................................... 42
Refresh Server Status ................................................................................................................................................. 42
Remove a Server Connection ..................................................................................................................................... 43
Contents 5
Chapter 4: Data Sets
45
Select a Data Set......................................................................................................................................................... 45
Add a Data Set ............................................................................................................................................................ 47
Remove a Data Set ..................................................................................................................................................... 48
Rename a Data Set ..................................................................................................................................................... 49
Rename a VSAM Data Set .......................................................................................................................................... 50
Delete a Data Set ........................................................................................................................................................ 51
Copy Utility ................................................................................................................................................................. 51
Copy a PDS File .................................................................................................................................................... 52
Copy a Sequential File ......................................................................................................................................... 56
Copy a VSAM File ................................................................................................................................................ 59
Allocate ...................................................................................................................................................................... 61
Allocate a New PDS ............................................................................................................................................. 62
Allocate a New Sequential Data Set .................................................................................................................... 64
Allocate a New VSAM Data Set ........................................................................................................................... 67
Add Multiple Volumes......................................................................................................................................... 69
Compare Utility .......................................................................................................................................................... 69
Compare Utility ................................................................................................................................................... 71
Compare Program Utility .................................................................................................................................... 74
Print Utility ................................................................................................................................................................. 78
Chapter 5: Members
83
Select a Member ........................................................................................................................................................ 83
Add a Member ........................................................................................................................................................... 84
Remove a Member ..................................................................................................................................................... 85
Rename a Member ..................................................................................................................................................... 86
Delete a Member ....................................................................................................................................................... 87
Open a Data Set or Member ...................................................................................................................................... 88
Data Set in Use .................................................................................................................................................... 92
Change Log .......................................................................................................................................................... 93
Compare Utility .......................................................................................................................................................... 97
Chapter 6: Selection
101
Add Selection Criteria ............................................................................................................................................... 102
Create Selection Criteria .......................................................................................................................................... 103
Modify Layout Selection Conditions ........................................................................................................................ 104
Define Selection Conditions ..................................................................................................................................... 106
Condition Specifications ........................................................................................................................................... 107
Update Selection Criteria ......................................................................................................................................... 109
Remove Selection Criteria ........................................................................................................................................ 110
6 Eclipse UI User Guide
Chapter 7: Layouts
113
Add a Layout............................................................................................................................................................. 114
Create a Custom Layout ........................................................................................................................................... 115
Modify Layout Rules ................................................................................................................................................. 116
Define Selection Conditions ..................................................................................................................................... 118
Insert a Layout .......................................................................................................................................................... 119
View a Layout ........................................................................................................................................................... 120
Update a Layout ....................................................................................................................................................... 121
Remove a Layout ...................................................................................................................................................... 122
Chapter 8: Editor
123
Open a Data Set or Member .................................................................................................................................... 123
Data Set in Use .................................................................................................................................................. 127
Change Log ........................................................................................................................................................ 128
Character Format ..................................................................................................................................................... 132
Single-Record Format ............................................................................................................................................... 132
Cancel ....................................................................................................................................................................... 133
Data Set-level Operations ........................................................................................................................................ 133
Exclude .............................................................................................................................................................. 134
Flip ..................................................................................................................................................................... 135
Locate ................................................................................................................................................................ 136
Find/Change ...................................................................................................................................................... 138
Reset ................................................................................................................................................................. 142
Record-level Operations........................................................................................................................................... 142
Copy .................................................................................................................................................................. 143
Move ................................................................................................................................................................. 144
Delete ................................................................................................................................................................ 145
Insert ................................................................................................................................................................. 145
Repeat ............................................................................................................................................................... 146
Case Change ...................................................................................................................................................... 146
Chapter 9: Properties
149
Contents 7
Chapter 1: CA File Master Plus Introduction
CA File Master Plus is a full function z/OS and OS/390 data management product that
provides enhanced capabilities for sequential, partitioned (PDS and PDSE), and VSAM
files.
CA File Master Plus provides a set of powerful and easy-to-use tools for manipulating
z/OS data sets. Many of the functions support specified record filter/selection criteria
and allow data to be displayed and modified using COBOL or PL/I copybooks.
You can access CA File Master Plus through a traditional mainframe green screen or
through an Eclipse Ready™ graphical user interface (Eclipse UI). The Eclipse UI is a
universal tool platform that is used to create a graphical user interface. You can use the
Eclipse UI on any Windows system that supports the Eclipse platform. The Eclipse UI
provides a Windows-based alternative to the green screen.
This section contains the following topics:
Use Dynamic Help (see page 9)
Use Dynamic Help
The CA File Master Plus help system displays content dynamically to reflect the wizard,
dialog, or view that is in focus.
The internal Dynamic Help view contains the following four pages that present help
topics in different ways:
Related Topics Page
Shows description and links to topics in the online documentation that is related to
the current context. You can click More Results to view more links.
All Topics Page
Displays the Table of Contents for the online CA File Master Plus documentation
arranged in a tree hierarchy that you can expand or collapse as needed.
Search Page
Lets you search the online documentation for specific text.
Bookmarks Page
Displays online Help topics that you mark as personal bookmarks.
Chapter 1: CA File Master Plus Introduction 9
Use Dynamic Help
More information:
CA File Master Plus Introduction (see page 9)
10 Eclipse UI User Guide
Chapter 2: Understanding Your Workspace
When you open the CA File Master Plus Eclipse UI, the Main Window Layout always
reverts to the same view as the last time you closed it. Changes you make are retained
from session to session.
This section contains the following topics:
Main Window (see page 11)
Views (see page 12)
Manage Shortcut Keys (see page 20)
Set Your Preferences (see page 23)
Main Window
When you start CA File Master Plus, the main window displays a set of tabbed sections
named views, the main menu bar, and the main toolbar.
Each view on the main window contains a set of items relevant to that area of
functionality. For example, the Error Log view contains a list of all error logs for your CA
File Master Plus sessions.
Each view contains a toolbar with a set of toolbar buttons relevant to that view. The
toolbar buttons help manage the items within that particular view. For example, the
Directory List view toolbar buttons let you add servers to the Directory List view and
refresh the servers listed there.
More information:
Understanding Your Workspace (see page 11)
Views (see page 12)
Manage Shortcut Keys (see page 20)
Set Your Preferences (see page 23)
Restore the Default Layout
The settings you defined for the Eclipse UI are saved, and the view looks the same the
next time you open the application. You can reset the main window layout to its default
settings by clicking Window, Reset Perspective. Click OK when the Reset Perspective
message appears. The settings are restored to the default application settings.
Chapter 2: Understanding Your Workspace 11
Views
More information:
Main Window (see page 11)
Views
Views provide a visual presentation of the CA File Master Plus environment. Use views
to navigate and manipulate information in CA File Master Plus. A perspective is the term
for the way your views are displayed in the main window.
Different views are accessible from the Window menu. Views present different
information in the product to help you manage data easily. Each view has a toolbar that
is customized for that view.
You can have more than one view open at a time. Multiple views are managed using
tabs and can be rearranged to suit your needs. Views can be minimized, maximized, and
closed using standard Eclipse UI controls.
More information:
Understanding Your Workspace (see page 11)
Open a View (see page 12)
Rearrange Tabbed Views (see page 13)
Import a View (see page 14)
Export a View (see page 15)
View Types (see page 16)
Main Window (see page 11)
Manage Shortcut Keys (see page 20)
Set Your Preferences (see page 23)
Open a View
You can display views that are available but not visible as part of the default layout of
the CA File Master Plus main window.
Follow these steps:
1.
Select Window, Show Views.
A submenu displays a list of views.
2.
Select the view that you want to open.
The CA File Master Plus main window shows the selected view.
12 Eclipse UI User Guide
Views
More information:
Views (see page 12)
Rearrange Tabbed Views (see page 13)
Import a View (see page 14)
Export a View (see page 15)
View Types (see page 16)
Rearrange Tabbed Views
CA File Master Plus lets you rearrange the order of views in a tabbed notebook if you
prefer to see the views differently on the main window.
The following procedure illustrates how to rearrange the Layouts and Selection views in
a tabbed notebook.
Follow these steps:
1.
Select Window, Reset Perspective.
2.
Click OK on the Reset Perspective dialog.
The window perspective is reset to its original layout.
3.
Select Selection from the Show Views drop-down list on the Window menu.
4.
Select Layouts from the Show Views drop-down list on the Window menu.
5.
Drag the Selection title bar to the right of the Layouts tab until the cursor appears
as a Stack cursor; then release the mouse button.
The Selection tab now appears to the right of the Layouts tab.
6.
Drag the Layouts tab to the right of the Selection tab until the cursor is a Stack
cursor and release the mouse button.
The Layouts tab now appears to the right of the Selection tab.
More information:
Views (see page 12)
Open a View (see page 12)
Import a View (see page 14)
Export a View (see page 15)
View Types (see page 16)
Chapter 2: Understanding Your Workspace 13
Views
Import a View
You can import the contents of the Directory List view, Selection view, or the Layouts
view from an appropriately formatted Extensible Markup Language (XML) file. A valid
XML file is one that contains the exported contents of the same view type from the CA
File Master Plus Eclipse UI. For example, to import servers, data sets, and members to
the Directory List view, you can only use an XML file that contains exported information
from a CA File Master Plus Eclipse UI Directory List view.
Note: Any Import action causes the contents of your existing view to be replaced by the
contents of the imported file.
Follow these steps:
1.
Select File, Import.
The Import wizard displays.
2.
Expand the CA File Master Plus folder.
3.
Select type of view you want to import and click Next.
4.
Click Browse and navigate to the XML file that you want to import.
The Destination Folder field gets populated with the path to the profile settings file.
5.
Click Finish.
A message displays prompting you to restart the application or cancel the import. A
restart is required for the imported view settings to take effect.
6.
Click Restart Now or Restart Later.
The view displays the imported content when the application next starts.
More information:
Views (see page 12)
Open a View (see page 12)
Rearrange Tabbed Views (see page 13)
Export a View (see page 15)
View Types (see page 16)
14 Eclipse UI User Guide
Views
Export a View
You can export the contents of the Directory List view, Selection view, or the Layouts
view to an Extensible Markup Language (XML) file. Save this file to your local hard drive
or a shared resource. You or other CA File Master Plus Eclipse UI users can then import
the XML file and populate a view with the contents of your exported view.
Follow these steps:
1.
Select File, Export.
The Export wizard displays.
2.
Expand the CA File Master Plus folder.
3.
Select type of view you want to export and click Next.
4.
Click Browse and navigate to the location where you want to save the export file in
XML format.
The Destination file field is populated with the path that you specified.
5.
(Optional) Select Overwrite existing file if you specified an export file name that
already exists. This option will overwrite the contents of the existing file with the
contents of the current export.
6.
Click Finish.
The view export file is created and saved to the location that you specified.
More information:
Views (see page 12)
Open a View (see page 12)
Rearrange Tabbed Views (see page 13)
Import a View (see page 14)
View Types (see page 16)
Chapter 2: Understanding Your Workspace 15
Views
View Types
Use the views available on the main window to navigate through a set of resources such
as a listing of data sets and members, reports, and properties. CA File Master Plus
provides the following views:
■
Directory List (see page 17)
Shows servers, data sets, and members to which you have connected
■
Selection (see page 18)
Shows selection members that you have added to the Eclipse UI
■
Layout (see page 19)
Shows layout data sets and members that you have added to the Eclipse UI
■
Properties (see page 19)
Shows data set properties
■
Report (see page 19)
Shows report results
■
Editor (see page 17)
Shows the contents of a data set or member in an editable view
More information:
Views (see page 12)
Directory List View (see page 17)
Editor View (see page 17)
Selection View (see page 18)
Layout View (see page 19)
Properties View (see page 19)
Report View (see page 19)
Open a View (see page 12)
Rearrange Tabbed Views (see page 13)
Import a View (see page 14)
Export a View (see page 15)
16 Eclipse UI User Guide
Views
Directory List View
The Directory List view displays servers, data sets, and members that you add in a
tree-style directory. Add frequently used resources to this view so that you can easily
access them and perform basic data management operations, such as comparing and
copying data sets.
Data sets are listed alphabetically, and you can filter the items to find specific data sets
or members.
Enter a text string in the Filter field to find specific items in the Directory List view. The
Directory List view then displays only data sets and members that contain your search
string.
More information:
View Types (see page 16)
Editor View (see page 17)
Selection View (see page 18)
Layout View (see page 19)
Properties View (see page 19)
Report View (see page 19)
Servers (see page 35)
Data Sets (see page 45)
Members (see page 83)
Layouts (see page 113)
Selection (see page 101)
Editor View
The Editor view displays the contents of a data set or member in either view or edit
mode. The data is displayed in either character or single-record format. You can use the
toolbar buttons to switch display modes when the editor is open.
Chapter 2: Understanding Your Workspace 17
Views
More information:
View Types (see page 16)
Directory List View (see page 17)
Selection View (see page 18)
Layout View (see page 19)
Properties View (see page 19)
Report View (see page 19)
Editor (see page 123)
Open a Data Set or Member (see page 88)
Character Format (see page 132)
Single-Record Format (see page 132)
Find/Change (see page 138)
Exclude (see page 134)
Reset (see page 142)
Locate (see page 136)
Flip (see page 135)
Cancel (see page 133)
Selection View
The Selection view displays selection criteria in a tree-style directory. Add frequently
used selection members to the Selection view so that you can easily access them. Use
this view to manage your selection criteria and perform actions such as creating and
modifying selection criteria members. Expand a selection member to view the selection
conditions in the member.
More information:
View Types (see page 16)
Directory List View (see page 17)
Editor View (see page 17)
Layout View (see page 19)
Properties View (see page 19)
Report View (see page 19)
Condition Specifications (see page 107)
Selection (see page 101)
Add Selection Criteria (see page 102)
Remove Selection Criteria (see page 110)
Create Selection Criteria (see page 103)
Update Selection Criteria (see page 109)
Modify Layout Selection Conditions (see page 104)
Define Selection Conditions (see page 106)
18 Eclipse UI User Guide
Views
Layout View
The Layout view displays layout data sets and members that you have added in a
tree-style directory. Use the Layout view to create, manage, and view the layouts that
are associated with your data sets. You can expand a layout to view the fields that are in
the layout. Use this view to manage your layouts and apply them to the data sets and
members you are working with.
More information:
View Types (see page 16)
Directory List View (see page 17)
Editor View (see page 17)
Selection View (see page 18)
Properties View (see page 19)
Report View (see page 19)
Layouts (see page 113)
Add a Layout (see page 114)
Remove a Layout (see page 122)
View a Layout (see page 120)
Create a Custom Layout (see page 115)
Insert a Layout (see page 119)
Update a Layout (see page 121)
Modify Layout Rules (see page 116)
Define Selection Conditions (see page 106)
Properties View
The Properties view displays the properties or attributes that are associated with a
selected data set.
More information:
View Types (see page 16)
Directory List View (see page 17)
Editor View (see page 17)
Selection View (see page 18)
Layout View (see page 19)
Report View (see page 19)
Properties (see page 149)
Report View
The Report view displays the summary output report upon completion of a utility
function. You can us the toolbar button on the Report view to display a detailed report
in a new editor pane.
Chapter 2: Understanding Your Workspace 19
Manage Shortcut Keys
More information:
View Types (see page 16)
Directory List View (see page 17)
Editor View (see page 17)
Selection View (see page 18)
Layout View (see page 19)
Properties View (see page 19)
Manage Shortcut Keys
You can move around the CA File Master Plus main window using certain keyboard keys
or key combinations. For example, press Ctrl+Shift+P to open the Copy PDS wizard.
To see the shortcut keys, click Help, Key Assist. The Shortcut Keys window opens on the
CA File Master Plus main window.
CA File Master Plus lets you define your own settings for the existing combinations or
use the default settings.
Key shortcuts that invoke commands or open views are not discussed in this online help.
Some of these commands and views exist because of the framework on which the
interface was developed, but they do not perform any specific function in the CA File
Master Plus application. CA Technologies does not support the use of these key
shortcuts.
More information:
Understanding Your Workspace (see page 11)
Customize Shortcut Key Definitions (see page 21)
Restore Default Shortcut Key Settings (see page 22)
Modify Shortcut Key Settings (see page 23)
Main Window (see page 11)
Views (see page 12)
Set Your Preferences (see page 23)
20 Eclipse UI User Guide
Manage Shortcut Keys
Customize Shortcut Key Definitions
CA File Master Plus provides you the default shortcut key definitions for many
commands used on the CA File Master Plus. You can define new key combinations or
customize existing key definitions for CA File Master Plus commands using the
Preferences dialog. Use the following procedure if you want to define a new shortcut
key for a CA File Master Plus command.
Follow these steps:
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Select General, Keys.
The commands appear in a table format that shows the classification for the
command, existing shortcut key sequence, and when the shortcut key is used.
Note: Click a header on the commands table to sort the list of commands based on
the command properties.
3.
Select a scheme from the drop-down list.
The following list contains the key mapping schemes available for commands on CA
File Master Plus:
■
Virtual Host Manager—Specifies the scheme provided with this product. It
includes mapping for functions specific to this software. This is the
recommended scheme.
■
Default—Specifies the default key sequences for all shortcut keys supplied with
the framework.
■
Emacs—Specifies the user-defined key sequences for selected shortcut keys to
emulate the Emacs editor software.
Chapter 2: Understanding Your Workspace 21
Manage Shortcut Keys
4.
Select the command that you want to modify in the table.
The following fields are automatically populated:
Name
Shows the command name. Press the key sequence for the command.
Binding
Lists the key sequence assigned to the selected command. Enter the new
sequence.
Note: To use a special key sequence, click the back arrow button and select
Backspace, Tab, or the Shift+Tab key combination.
When
Lists the situations when you can use the new key sequence. Select a situation
from the drop-down list.
5.
Check the Include unbound commands box to include all of the commands that do
not bind to a particular situation.
6.
Click Apply.
The new key sequence is assigned to the selected command. Click the View tab to
see the new shortcut key sequence in the commands table on the Preferences
dialog.
7.
Click OK to save the settings and close the dialog.
Restore Default Shortcut Key Settings
You can restore the default shortcut key definitions for commands used in CA File
Master Plus. Restoring all keys to the default settings lets you remove all user changes
made to specific shortcut key settings.
Follow these steps:
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Select General, Keys.
The Keys dialog shows the preferences for shortcut keys.
3.
Click Restore Defaults.
The Restore Keyboard Defaults dialog opens.
22 Eclipse UI User Guide
4.
Click OK to restore all keys to the default settings.
5.
Click OK to close the Keys dialog.
Set Your Preferences
More information:
Manage Shortcut Keys (see page 20)
Customize Shortcut Key Definitions (see page 21)
Modify Shortcut Key Settings (see page 23)
Modify Shortcut Key Settings
You can edit or remove shortcut key definitions for CA File Master Plus commands. You
may prefer to choose your own shortcut keys instead of using a default shortcut key
definition for a CA File Master Plus command.
Follow these steps:
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Select General, Keys.
The Keys dialog shows the preferences for shortcut keys.
Note: Click a header on the commands table to sort the list of commands based on
the command properties.
3.
Select a shortcut key command.
4.
Do one of the following:
5.
■
Click Copy Command to create a copy of the selected key sequence.
■
Click Remove Binding to remove the key sequence from the command.
■
Click Restore Command to show the default key sequence assigned to the
command.
Click Apply.
The changes to the key sequence are updated.
6.
Click OK to close the dialog.
Note: All user-defined key sequence settings are cancelled when you restore
default key settings.
Set Your Preferences
Chapter 2: Understanding Your Workspace 23
Set Your Preferences
More information:
Understanding Your Workspace (see page 11)
Set Eclipse UI Preferences (see page 24)
Set Startup Preferences (see page 26)
Set Preferences for Text Editors (see page 28)
Set Shortcut Key Preferences (see page 30)
Set Help Preferences (see page 32)
Help Content Preferences (see page 33)
Main Window (see page 11)
Views (see page 12)
Manage Shortcut Keys (see page 20)
Set Eclipse UI Preferences
You can set the preferences specific to the CA File Master Plus Eclipse UI using the
Preferences dialog.
Follow these steps:
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Select CA File Master Plus Eclipse UI.
The CA File Master Plus Eclipse UI page displays.
3.
Change the default settings for the following fields to suit your needs:
Maximum number of recently used items
Indicates the maximum number of recently used items to display in the
drop-down menu.
Always remove items without prompting
Disables the dialog that prompts for confirmation when removing an item from
the Eclipse UI.
Always change data set name without prompting
Disables the dialog that prompts for confirmation when renaming a data set.
Always exit without prompting
Disables the Confirm Exit dialog that displays when you close CA File Master
Plus.
Disable preview
Disables the Preview button on all wizards.
24 Eclipse UI User Guide
Set Your Preferences
4.
Click OK.
CA File Master Plus saves the changes and closes the Preferences dialog. The
changes are used in all succeeding sessions unless you change the preferences
again.
Note: You can restore the default configuration settings anytime on the Preferences
dialog. To restore the default settings, navigate to the page you want to restore,
click Restore Defaults, and then click OK.
Note: You can configure the mainframe settings after you have added a server to your
Directory List view. For more information about configuring the mainframe settings, see
Configure Mainframe Settings (see page 36).
More information:
Set Your Preferences (see page 23)
Set Startup Preferences (see page 26)
Set Preferences for Text Editors (see page 28)
Set Shortcut Key Preferences (see page 30)
Set Help Preferences (see page 32)
Help Content Preferences (see page 33)
Configure Mainframe Settings (see page 36)
Chapter 2: Understanding Your Workspace 25
Set Your Preferences
Set Startup Preferences
You can set the general preferences for CA File Master Plus using the Preferences dialog.
Note: Expanding the General folder displays the Appearance, Capabilities, and Editors
options. CA File Master Plus does not provide support for the features that are related
to the Capabilities option.
Follow these steps:
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Select General.
The Preferences dialog opens the General page.
3.
Change the default settings for the following fields to suit your needs:
Keep next/previous editor, view and perspectives dialog open
Lets you access the pages on a dialog that you have previously seen for an
active project. Click the Previous or Next arrow button to see the previous or
next page respectively.
Note: When you close the dialog and then reopen it, the previously stored page
order will not be available.
Specifies that the Program Listing area and the view cycle dialogs remain open
after you release their activation keys. Usually, the dialogs or menus close as
soon as you release the activation keys (such as Ctrl+F7).
Default: Off
When this preference is checked, you can use the key combination Ctrl +F7 on
the CA File Master Plus main window to keep the pop-up menu listing those
views that can be opened, when you release the control keys. When this check
box is cleared, the pop-up menu remains visible only as long as you hold down
the control key. If you release the control key, the pop-up menu closes.
26 Eclipse UI User Guide
Set Your Preferences
Open mode
Specifies the default behavior for opening views and programs in the Program
Listing area. You can select one of the following methods for opening these
resources:
Double click
Specifies a single-click to select a resource and a double-click to open that
resource in the Program Listing area.
Single click (Select on hover)
Specifies hovering the mouse over a resource to select it and single-clicking
on the resource to open it in the Program Listing area.
Single click (Open when using arrow keys)
Specifies using the arrow keys to select a resource and automatically
opening it in the Program Listing area.
Default: Double click
Note: The effect of these selections may vary depending on the view that has
the focus.
4.
Click OK.
CA File Master Plus saves the changes and closes the Preferences dialog. The
changes are used in all succeeding sessions unless you change the preferences
again.
Note: You can restore the default configuration settings anytime on the Preferences
dialog. To restore the default settings, navigate to the page you want to restore,
click Restore Defaults, and then click OK.
Note: CA File Master Plus does not support Always run in background and Show Heap
Status fields in this dialog.
More information:
Set Your Preferences (see page 23)
Set Eclipse UI Preferences (see page 24)
Set Preferences for Text Editors (see page 28)
Set Shortcut Key Preferences (see page 30)
Set Help Preferences (see page 32)
Help Content Preferences (see page 33)
Set Shortcut Key Preferences (see page 30)
Set Help Preferences (see page 32)
Chapter 2: Understanding Your Workspace 27
Set Your Preferences
Set Preferences for Text Editors
You can specify the settings that affect the general appearance and behavior of the text
editors.
To set the text editor settings
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Expand General and select Editors, Text Editors.
The Preferences dialog opens the Text Editors page.
3.
Change the default settings for the following fields to suit your needs:
Highlight current line
Highlights the current line in text editors.
Default: On
Show print margin
Displays the print margin. Checking this box enables the Print margin columns
field.
Default: Off
Print margin columns
Lets you specify the print margin column.
Default: 80
Show line numbers
Displays line numbers on the left side of text editors.
Default: Off
Show range indicator
Displays the range indicator for text editors.
Default: On
28 Eclipse UI User Guide
Set Your Preferences
Appearance color options
Lets you specify the color for the following values:
■
Line number foreground
■
Current line highlight
■
Print margin
■
Find scope
■
Selection foreground color
■
Selection background color
■
Background color
■
Foreground color
■
Hyperlink
Note: CA File Master Plus does not support the following fields and options and is
not responsible for the results if you choose to use any of these options.
4.
■
Undo history size
■
Displayed tab width
■
Insert spaces for tabs
■
Show whitespace characters
■
Show affordance in hover on how to make it sticky
■
When mouse moved into hover
■
Enable drag and drop of text
■
Warn before editing a derived file
■
Smart caret positioning at line start and end
Click OK.
CA File Master Plus saves the changes and closes the Preferences dialog. The
changes are used in all succeeding sessions unless you change the preferences
again.
Note: You can restore the default configuration settings anytime on the Preferences
dialog. To restore the default settings, navigate to the page you want to restore,
click Restore Defaults, and then click OK.
Note: CA File Master Plus does not support the settings for the following options for
text editors: Linked mode, Quick Difference, and Spelling.
Chapter 2: Understanding Your Workspace 29
Set Your Preferences
More information:
Set Your Preferences (see page 23)
Set Eclipse UI Preferences (see page 24)
Set Startup Preferences (see page 26)
Set Shortcut Key Preferences (see page 30)
Set Help Preferences (see page 32)
Help Content Preferences (see page 33)
Set Shortcut Key Preferences
You can modify the default shortcut keys assigned for certain functions in CA File Master
Plus. The General Preference settings for keys affect the key mapping or binding used to
perform various functions in CA File Master Plus.
Note: The Key mapping feature provides the ability to modify key assignments. CA File
Master Plus does not support the functionality of these key mappings.
Follow these steps:
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Expand General and select Keys.
The Preferences dialog opens the Keys page. This page lists the default key
mappings for all commands and functions in CA File Master Plus.
3.
Select a scheme from the Scheme drop-down list. Choose CA File Master Plus,
Default, or Emacs scheme.
The Keys page lists the command key sequences for the selected scheme. A table
displays binding, action, and category for each command key sequence.
4.
Scroll or type the name of the command key sequence you want to edit.
The Preview pane shows the details such as name of the selected key sequence,
description, binding, event when the selected key works, and conflicts information.
5.
Change the default settings for the selected key to suit your needs:
Name
Displays a name for the command key sequence. This is a non-editable field.
Description
Displays a description for the command key sequence. This is a non-editable
field.
30 Eclipse UI User Guide
Set Your Preferences
Binding
Displays the binding key combination for the command key sequence. Type the
key sequence you want to assign to the function in the Key Sequence, Name
field. Click the arrow and select Backspace, Tab, or Shift+Tab to set key
combinations for the selected key sequence.
When
Displays a list of actions for command key sequences. Select the action when
you want to initiate a selected key sequence from the drop-down list.
Conflicts
Displays a conflicting key sequence that uses the same key combination as the
selected command key sequence. Change the value in the Binding field.
6.
Click OK.
CA File Master Plus saves the changes and closes the Preferences dialog. The
changes are used in all succeeding sessions unless you change the preferences
again.
Note: You can restore the default configuration settings anytime on the Preferences
dialog. To restore the default settings, navigate to the page you want to restore,
click Restore Defaults, and then click OK.
More information:
Set Your Preferences (see page 23)
Set Eclipse UI Preferences (see page 24)
Set Startup Preferences (see page 26)
Set Preferences for Text Editors (see page 28)
Set Help Preferences (see page 32)
Help Content Preferences (see page 33)
Chapter 2: Understanding Your Workspace 31
Set Your Preferences
Set Help Preferences
You can specify the Help preferences that affect the way online help is displayed and
determine whether an external browser is used to display help information.
Note: If you do not specify use of an external help browser, CA File Master Plus uses an
internal panel to host the web browser.
Follow these steps:
1.
Select Window, Preferences.
The Preferences dialog opens.
2.
Double-click Help.
The Preferences dialog opens the Help page.
3.
Change the default settings for the following fields to suit your needs:
Open help search
Specifies whether to open the help search in the dynamic help view or in a
browser.
Default: In the dynamic help view
Open help contents
Specifies whether to open the help contents in the internal help browser or an
external browser.
Default: In the internal help browser
Open window context help
Specifies whether to open the context help for windows in a dynamic view
panel or in a pop-up information box (infopop).
Default: In the dynamic help view
Open dialog context help
Specifies whether to open dialog context help in a dialog tray or in a pop-up
information box.
Default: In a dialog tray
4.
Click OK.
CA File Master Plus saves the changes and closes the Preferences dialog. The
changes are used in all succeeding sessions unless you change the preferences
again.
Note: You can restore the default configuration settings anytime on the Preferences
dialog. To restore the default settings, navigate to the page you want to restore,
click Restore Defaults, and then click OK.
32 Eclipse UI User Guide
Set Your Preferences
More information:
Set Shortcut Key Preferences (see page 30)
Help Content Preferences
Content preferences are not currently supported by CA File Master Plus.
More information:
Set Your Preferences (see page 23)
Set Eclipse UI Preferences (see page 24)
Set Startup Preferences (see page 26)
Set Preferences for Text Editors (see page 28)
Set Shortcut Key Preferences (see page 30)
Set Help Preferences (see page 32)
Chapter 2: Understanding Your Workspace 33
Chapter 3: Servers
CA File Master Plus relies on a server running on a z/OS mainframe to provide all
mainframe services.
The CA File Master Plus server is installed with the mainframe component of CA File
Master Plus. It is started by submitting a CA supplied job to z/OS. The server continues
to execute until an administrator issues a stop command or the job gets canceled.
Once started, the application uses a TCP/IP port number that enables CA File Master
Plus to communicate with the z/OS mainframe. A port number is assigned during the
installation of the server. You must specify this port number when you define a server
connection.
This section contains the following topics:
Add a New Server Connection (see page 35)
Configure Mainframe Settings (see page 36)
Log On to the Mainframe (see page 40)
Reconfigure a Server (see page 41)
Reset Server Password (see page 42)
Refresh Server Status (see page 42)
Remove a Server Connection (see page 43)
Add a New Server Connection
Before you start to view and edit data, you need to connect to a server. When you add a
server it appears in the Directory List view.
Follow these steps:
1.
Select CA File Master Plus, Add Server.
The New Server Definition dialog opens.
2.
Complete the following fields:
Name
Specifies the name of the server connection. Valid values are uppercase and
lowercase alphanumeric characters, special characters, and embedded spaces.
Host
Specifies the z/OS host name assigned by your installation that is used for a
TSO or CICS logon.
Chapter 3: Servers 35
Configure Mainframe Settings
Port
Specifies the TCP/IP port number of the server.
3.
Click Finish.
The server is added to the Directory List view.
More information:
Servers (see page 35)
Configure Mainframe Settings (see page 36)
Log On to the Mainframe (see page 40)
Reconfigure a Server (see page 41)
Reset Server Password (see page 42)
Refresh Server Status (see page 42)
Remove a Server Connection (see page 43)
Configure Mainframe Settings
Configure your mainframe settings to specify your default processing and change log
parameters and other settings specific to the servers you are connecting to. You must
add a server to your Directory List view before you can configure these settings.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the server you want to configure and select Configure Mainframe
Settings.
3.
Set the options on Defaults tab.
Confirm data set deletes on mainframe
Displays a confirmation screen when you delete a data set from the mainframe.
Confirm member deletes on mainframe
Displays a confirmation screen when you delete a member from a data set on
the mainframe.
36 Eclipse UI User Guide
Configure Mainframe Settings
Specify one of the following:
DASD unit name
Specifies the initial value used for the generic unit name when new data
sets are allocated.
Default: SYSDA
SMS storage class
Specifies the initial value for the SMS storage class used for the allocation
of new data sets that will be SMS-managed.
Job information
Specify 1-4 lines of JCL control statements, usually jobcard information. These
lines are inserted at the beginning of all CA File Master Plus-generated batch
jobs.
Note: Each line can contain up to 73 characters.
4.
Set the options on the Parm Files tab.
Selection criteria
Defines the selection criteria PDS that contains statements used to filter your
view of data.
Custom record layout
Defines the default custom record layout PDS.
Note: You can allocate a new data set by clicking on the Allocate button. For more
information, see Allocate a New Parm PDS (see page 40) in the online help.
5.
Set the options on the Change Log tab.
Data set name pattern
Displays the name of the change log file. This field is not editable.
Storage
Set one of the following:
Volume serial
Identifies the volume on which a new change log file will be allocated.
Note: Select this only when directing the change log to a specific volume.
Generic unit
Identifies the generic unit on which a new change log file will be allocated.
Note: Leave this blank if you want to use the generic unit default value.
Chapter 3: Servers 37
Configure Mainframe Settings
Primary allocation
Defines the number of cylinders to indicate the space of the primary allocation
of the change log data set. The value must be greater than zero.
Secondary allocation
Defines the number of cylinders to indicate the space of the secondary
allocation of the change log data set.
6.
Set the options on the Print tab. The options and values you specify here become
the default values for the print function.
Sysout class
Specifies the position of the sysout class to which you want the printer routed.
Number of copies
Specifies the number of copies that you want printed.
(Optional) Define print destination
Specifies the printer you want to use. Select one of the following options:
Destination printer
Specifies the printer ID of the local or remote printer to which you want
the print job routed.
External JES node
Specifies the external JES node name to which you want the print job
routed.
Sysout writer name
Specifies the member name of the sysout writer program to which you
want the print job routed.
Print data set name
Specifies the name of the data set to which you want to print.
Print member name
Specifies the name of the member to which you want to print. Also specify
the data set disposition:
■
Select SHR if you want the printed data to replace the contents of an
existing data set. This option allows concurrent access to the data set while
the print is in progress.
■
Select MOD if you want the printed data added to the end of an existing
data set.
■
Click the New button to create a new data set.
Note: For detailed information about the Allocate screen, see one of the
following topics in the online help:
38 Eclipse UI User Guide
Configure Mainframe Settings
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
Note: The options and values you specify here will be the default print settings
when you access the print function in CA File Master Plus.
7.
Click Finish.
Your mainframe settings for this server are configured.
Note: You can configure the Eclipse UI preferences from the Window menu. For more
information about configuring the Eclipse UI preferences, see Set Eclipse UI Preferences
(see page 24).
More information:
Servers (see page 35)
Allocate a New Parm PDS (see page 40)
Add a New Server Connection (see page 35)
Log On to the Mainframe (see page 40)
Reconfigure a Server (see page 41)
Reset Server Password (see page 42)
Refresh Server Status (see page 42)
Remove a Server Connection (see page 43)
Set Eclipse UI Preferences (see page 24)
Chapter 3: Servers 39
Log On to the Mainframe
Allocate a New Parm PDS
You can define a new parm PDS when configuring your mainframe settings. Use the
Allocate button to allocate the new PDS from within CA File Master Plus so you do not
have to configure the new PDS manually.
Follow these steps:
1.
Open the Allocate a New Parm PDS dialog from the Configure Mainframe Settings
dialog. For more information, see Configure Mainframe Settings (see page 36).
2.
Complete the DSN of New Parm PDS field to define the data set name.
3.
Specify the Allocation Options
Allocate empty
The new PDS is allocated with no members.
Allocate and copy selected members
The new PDS is allocated, and then you select members to copy from the PDS
specified in the Copy from PDS field.
Allocate and copy all members
The new PDS is allocated, and members from the PDS specified in the Copy
from PDS field are copied.
4.
Click Next.
The Allocate a New Partitioned Data Set dialog opens.
5.
Complete the Allocate a New Partitioned Data Set dialog. For more information, see
Allocate a New Partitioned Data Set (see page 62).
The new parm PDS is allocated as defined.
More information:
Configure Mainframe Settings (see page 36)
Refresh Server Status (see page 42)
Add a New Server Connection (see page 35)
Reconfigure a Server (see page 41)
Remove a Server Connection (see page 43)
Reset Server Password (see page 42)
Configure Mainframe Settings (see page 36)
Log On to the Mainframe
You are prompted to supply your logon credentials the first time you request data from
the server or send data to the server.
40 Eclipse UI User Guide
Reconfigure a Server
Reconfigure a Server
You can reconfigure the existing server definitions displayed on the Directory List view.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the server that you want to configure and click Update Server.
The Update Server Definition dialog opens.
3.
Modify the details for the server that you want to configure.
Name
Specifies the name of the server connection.
Valid values: uppercase and lowercase alphanumeric characters, special
characters, and embedded spaces.
Host
Specifies the z/OS host name assigned by your installation. This is the host
name used for TSO logon.
Port
Specifies the TCP/IP port number for the selected server.
4.
Click Finish.
The server definition is updated and the Directory List view shows the details of the
modified server.
More information:
Servers (see page 35)
Add a New Server Connection (see page 35)
Configure Mainframe Settings (see page 36)
Log On to the Mainframe (see page 40)
Reset Server Password (see page 42)
Refresh Server Status (see page 42)
Remove a Server Connection (see page 43)
Chapter 3: Servers 41
Reset Server Password
Reset Server Password
You can reset the password for any server connection listed in the Directory List view.
Reset Password clears the password you have stored. You will be prompted to enter
your password the next time CA File Master Plus accesses the mainframe.
Note: You cannot change your mainframe password in CA File Master Plus.
To reset your server password, right-click the server connection in the Directory List
view whose password you want to reset, and then click Reset Password.
More information:
Servers (see page 35)
Add a New Server Connection (see page 35)
Configure Mainframe Settings (see page 36)
Log On to the Mainframe (see page 40)
Reconfigure a Server (see page 41)
Refresh Server Status (see page 42)
Remove a Server Connection (see page 43)
Refresh Server Status
You may want to refresh the status for server connections in the Directory List view.
To refresh the status of a server, right-click the server name and select Refresh Server.
The Directory List view reloads to show the most current status for the server
connections that you refreshed.
More information:
Servers (see page 35)
Add a New Server Connection (see page 35)
Configure Mainframe Settings (see page 36)
Log On to the Mainframe (see page 40)
Reconfigure a Server (see page 41)
Reset Server Password (see page 42)
Remove a Server Connection (see page 43)
42 Eclipse UI User Guide
Remove a Server Connection
Remove a Server Connection
You can remove a server connection from the Directory List view. If you are no longer
using a server, you may want to remove the connection to maintain a clean workspace.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the server that you want to remove and select Remove Server From List.
Note: You can use Ctrl-click or Shift-click to remove multiple servers.
A confirmation dialog opens.
3.
Click Yes.
The selected server connection is removed from the Directory List view. The view
refreshes to show the list of available server connections.
More information:
Servers (see page 35)
Add a New Server Connection (see page 35)
Configure Mainframe Settings (see page 36)
Log On to the Mainframe (see page 40)
Reconfigure a Server (see page 41)
Reset Server Password (see page 42)
Refresh Server Status (see page 42)
Chapter 3: Servers 43
Chapter 4: Data Sets
You can use CA File Master Plus to manipulate z/OS data sets. You can add, delete, copy,
edit, and print VSAM, sequential, PDS data sets, and PDS members. Perform these
actions through the Directory List view after adding one or more servers.
Note: You can view the properties of any data set in your Directory List view. To display
data set properties, right-click a data set and select Properties.
Note: The application supports PDS and PDSE files. Where ever the documentation says
PDS, it also refers to PDSE files, unless otherwise noted.
This section contains the following topics:
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
Select a Data Set
Many of the tools in CA File Master Plus require that you select or identify data sets
upon which to perform an action. You can select data sets in several ways. The method
that best meets your needs is defined by the task you are attempting to accomplish and
the information you have available.
To specify a data set in a field like the Data set name field in dialogs and wizards such as
Add a Data set, Add Layout, and Add Selection Criteria, follow the steps in one of the
following methods:
■
Use the drop-down menu to select a data set from the history of previously used
data set names
■
Type a fully qualified data set name of 1 - 44 characters, with each qualifier being 1
- 8 characters long. Characters can be alphanumeric (A - Z, 0 - 9), national (@,#,$),
or a hyphen (-). Separate each qualifier with a period (.). The first character of a
qualifier must be a letter or a national character.
Chapter 4: Data Sets 45
Select a Data Set
■
Type a wildcarded data set name and complete the following steps:
–
Click Select.
The dialog is populated with data set names that match your wildcarded
criteria. The populated table displays the following columns:
–
–
Data set name
–
Volume
–
File type
–
Data set organization string (DSOrgStr)
–
Logical record length (LRECL)
–
Block Size (BlkSize)
–
Record (RecFM)
–
Tracks
–
Extents
–
Date Created
–
Date Referenced
Select the check box next to the data set that you want to add to the view.
Select more than one check box to add multiple data sets, or use the Select All
button to select all data sets in the list.
Note: The application supports the standard IBM wildcard characters *, **, and %.
More information:
Data Sets (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
Properties (see page 149)
46 Eclipse UI User Guide
Add a Data Set
Add a Data Set
Add a data set to your Directory List view to work with the data set or members within
the data set. You can add any number of data sets to your view.
Follow these steps:
1.
Open the Directory List view.
2.
Select the server in the Directory List view to which you want to add a data set.
3.
Right-click and select Add Data Set.
The Add Data Set dialog opens.
4.
Complete the following fields:
Data set name
Specifies the name of the data set you want to add.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Volume serial
Enter the volume serial only if the data set is not cataloged. Otherwise, leave
this field empty.
5.
Click Finish.
The data set is added to the list of data sets under the selected server.
Note: Data sets are listed in alphabetical order.
More information:
Data Sets (see page 45)
Select a Data Set (see page 45)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
Properties (see page 149)
Chapter 4: Data Sets 47
Remove a Data Set
Remove a Data Set
You can remove data sets you no longer want in your Directory List view. This procedure
removes the data set from your Directory List view, but does not otherwise alter the
data set itself. To delete a data set from the mainframe, use the Delete function. For
more information, see Delete a Data Set (see page 51).
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the data set that you want to delete and select Remove Data Set From
List.
Note: You can use Ctrl-click or Shift-click to remove multiple data sets.
The Confirm Remove dialog opens.
3.
Click OK.
The data set is removed from the server. The Directory List view refreshes to show
the list of available data sets.
More information
Data Sets (see page 45)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
48 Eclipse UI User Guide
Rename a Data Set
Rename a Data Set
You can rename a cataloged data set on the mainframe using the Eclipse UI through the
Directory List view.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the data set that you want to rename and select Mainframe Data Set
Utilities, Rename Data Set.
The Rename Data Set dialog displays.
3.
Type the new name into the New name field.
4.
Click OK.
The data set is renamed on the mainframe, and the Directory List view updates to
reflect the new name.
More information:
Data Sets (see page 45)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
Chapter 4: Data Sets 49
Rename a VSAM Data Set
Rename a VSAM Data Set
You can rename a VSAM data set on the mainframe using the Eclipse UI through the
Directory List view.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the VSAM data set that you want to rename and select Mainframe Data
Set Utilities, Rename Data Set.
3.
Type the new name into the New cluster field.
Note: By default, the Same update to data and index option is selected. You can
modify the data and index names by clearing this check box and typing the new
data and index names into the New data and New index fields.
4.
Click OK.
The Confirm Rename dialog displays.
Note: You can customize the Eclipse UI to rename data sets and members without
prompting for confirmation. For more information, see Set Eclipse UI Preferences
(see page 24).
5.
Click OK.
The data set is renamed on the mainframe, and the Directory List view updates to
reflect the new name.
More information:
Data Sets (see page 45)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
50 Eclipse UI User Guide
Delete a Data Set
Delete a Data Set
You can delete a cataloged data set from the mainframe using the Eclipse UI. The
following procedure deletes a data set from the mainframe and removes it from your
Directory List view.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the data set that you want to delete and select Mainframe Data Set
Utilities, Delete Data Set.
Note: You can use Ctrl+click or Shift+click to delete multiple data sets.
The Confirm Delete dialog displays.
Note: You can configure the application so that the confirm dialog does not display.
Set this option in the Configure Mainframe Settings dialog. For more information,
see Configure Mainframe Settings (see page 36).
3.
Click OK.
The data set is deleted from the mainframe and removed from the Directory List
view. The Directory List view refreshes to show the list of available data sets.
More information:
Data Sets (see page 45)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
Copy Utility
You can use CA File Master Plus to copy PDS files and members, Sequential data sets,
and VSAM data sets. Use this feature to perform tasks such as creating backup and
recovery files or test files. To access the copy utility menu option, right-click the data set
that you want to copy. If the data set is not listed in the Directory List view, select Copy
from the CA File Master Plus, Utilities menu.
Chapter 4: Data Sets 51
Copy Utility
More information:
Data Sets (see page 45)
Copy a PDS File (see page 52)
Copy a Sequential File (see page 56)
Copy a VSAM File (see page 59)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Print Utility (see page 78)
Select a Data Set (see page 45)
Select a Member (see page 83)
Copy a PDS File
The copy utility lets you copy an entire PDS data set or selected members of a PDS data
set into another existing data set or into a newly allocated data set.
Follow these steps:
1.
Open the Directory List view.
2.
Select the data set or member name that you want to copy.
3.
Right-click and select Utilities, Copy PDS.
The Copy PDS Utility wizard opens. The Data set name field displays the name of
the data set you selected.
Note: You can copy data sets not listed in your Directory List view by selecting
Utilities, Copy from the CA File Master Plus menu. If you select this option, there is
an additional page at the beginning of the wizard in which you identify the data set
that you want to copy.
52 Eclipse UI User Guide
Copy Utility
4.
Complete the following fields to identify what you want to copy:
(Optional) Member name
Specifies the specific member or members that you want to copy. Enter an
asterisk (*) to copy all members.
Note: For more information about identifying a member, see Select a Member
(see page 83).
Note: You can specify a new name for copied members in the Rename column
of the Members table.
Volume serial
Specifies the volume serial. This step is mandatory if the data set is not
cataloged. Otherwise, this step is optional.
5.
Click Next.
6.
Specify where you want to copy the data set or members to:
Data set name
Identify the name of the data set that you want the information copied to. This
can be a data set that exists on the server or the name of a new data set.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Volume serial
Specifies the volume serial. This step is mandatory if the data set is not
cataloged. Otherwise, this step is optional.
Chapter 4: Data Sets 53
Copy Utility
7.
Specify the disposition of the copy by selecting SHR, OLD, or NEW.
■
Select SHR if you want the copied data to replace the contents of an existing
data set. This option allows concurrent access to the data sets while the copy is
in progress.
■
Select OLD if you want the copied data to replace the contents of an existing
data set. This option restricts access to the data sets while the copy is in
progress.
■
Click the New button to create a new data set. If you select this option, you
must take the following steps:
–
Specify the type of data set to create in the New Allocation group.
–
Click the Allocate button to open the Allocate wizard.
–
Complete the fields in the Allocate wizard and click Finish.
Note: For detailed information about the Allocate wizard, see one of the
following topics:
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
54 Eclipse UI User Guide
Copy Utility
8.
(Optional) Select the Replace Like-Named Members replacement option.
When a copied member exists in both the To and From data sets, members in the
From data set replace members with the same name in the To data set. Select this
check box to enable this replacement option. If this check box is not selected,
members with the same name are not copied.
9.
Click Next.
10. (Optional) Do one of the following to specify the layout:
■
Select from the drop-down list a layout displayed in your layout view.
■
Specify the layout data set and member name.
11. (Optional) Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
12. Click Next.
A summary page shows the options that you have selected.
13. Click Finish.
The Copy Wizard report view opens and displays information about the copy
operation.
Note: Select Copy Utility from the CA File Master Plus menu if the data set you want
to copy is not in the Directory List view.
More information:
Copy Utility (see page 51)
Copy a Sequential File (see page 56)
Copy a VSAM File (see page 59)
Select a Data Set (see page 45)
Select a Member (see page 83)
Chapter 4: Data Sets 55
Copy Utility
Copy a Sequential File
The copy utility lets you copy a data set into another existing data set or into a newly
allocated data set.
Follow these steps:
1.
Open the Directory List view.
2.
Select the data set that you want to copy.
3.
Right-click and select Utilities, Copy Sequential.
The Copy Sequential Utility wizard opens. The Data set name field displays the
name of the data set you selected.
Note: You can copy data sets not listed in your Directory List view by selecting
Utilities, Copy from the CA File Master Plus menu. If you select this option, there is
an additional page at the beginning of the wizard in which you identify the data set
that you want to copy.
4.
Specify the volume serial of the data set that you want to copy. This step is
mandatory if the data set is not cataloged. Otherwise, this step is optional
5.
Specify where you want to copy the data set or members to:
Data set name
Select the data set where you want the copied records to be put.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
(Optional) Member name
Specify the member to which you want to copy the sequential file data, if you
are copying the sequential data set to a PDS.
Note: For more information about identifying a member, see Select a Member
(see page 83).
Volume serial
Specifies the volume serial. This step is mandatory if the data set is not
cataloged. Otherwise, this step is optional.
6.
56 Eclipse UI User Guide
Specify the disposition of the copy by selecting SHR, OLD, MOD, or by creating a
new data set.
■
Select SHR if you want the copied data set to replace the contents of an
existing data set. This option allows concurrent access to the data sets while
the copy is in progress.
■
Select OLD if you want the copied data set to replace the contents of an
existing data set. This option restricts access to the data sets while the copy is
in progress.
Copy Utility
■
Select MOD if you want the copied data set added to the end of an existing
data set.
■
Click the New button to create a new data set. If you select this option, you
must take the following steps:
–
Specify the type of data set to create in the New Allocation group.
–
Click the Allocate button to open the Allocate wizard.
–
Complete the fields in the Allocate wizard and click Finish.
Note: For detailed information about the Allocate wizard, see one of the
following topics:
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
7.
Click Next.
8.
(Optional) Do one of the following to specify the layout:
9.
■
Select from the drop-down list a layout displayed in your layout view.
■
Specify the layout data set and member name.
(Optional) Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
10. Click Next.
A summary page shows the options that you have selected.
11. Click Finish.
The Copy Wizard report view opens and displays information about the copy
operation.
Chapter 4: Data Sets 57
Copy Utility
Note: Select Copy Utility from the CA File Master Plus menu if the data set you want
to copy is not in the Directory List view.
More information:
Copy Utility (see page 51)
Copy a PDS File (see page 52)
Copy a VSAM File (see page 59)
Select a Data Set (see page 45)
Select a Member (see page 83)
58 Eclipse UI User Guide
Copy Utility
Copy a VSAM File
The copy utility lets you copy a data set into another existing data set or into a newly
allocated data set.
Follow these steps:
1.
Open the Directory List view.
2.
Select from the Directory List view the data set you want to copy.
3.
Right-click and select Utilities, Copy VSAM.
The Copy VSAM Utility wizard opens. The Data set name field displays the name of
the data set you selected.
Note: You can copy data sets not listed in your Directory List view by selecting
Utilities, Copy from the CA File Master Plus menu. If you select this option, there is
an additional page at the beginning of the wizard in which you identify the data set
that you want to copy.
4.
Click Next.
5.
Specify where you want to copy the data set or members to:
(Optional) Member name
If you are copying the VSAM file to a PDS, you can select the specific member
to which you want to copy the sequential file data.
Note: For more information about identifying a member, see Select a Member
(see page 83).
Volume serial
Specifies the volume serial. This step is mandatory if the data set is not
cataloged. Otherwise, this step is optional.
6.
Specify the disposition of the copy by selecting either SHR or OLD, or creating a new
data set:
■
Select SHR if you want the copied data set to replace the contents of an
existing data set. This option allows concurrent access to the data sets while
the copy is in progress.
■
Select OLD if you want the copied data set to replace the contents of an
existing data set. This option restricts access to the data sets while the copy is
in progress.
■
Click the New button to create a new data set. If you select this option, you
must take the following steps:
–
Specify the type of data set to create in the New Allocation group.
–
Click the Allocate button to open the Allocate wizard.
–
Complete the fields in the Allocate wizard and click Finish.
Chapter 4: Data Sets 59
Copy Utility
Note: For detailed information about the Allocate wizard, see one of the
following topics:
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
7.
(Optional) Select the Replace duplicate keys in KSDS replacement option.
When a key exists in both the KSDS VSAM To and From data sets, keys in the From
data set replace duplicate keys in the To data set. Select this check box to enable
this replacement option. If this check box is not selected, encountering duplicate
keys causes an abend.
8.
Click Next.
9.
(Optional) Do one of the following to specify the layout:
■
Select from the drop-down list a layout displayed in your layout view.
■
Specify the layout data set and member name.
10. (Optional) Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
11. Click Next.
A summary page shows the options that you have selected.
12. Click Finish
The Copy Wizard report view opens and displays information about the copy
operation.
60 Eclipse UI User Guide
Allocate
More information:
Copy Utility (see page 51)
Copy a PDS File (see page 52)
Copy a Sequential File (see page 56)
Select a Data Set (see page 45)
Select a Member (see page 83)
Allocate
You can use CA File Master Plus to allocate PDS, Sequential, and VSAM data sets. This
utility is available through the copy wizards. Alternatively, you can access the Allocate
Data Set wizard by selecting a server and the selecting Allocate Data Set from the CA File
Master Plus, Manage Data Sets menu. The following procedure describes how to access
the file-specific Allocate Data Set wizard using the CA File Master Plus menu.
Follow these steps:
1.
Select the server to where you want the newly allocated data set to reside.
2.
Select Allocate from the CA File Master Plus, Manage Data Sets menu.
The Allocate Data Set wizard opens.
3.
Specify the name of the data set that you want to create.
4.
Specify the data set type. Select one of the following file types:
5.
■
PDS
■
SEQ
■
VSAM
Click Next
The subsequent pages of the Allocate Data Set wizard for the specified data set file
type display. Complete the allocation wizard using the following instructions for the
specified file type:
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
The data set is allocated according to your specifications.
Chapter 4: Data Sets 61
Allocate
More information:
Data Sets (see page 45)
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
Add Multiple Volumes (see page 69)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Compare Utility (see page 69)
Print Utility (see page 78)
Select a Data Set (see page 45)
Select a Member (see page 83)
Allocate a New PDS
Use the Allocate New Partitioned Data Set wizard to create a new PDS.
Follow these steps:
62 Eclipse UI User Guide
1.
Select Add to Directory List view if you want the new data set displayed in your
Directory List view.
2.
Complete the Model Data Set Name field if you want your new PDS to copy the
properties of another PDS.
a.
Enter the name of a data set that exists on the server.
b.
Click Confirm.
Allocate
3.
Complete one of the following sections:
■
SMS Data Set—Complete the fields in this section to define the location and
attributes of your new data set.
Management Class
Specifies the name of the SMS management class that controls data set
backup, retention, and migration services
Storage Class
Specifies the name of the SMS storage class associated with the data set
that controls the volume where the data set is stored
Data Class
Specifies the name of the SMS data class that defines the allocation
defaults for the data set
■
Use Non-SMS—Select this option and complete one of the following fields for
the data set you are allocating.
Volume Serial
Specifies the volume serial.
Generic Unit Name
Specifies the generic unit name for the direct-access volume in which you
want the data set stored.
4.
Click Next.
5.
Specify the data set type. Select one of the following options:
PDS
Partitioned Data Set
PDSE
Partitioned Data Set Extended
6.
Specify the space allocation unit.
Chapter 4: Data Sets 63
Allocate
7.
Specify the allocation parameters:
Primary Allocation
Specifies the amount of space allocated in each primary allocation that
contains the specified number of tracks, cylinders, or blocks
Secondary Allocation
Specifies the amount of space allocated in each secondary allocation that
contains the specified number of tracks, cylinders, or blocks
Directory Blocks
Specifies the number of 256-byte directory blocks to allocate for the data set
Note: If you are allocating a PDS, this parameter is mandatory. If you are
allocating a PDSE, it is optional.
Record Format
Specifies the format of the record.
Record Length
Specifies the logical record length allocated for records stored in the data set
Block Size
Specifies the size allocated for variable blocked or fixed blocked files
Note: Select Use optimal value to allow the system to calculate the optimum
block size.
8.
Click Finish.
Allocate a New Sequential Data Set
Use the Allocate New Sequential Data Set wizard to create a new sequential data set.
Follow these steps:
64 Eclipse UI User Guide
1.
Select Add to Directory List view if you want the new data set displayed in your
Directory List view.
2.
Complete the Model Data Set Name field if you want your new data set to copy the
properties of another data set.
a.
Enter the name of a data set that exists on the server.
b.
Click Confirm.
Allocate
3.
Complete one of the following sections:
■
SMS Data Set—Complete the fields in this section to define the location and
attributes of your new data set.
Management Class
Specifies the name of the SMS management class that controls data set
backup, retention, and migration services
Storage Class
Specifies the name of the SMS storage class associated with the data set
that controls the volume where the data set is stored
Data Class
Specifies the name of the SMS data class that defines the allocation
defaults for the data set
■
Use Non-SMS—Select this option and complete one of the following fields for
the data set you are allocating.
Volume Serial
Specifies the volume serial.
Generic Unit Name
Specifies the generic unit name for the direct-access volume in which you
want the data set stored.
4.
Click Next.
5.
Specify the data set type. Select one of the following options:
SEQ
Sequential file
LARGE
Large format sequential data set
6.
Specify the space allocation unit.
7.
Specify the allocation parameters:
Primary Allocation
Specifies the amount of space allocated in each primary allocation that
contains the specified number of tracks, cylinders, or blocks
Secondary Allocation
Specifies the amount of space allocated in each secondary allocation that
contains the specified number of tracks, cylinders, or blocks
Chapter 4: Data Sets 65
Allocate
Record Format
Specifies the format of the record.
Record Length
Specifies the logical record length allocated for records stored in the data set
Block Size
Specifies the size allocated for variable blocked or fixed blocked files
Note: Select Use optimal value to allow the system to calculate the optimum
block size.
Multiple Volumes
Specifies that the new data set contains multiple volumes.
Note: If you select Multiple Volumes, click Edit to open the Add Multiple
Volumes dialog. For more information on the Add Multiple Volumes dialog, see
Add Multiple Volumes (see page 69).
8.
Click Finish.
More information:
Allocate (see page 61)
Allocate a New PDS (see page 62)
Allocate a New VSAM Data Set (see page 67)
Add Multiple Volumes (see page 69)
Select a Data Set (see page 45)
Add Multiple Volumes (see page 69)
Select a Member (see page 83)
66 Eclipse UI User Guide
Allocate
Allocate a New VSAM Data Set
Use the Allocate New VSAM Data Set wizard to create a new VSAM data set.
Follow these steps:
1.
Select Add to Directory List view if you want the new data set displayed in your
Directory List view.
2.
Complete the Model Data Set Name field if you want your new data set to copy the
properties of another data set.
a.
Enter the name of a data set that exists on the server.
b.
Click Confirm.
3.
Complete the fields in the Component DSNs section to define the data set name,
location, and file type.
4.
Select and complete one of the following sections:
5.
■
Volume—Complete the Data and Index fields to specify the volume that
contains the data component of the VSAM that you are defining.
■
SMS Class—Complete the Storage Class, Data Class, and Management Class
fields to define the location and attributes of your new data set.
Select options for additional functionalities in the Options section.
Note: If you select Multiple Volumes, click Edit to open the Add Multiple Volumes
dialog. For more information on the Add Multiple Volumes dialog, see Add Multiple
Volumes (see page 69).
6.
Click Next.
7.
Define the allocation parameters. Specify the following parameters:
CI Size
Control size for the data and index components of the file
Unit
Space allocation unit. Select one of the following options:
TRKS
Tracks
CYL
Cylinders
REC
Records
K
Kilobytes
Chapter 4: Data Sets 67
Allocate
M
Megabytes
Primary
Primary space allocation
Secondary
Secondary space allocation
Key position
Position of key for VSAM file
Key length
Key length for VSAM file
Avg record size
Average length of records
Max record size
Length of largest record allowed
Owner ID
ID of owner associated with file
Percent free CI and CA
Amount of empty space allocated in each control interval when file is initially
loaded
Share options crossregion
Specifies how the file can be shared among regions using Global Resource
Serialization. Select one of the following options:
1
Unlimited read OR one read/write
2
Unlimited read AND one read/write
3
Shared fully
4
Shared fully and updated/refreshed immediately
Share options crosssystem
Specifies how the file can be shared among systems using Global Resource
Serialization. Select one of the following options:
3
68 Eclipse UI User Guide
Compare Utility
Shared fully
4
Shared fully and updated/refreshed immediately
Buffer Space
Minimum buffer space allocated when file is accessed
8.
Click Finish.
More information:
Allocate (see page 61)
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Add Multiple Volumes (see page 69)
Select a Data Set (see page 45)
Add Multiple Volumes (see page 69)
Select a Member (see page 83)
Add Multiple Volumes
If you select the Multiple volumes option when allocating a data set, you must click the
Edit button to specify the details for the additional volumes. Complete the fields in the
Multiple Volumes dialog and then click Finish.
More information:
Allocate (see page 61)
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
Compare Utility
You can use CA File Master Plus to compare the contents of two data sets or two or
more members in a PDS. You can also compare the contents of two programs using this
utility. To access the compare utility menu option, right-click the member, data set, or
program that you want to compare. If the item that you want to compare is not listed in
the Directory List view, select a server and then select Compare from the CA File Master
Plus, Utilities menu.
Chapter 4: Data Sets 69
Compare Utility
More information:
Data Sets (see page 45)
Compare Utility (see page 71)
Compare Program Utility (see page 74)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Print Utility (see page 78)
Select a Data Set (see page 45)
Select a Member (see page 83)
70 Eclipse UI User Guide
Compare Utility
Compare Utility
You can use CA File Master Plus to compare the contents of two data sets or two or
more members in a PDS. Use this feature to perform tasks such as identifying or
verifying changes made to a data set. Access this utility through the right-click menu, or
you can compare data sets and members not listed in your Directory List view by
selecting a server and then selecting Compare from the CA File Master Plus, Utilities
menu.
Follow these steps:
1.
Open the Directory List view.
2.
Select from the Directory List view one of the data sets or members that you want
to compare.
3.
Right-click the data set or member and select Utilities, Compare.
The Compare Data Set Utility wizard opens.
4.
Complete the following fields on the Old Data Set page, or verify that the prefilled
information is correct:
Data set name
Specifies the name of the first data set that you want to compare.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member name
Specifies the name of the member that you want to compare. Perform a
wildcard search to select more than one member. Enter an asterisk (*) to
compare all members.
Note: This field is only active when comparing members in a PDS.
Note: For more information about identifying a member, see Select a Member
(see page 83).
5.
Click Next.
6.
Specify the name of the data set and member as on the New Data Set page. This
identifies data set and member that you want to compare to the Old data set. If you
are comparing members in a PDS, the Old and New data sets must both contain the
members you want to compare.
7.
Click Next.
8.
Select the Output Format options that you want to apply.
Print
Specifies the display format of the compare report. Select one of the following
options:
Character
Chapter 4: Data Sets 71
Compare Utility
Displays records in character format, up to 100 characters
Hexadecimal
Displays records in three-line hexadecimal format
Single record
Displays field names and values for each record.
Note: If you select this option, you must specify a record layout.
Record display
Specifies which records to display in the compare report. Select one of the
following options:
All
Displays all records
Mismatched
Displays only mismatched records
Summary
Displays only a summary of the data set compare
Field display
Specifies which fields to display in the compare report. Select one of the
following options:
All
Displays all fields
Mismatched
Displays only fields that have different content
9.
(Optional) Specify a layout for the old and new data sets. Do one of the following in
the Old data set layout and the New data set layout groups:
■
Select from the drop-down list a layout displayed in your Layout view.
■
Specify the layout data set and member name.
Note: Select Use old data set layout to use the specified layout for both the old and
new data sets.
Note: You must specify a layout for a single record report format. Otherwise, this
step is optional.
Note: For more information about identifying a data set, see Select a Data Set (see
page 45).
10. (Optional) Specify selection criteria. Do one of the following:
■
72 Eclipse UI User Guide
Type selection conditions into the selection criteria text box.
Compare Utility
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
Note: This option is only available if you specified a layout with the single
record print mode.
11. Click Next.
12. Specify the position of the data and length of the compare, if you want to compare
only a portion of a data set or member.
13. Click Next.
A summary page shows the options that you have selected.
14. Click Finish.
The summary results of your compare are displayed in the Report view.
You can display the detailed compare report by clicking the
icon in the top right
corner of the compare report summary. When you close the compare report
summary, the detailed compare report closes and is deleted.
More information:
Compare Utility (see page 69)
Compare Program Utility (see page 74)
Select a Data Set (see page 45)
Select a Member (see page 83)
Chapter 4: Data Sets 73
Compare Utility
Compare Program Utility
You can use CA File Master Plus to compare the contents of two programs or two
program libraries. Use this feature to complete tasks such as identifying any changes
made to a program. Access this utility through the right-click menu, or you can compare
programs not listed in your Directory List view by selecting a server and then selecting
Compare from the CA File Master Plus, Utilities menu.
Follow these steps:
1.
Open the Directory List view.
2.
Select from the Directory List view one of the programs that you want to compare.
3.
Right-click the program and select Utilities, Compare.
The Compare Program Utility wizard opens.
4.
Complete the following fields on the Old Data Set page, or verify that the prefilled
information is correct:
Data set name
Specifies the name of the data set that contains the program that you want to
compare.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member name
Specifies the name of the program that you want to compare. Perform a
wildcard search to select more than one program. Enter an asterisk (*) to
compare all members.
Note: For more information about identifying a member, see Select a Member
(see page 83).
5.
Click Next.
6.
Specify the name of the data set and member as on the New Data Set page. This
identifies program that you want to compare to the Old program. If you are
comparing members in a PDS, the Old and New data sets must both contain the
members you want to compare.
7.
Click Next.
8.
Specify the output format:
Print
Specifies the display format of the compare report. Select one of the following
options:
Character
Displays records in character format, up to 100 characters
Instruction
74 Eclipse UI User Guide
Compare Utility
Displays records in machine instruction format
Record display
Specifies which records to display in the compare report. Select one of the
following options:
All
Displays all records
Mismatched
Displays only mismatched records
Summary
Displays only a summary of the data set compare
Field display
Specifies which fields to display in the compare report. Select one of the
following options:
All
Displays all fields
Mismatched
Displays only fields that have different content
Max mismatches
Specifies the maximum number of mismatched records to display
Output page size
Specifies the maximum number of lines per page for the SYSLIST output file
9.
Specify the options that you want to include or exclude in the program compare.
Properties
Include
Specifies that the following options are included in the compare
Exclude
Specifies that the following options are excluded in the compare
Attributes
The program link attributes: reentrant, reusable, refreshable, authorization,
code, amode, rmode, and SSI
Entry point
The program entry point location
Link date
The date and time the program was linked
Chapter 4: Data Sets 75
Compare Utility
Total size
The size of the program
CSECT name
The name of the CSECTs
CSECT date
The date carried in Binder IDR-B records
CSECT size
The size of the CSECTs
Translator
Identifies compiler information
Content
The module text
IDRZAP
IDRZAP information carried in Binder B_IDRZ records
IDRUSER
Information carried in Binder B_IDRU records added as a result of the Binder
IDENTIFY statement or programmatically
ESD
External Symbol Information carried in Binder B_ESD records; for example,
external references
10. Specify the additional CSECT options for the compare.
CSECT compare
Controls how CSECTs are compared. Specify one of the following options:
By name
Specifies that CSECTs with identical names are compared
By order
Specifies that CSECTs are compared in the order in which they appear in
the program
(Optional) Include
CSECTs that are included from the program comparison
(Optional) Exclude
CSECTs that are excluded from the program comparison
76 Eclipse UI User Guide
Compare Utility
Note: You can use wildcards when specifying CSECTs to include or exclude. By
default, all CSECTs are compared. For more information, including syntax, see
the Batch Reference Eclipse Guide.
11. Click Next.
A summary page shows the options that you have selected.
12. Click Finish.
The summary results of your compare are displayed in the Report view.
You can display the detailed compare report by clicking the
icon in the top right
corner of the compare report summary. When you close the compare report
summary, the detailed compare report closes and is deleted.
More information:
Compare Utility (see page 69)
Compare Utility (see page 71)
Select a Data Set (see page 45)
Select a Member (see page 83)
Chapter 4: Data Sets 77
Print Utility
Print Utility
You can use CA File Master Plus to print the contents of a data set or PDS member. You
can limit the contents of what you print by specifying a starting position, setting a limit
on the number of records to print, and using selection criteria. Specify a layout to
format the print output. You can print a data set or member that is not listed in your
Directory List view by selecting a server and then selecting Print from the CA File Master
Plus, Utilities menu.
Note: You can only print to a device configured for the mainframe environment.
Follow these steps:
1.
Open the Directory List view.
2.
Select from the Directory List view the data set or member that you want to print.
3.
Right-click the data set or member that you want to print and select Utilities, Print.
The Print wizard opens. The server, data set name and member name (if applicable)
of the data set you are printing are displayed at the top of the wizard.
4.
Complete the following fields on the Print page:
Member name
Specifies the name of the member you want to print.
Note: The field is active if you have selected a PDS. If you selected a member in
a PDS in Step 3, the Member name field displays that member name, but you
can change it using this field. Selected members are displayed in the Members
table and you can change your member selections using the check boxes in that
table.
Note: For more information about identifying a member, see Select a Member
(see page 83).
Volume serial
Enter the volume serial. This step is mandatory if the data set is not cataloged.
Otherwise, this step is optional.
(Optional) Starting Key
Specify the location at which to begin printing. Use one of the following
formats, depending on the file type of the data set you are printing:
Sequential file
Numeric value for starting record number
KSDS VSAM
C'xxx' or X'hhhh' format for key of start position
ESDS VSAM
X'hhhh' format for RBA of start position
78 Eclipse UI User Guide
Print Utility
RRDS VSAM
Numeric Relative Record Number of start position
(Optional) Print Limit
Specify the maximum number of records that you want to be printed.
5.
Click Next.
6.
Specify the following options on the Options tab:
Print mode
Character
Displays records in character format, up to 100 characters
Hexadecimal
Displays records in three-line hexadecimal format
List
Displays records in character format without scale and record numbers
Single record
Displays field names and values for each record
Note: If you select this option, you must specify a record layout.
Layout
Specifies a layout. If you selected Single record for the print mode you must
specify a layout. Otherwise, this field is optional. Do one of the following:
■
Select from the drop-down list a layout displayed in your Layout view.
■
Specify the layout data set and member name.
Selection criteria
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection
Criteria Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the
specified layout.
Note: For more information on modifying selection criteria, see Modify
Layout Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that
the selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
Chapter 4: Data Sets 79
Print Utility
7.
Click Next.
8.
Specify the following options on the Print Output Control page:
Sysout class
Specifies the position of the sysout class to which you want the printer routed.
Number of copies
Specifies the number of copies that you want printed.
(Optional) Define print destination
Specifies the printer you want to use. Select one of the following options:
Destination printer
Specifies the printer ID of the local or remote printer to which you want
the print job routed.
External JES node
Specifies the external JES node name to which you want the print job
routed.
Sysout writer name
Specifies the member name of the sysout writer program to which you
want the print job routed.
Print data set name
Specifies the name of the data set to which you want to print.
Print member name
Specifies the name of the member to which you want to print. Also specify
the data set disposition:
■
Select SHR if you want the printed data to replace the contents of an
existing data set. This option allows concurrent access to the data set while
the print is in progress.
■
Select MOD if you want the printed data added to the end of an existing
data set.
■
Click the New button to create a new data set.
Note: For detailed information about the Allocate screen, see one of the
following topics in the online help:
Allocate a New PDS (see page 62)
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
9.
80 Eclipse UI User Guide
Click Next.
Print Utility
10. Type 1-4 lines of JCL control statements into the Job information box. If you
specified job information in the Configure Mainframe Settings dialog, that
information is prefilled and you can edit it if needed.
Note: Each line can contain up to 73 characters.
11. Click Finish.
The print job is submitted according to your specifications.
More information:
Data Sets (see page 45)
Select a Data Set (see page 45)
Add a Data Set (see page 47)
Remove a Data Set (see page 48)
Rename a Data Set (see page 49)
Rename a VSAM Data Set (see page 50)
Delete a Data Set (see page 51)
Copy Utility (see page 51)
Allocate (see page 61)
Compare Utility (see page 69)
Chapter 4: Data Sets 81
Chapter 5: Members
You can use CA File Master Plus to manipulate members in data sets. You can add,
remove, edit, and compare members in PDS files. Perform these actions through the
Directory List view after adding one or more PDS files.
This section contains the following topics:
Select a Member (see page 83)
Add a Member (see page 84)
Remove a Member (see page 85)
Rename a Member (see page 86)
Delete a Member (see page 87)
Open a Data Set or Member (see page 88)
Compare Utility (see page 97)
Select a Member
Many of the tools in CA File Master Plus require that you select, or identify, a member
upon which to perform an action. To select a member, type a fully qualified member
name of 1 - 8 characters. Characters can be alphanumeric (A to Z, 0 - 9) and national
(@,#,$). The first character must be a letter or a national character. You can use
wildcards and selection criteria to select a member.
Note: The application supports the standard IBM wildcard characters *, **, and %.
To select a member using a wildcard, follow these steps:
1.
Type a wildcarded member name and click Select.
The Select Member dialog opens. The Select member table populates with
members that meet the wildcard conditions.
2.
Select the check box next to the member you want to add to the view. Select more
than one check box to add multiple members.
3.
Click OK.
To select a member using selection criteria, follow these steps:
1.
Leave the Member name field blank or type a wildcarded member name and click
Filter.
The Select Member Options dialog opens.
Chapter 5: Members 83
Add a Member
2.
3.
(Optional) Do one of the following to specify the layout:
■
Select from the drop-down list a layout displayed in your layout view.
■
Specify the layout data set and member name.
Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
4.
Click OK.
The Select Member Options dialog closes and the Select member table populates
with members that meet the specified selection criteria.
5.
Select the check box next to the member you want to add to the view. Select more
than one check box to add multiple members.
6.
Click OK.
More information:
Members (see page 83)
Add a Member (see page 84)
Remove a Member (see page 85)
Rename a Member (see page 86)
Delete a Member (see page 87)
Open a Data Set or Member (see page 88)
Compare Utility (see page 97)
Select a Data Set (see page 45)
Add a Member
You can add members from a PDS data set to your Directory List view using CA File
Master Plus. Use this feature to manage the content of your Directory List view.
84 Eclipse UI User Guide
Remove a Member
Follow these steps:
1.
Open the Directory List view.
2.
Select the PDS data set you want to add a member to.
3.
Right-click and select Add Member.
The Select Member dialog opens.
4.
Select the members that you want to add.
Note: For more information about identifying a member, see Select a Member (see
page 83).
5.
Click Finish.
The member is added to the PDS, and the Directory List view refreshes to display
the members added to the data set. Members are listed in alphabetical order under
the data set in which they reside.
More information:
Members (see page 83)
Select a Member (see page 83)
Remove a Member (see page 85)
Rename a Member (see page 86)
Delete a Member (see page 87)
Open a Data Set or Member (see page 88)
Compare Utility (see page 97)
Select a Data Set (see page 45)
Select a Member (see page 83)
Remove a Member
You can remove members from data sets in your Directory List view using CA File Master
Plus. Use this feature to manage the content of your Directory List view. Removing
members updates the Directory List view only. This action does not modify the contents
of the data set. To delete a member from the mainframe, use the Delete function. For
more information, see Delete a Member (see page 87).
Chapter 5: Members 85
Rename a Member
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the member that you want to remove from the Directory List view and
select Remove Member From List.
Note: You can use Ctrl-click and Shift-click to select multiple members to remove.
The Confirm Remove dialog opens.
3.
Click OK.
The member is removed from the data set. The Directory List view refreshes to
show the updated list of available data sets and members.
More information:
Members (see page 83)
Select a Member (see page 83)
Add a Member (see page 84)
Rename a Member (see page 86)
Delete a Member (see page 87)
Open a Data Set or Member (see page 88)
Compare Utility (see page 97)
Rename a Member
You can rename members in a PDS data set in your Directory List view using CA File
Master Plus.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the member that you want to rename and select Mainframe Library
Utilities, Rename Member.
The Rename Member dialog displays.
3.
Type the new name into the New name field.
4.
Click OK.
The member is renamed on the mainframe, and the Directory List view updates to
reflect the new name.
86 Eclipse UI User Guide
Delete a Member
More information:
Members (see page 83)
Select a Member (see page 83)
Add a Member (see page 84)
Remove a Member (see page 85)
Delete a Member (see page 87)
Open a Data Set or Member (see page 88)
Compare Utility (see page 97)
Delete a Member
You can delete a member from a data set on the mainframe using the Eclipse UI. The
following procedure deletes a member from the mainframe and removes it from your
Directory List view.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the member that you want to delete and select Mainframe Library
Utilities, Delete Member.
Note: You can use Ctrl+click or Shift+click to delete multiple members.
The Confirm Delete dialog displays.
Note: You can configure the application so that the confirm dialog does not display.
Set this option in the Configure Mainframe Settings dialog. For more information,
see Configure Mainframe Settings (see page 36).
3.
Click OK.
The member is deleted from the mainframe and removed from the Directory List
view. The Directory List view refreshes to show the list of available members.
More information:
Members (see page 83)
Select a Member (see page 83)
Add a Member (see page 84)
Remove a Member (see page 85)
Rename a Member (see page 86)
Open a Data Set or Member (see page 88)
Compare Utility (see page 97)
Chapter 5: Members 87
Open a Data Set or Member
Open a Data Set or Member
You can use CA File Master Plus to view and edit VSAM data sets, sequential data sets,
and members of PDS files. You can open a data set or member that is not listed in your
Directory List view by selecting a server and then selecting Open from the CA File
Master Plus menu.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the data set or member that you want to edit and select Open.
The Open Data Set wizard opens.
3.
Complete the following fields, or verify that the prefilled information is correct:
Data set name
Specifies the name of the data set that you want to open.
Member name
Specifies the name of the member that you want to open.
Note: This field is only active when opening a PDS member.
Volume serial
Enter the volume serial only if the data set is not cataloged. Otherwise, leave
this field empty.
4.
Specify the Open mode. Select one of the following options:
Edit
Allows you to make changes in the editor window and save the changes
View
Allows you to make changes in the editor window but you cannot save the
changes
88 Eclipse UI User Guide
Open a Data Set or Member
5.
(Optional) Modify the values in the Change log options. These values are prefilled
with the values you specified in the Configure Mainframe Settings dialog.
Data set name pattern
Displays the name of the change log file. This field is not editable.
Storage
Set one of the following:
Volume serial
Identifies the volume on which a new change log file will be allocated.
Note: Select this only when directing the change log to a specific volume.
Generic unit
Identifies the generic unit on which a new change log file will be allocated.
Note: Leave this blank if you want to use the generic unit default value.
Chapter 5: Members 89
Open a Data Set or Member
Primary allocation
Defines the number of cylinders to indicate the space of the primary allocation
of the change log data set. The value must be greater than zero.
Secondary allocation
Defines the number of cylinders to indicate the space of the secondary
allocation of the change log data set.
Note: The Change log options are activated when the Enable change log option is
selected. If the Enable change log option is selected but no values are specified in
the Change log options, the values specified in the mainframe settings are used. For
more information, see Configure Mainframe Settings (see page 36).
6.
(Optional) Select Enable change log to capture changes that are made to the data
set or member in the change log data set.
7.
Click Next.
8.
Select one of the following Display mode options:
Character
Displays records in character format
Single Record
Displays one record at a time with the field names on the left and the
formatted values on the right
Note: If you select this option, you must specify a record layout.
To switch to another display mode once the editor is open, right-click anywhere in
the editor and select a display format from the menu. Once the file opens, you can
switch between Character and Hexadecimal format by clicking on the icon at the
top of the file view.
9.
Specify a layout. Do one of the following.
■
Select from the drop-down list a layout displayed in your Layout view.
■
Specify the layout data set and member name.
Note: If you specified the character display mode, this step is optional.
10. (Optional) Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
90 Eclipse UI User Guide
Open a Data Set or Member
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
Note: The layout section is not active if you selected Character for the Display
mode.
11. Click Finish.
The data set or member opens in the editor. Data sets opened with the View option
are marked as Read-only.
More information:
Members (see page 83)
Data Set in Use (see page 92)
Change Log (see page 93)
Select a Member (see page 83)
Add a Member (see page 84)
Remove a Member (see page 85)
Rename a Member (see page 86)
Delete a Member (see page 87)
Compare Utility (see page 97)
Select a Data Set (see page 45)
Select a Member (see page 83)
Chapter 5: Members 91
Open a Data Set or Member
Data Set in Use
Only one user or job can have a data set or member open in edit mode at one time, but
more than one user can open a data set or member in view mode. If a user opens a data
set or member in edit mode, no other user can edit or view that data set. However, if a
user opens a data set or member in view mode, another user can open that data set in
either edit or view mode.
If a user attempts to open in edit mode a data set or member that is already open in
either view or edit mode, the Data Set in Use dialog displays. This dialog displays the
following information about the job currently accessing the data set:
Job Name
Name of the job that has the data set open in view or edit mode
Major Enqueue Name
The data set resource name used by dynamic file allocation
Enqueue Type
The enqueue type is one of the following:
SHR
File can be allocated by other users
EXCL
File is allocated exclusively to the job
System
Name of the LPAR on which the resource is allocated
To exit the Data Set in Use dialog, do one of the following:
■
Click Cancel.
The action is canceled and the dialog closes.
■
Click Continue
If the data set is already opened in view mode, your request is processed and the
data set opens in the editor.
If another user already has the data set open in edit mode, a message displays
informing you that you cannot edit the data set. Click OK and your action is
canceled.
More information:
Open a Data Set or Member (see page 88)
Change Log (see page 93)
92 Eclipse UI User Guide
Open a Data Set or Member
Change Log
You have the option of enabling the change log when you open a data set or member
for editing. The Open Data Set dialog displays when you have selected this option, made
changes to a data set, and then close the data set. Use this dialog to set the options for
the change log.
1.
At the Save Resource message that displays when you close a data set that you
have changed, click Yes.
The Change Log dialog displays.
The Log data set field displays the current data set specified for the change log.
2.
Select one of the following options:
Print data set
Displays the Print Change Log wizard. For more information, see Print Change
Log (see page 95).
Note: If you select this option, the Delete after print option is enabled. Select
this option to delete the data set after it is printed.
Keep data set
Adds the change log from the edit session to the end of the change log
specified at the top of the dialog.
Note: If you select this option, the Allocate new data set in next session option
is enabled. Select this option to allocate a new data set at the beginning of the
next session and save the change log to the new data set. The name of the new
change log is determined by the pattern defined in the CAWAOPTS module.
The default pattern results in the same data set name as the currently specified
change log with the last number incremented by 1.
Delete data set
The change log is deleted without printing.
3.
(Optional) Enter a description of the changes that you made to the data set you are
closing. You can enter three lines of up to 60 characters each in this field. Each line
displays as a separate line in the change log report.
4.
Click OK.
The change log is processed as specified.
If you selected an option to print the change log, the Print Change Log wizard
displays. For more information, see Print Change Log (see page 95).
Chapter 5: Members 93
Open a Data Set or Member
More information:
Open a Data Set or Member (see page 88)
Print Change Log (see page 95)
Data Set in Use (see page 92)
94 Eclipse UI User Guide
Open a Data Set or Member
Print Change Log
When you select an option to print the change log from the Open Data Set dialog, the
Print Change Log wizard displays.
Note: You can only print to a device configured for the mainframe environment.
Follow these steps:
1.
Specify the following options:
Sysout class
Specifies the position of the sysout class to which you want the printer routed.
Number of copies
Specifies the number of copies that you want printed.
(Optional) Define print destination
Specifies the printer you want to use. Select one of the following options:
Destination printer
Specifies the printer ID of the local or remote printer to which you want
the print job routed.
External JES node
Specifies the external JES node name to which you want the print job
routed.
Sysout writer name
Specifies the member name of the sysout writer program to which you
want the print job routed.
Print data set name
Specifies the name of the data set to which you want to print.
Print member name
Specifies the name of the member to which you want to print. Also specify
the data set disposition:
■
Select SHR if you want the printed data to replace the contents of an
existing data set. This option allows concurrent access to the data set while
the print is in progress.
■
Select MOD if you want the printed data added to the end of an existing
data set.
■
Click the New button to create a new data set.
Note: For detailed information about the Allocate screen, see one of the
following topics in the online help:
Allocate a New PDS (see page 62)
Chapter 5: Members 95
Open a Data Set or Member
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
2.
Specify the output format. Specify the following options:
Output format
Specifies the format of the change log data. Select one of the following options:
Character
Displays records in character format, up to 100 characters
Hexadecimal
Displays records in three-line hexadecimal format
List
Displays records in character format without scale and record numbers
Single record
Displays field names and values for each record
Field display
Specifies which fields to print. Select one of the following options:
All
Prints all fields in the data set
Mismatched
Prints only fields that have different content
3.
Click Next.
4.
Type 1-4 lines of JCL control statements into the Job information box. If you
specified job information in the Configure Mainframe Settings dialog, that
information is prefilled and you can edit it if needed.
Note: Each line can contain up to 73 characters.
5.
Click Finish.
The print job is submitted to the printer you have specified as the default in your
mainframe settings.
More information:
Change Log (see page 93)
96 Eclipse UI User Guide
Compare Utility
Compare Utility
You can use CA File Master Plus to compare the contents of two data sets or two or
more members in a PDS. Use this feature to perform tasks such as identifying or
verifying changes made to a data set. Access this utility through the right-click menu, or
you can compare data sets and members not listed in your Directory List view by
selecting a server and then selecting Compare from the CA File Master Plus, Utilities
menu.
Follow these steps:
1.
Open the Directory List view.
2.
Select from the Directory List view one of the data sets or members that you want
to compare.
3.
Right-click the data set or member and select Utilities, Compare.
The Compare Data Set Utility wizard opens.
4.
Complete the following fields on the Old Data Set page, or verify that the prefilled
information is correct:
Data set name
Specifies the name of the first data set that you want to compare.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member name
Specifies the name of the member that you want to compare. Perform a
wildcard search to select more than one member. Enter an asterisk (*) to
compare all members.
Note: This field is only active when comparing members in a PDS.
Note: For more information about identifying a member, see Select a Member
(see page 83).
5.
Click Next.
6.
Specify the name of the data set and member as on the New Data Set page. This
identifies data set and member that you want to compare to the Old data set. If you
are comparing members in a PDS, the Old and New data sets must both contain the
members you want to compare.
7.
Click Next.
8.
Select the Output Format options that you want to apply.
Print
Specifies the display format of the compare report. Select one of the following
options:
Character
Chapter 5: Members 97
Compare Utility
Displays records in character format, up to 100 characters
Hexadecimal
Displays records in three-line hexadecimal format
Single record
Displays field names and values for each record.
Note: If you select this option, you must specify a record layout.
Record display
Specifies which records to display in the compare report. Select one of the
following options:
All
Displays all records
Mismatched
Displays only mismatched records
Summary
Displays only a summary of the data set compare
Field display
Specifies which fields to display in the compare report. Select one of the
following options:
All
Displays all fields
Mismatched
Displays only fields that have different content
9.
(Optional) Specify a layout for the old and new data sets. Do one of the following in
the Old data set layout and the New data set layout groups:
■
Select from the drop-down list a layout displayed in your Layout view.
■
Specify the layout data set and member name.
Note: Select Use old data set layout to use the specified layout for both the old and
new data sets.
Note: You must specify a layout for a single record report format. Otherwise, this
step is optional.
Note: For more information about identifying a data set, see Select a Data Set (see
page 45).
10. (Optional) Specify selection criteria. Do one of the following:
■
98 Eclipse UI User Guide
Type selection conditions into the selection criteria text box.
Compare Utility
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
Note: This option is only available if you specified a layout with the single
record print mode.
11. Click Next.
12. Specify the position of the data and length of the compare, if you want to compare
only a portion of a data set or member.
13. Click Next.
A summary page shows the options that you have selected.
14. Click Finish.
The summary results of your compare are displayed in the Report view.
You can display the detailed compare report by clicking the
icon in the top right
corner of the compare report summary. When you close the compare report
summary, the detailed compare report closes and is deleted.
More information:
Members (see page 83)
Select a Member (see page 83)
Add a Member (see page 84)
Remove a Member (see page 85)
Rename a Member (see page 86)
Delete a Member (see page 87)
Open a Data Set or Member (see page 88)
Select a Data Set (see page 45)
Select a Member (see page 83)
Chapter 5: Members 99
Chapter 6: Selection
Selection criteria are data sets or members that contain selection conditions. Use
selection criteria to restrict your view of a data set or member according to conditions
specified in the selection criteria.
Selection criteria are collections of selection conditions that are saved in a selection
criteria data set or member for future reuse.
Selection conditions are the individual search terms in selection criteria data sets or
members that are used to identify the specific records or members you seek. A selection
condition consists of a field, an operator, and a literal, or the value to which the field is
compared.
You can use CA File Master Plus to manage your selection criteria data sets and
members. You can add and delete the selection criteria data sets and members you
want to use. When you are performing some functions in the Eclipse UI, such as
compare, you can specify selection conditions that identify the members on which to
perform the function. You can specify the selection conditions by entering the
conditions individually or by specifying a selection criteria that you have added to the
selection view.
Use the Selection view to add and manage selection data sets and members. You can
add selection criteria to the Selection view after adding one or more servers to the
Eclipse UI. You can also specify selection criteria that have not already been added to
the Selection view from within utility wizards, such as copy and compare.
Note: You can view the properties of any selection data set in your Selection view. To
display selection properties, right-click a selection data set and select Properties.
This section contains the following topics:
Add Selection Criteria (see page 102)
Create Selection Criteria (see page 103)
Modify Layout Selection Conditions (see page 104)
Define Selection Conditions (see page 106)
Condition Specifications (see page 107)
Update Selection Criteria (see page 109)
Remove Selection Criteria (see page 110)
Chapter 6: Selection 101
Add Selection Criteria
Add Selection Criteria
You can add selection criteria to the Selection view in CA File Master Plus so you can
easily access and apply them.
Follow these steps:
1.
Open the Selection view.
2.
Right-click anywhere in the Selection view and select Add Selection Criteria.
The Add Selection Criteria dialog opens.
3.
Complete the following fields:
Data set name
Specifies the name of the data set that contains the selection criteria.wa
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member
Specifies the name of the selection criteria member that you want to add.
Note: For more information about identifying a member, see Select a Member
(see page 83).
4.
Click OK.
The selection criteria data set or member is added to the Selection view. The
selection criteria are listed in alphabetical order.
More information:
Selection (see page 101)
Create Selection Criteria (see page 103)
Modify Layout Selection Conditions (see page 104)
Define Selection Conditions (see page 106)
Condition Specifications (see page 107)
Update Selection Criteria (see page 109)
Remove Selection Criteria (see page 110)
Select a Data Set (see page 45)
Properties (see page 149)
Select a Member (see page 83)
102 Eclipse UI User Guide
Create Selection Criteria
Create Selection Criteria
You can create a selection criteria data set or member in the Selection view in CA File
Master Plus.
Follow these steps:
1.
Open the Selection view.
2.
Right-click anywhere in the Selection view and select Create Selection Criteria.
The Create Selection Criteria dialog opens.
3.
Complete the following fields:
Data set name
Specifies the name of the selection criteria data set or the data set that
contains the selection criteria member that you want to add.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member
Specifies the name of the selection criteria member that you want to add.
Note: For more information about identifying a member, see Select a Member
(see page 83).
Description
Displays a short explanation of the layout member.
4.
5.
(Optional) Do one of the following to specify the layout:
■
Select from the drop-down list a layout displayed in your layout view.
■
Specify the layout data set and member name.
Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Chapter 6: Selection 103
Modify Layout Selection Conditions
Note: For more information on importing selection criteria, see Import
Selection Criteria.
6.
Click OK.
The selection member is created and added to the Selection view.
More information:
Selection (see page 101)
Add Selection Criteria (see page 102)
Modify Layout Selection Conditions (see page 104)
Define Selection Conditions (see page 106)
Condition Specifications (see page 107)
Update Selection Criteria (see page 109)
Remove Selection Criteria (see page 110)
Select a Data Set (see page 45)
Properties (see page 149)
Select a Member (see page 83)
Modify Layout Selection Conditions
You can use CA File Master Plus to modify the conditions contained within a layout.
Follow these steps:
1.
Click Layout in the Selection criteria group box.
The Layout dialog displays.
2.
Modify the selection conditions to meet your needs. For each field, you can update
the values in the following columns:
And/Or
Specifies whether to join multiple selection conditions. Select one of the
following values: And, Or.
104 Eclipse UI User Guide
Modify Layout Selection Conditions
Operator
Defines the criteria. Select one of the following values: Equal, Not Equal,
Greater Than, Less Than, Greater Than or Equal, Less Than or Equal, Contains.
Note: Not all values are available for all data formats.
Compare Value or Field Name
Creates the condition. Specify either a field name or one or more literal values.
For example, C'VT' C'NH' C'MA'. Right-click in this field to see the available
options.
Note: For more information on valid values for this field, see Define Selection
Conditions (see page 106).
3.
(Optional) Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
4.
Note: For more information on importing selection criteria, see Import Selection
Criteria.
5.
Select the rules that you want to add to the selection criteria member.
6.
Click OK.
The Layout dialog closes, and your changes to the selection criteria are displayed.
More information:
Selection (see page 101)
Add Selection Criteria (see page 102)
Create Selection Criteria (see page 103)
Define Selection Conditions (see page 106)
Condition Specifications (see page 107)
Update Selection Criteria (see page 109)
Remove Selection Criteria (see page 110)
Select a Data Set (see page 45)
Properties (see page 149)
Select a Member (see page 83)
Chapter 6: Selection 105
Define Selection Conditions
Define Selection Conditions
A selection criteria member consists of statements that determine if the value in a given
field meets a Define Selection Conditions value you specify. Build selection conditions
based on a field in a custom layout member. Compare the value in that field to another
field in the layout member or to a literal value that you define.
To identify another field in the layout as the compare field in your selection condition,
follow these steps:
1.
Select the row in the table that contains the field name on which you want to build
the selection criteria.
2.
Right-click in the Compare Value or Field Name cell and select Field Name
The Select Field Name dialog displays.
3.
Select the field name that you want to set as the compare field in your selection
criteria.
4.
Click OK.
The Select Field Name dialog closes.
To define literal values as the compare value in your selection condition, follow these
steps:
1.
Select the row in the table that contains the field name on which you want to build
the selection criteria.
2.
Right-click in the Compare Value or Field Name cell and select one of the following
data type indicators:
■
C—Character
■
H—Hex
■
T—Text
The option you selected displays in the Compare Value or Field Name cell, followed
by two single quotation marks.
Note: Not all data type indicators are available for every field type.
3.
Put your cursor between the two single quote marks.
4.
Type between the single quote marks the literal value to which you want the field
name compared.
Note: For more information about selection criteria literal values, see Condition
Specifications (see page 107).
Repeat steps 2 to 4 until you have specified all the literal values for the selection
condition for this field name.
106 Eclipse UI User Guide
Condition Specifications
More information:
Selection (see page 101)
Add Selection Criteria (see page 102)
Create Selection Criteria (see page 103)
Modify Layout Selection Conditions (see page 104)
Condition Specifications (see page 107)
Update Selection Criteria (see page 109)
Remove Selection Criteria (see page 110)
Condition Specifications
The following table shows some sample condition specifications.
Condition Specification
Description
MEMBER
Specifies that subsequent selection
condition apply to PDS member selection
only. This parameter and subsequent
selection criteria are ignored if specified for
non-PDS data sets.
RECORD
Specifies that subsequent selection
condition apply to record selection only.
101 = C'NY'
Position 101 for a length of 2 equals 'NY'
1(3) = C'001'
Position 1 for a length of 3 equals '001'
C'TEXAS'
Character string 'TEXAS' anywhere in the
record
'TEXAS'
Character string 'TEXAS' anywhere in the
record
1(3) = C'001' & 101 = C'NY'
Compound condition
10(4) EQP
Pos 10 for a length of 4 is a valid packed
value
80 = C'NY' C'NJ' C'MA'
Position 80 equals one of the three values
80 = C'NY,NJ,MA'
Position 80 equals one of the same three
values
100(2) = P'0,1,999'
Two-byte packed field equals one of three
values
Chapter 6: Selection 107
Condition Specifications
100 =
C"100,00"
Position 100 for a length of 7 equals
'100,000'
Note: Quotes are required when the search
string contains a comma
82(2) > 84
Compare position 82 to position 84 for
length of 2
101(20) CO C'NEW YORK'
Looks for the character string in columns
101-120
INLIM(5000)
Stop reading/selecting after reading 5000
records.
SELLIM(1000)
Only select 1000 records based on selection
criteria
STARTKEY='56789'
Select keyed VSAM records starting with
key '56789'
STARTREC=1001
Select records starting with record number
1001
STARTRBA=X'1FD8'
Select records starting with the record with
RBA x'1FD8'
More information:
Selection (see page 101)
Add Selection Criteria (see page 102)
Create Selection Criteria (see page 103)
Modify Layout Selection Conditions (see page 104)
Define Selection Conditions (see page 106)
Update Selection Criteria (see page 109)
Remove Selection Criteria (see page 110)
108 Eclipse UI User Guide
Update Selection Criteria
Update Selection Criteria
You can update a selection criteria member that is displayed in the Selection view in CA
File Master Plus.
Follow these steps:
1.
Open the Selection view.
2.
Right-click on the member you want to update and select Update.
The Update dialog opens.
3.
Select the server where the selection criteria member resides.
4.
Click Next.
5.
Update the following fields:
Data set name
Specifies the name of the data set that contains the selection criteria member.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member
Specifies the name of the selection criteria member.
Description
Displays a short explanation of the selection criteria member.
6.
7.
(Optional) Do one of the following to specify the layout:
■
Select from the drop-down list a layout displayed in your layout view.
■
Specify the layout data set and member name.
Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Chapter 6: Selection 109
Remove Selection Criteria
Note: For more information on importing selection criteria, see Import
Selection Criteria.
8.
Click OK.
The member is updated and the Selection view refreshes.
More information:
Selection (see page 101)
Add Selection Criteria (see page 102)
Create Selection Criteria (see page 103)
Modify Layout Selection Conditions (see page 104)
Define Selection Conditions (see page 106)
Condition Specifications (see page 107)
Remove Selection Criteria (see page 110)
Select a Data Set (see page 45)
Properties (see page 149)
Select a Member (see page 83)
Remove Selection Criteria
You can remove selection criteria you no longer want on your Selection view.
Follow these steps:
1.
Open the Selection view.
2.
Do one of the following:
■
Right-click the data set that you want to delete and select Remove Data Set
From List.
■
Right-click the member that you want to delete and select Remove Member
From List.
The Confirm Remove dialog opens.
Note: You can use Ctrl-click or Shift-click to remove multiple layouts.
3.
Click OK.
The member, or the data set and its associated members, is removed. The Selection
view refreshes to show the list of available data sets and members.
110 Eclipse UI User Guide
Remove Selection Criteria
More informtaion:
Selection (see page 101)
Add Selection Criteria (see page 102)
Create Selection Criteria (see page 103)
Modify Layout Selection Conditions (see page 104)
Define Selection Conditions (see page 106)
Condition Specifications (see page 107)
Update Selection Criteria (see page 109)
Chapter 6: Selection 111
Chapter 7: Layouts
Layouts control what information is displayed and how information is formatted when
viewing a data set or its members. CA File Master Plus users can specify a layout to use
when working with any data set or member. The layout provides an easy way to control
which fields are viewed and how records are formatted. Layouts also help to identify
which records are displayed.
CA File Master Plus supports the use of two different types of layouts: COBOL or PL/I
layouts and custom layouts.
A COBOL or PL/I layout, also referred to simply as a layout, can be a member of a PDS, a
CA Librarian data set, or a CA Panvalet data set.
A custom layout defines one or more custom views based on COBOL or PL/I layouts. A
custom layout must reside in a PDS.
Using a custom layout you can do the following:
■
Map data using different record layouts for different record types
■
Eliminate layout fields that you do not want to include in your view
■
Map only a portion of a file record starting at a specified record offset
A custom layout contains references to one or more ordinary COBOL or PL/I layouts. You
can use custom layouts anywhere that CA File Master Plus allows a layout, except within
another custom layout.
CA File Master Plus users can access any number of layout data sets and members. Use
this feature to create, update, and apply the layouts that you work with. You can add,
remove, and modify layouts using the Layouts view.
Note: You can view the properties of any layout data set in your Layout view. To display
layout data set properties, right-click a layout data set and select Properties.
This section contains the following topics:
Add a Layout (see page 114)
Create a Custom Layout (see page 115)
Modify Layout Rules (see page 116)
Define Selection Conditions (see page 118)
Insert a Layout (see page 119)
View a Layout (see page 120)
Update a Layout (see page 121)
Remove a Layout (see page 122)
Chapter 7: Layouts 113
Add a Layout
Add a Layout
You can add layouts to the Layouts view in CA File Master Plus so you can easily access
and apply them.
Follow these steps:
1.
Open the Layouts view.
2.
Right-click anywhere in the Layouts view and select Add Layout.
The Add Layout dialog opens.
3.
Complete the following fields:
Data set name
Specifies the name of the PDS, CA Librarian, or CA Panvalet library that contains
the layout member.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member
Specifies the name of the layout member.
Note: For more information about identifying a member, see Select a Member
(see page 83).
4.
Click OK.
The selected layout and the associated field names are added to the Layouts view.
The layouts are listed in alphabetical order.
More information:
Layouts (see page 113)
Create a Custom Layout (see page 115)
Modify Layout Rules (see page 116)
Define Selection Conditions (see page 118)
Insert a Layout (see page 119)
View a Layout (see page 120)
Update a Layout (see page 121)
Remove a Layout (see page 122)
Select a Data Set (see page 45)
Properties (see page 149)
Select a Member (see page 83)
114 Eclipse UI User Guide
Create a Custom Layout
Create a Custom Layout
You can create custom layouts using the Layouts view so you can perform all your
custom layout tasks within CA File Master Plus.
Follow these steps:
1.
Open the Layouts view.
2.
Right-click anywhere in the Layouts view and select Create Custom Layout.
The Custom Layout Definition dialog opens.
3.
Complete the following fields:
Data set name
Specifies the name of the PDS where you want the new layout member to
reside.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member name
Specifies a member name for your custom layout.
Note: For more information about identifying a member, see Select a Member
(see page 83).
Description
Specifies a description for your custom layout.
Record offset
Defines the number of records to skip at the beginning of the layout. If the first
field in the layout does not correspond to the start of the record data, type the
record that should be considered the first field of the layout.
4.
Click Insert Layout.
The Insert Layout wizard displays.
5.
Complete the Insert Layout wizard. For more information, see Insert a Layout (see
page 119).
The layout or layouts you have selected are added to the member table.
Note: After adding one or more layouts to the member table, you can modify the
rules associated with the layout. For more information, see Modify Layout Rules
(see page 116).
6.
Select a layout and click Set as Default.
The Default layout field updates to display the layout you selected.
7.
Click OK.
The Layouts view updates to display the layout you created.
Chapter 7: Layouts 115
Modify Layout Rules
More information:
Layouts (see page 113)
Add a Layout (see page 114)
Modify Layout Rules (see page 116)
Define Selection Conditions (see page 118)
Insert a Layout (see page 119)
View a Layout (see page 120)
Update a Layout (see page 121)
Remove a Layout (see page 122)
Select a Data Set (see page 45)
Properties (see page 149)
Select a Member (see page 83)
Modify Layout Rules
You can use CA File Master Plus to modify the rules in a custom layout. Use this feature
to define or update the data-specific conditions under which a particular layout is used.
You can also use this feature to identify which fields are included in formatted displays.
Follow these steps:
1.
Open the Custom Layout Definition dialog by taking one of the following actions:
■
Right-click a layout member and select Create Custom Layout.
■
Right-click a custom layout and select Update.
The Custom Layout Definition dialog opens.
2.
Select the layout member associated with the rules you want to create or modify.
3.
Click Rules.
The Rules dialog displays.
4.
Modify the selection conditions to meet your needs. For each field, you can update
the values in the following columns:
And/Or
Specifies whether to join multiple selection conditions. Select one of the
following values: And, Or.
116 Eclipse UI User Guide
Modify Layout Rules
Operator
Defines the criteria. Select one of the following values: Equal, Not Equal,
Greater Than, Less Than, Greater Than or Equal, Less Than or Equal, Contains.
Note: Not all values are available for all data formats.
Compare Value or Field Name
Creates the condition. Specify either a field name or one or more literal values.
For example, C'VT' C'NH' C'MA'. Right-click in this field to see the available
options.
Note: For more information on valid values for this field, see Define Selection
Conditions (see page 106).
5.
Click OK.
The Rules dialog closes, and your changes to the selection conditions are saved.
More information:
Layouts (see page 113)
Add a Layout (see page 114)
Create a Custom Layout (see page 115)
Define Selection Conditions (see page 118)
Insert a Layout (see page 119)
View a Layout (see page 120)
Update a Layout (see page 121)
Remove a Layout (see page 122)
Select a Data Set (see page 45)
Select a Member (see page 83)
Chapter 7: Layouts 117
Define Selection Conditions
Define Selection Conditions
A selection criteria member consists of statements that determine if the value in a given
field meets a Define Selection Conditions value you specify. Build selection conditions
based on a field in a custom layout member. Compare the value in that field to another
field in the layout member or to a literal value that you define.
To identify another field in the layout as the compare field in your selection condition,
follow these steps:
1.
Select the row in the table that contains the field name on which you want to build
the selection criteria.
2.
Right-click in the Compare Value or Field Name cell and select Field Name
The Select Field Name dialog displays.
3.
Select the field name that you want to set as the compare field in your selection
criteria.
4.
Click OK.
The Select Field Name dialog closes.
To define literal values as the compare value in your selection condition, follow these
steps:
1.
Select the row in the table that contains the field name on which you want to build
the selection criteria.
2.
Right-click in the Compare Value or Field Name cell and select one of the following
data type indicators:
■
C—Character
■
H—Hex
■
T—Text
The option you selected displays in the Compare Value or Field Name cell, followed
by two single quotation marks.
Note: Not all data type indicators are available for every field type.
3.
Put your cursor between the two single quote marks.
4.
Type between the single quote marks the literal value to which you want the field
name compared.
Note: For more information about selection criteria literal values, see Condition
Specifications (see page 107).
Repeat steps 2 to 4 until you have specified all the literal values for the selection
condition for this field name.
118 Eclipse UI User Guide
Insert a Layout
More information:
Layouts (see page 113)
Add a Layout (see page 114)
Create a Custom Layout (see page 115)
Modify Layout Rules (see page 116)
Insert a Layout (see page 119)
View a Layout (see page 120)
Update a Layout (see page 121)
Remove a Layout (see page 122)
Insert a Layout
When creating or modifying a custom layout, use the Insert Layout dialog to insert a
layout into your custom layout.
Follow these steps:
1.
Click Insert Layout from the Custom Layout Definition dialog.
The Insert Layout dialog displays.
2.
Complete the following fields:
Data set name
Specifies the name of the PDS, CA Librarian, or CA Panvalet library that contains
the layout member.
Member
Specifies the name of the layout member.
3.
Click Next.
The Select Top Level page displays.
4.
Select one or more top level field names from the Select Top Level page.
5.
Click Finish.
The selected layout and the associated field names are added to the Layouts view.
Chapter 7: Layouts 119
View a Layout
More information:
Layouts (see page 113)
Add a Layout (see page 114)
Create a Custom Layout (see page 115)
Modify Layout Rules (see page 116)
Define Selection Conditions (see page 118)
View a Layout (see page 120)
Update a Layout (see page 121)
Remove a Layout (see page 122)
Select a Data Set (see page 45)
Select a Member (see page 83)
View a Layout
You can view the contents of a layout from the Layout view. The View Layout dialog
shows the fields in the layout.
To view a layout, right-click the layout and select View.
Follow these steps:
1.
Right-click the layout that you want to view and select View.
The Custom Layout Update wizard opens.
2.
Select the server that contains the layout you want to view.
3.
Click Next.
The Custom Layout Update wizard displays the contents of the selected layout
member.
More information:
Layouts (see page 113)
Add a Layout (see page 114)
Create a Custom Layout (see page 115)
Modify Layout Rules (see page 116)
Define Selection Conditions (see page 118)
Insert a Layout (see page 119)
Update a Layout (see page 121)
Remove a Layout (see page 122)
Select a Data Set (see page 45)
Select a Member (see page 83)
120 Eclipse UI User Guide
Update a Layout
Update a Layout
You can update the properties and contents of a custom layout using the Layouts view.
Follow these steps:
1.
Right-click the custom layout that you want to modify and select Update.
The Update dialog opens.
2.
Complete or update following fields:
Data set name
Specifies the name of the PDS, CA Librarian, or CA Panvalet library where you
want the new layout member to reside.
Note: For more information about identifying a data set, see Select a Data Set
(see page 45).
Member name
Specifies a member name for your custom layout.
Note: For more information about identifying a member, see Select a Member
(see page 83).
Description
Specifies a description for your custom layout.
Record offset
Defines the number of records to skip at the beginning of the layout. If the first
field in the layout does not correspond to the start of the record data, type the
record that should be considered the first field of the layout.
3.
Click Insert Layout.
The Insert Layout wizard displays.
4.
Complete the Insert Layout wizard. For more information, see Insert a Layout (see
page 119).
The layout or layouts you have selected are added to the member table.
5.
Select a layout and click Set as Default.
The Default layout field updates to display the layout you selected.
6.
Click OK.
The Layouts view updates to display the layout you created.
7.
Click Finish.
The custom layout is updated and the Layout view refreshes.
Chapter 7: Layouts 121
Remove a Layout
Remove a Layout
You can remove layouts you no longer want on your Layouts view. This procedure
removes the layout from your Layouts view, but does not otherwise alter the layout
itself.
Follow these steps:
1.
Open the Layouts view.
2.
Select the member or data set you want to remove.
3.
Do one of the following:
■
Right-click the data set that you want to delete and select Remove Data Set
From List.
■
Right-click the member that you want to delete and select Remove Member
From List.
The Confirm Remove dialog opens.
Note: You can use Ctrl-click or Shift-click to remove multiple layouts.
4.
Click Yes.
The member, or the data set and its associated members, is removed. The Layouts
view refreshes to show the list of available data sets and members.
More information:
Layouts (see page 113)
Add a Layout (see page 114)
Create a Custom Layout (see page 115)
Modify Layout Rules (see page 116)
Define Selection Conditions (see page 118)
Insert a Layout (see page 119)
View a Layout (see page 120)
Update a Layout (see page 121)
122 Eclipse UI User Guide
Chapter 8: Editor
You can use CA File Master Plus to edit data sets and members from your Directory List
view. Perform these actions through the Directory List view after adding one or more
data sets. You can edit a data set or member that is not listed in your Directory List view
by selecting a server and then selecting Open from the CA File Master Plus menu.
This section contains the following topics:
Open a Data Set or Member (see page 123)
Character Format (see page 132)
Single-Record Format (see page 132)
Cancel (see page 133)
Data Set-level Operations (see page 133)
Record-level Operations (see page 142)
Open a Data Set or Member
You can use CA File Master Plus to view and edit VSAM data sets, sequential data sets,
and members of PDS files. You can open a data set or member that is not listed in your
Directory List view by selecting a server and then selecting Open from the CA File
Master Plus menu.
Follow these steps:
1.
Open the Directory List view.
2.
Right-click the data set or member that you want to edit and select Open.
The Open Data Set wizard opens.
3.
Complete the following fields, or verify that the prefilled information is correct:
Data set name
Specifies the name of the data set that you want to open.
Member name
Specifies the name of the member that you want to open.
Note: This field is only active when opening a PDS member.
Volume serial
Enter the volume serial only if the data set is not cataloged. Otherwise, leave
this field empty.
Chapter 8: Editor 123
Open a Data Set or Member
4.
Specify the Open mode. Select one of the following options:
Edit
Allows you to make changes in the editor window and save the changes
View
Allows you to make changes in the editor window but you cannot save the
changes
5.
(Optional) Modify the values in the Change log options. These values are prefilled
with the values you specified in the Configure Mainframe Settings dialog.
Data set name pattern
Displays the name of the change log file. This field is not editable.
Storage
Set one of the following:
Volume serial
Identifies the volume on which a new change log file will be allocated.
Note: Select this only when directing the change log to a specific volume.
Generic unit
Identifies the generic unit on which a new change log file will be allocated.
Note: Leave this blank if you want to use the generic unit default value.
124 Eclipse UI User Guide
Open a Data Set or Member
Primary allocation
Defines the number of cylinders to indicate the space of the primary allocation
of the change log data set. The value must be greater than zero.
Secondary allocation
Defines the number of cylinders to indicate the space of the secondary
allocation of the change log data set.
Note: The Change log options are activated when the Enable change log option is
selected. If the Enable change log option is selected but no values are specified in
the Change log options, the values specified in the mainframe settings are used. For
more information, see Configure Mainframe Settings (see page 36).
6.
(Optional) Select Enable change log to capture changes that are made to the data
set or member in the change log data set.
7.
Click Next.
8.
Select one of the following Display mode options:
Character
Displays records in character format
Single Record
Displays one record at a time with the field names on the left and the
formatted values on the right
Note: If you select this option, you must specify a record layout.
To switch to another display mode once the editor is open, right-click anywhere in
the editor and select a display format from the menu. Once the file opens, you can
switch between Character and Hexadecimal format by clicking on the icon at the
top of the file view.
9.
Specify a layout. Do one of the following.
■
Select from the drop-down list a layout displayed in your Layout view.
■
Specify the layout data set and member name.
Note: If you specified the character display mode, this step is optional.
10. (Optional) Specify selection criteria. Do one of the following:
■
Type selection conditions into the selection criteria text box.
Note: For more information on valid selection conditions, see Selection Criteria
Specifications (see page 107).
■
Click Layout to build selection conditions based on the contents of the specified
layout.
Note: For more information on modifying selection criteria, see Modify Layout
Selection Conditions (see page 104).
Chapter 8: Editor 125
Open a Data Set or Member
Note: If you specify selection criteria, you can click Validate to verify that the
selection criteria listed are legitimate.
■
Click Import to import selection criteria from an existing selection criteria
member.
Note: For more information on importing selection criteria, see Import
Selection Criteria.
Note: The layout section is not active if you selected Character for the Display
mode.
11. Click Finish.
The data set or member opens in the editor. Data sets opened with the View option
are marked as Read-only.
More information:
Editor (see page 123)
Data Set in Use (see page 127)
Change Log (see page 128)
Character Format (see page 132)
Single-Record Format (see page 132)
Cancel (see page 133)
Data Set-level Operations (see page 133)
Record-level Operations (see page 142)
Select a Data Set (see page 45)
Select a Member (see page 83)
126 Eclipse UI User Guide
Open a Data Set or Member
Data Set in Use
Only one user or job can have a data set or member open in edit mode at one time, but
more than one user can open a data set or member in view mode. If a user opens a data
set or member in edit mode, no other user can edit or view that data set. However, if a
user opens a data set or member in view mode, another user can open that data set in
either edit or view mode.
If a user attempts to open in edit mode a data set or member that is already open in
either view or edit mode, the Data Set in Use dialog displays. This dialog displays the
following information about the job currently accessing the data set:
Job Name
Name of the job that has the data set open in view or edit mode
Major Enqueue Name
The data set resource name used by dynamic file allocation
Enqueue Type
The enqueue type is one of the following:
SHR
File can be allocated by other users
EXCL
File is allocated exclusively to the job
System
Name of the LPAR on which the resource is allocated
To exit the Data Set in Use dialog, do one of the following:
■
Click Cancel.
The action is canceled and the dialog closes.
■
Click Continue
If the data set is already opened in view mode, your request is processed and the
data set opens in the editor.
If another user already has the data set open in edit mode, a message displays
informing you that you cannot edit the data set. Click OK and your action is
canceled.
More information:
Open a Data Set or Member (see page 123)
Change Log (see page 128)
Chapter 8: Editor 127
Open a Data Set or Member
Change Log
You have the option of enabling the change log when you open a data set or member
for editing. The Open Data Set dialog displays when you have selected this option, made
changes to a data set, and then close the data set. Use this dialog to set the options for
the change log.
1.
At the Save Resource message that displays when you close a data set that you
have changed, click Yes.
The Change Log dialog displays.
The Log data set field displays the current data set specified for the change log.
2.
Select one of the following options:
Print data set
Displays the Print Change Log wizard. For more information, see Print Change
Log (see page 95).
Note: If you select this option, the Delete after print option is enabled. Select
this option to delete the data set after it is printed.
Keep data set
Adds the change log from the edit session to the end of the change log
specified at the top of the dialog.
Note: If you select this option, the Allocate new data set in next session option
is enabled. Select this option to allocate a new data set at the beginning of the
next session and save the change log to the new data set. The name of the new
change log is determined by the pattern defined in the CAWAOPTS module.
The default pattern results in the same data set name as the currently specified
change log with the last number incremented by 1.
Delete data set
The change log is deleted without printing.
3.
(Optional) Enter a description of the changes that you made to the data set you are
closing. You can enter three lines of up to 60 characters each in this field. Each line
displays as a separate line in the change log report.
4.
Click OK.
The change log is processed as specified.
If you selected an option to print the change log, the Print Change Log wizard
displays. For more information, see Print Change Log (see page 95).
128 Eclipse UI User Guide
Open a Data Set or Member
More information:
Open a Data Set or Member (see page 123)
Print Change Log (see page 130)
Data Set in Use (see page 127)
Chapter 8: Editor 129
Open a Data Set or Member
Print Change Log
When you select an option to print the change log from the Open Data Set dialog, the
Print Change Log wizard displays.
Note: You can only print to a device configured for the mainframe environment.
Follow these steps:
1.
Specify the following options:
Sysout class
Specifies the position of the sysout class to which you want the printer routed.
Number of copies
Specifies the number of copies that you want printed.
(Optional) Define print destination
Specifies the printer you want to use. Select one of the following options:
Destination printer
Specifies the printer ID of the local or remote printer to which you want
the print job routed.
External JES node
Specifies the external JES node name to which you want the print job
routed.
Sysout writer name
Specifies the member name of the sysout writer program to which you
want the print job routed.
Print data set name
Specifies the name of the data set to which you want to print.
Print member name
Specifies the name of the member to which you want to print. Also specify
the data set disposition:
■
Select SHR if you want the printed data to replace the contents of an
existing data set. This option allows concurrent access to the data set while
the print is in progress.
■
Select MOD if you want the printed data added to the end of an existing
data set.
■
Click the New button to create a new data set.
Note: For detailed information about the Allocate screen, see one of the
following topics in the online help:
Allocate a New PDS (see page 62)
130 Eclipse UI User Guide
Open a Data Set or Member
Allocate a New Sequential Data Set (see page 64)
Allocate a New VSAM Data Set (see page 67)
2.
Specify the output format. Specify the following options:
Output format
Specifies the format of the change log data. Select one of the following options:
Character
Displays records in character format, up to 100 characters
Hexadecimal
Displays records in three-line hexadecimal format
List
Displays records in character format without scale and record numbers
Single record
Displays field names and values for each record
Field display
Specifies which fields to print. Select one of the following options:
All
Prints all fields in the data set
Mismatched
Prints only fields that have different content
3.
Click Next.
4.
Type 1-4 lines of JCL control statements into the Job information box. If you
specified job information in the Configure Mainframe Settings dialog, that
information is prefilled and you can edit it if needed.
Note: Each line can contain up to 73 characters.
5.
Click Finish.
The print job is submitted to the printer you have specified as the default in your
mainframe settings.
More information:
Change Log (see page 128)
Chapter 8: Editor 131
Character Format
Character Format
The CA File Master Plus editor can display records in character format. To display
records in character format, do one of the following:
■
Select the character display mode in the Open a Data Set wizard.
■
Right-click anywhere in the editor screen and select Character format from the
menu.
The contents of the data set or member display in the editor in character format.
More information:
Editor (see page 123)
Open a Data Set or Member (see page 123)
Single-Record Format (see page 132)
Cancel (see page 133)
Data Set-level Operations (see page 133)
Record-level Operations (see page 142)
Single-Record Format
The CA File Master Plus editor can display records in single-record format. The record
number, record length, and record layout are displayed at the top of the editor. The
record data is displayed in a table format showing the layout fields and values. Use the
First, Previous, Next, and Last buttons to navigate through the records in the data set or
member.
To display records in single-record format, do one of the following:
■
Select the single-record display mode in the Open a Data Set wizard.
■
Right-click anywhere in the editor screen and select Single-record format from the
menu.
The contents of the data set or member display in the editor in single-record format.
Note: To view records in single-record format using either method, you must specify a
layout when opening the data set or member.
132 Eclipse UI User Guide
Cancel
More information:
Editor (see page 123)
Open a Data Set or Member (see page 123)
Character Format (see page 132)
Cancel (see page 133)
Data Set-level Operations (see page 133)
Record-level Operations (see page 142)
Cancel
Cancel the changes you have made in the editor by clicking the X on the editor tab. The
editor will close without saving any changes and the data set or member will revert to
the state of its last save.
More information:
Editor (see page 123)
Open a Data Set or Member (see page 123)
Character Format (see page 132)
Single-Record Format (see page 132)
Data Set-level Operations (see page 133)
Record-level Operations (see page 142)
Data Set-level Operations
Use the following commands to modify your data set-level operations.
More information:
Editor (see page 123)
Exclude (see page 134)
Flip (see page 135)
Locate (see page 136)
Find/Change (see page 138)
Reset (see page 142)
Open a Data Set or Member (see page 123)
Character Format (see page 132)
Single-Record Format (see page 132)
Cancel (see page 133)
Record-level Operations (see page 142)
Chapter 8: Editor 133
Data Set-level Operations
Exclude
Use the Exclude command to exclude all lines that match a specified pattern or string.
The editor shows all records except for those that match the Exclude criteria.
Follow these steps:
1.
Right-click anywhere in the editor, click Data Set-level Operations, Exclude.
The Exclude dialog displays.
2.
Specify the following values:
Exclude string
Specifies the string to exclude
Start column
Specifies the first, or leftmost, column in which to search
End column
Specifies the last, or rightmost, column in which to search
Note: If the end column is not also specified, the specified string must begin
the in the start column.
3.
Specify the following options:
Next
Start from the current position in the file and locate the next occurrence of the
specified string
Previous
Start from the current position in the file and locate the previous occurrence of
the specified string
First
Start at the beginning of the file and locate the first occurrence of the specified
string
Last
Start at the end of the file and locate the last occurrence of the specified string
Character
Match strings anywhere in a word
Word
Match only complete words
Prefix
Match only strings at the beginning of words
Suffix
134 Eclipse UI User Guide
Data Set-level Operations
Match only strings at the end of words
4.
Click one of the following buttons:
Exclude
Excludes a single item.
Exclude All
Excludes all items.
The dialog closes and the editor refreshes, hiding from view any lines that match
the excluded criteria. Contiguous excluded lines are displayed as a single line of
dashes.
More information:
Data Set-level Operations (see page 133)
Flip (see page 135)
Locate (see page 136)
Find/Change (see page 138)
Reset (see page 142)
Flip
Use the Flip command to toggle the state of the Exclude processing option without
redefining the option. All lines that were previously excluded are displayed, and all lines
that were previously displayed are excluded.
To execute the Flip command, right-click anywhere in the editor, click Data Set-level
Operations, Flip. The editor refreshes, showing the opposite of the previous display.
For example, if the editor showed the contents of a member with 20 records excluded,
using the Flip command will cause the editor to refresh showing only those 20 records.
More information:
Data Set-level Operations (see page 133)
Exclude (see page 134)
Locate (see page 136)
Find/Change (see page 138)
Reset (see page 142)
Chapter 8: Editor 135
Data Set-level Operations
Locate
Use the Locate command in the editor to jump to a specific record in the open data set
or member.
Follow these steps:
1.
Right-click anywhere in the editor, click Data Set-level Operations, Locate.
The Locate dialog displays.
2.
Specify the a value for one of the following options:
Line number
Locates records according to the numeric line number.
Key value
Locates records according to a full or partial VSAM key field value.
Type can be Character or Hexadecimal. Character is the default. Click the
drop-down arrow and select Hexadecimal to change the value.
Keywords
Select one or more of the commands that you want to include in your locate
criteria:
Change
Jumps to a record with a CHANGE attribute.
Command
Jumps to a record with a COMMAND attribute.
Error
Jumps to a record with an ERROR attribute
3.
Select one of the following location options:
First
Jumps to the first record with the specified keyword command
Last
Jumps to the last record with the specified keyword command
Next
Jumps to the next record with the specified keyword command
Previous
Jumps to the previous record with the specified keyword command
4.
Click OK.
The editor refreshes to display the record that meets the defined criteria.
136 Eclipse UI User Guide
Data Set-level Operations
More information:
Data Set-level Operations (see page 133)
Exclude (see page 134)
Flip (see page 135)
Find/Change (see page 138)
Reset (see page 142)
Chapter 8: Editor 137
Data Set-level Operations
Find/Change
Use the Find/Change command in the editor to find records that contain specified
character strings and to change one specified string to another. You can use the editor
normally while the Find/Change dialog is open.
Follow these steps:
1.
Right-click anywhere in the editor, click Data Set-level Operations, Find/Change.
The Find/Change dialog displays.
2.
Specify the find and change details:
Find
Specifies the string to find
Change to
Specifies the string with which you want the find string replaced
Note: If the Change to and Find fields are not the same length, the record
length is corrected by be removing characters or adding pad characters to the
end of the record. The Change Confirmation message displays with more
information about correcting the length of the changed record.
Type
Specifies the data type of the find string
Length
Specifies the length of the find string
Note: You must complete the Length field if you selected Packed decimal as the
data type. Otherwise this field is not active.
3.
Select the column range information:
Start column
Specifies the first, or leftmost, column in which to search
End column
Specifies the last, or rightmost, column in which to search
Note: If the end column is not also specified, the specified string must begin
the in the start column.
Note: If no column limits are specified, all records are searched for the Find string.
4.
Select the occurrence options:
Next
Start from the current position in the file and locate the next occurrence of the
specified string
Previous
138 Eclipse UI User Guide
Data Set-level Operations
Start from the current position in the file and locate the previous occurrence of
the specified string
First
Start at the beginning of the file and locate the first occurrence of the specified
string
Last
Start at the end of the file and locate the last occurrence of the specified string
5.
Select the location options that define where the string can occur in the context of
other characters in a record:
Character
Match strings anywhere in a word
Word
Match only complete words
Prefix
Match only strings at the beginning of words
Suffix
Match only strings at the end of words
6.
Specify the search options that define where to perform the search:
All lines
Search in all lines
Excluded
Search only in excluded lines
Nonexcluded lines
Search only in lines that are not excluded
Find limit
Specifies the number of records to include in the search
7.
Click one of the following buttons:
Find
Runs the find command until the specified conditions are met once.
Note: The result is highlighted in the editor in Character mode but not in
single-record format.
Find all
Runs the find command until all instances that meet the specified conditions
are met.
Chapter 8: Editor 139
Data Set-level Operations
Note: The result is highlighted in the editor in Character mode but not in
single-record format.
Change
Runs the change command until one change is made according to the specified
conditions
Note: This button activates when you specify a value in the Change to field.
Change all
Runs the change command until all changes are made according to the
specified conditions
Note: This button activates when you specify a value in the Change to field.
A message displays a summary of the find or change results.
Note: If the Find and Change to values are a different length, the Change
Confirmation dialog displays showing information about correcting the record
length. Click OK to exit the Change Confirmation message. For more information
about correcting the record length, see Change Confirmation (see page 141).
Use the editor scroll bar to view all the results.
8.
Click Close.
The Find/Change dialog closes. The find or change results remain highlighted until
you run a find or change command again or until you reset the processing option.
For more information, see Reset (see page 142).
More information:
Data Set-level Operations (see page 133)
Change Confirmation (see page 141)
Exclude (see page 134)
Flip (see page 135)
Locate (see page 136)
Reset (see page 142)
140 Eclipse UI User Guide
Data Set-level Operations
Change Confirmation
When using the Find/Change dialog to change the contents of a record, the record
length must remain the same. If the length of the Find and Change to fields are
different, the Change Confirmation message displays.
If the length of the Change to string is greater than the length of the Find string, the
Change Conformation displays, telling you that the end of the record will be truncated
to correct the record length. Click OK to close the Change Confirmation message.
If the length of the Change to string is less than the length of the Find string, the Change
Confirmation displays, prompting you to specify the type of the pad characters to add to
the end of the record. Specify the pad character details and then click OK.
To specify the pad characters, select one of the following options:
Space
Specifies a blank character
Null
Specifies a null character
Character
Specifies a specific character
Note: if you select this option, the Value field is enabled. Specify the character to
add to the end of the record.
Hexadecimal
Specifies a hexadecimal character
Note: if you select this option, the Value field is enabled. Specify hexadecimal value
to add to the end of the record. For example, 00.
More information:
Find/Change (see page 138)
Chapter 8: Editor 141
Record-level Operations
Reset
Use the Reset command in the editor to reset processing options. It clears any
highlighting, line markers, and shows any lines that were excluded.
Follow these steps:
1.
Right-click anywhere in the editor, click Data Set-level Operations, Reset.
The Reset dialog displays.
2.
Select all of the processing options that you want to reset:
Command
Clears all pending commands
Error
Removes all error flags
Exclude
Resets all exclude status
Change
Removes all change flags
Find
Clears all find highlights
Note: You must select at least one reset option.
3.
Click OK.
The specified processing options are reset.
More information:
Data Set-level Operations (see page 133)
Exclude (see page 134)
Flip (see page 135)
Locate (see page 136)
Find/Change (see page 138)
Record-level Operations
Use the following commands modify your record-level operations.
142 Eclipse UI User Guide
Record-level Operations
More information:
Editor (see page 123)
Copy (see page 143)
Move (see page 144)
Delete (see page 145)
Insert (see page 145)
Repeat (see page 146)
Case Change (see page 146)
Open a Data Set or Member (see page 123)
Character Format (see page 132)
Single-Record Format (see page 132)
Cancel (see page 133)
Data Set-level Operations (see page 133)
Copy
Use the Copy command in the editor to copy a record or records within a data set.
Follow these steps:
1.
Right-click the record that you want to copy in the editor, and then click
Record-level Operations, Copy.
The Move/Copy pending action displays in the status bar.
Note: You can use Shift+click to copy multiple contiguous records.
2.
Right-click the destination record.
Note: You cannot paste into the selection that is being copied.
3.
Click Paste and then select one of the following from the menu:
After
Copies the record or records after the selected destination record.
Before
Copies the record or records before the selected destination record.
The records are copied and the editor view updates.
Chapter 8: Editor 143
Record-level Operations
More information:
Record-level Operations (see page 142)
Move (see page 144)
Delete (see page 145)
Insert (see page 145)
Repeat (see page 146)
Case Change (see page 146)
Move
Use the Move command in the editor to move a record or records from one location to
another location within the same data set.
Follow these steps:
1.
Right-click the record in the editor that you want to move, and then click
Record-level Operations, Move.
The Move/Copy pending action displays in the status bar.
Note: You can use Shift+click to copy multiple contiguous records.
2.
Right-click the destination record.
Note: You cannot paste into the selection that is being moved.
3.
Click Paste and then select one of the following from the menu:
After
Moves the record or records after the selected destination record.
Before
Moves the record or records before the selected destination record.
The records are moved and the editor view updates.
More information:
Record-level Operations (see page 142)
Copy (see page 143)
Delete (see page 145)
Insert (see page 145)
Repeat (see page 146)
Case Change (see page 146)
144 Eclipse UI User Guide
Record-level Operations
Delete
Use the Delete command in the editor to delete any number of records.
To delete a record from a data set, right-click the record that you want to delete and
then select Record-level Options, Delete from the menu. The record is deleted and the
editor view updates.
Note: You can use Ctrl+click or Shift+click to select multiple records to delete.
More information:
Record-level Operations (see page 142)
Copy (see page 143)
Move (see page 144)
Insert (see page 145)
Repeat (see page 146)
Case Change (see page 146)
Insert
Use the Insert command in the editor to insert any number of new records.
Follow these steps:
1.
Right-click a record in the editor, and then click Record-level Operations, Insert.
The Insert dialog opens.
2.
Specify the following values as necessary:
After Current Record
Inserts the new records after the selected record.
Before Current Record
Inserts the new records before the selected record.
Number of records.
Type or select the number of records that you want to insert.
Record length
This field is only active when you work with a variable-length file. Type or select
the record length.
3.
Click OK to complete.
The new records are inserted and the editor view updates.
Chapter 8: Editor 145
Record-level Operations
More information:
Record-level Operations (see page 142)
Copy (see page 143)
Move (see page 144)
Delete (see page 145)
Repeat (see page 146)
Case Change (see page 146)
Repeat
Use the Repeat command in the editor to repeat a record or records.
To repeat a record or records within a data set, right-click the record that you want to
repeat and then select Record-level Options, Repeat from the menu. A new record is
inserted with the same contents of the selected record, and the editor view updates.
Note: You can use Ctrl+click or Shift+click to select multiple records to repeat.
More information:
Record-level Operations (see page 142)
Copy (see page 143)
Move (see page 144)
Delete (see page 145)
Insert (see page 145)
Case Change (see page 146)
Case Change
Use the Case Change command in the editor to change a record to uppercase or
lowercase.
To change the case of a record or records, right-click the record and then select
Record-level Options, Change Case. Select Lowercase or Uppercase to suit your needs.
The case is changed and the editor view updates.
Note: You can use Ctrl+click or Shift+click to select multiple records for this feature.
146 Eclipse UI User Guide
Record-level Operations
More information:
Record-level Operations (see page 142)
Copy (see page 143)
Move (see page 144)
Delete (see page 145)
Insert (see page 145)
Repeat (see page 146)
Chapter 8: Editor 147
Chapter 9: Properties
You can use the Properties view to display the properties for a selected data set.
To display data set properties, right-click a data set and select Properties. The Properties
view opens, or refreshes if it is already open, and shows the attributes for that data set.
Access this feature through any of the following views:
■
Directory List
■
Layouts
■
Selection
Chapter 9: Properties 149
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising