file manager user guide
TRANSCRIPT
Version 7 Release 1
Version 7 Release 1
First Edition (September 2006)
This edition applies to Version 7 Release 1 Modification Level 0 of IBM File Manager for z/OS (program number
5655-R47) and
Order publications through your IBM representative or the IBM branch office serving your locality. Publications are
not stocked
www.ibm.com/software/awdtools/filemanager/
95141-1003
U.S.A.
or fax your comments from within the U.S., to: 800-426-7773 or, from outside the U.S., to: 408-463-2629.
or use
www.ibm.com/software/awdtools/rcf/
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any
way it
US Government
Note!
Before using this information and the product it supports, be sure to read the general information under
“Notices” on page 979.
should
use
this
document
Using LookAt to look up message explanations . . xii
How to read the syntax diagrams . . . . . . . xiii
Summary of changes . . . . . . . . xv
Part 1. Working with File Manager . . 1
Chapter 1. File Manager overview . . . . 7 File
Manager
actions
Data sets and records . . . . . . . . . . . 8 Templates . . . . . . . . . . . . . . . 9
Why use a template? . . . . . . . . . . 9 What can you do with a template? . . . . . 10
Where can you use templates? . . . . . . . 11
Chapter 2. Getting started with File Manager . . . . . . . . . . . . . . 13 Starting and exiting File Manager . . . . . . . 13
Starting File Manager . . . . . . . . . . 13
Checking your File Manager version . . . . . 15 Checking which COBOL compiler you’re using 17
Exiting from File Manager . . . . . . . . 17 Invoking File Manager panels from outside File
Manager
. 19
Specifying quoted strings . . . . . . . . . 20 Specifying a data set and a member name . . . 20 Selecting a range of PDS(E) members . . . . . 25
Using hexadecimal values in File Manager . . . 28 Getting help . . . . . . . . . . . . . . 28
Displaying field help information . . . . . . 29
Accessing Tutorial
Set tape processing options (option 0.3) . . . . 36
Set batch job card information (option 0.4) . . . 36 Edit/Browse options (option 0.8) . . . . . . 36
VSAM edit sharing options (option 0.9) . . . . 37
Displaying or editing DBCS characters . . . . 37 National characters . . . . . . . . . . . 38
Chapter 3. Viewing data sets . . . . . 39
Displaying data
Removing or changing the template . . . . . 44 Viewing packed data . . . . . . . . . . 44
Listing statistics for the current viewing session 45
Displaying your
Retrieving details from a data set list . . . . . 52
Allocating program function keys . . . . . . 53
Manipulating your view of the data . . . . . . 54 Using primary commands when browsing or
editing . . . . . . . . . . . . . . . 54
Selecting a
Sorting the data . . . . . . . . . . . . 66
Finding specific data . . . . . . . . . . 68
Working with File Manager and shared files . . . 71
Overview of shared file features . . . . . . 72
What File
Chapter 4. Creating and editing templates . . . . . . . . . . . . . 81 Template types and structure . . . . . . . . 81
Information stored in a template . . . . . . 81
About copybook
Managing templates . . . . . . . . . . . 91
Setting your template processing options . . . 92 Specifying or updating the source definition for a
copybook template . . . . . . . . . . . 96
Advanced copybook selection . . . . . . . 97 Creating a copybook template with the
Template Workbench
Creating a template from a model template . . 101 Creating dynamic templates . . . . . . . 102
Creating corresponding templates from selected
copybooks . . . . . . . . . . . . . 105
Editing a template . . . . . . . . . . . 106 Updating one or more templates . . . . . . 110
Manipulating the display of fields in records . . . 112
Selecting and
hexadecimal . . . . . . . . . . . . . 116
UPDATE (DSEB only) . . . . . . . . . 956
DROP . . . . . . . . . . . . . . . 958
DROP MEMBER
. 959
Chapter 18. File Manager messages 961 Format of numbered messages . . . . . . . 961
Messages . . . . . . . . . . . . . . . 961
Trademarks . . . . . . . . . . . . . . 981
Related publications for COBOL . . . . . . . 983
Related publications
About this document
This document provides guidance and reference information for users of IBM File
Manager for z/OS working with QSAM data sets, VSAM data sets, IAM data sets,
or PDS members.
File Manager for z/OS contains four “flavors” of File Manager, for working in
different environments or with different data formats:
v File Manager “base” component (described in this document), for working with
QSAM data sets, VSAM data sets, IAM data sets, or PDS members.
v File Manager DB2 component, for working with DB2® data sets
v
File
Manager
IMS
component, for working with IMS™data sets
v FM/CICS for working with CICS® resources.
This document describes the File Manager Base component. For information about
the DB2, IMS, and CICS components, see these documents:
v File Manager User’s Guide and Reference for DB2 Data, SC19-1038
v File Manager User’s Guide and Reference for IMS Data, SC19-1039
v File Manager User’s Guide and Reference for CICS, SC19-1040
In the rest of this document, the term ″File Manager″ refers only to the File
Manager Base component, not to the DB2 or IMS components.
This document is divided into two parts:
Part 1. Working with File Manager
Describes the concepts inherent within File Manager, provides step-by-step
instructions on how to perform tasks using the File Manager panels under
ISPF and describes how to use the File Manager functions in batch jobs,
REXX procedures or TSO clists. The information is presented in a
task-based format, with panel, field, command and function definitions
provided only when they are relevant to the current task. For a complete
description of a particular panel, field, command or function, you should
use the appropriate chapter in Part 2 File Manager References.
Users who are new to File Manager should find that Part 1 presents the
tasks in logical groupings, helping you to use the guide as a learning tool,
as well as enabling you to quickly find the specific task instructions you
need.
Provides a lookup reference for File Manager panels, commands, functions
and messages. The information is presented in four main chapters:
1. File Manager Panel and Field Reference: Lists all of the File Manager
panels, provides a definition for each field in the panel and, where
applicable, lists the value ranges that are valid for each field.
2. File Manager Command Reference: Lists all of the Primary and Prefix
commands and gives a brief description of its syntax, usage and
equivalent function.
3. File Manager Function Reference: Lists all of the File Manager functions
and gives a description of its syntax, usage and available parameters.
© Copyright
IBM
Corp.
2000,
2006
4. File Manager Messages: Provides the full text explanation of all File
Manager error messages.
Both new and experienced users of File Manager can use Part 2 to quickly
look up such things as the exact syntax of a command or function, or the
acceptable values for a field in a panel.
Who should use this document
This document is for three kinds of File Manager users:
v Application programmers who need to test and debug programs
v Service support personnel who need to analyze and fix problems
v System administrators and system operators who need to do routine tasks such
as moving large amounts of data
This document assumes that you are familiar with using ISPF.
To use File Manager functions in batch jobs, you must already be familiar with
JCL.
To use File Manager functions in REXX procedures, you must already be familiar
with the REXX programming language.
Prerequisite and related information
Evaluating File Manager
File Manager Fact Sheet provides an overview of the product to help the
business professional decide if File Manager has the functions needed.
Planning for, installing, customizing, and maintaining File Manager
Refer first to the File Manager Customization Guide which may then refer
you to the File Manager Program Directory (shipped with the product tape)
for some information.
Using File Manager
This document, the File Manager User’s Guide and Reference, is a guide to
using File Manager. When using File Manager under ISPF, you can also
refer to the online help.
For information about related products, see the “Bibliography” on page 983.
Using LookAt to look up message explanations
LookAt is an online facility that lets you look up explanations for most messages
you encounter, as well as for some system abends and codes. Using LookAt to find
information is faster than a conventional search because in most cases LookAt goes
directly to the message explanation.
You can access LookAt from the Internet at: http://www.ibm.com/eserver/ zseries/zos/bkserv/lookat/ or from anywhere in z/OS or z/OS.e where you can
access a TSO/E command line (for example, TSO/E prompt, ISPF, z/OS UNIX
System Services running OMVS).
The LookAt Web site also features a mobile edition of LookAt for devices such as
Pocket PCs, Palm OS, or Linux-based handhelds. So, if you have a handheld
xii File Manager
device with wireless access and an Internet browser, you can now access LookAt
message information from almost anywhere.
To use LookAt as a TSO/E command, you must have LookAt installed on your
host system. You can obtain the LookAt code for TSO/E from a disk on your z/OS
Collection (SK3T-4269) or from the LookAt Web site’s
Download link.
How to read the syntax diagrams
The syntax for File Manager Primary commands is described using the structure
defined below.
v Read the syntax diagrams from left to right, from top to bottom, following the
path of the line.
The symbol indicates the beginning of a statement.
The symbol indicates that a statement is continued on the next line.
The symbol indicates that a statement is continued from the previous line.
The symbol indicates the end of a statement.
v Required items appear on the horizontal line (the main path).
STATEMENT required_item
STATEMENT optional_item
v If you can choose from two or more items, they appear vertically, in a stack.
If you must choose one of the items, one item of the stack appears on the main
path.
If choosing one of the items is optional, the entire stack appears below the main
path.
v An arrow returning to the left above the main line indicates an item that can be
repeated.
v The required part of keywords appear in uppercase letters (for example, SHAdow).
The abbreviated or whole keyword you enter must be spelled exactly as shown
(SHA, SHAD, SHADO, or SHADOW).
v Variables (for example, nlrecs) appear in lowercase letters. They represent
user-supplied names or values.
First Edition (September 2006)
This section describes the major new features provided in File Manager Version 7.
Technical changes are marked in the text by a vertical change bar in the left
margin.
XML
support
A new function has been added to generate well-formed XML from an
input data set (file) and a template. The function is a new feature of the
Copy Utility. The function has an interactive ISPF-based interface and a
batch interface.
For details, see:
v “Generating data in external format - XML representation” on page 211
Creating and updating multiple templates
A new utility, the Template Update Utility, allows you to make bulk
changes to templates and to easily identify templates that are updated by
copybook changes.
Creating multiple templates from a PDS of copybooks
A new utility, the Batch Template Build Utility, allows you to create
multiple templates from a PDS of copybooks.
For details, see:
105
v “BTB (Batch Template Build)” on page 717
Updating multiple templates from a PDS of copybooks
A new utility, the Batch Template Update Utility, allows you to update
multiple templates from a PDS of copybooks.
For details, see:
105
Additional Compare Utility output
The Compare Utility (and the DSM batch function) have been enhanced to:
v Optionally generate four output data sets containing the records
identified as inserted, deleted, changed, or matched. The option is only
supported when a record synchronization option of either keyed or
one-to-one has been selected.
v Provide additional options to control the reporting of inserted, deleted,
changed, and matched records.
v Provide an option to limit the size of the generated report.
For details, see:
© Copyright
IBM
Corp.
2000,
2006
v “Compare Utility: Options panel” on page 412
v “Compare Utility: Output Data Sets” on page 422
LHEX field format in File Manager templates
You can now display and edit a formatted alphanumeric data element in a
single line HEX (LHEX) field format. The LHEX field format is supported
in all functions which use templates to display, edit, or print formatted
alphanumeric fields.
v “Displaying alphanumeric fields in long hexadecimal” on page 116
v “DSG (Data Set Generate)” on page 778
v “Copybook View and Print: View panel” on page 441
v “Create Tape Data panel” on page 444
v “Data Create Utility panel” on page 446
v “Edit Dynamic Template panel” on page 469
v “Field Attributes panel - alphanumeric fields” on page 489
v “Field Selection/Edit panel” on page 498
VSAM secondary index creation
You can now build an alternate index (AIX) for a VSAM file.
For details, see:
Improved
syntax
for
FIND,
CHANGE,
and
EXCLUDE
primary
commands
Enhancements have been made to the syntax for FIND, CHANGE, and
EXCLUDE primary commands. You can now specify:
v An asterisk (*) in place of a string to indicate that the search string
specified on the previous similar command (FIND, CHANGE, or
EXCLUDE as applicable) is to be used as the search string.
In the case of the CHANGE primary command, you can also specify an
asterisk to indicate the replacement string specified on the previous
CHANGE command is to be used as the replacement string.
v One of the keywords, CHARS, PREFIX, SUFFIX, or WORD to control the
portion of the data to be matched to the search string.
v Parameters in any order.
v CHG as a short form of CHANGE.
For details, see:
v “Finding and replacing strings” on page 178
v “CHANGE primary command” on page 626
v “FIND primary command” on page 645
v “EXCLUDE primary command” on page 639
Templates by DDNAME
Additional batch function parameters are now available to provide more
flexibility and support for concatenated datasets.
For details, see:
v “DSC (Data Set Copy)” on page 741
v “DSEB (Data Set Edit Batch) — batch only” on page 767
xvi File Manager
v “DSU (Data Set Update) — batch only” on page 830
v “PBK (Print Copybook)” on page 876
CAPS setting, separate Suppressed and Not Selected options
You can now specify the:
v CAPS setting as a profile option
v SHOW option separately for not-selected and suppressed records.
The Edit/Browse Options panel has also been redesigned to make it easier
to find and select options. Where applicable, the relevant primary
command that affects the option during a Browse or Edit session is shown
on the panel.
For details, see:
v “Changing the case of data” on page 177
v “Displaying “suppressed” records” on page 155
v “Displaying “not-selected” records” on page 157
v “Edit/Browse Options panel” on page 481
VSAM Record Integrity Checking
Additional edit facilities have been introduced to help you work with
VSAM files in a shared environment. These features include:
v Record integrity checking and warning when saving a record.
v The ability to save an individual record, or a set of individual records,
by the use of numbered of grouped line commands.
v New options that let you specify:
– A file is saved after a specified number of updates
– A file is saved after a specified number of updates in the CHANGE
ALL process<
– Whether a warning is displayed when an integrity failure occurs
during a CHANGE ALL command.
v The ability to reread an individual record or all records by issuing a
refresh command.
v The ability to locate records that have encountered an integrity check
during the save process.
For details, see:
v “Working with File Manager and shared files” on page 71
Edit/Browse options
In an Edit or Browse session, you can now use the new PROFILE primary
command to display your current Edit/Browse options.
For details, see:
v “PROFILE primary command” on page 672
SCS VSAM file information
A number of enhancements have been made to way in which you can
view your data sets:
v The date on which a data set was last updated is now shown on the
VSAM Entry Detail panel.
v A new primary command, EXTENT, allows you to produce a list of all
allocated extents on all volumes for a PDSE data set.
v A new primary command, VOLUME, displays volume information for a
VSAM or non-VSAM data set in a pop-up panel.
v You can now use the INFO primary command to see all significant data
set information for a non-VSAM data set in a single panel.
v When you want to list all data sets which match a specified data set
mask, you ca now specify a limit for the number of the data sets to be
processed.
v “Selecting your service” on page 256
v “Displaying volume information” on page 261
v “Displaying extent details for non-VSAM data sets” on page 262
v “VOLUME primary command” on page 705
v “EXTENT primary command” on page 642
v “LOCATE primary command” on page 659
v “SCS (Catalog Services)” on page 881
v “Catalog Services panel” on page 401
v “Non-VSAM Entry Detail panel” on page 534
v “VSAM Entry Detail panel” on page 611
Volume list selection
The Work with VTOC utility (and the equivalent batch function, DVT)
have been enhanced to allow you to select details based on the SMS
storage group, device type, device address (unit), and volume status.
For details, see:
v “Displaying a Volume Table of Contents (VTOC)” on page 268
v “DVT (Display VTOC)” on page 842
v “Display VTOC panel” on page 454
v Figure 130 on page 458
v Figure 220 on page 607
Additional
print
formatting
options
Enhancements have been made to print formatting in SNGL format for
both batch and online processing.
For details, see:
v “Setting your Print Processing Options” on page 245
v “Printing data sets” on page 246
v “Printing a single record” on page 251
v “Edit/Browse Options panel” on page 481
v “Print Utility panel” on page 544
v “DSP (Data Set Print)” on page 816
Compare Utility - new option to always show selected fields
A new option available with the Compare Utility, Always show SELECTed
fields, causes fields selected in the template to appear in the comparison
xviii File Manager
results, regardless of whether they have changed or not. This can be
helpful in identifying records with differences.
For details, see:
Segmented ID criteria
features:
v Provision of a related ID criteria. This is a criteria based on a field in
another segment’s layout. A level-01 layout can contain multiple related
ID criteria.
v Modification of the existing selection process, such that segmented
selection applies to the record as a whole. This, combined with the
previous point, allows template criteria to be used for data that is
interrelated in some way amongst segments.
v Further modifications to the selection process such that records (and all
segments contained therein) that do not meet selection criteria are not
provided to utilities or to Edit or Browse. (The existing behaviour, where
segments that have been de-selected in the template are not provided to
utilities but are provided to Browse and Edit, remains unchanged.)
For details, see:
v “Field Selection/Edit panel” on page 498
v “Related ID expression panel” on page 555
v “RID Selection panel” on page 559
COBOL compiler
A new primary command, SHOWCOB, allows you to check which COBOL
compiler is currently loaded.
For details, see:
v “Checking which COBOL compiler you’re using” on page 17
Support for Large Block Interface and for volumes with more than 64K tracks
File Manager now provides support:
v For Large Block Interface (LBI) for tapes.
v In full-volume utilities, for disk volumes with more than 64K tracks.
For details, see:
New
COBOL
compiler
option
An additional COBOL compiler option is now available that allows you to
select the COBOL SPECIAL-NAMES paragraph, ″Decimal-point is comma″.
When you select this option, the COBOL compiler exchanges the functions
of the period and the comma in PICTURE character strings and in numeric
literals.
v “Setting your COBOL processing options” on page 93
v “Set COBOL Processing Options panel (option 0.6)” on page 563
v “DSB (Data Set Browse)” on page 736
v “DSC (Data Set Copy)” on page 741
Summary of
v “DSE (Data Set Edit)” on page 762
v “DSEB (Data Set Edit Batch) — batch only” on page 767
v “DSG (Data Set Generate)” on page 778
v “DSM (Data Set Compare)” on page 788
v “DSP (Data Set Print)” on page 816
v “DSU (Data Set Update) — batch only” on page 830
v “PBK (Print Copybook)” on page 876
Chapter 1. File Manager overview .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. .
. 9 Why use a template? . . . . . . . . . . 9 What can you do with a template? . . . . . 10
Where can you use templates? . . . . . . . 11
Chapter 2. Getting started with File Manager . . 13
Starting and exiting File Manager . . . . . . . 13
Starting File Manager . . . . . . . . . . 13
which
COBOL
compiler
Using the File Manager interface . . . . . . . 18
Navigating in File Manager . . . . . . . . 18 Issuing commands . . . . . . . . . . . 19 Specifying quoted strings . . . . . . . . . 20 Specifying a data set and a member name . . . 20
Examples of
Using hexadecimal values in File Manager . . . 28 Getting help . . . . . . . . . . . . . . 28
Displaying field help information . . . . . . 29
Accessing Tutorial Help . . . . . . . . . 29
your
default
processing
options
Set batch job card information (option 0.4) . . . 36 Edit/Browse options (option 0.8) . . . . . . 36
VSAM edit sharing options (option 0.9) . . . . 37
Displaying or editing DBCS characters . . . . 37 National characters . . . . . . . . . . . 38
Chapter 3. Viewing data sets .
.
.
.
.
.
.
data
without
using
templates
. 40
Displaying data with a template . . . . . . 41 Example of displaying data with a template 42
Removing or changing the template . . . . . 44 Viewing packed data . . . . . . . . . . 44 Listing statistics for the current viewing session 45
Displaying your current Edit/Browse options . . 46
Ending a
Making a list the current data set list . . . . 49 Creating
a
new
personal
data
set
list
Progressive retrieval (NRETRIEV primary
Manipulating your
. 54
Selecting a display format . . . . . . . . 55 Setting the initial display format . . . . . 55
Changing the display format . . . . . . 55
Display formats . . . . . . . . . . . 55
Displaying the RBA and record length
information
Scrolling to the first or last record or column 65
Holding fields when scrolling left or right . . 65
Locating a field, column or record number . . 66
Sorting the data . . . . . . . . . . . . 66
Finding specific data . . . . . . . . . . 68
Finding errors
What File Manager considers a shared file . . . 72
Record integrity checking . . . . . . . . . 72
“==MSG>” and “=PROF>” indicators . . . 76
Refreshing the
(Autosave frequency option) . . . . . . . 78
Template types and structure . . . . . . . . 81
Information stored in a template . . . . . . 81
About copybook templates . . . . . . . . 83
Segmented data templates . . . . . . . . 85
Support for PL/I data description entries . . 88
Support for variable-length arrays . . . . . 89 Editing rules for PL/I varying length string
types . . . . . . . . . . . . . . 90 Editing rules for PL/I varying length zero
terminated string
internal
(FASTREXX)
processing
processing . . . . . . . . . . . . . 355
Manager panel . . . . . . . . . . . 355
Enhanced processing modes . . . . . . . 359
Enhanced record processing . . . . . . 359
Performance tips . . . . . . . . . . . 362
Printing data . . . . . . . . . . . . 363
Copying data . . . . . . . . . . . . 363
Writing one or more optionally edited records to
one or more output files, depending on data in
the input record . . . . . . . . . . . 366 Determining
whether
to
copy
or
print
a
member
IBM File Manager for z/OS™ (base component) provides comprehensive,
user-friendly tools for working with HFS files and QSAM, VSAM and IAM data
sets. These tools include the familiar browse, edit, copy and print utilities found in
ISPF, enhanced to meet the needs of application developers.
This chapter provides an overview of the types of actions you can perform with
File Manager, a list of the types of data sets upon which you can perform these
actions and some concept information about templates, one of the main tools used
to view and edit data sets in File Manager.
File Manager actions
You can use File Manager to display, edit, update, create, copy, compare, print and
erase data. You can manipulate this data as logical units, accessed by the data set
name; or as physical units, accessed at each physical disk or tape location. Adding
to this capability is an interactive interface that allows you to view data in both
TABLE and SINGLE RECORD formats.
When working with data sets, you can:
v View, change, sort, copy and print data as unformatted or formatted with
copybook or dynamic templates
v Perform sophisticated data set comparisons
v Find and change data strings in a single data set or in multiple data sets
v Create new HFS files or QSAM, VSAM or IAM data sets and data set records
v Create REXX procedures for advanced record processing
v Use selected DFSORT® control statements to control the Data Set Copy and Data
Set Print functions
v Create batch jobs, REXX procedures or CLISTs to automate tasks
For many of these tasks, you can use File Manager templates. A template provides a
logical view of a data set, based upon field definitions in a COBOL or PL/I
copybook, or else created dynamically. If you use a template, you can:
v Format data according to record structures defined in COBOL or PL/I
copybooks, or dynamically define your own record structure
v Select the fields and records that you want to work with, adjust how fields are
displayed, select fields for copying, and set the contents of fields for created data
v Code record identification and selection criteria within File Manager panels, or
use File Manager’s REXX interface to code complex criteria
v Copy data between fields of different data type and length; and
v Work with files containing multiple record structures
File Manager also provides utilities that allow you to manipulate data in other
ways:
v With the Tape Utility you can:
– Copy tape files, optionally changing the block size and record format
– Copy a logical volume from an Exported Stacked Volume to a physical tape
volume
© Copyright
IBM
Corp.
2000,
2006
– Update tape records on-screen, while copying the records from one tape to
another
– Bypass tape blocks with data-check errors
– Summarize the contents of a tape
v With the Disk Utility, you can look at and edit a file, based on the contents of the data at each physical disk location. There is support for character and
hexadecimal format. Because the access is done at the level of the physical track,
all file types are supported, including BDAM. With the disk utilities, you can:
– List data sets on a disk
– Edit data on a specific track
– Identify the disk extents of a data set
– Search for data within a disk extent
v You can use the Object Access Method (OAM) Utility to list, browse, print,
update, erase, copy, back up and restore OAM objects.
v The IDCAMS front end (Catalog Services) allows you to control the OS/390
IDCAMS utility from user-friendly File Manager panels.
Data sets and records
File Manager provides production and development logical file manipulation for
HFS files, QSAM and VSAM (including IAM) data sets.
You can browse or edit these types of data sets:
v QSAM data sets: A member of a partitioned data set or a sequential data set
with any of these data set attributes:
– Record format
- For spanned variable-length data: 1–16MB
v VSAM data sets:
– RRDS (fixed-length or variable-length)
– PATH (PATHs related to an alternate index are restricted to browse only)
– AIX
v HFS files: A file contained in the z/OS UNIX Hierarchical File System (HFS)
– Record format
- Binary
- Text mode files are variable length: 1-32752
- Binary mode files are fixed length: 1-32760
File Manager Version 7 is able to use COBOL and PL/I copybooks that are stored
in a PDS, a PDSE, a CA-Panvalet library, or a library accessed using the Library
Management System Exit.
Templates
A File Manager template is a file that provides a particular interpretation of a data
set. The template defines a logical view that you can use to view and manipulate
the data in records as discrete fields. With a template, you can select and format
records and fields when editing, browsing, copying, printing and creating data
sets. Templates can be based upon a COBOL or PL/I copybook or can be created
dynamically. You can apply different templates to the same data, to achieve
different purposes. For example, you might create a number of templates with
different selection criteria in place, and then apply the template that defines the
subset of records that you need for a particular purpose. Also, you can apply the
same template to different data sets, provided that they have similar record and
field structures.
The File Manager Base, DB2 and IMS components all use templates. However,
these templates are not interchangeable between the components. You cannot, for
example, use a “base” template in the File Manager DB2 component. Dynamic
templates are only available within the Base component.
Why use a template?
Typically, data sets containing application data have a well-defined structure,
where each record in the data set consists of several fields. Each field contains a
discrete item of data, such as a person’s name, a product code or a currency
amount (depending on the application). This data can be of various types: some
fields contain character data, others contain numeric data (perhaps encoded in
binary format to conserve storage space).
To work efficiently with these data sets, you need tools that recognize record
structure, allowing you to selectively process individual fields.
For example, if you use a text editor (such as the ISPF editor) to display an
application data set, then each record appears as a string of characters, with no
indication that the records consist of individual fields. Fields containing numeric
data encoded in binary or packed decimal format are represented by their
(typically “non-displayable”) character values, rather than their numeric values.
Even if you know the column boundaries of each field, editing an application data
set in a text editor can be difficult and tedious:
v If you want to find and replace data in a specific field, then you have to be
careful not to change the field length; otherwise, you could move the boundaries
of subsequent fields, and corrupt the record structure.
v If you want to find and replace data in numeric fields where the data has been
encoded in binary or packed decimal format, then you have to specify the find
and replace values in that format (typically, as hexadecimal values), rather than
as numeric values.
v If the file you are editing contains several record types (each with its own
structure), and you only want to find and replace data in one record type, then
you have to exclude other record types from editing.
The Grant Smith record contains the numeric value “94”, stored in a binary
numeric field. To change this from 94 to 48, without using a template, you would
need to:
1. Display the hexadecimal values of the record data.
2. Determine the column positions occupied by the field.
3. Convert the numeric value 48 into its hexadecimal equivalent (X'30').
To change the value of the AGE binary numeric field from 94 to 48, you can
simply overtype 94 with 48, or enter the following command (where #5 is the
“field reference” for the AGE field):
CHANGE 94
Another situation in which you might want to use a template is when you are
copying data. When you use a copy utility that does not recognize record
structure, you are often limited to copying an entire data set, or a number of records. If you want to copy only records with particular field values, or only
particular fields, then you must write a custom program.
When using templates with File Manager, you can specify criteria to select only the
records you want to copy, and to select the fields you want from the list of fields
in the record.
Using a template, you can:
v Format records
You can display, print and compare fields taking into account their data types.
For example, binary numeric fields are displayed as their true numeric values,
not as the character representation of their binary value.
When editing, you can overtype or use CHANGE commands to replace these
formatted numeric field values with different numeric values; File Manager
adjusts the underlying binary value in the data set.
You can select which fields are displayed (when browsing or editing) or printed.
When browsing or editing data, you can limit the scope of commands (such as
FIND and CHANGE) to particular fields.
You can change the order in which fields are displayed (when browsing or
editing) or printed.
For numeric fields, you can display or suppress leading zeros (so that, for
example, 00057 is displayed and printed as 57); the default is to suppress
leading zeros.
To illustrate, here are some records containing a mixture of alphanumeric and numeric fields
displayed in
000015 01Graham Prestcott õ ç
Here is the same record displayed in the File Manager editor using a template:
REC-TYPE NAME EMPLOYEE-NO AGE SALARY MONTH(1) MONTH(2)
#2
#3
#4
#5
#6
#7
#7
<>
v Reformat records
When copying data, you can “map” which fields in the input data set you want
copied to the output data set. You can insert or delete fields, and copy data
between fields of different data types or lengths.
v Identify record types and select records within those types
You can select records using two levels of criteria:
– Record identification criteria
Identify the unique characteristics of a record type, enabling File Manager to
distinguish it from other types of record in the same data set. You can then
select which record types in a data set you want to use.
Before you can specify record identification criteria, you need to examine
your data, and determine what field values uniquely identify a record as
belonging to a particular type.
– Record selection criteria
After a record has been identified as belonging to a particular type, you can
specify record selection criteria to narrow down which records of that type
you want to use.
v Create data
When creating a new data set, or adding a new field when copying a data set,
you can specify field “create attributes” (patterns that File Manager uses to
initialize field values).
Where can you use templates?
The following table lists the tasks, panels and functions that support the use of templates:
Task Panel Function
Edit data
Create data
Update data
DSU
(batch
only)1
Notes:
1. For the DSEB and DSU functions, the template is not used during editing or updating; it
is only used during enhanced batch processing, when you call the File Manager REXX
external function PRINT with SNGL or TABL format.
The difference between using DSU to “update” data versus using DSEB to “edit” data is
that DSU operates on a “per record” basis: each record in a data set is treated separately,
in sequence; whereas you can use DSEB to move between the records in a data set as
you choose,
With any of these panels or functions, you can supply an existing template (created
dynamically or from a copybook), supply a COBOL or PL/I copybook, or create a
new dynamic template. If you supply a copybook, then File Manager compiles it
into a template before use.
Overview
Chapter 2. Getting started with File Manager
This chapter is designed to help the new user to familiarize themselves with the
user interface and general methods for working within File Manager panels.
The major tasks described in this chapter are:
“Starting and exiting File Manager”;
“Using the File Manager interface” on page 18;
“Getting help” on page 28; and
“Setting your default processing options” on page 32
Starting and exiting File Manager
File Manager is an ISPF-developed application and is usually run from within an
ISPF session. Exiting from File Manager returns you to your ISPF session. File
Manager panels can also be invoked from outside of the File Manager application.
A subset of File Manager functions is available in non-ISPF mode (batch
processing). See Chapter 17, “Functions,” on page 707.
The tasks described in this section are:
v “Starting File Manager”;
v “Checking your File Manager version” on page 15;
v “Exiting from File Manager” on page 17; and
v “Invoking File Manager panels from outside File Manager” on page 17.
Starting File Manager For information about running File Manager in non-ISPF mode (batch processing),
see Chapter 17, “Functions,” on page 707.
How you start File Manager in ISPF depends on how it has been installed on your
system. Typically, File Manager is installed as an option on your z/OS Primary
Option Menu:
To start File Manager:
1. Select the File Manager option from the z/OS Primary Option Menu.
Note: If File Manager is not an option on your menu, ask your system
administrator to explain the startup process used at your site.
When you start File Manager, the File Manager Primary Option Menu is
shown, with the current version information displayed in a pop-up message
box.
1 View Display source data or listings
2 Edit Create or change source data
3 Utilities
5 Batch Submit job for language processing
6 Command Enter TSO or Workstation commands
7 Dialog Test Perform dialog testing
8 LM
11 Workplace ISPF Object/Action Workplace
12 OS/390 System OS/390 system programmer applications
13 OS/390 User OS/390 user applications
14 IBMGSA
F File
Option ===>
F________________________________________________________________
Figure 1. z/OS Primary Option Menu panel showing File Manager option
Getting started with File Manager
14 File Manager
RELATED
TOPICS
Checking your File Manager version
To display the full version information for File Manager, enter VER on the
Command line of any panel. The current File Manager version number and the
PTF number for each File Manager component is displayed in a window. The
window also indicates whether or not File Manager is APF-authorized.
Process
Options
Help
3 Utilities
5 Disk/VSAM
7 Templates
Chapter 2.
An alternative way to display version information is to select Help > 7. About
from the Action Bar on any panel. The current File Manager version number and
the PTF number of the File Manager base component is displayed. The window
also shows the copyright information and any notes from IBM that are shipped
with the product.
Process Options Help
0
Settings
Set
processing
options
User
ID
2
4 IBM File Manager for z/OS Version 7 Release 1
5
7 5655-R47 (C) Copyright IBM Corporation 1986, 2006 - All rights reserved
X
“VER (Display Service Level)” on page 915
Process
Options
Help
4 IBM File Manager for z/OS Version 7 Release 1
5
16 File Manager
Checking which COBOL compiler you’re using
File Manager uses the currently loaded COBOL compiler to create a template from
a COBOL copybook.
To display details about the current COBOL compiler, enter SHOWCOB on the
Command line of any panel. File Manager displays details about the current
COBOL compiler in a window.
RELATED TOPICS
“SHOWCOB primary command” on page 689
Exiting from File Manager You can exit from File Manager from the Primary Options Menu panel in any of the following ways:
v Press the Exit function key (F3).
v Enter X (or EXIT or END) on the Command line.
v Select
To exit the application from any panel within File Manager:
v Enter =X on the Command line.
RELATED TOPICS
“END primary command” on page 638
“EXIT primary command” on page 642
Invoking File Manager panels from outside File Manager File Manager panels can also be invoked directly from any REXX procedure, TSO
clist or ISPF Command line. To do
Version 7 Release 1
First Edition (September 2006)
This edition applies to Version 7 Release 1 Modification Level 0 of IBM File Manager for z/OS (program number
5655-R47) and
Order publications through your IBM representative or the IBM branch office serving your locality. Publications are
not stocked
www.ibm.com/software/awdtools/filemanager/
95141-1003
U.S.A.
or fax your comments from within the U.S., to: 800-426-7773 or, from outside the U.S., to: 408-463-2629.
or use
www.ibm.com/software/awdtools/rcf/
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any
way it
US Government
Note!
Before using this information and the product it supports, be sure to read the general information under
“Notices” on page 979.
should
use
this
document
Using LookAt to look up message explanations . . xii
How to read the syntax diagrams . . . . . . . xiii
Summary of changes . . . . . . . . xv
Part 1. Working with File Manager . . 1
Chapter 1. File Manager overview . . . . 7 File
Manager
actions
Data sets and records . . . . . . . . . . . 8 Templates . . . . . . . . . . . . . . . 9
Why use a template? . . . . . . . . . . 9 What can you do with a template? . . . . . 10
Where can you use templates? . . . . . . . 11
Chapter 2. Getting started with File Manager . . . . . . . . . . . . . . 13 Starting and exiting File Manager . . . . . . . 13
Starting File Manager . . . . . . . . . . 13
Checking your File Manager version . . . . . 15 Checking which COBOL compiler you’re using 17
Exiting from File Manager . . . . . . . . 17 Invoking File Manager panels from outside File
Manager
. 19
Specifying quoted strings . . . . . . . . . 20 Specifying a data set and a member name . . . 20 Selecting a range of PDS(E) members . . . . . 25
Using hexadecimal values in File Manager . . . 28 Getting help . . . . . . . . . . . . . . 28
Displaying field help information . . . . . . 29
Accessing Tutorial
Set tape processing options (option 0.3) . . . . 36
Set batch job card information (option 0.4) . . . 36 Edit/Browse options (option 0.8) . . . . . . 36
VSAM edit sharing options (option 0.9) . . . . 37
Displaying or editing DBCS characters . . . . 37 National characters . . . . . . . . . . . 38
Chapter 3. Viewing data sets . . . . . 39
Displaying data
Removing or changing the template . . . . . 44 Viewing packed data . . . . . . . . . . 44
Listing statistics for the current viewing session 45
Displaying your
Retrieving details from a data set list . . . . . 52
Allocating program function keys . . . . . . 53
Manipulating your view of the data . . . . . . 54 Using primary commands when browsing or
editing . . . . . . . . . . . . . . . 54
Selecting a
Sorting the data . . . . . . . . . . . . 66
Finding specific data . . . . . . . . . . 68
Working with File Manager and shared files . . . 71
Overview of shared file features . . . . . . 72
What File
Chapter 4. Creating and editing templates . . . . . . . . . . . . . 81 Template types and structure . . . . . . . . 81
Information stored in a template . . . . . . 81
About copybook
Managing templates . . . . . . . . . . . 91
Setting your template processing options . . . 92 Specifying or updating the source definition for a
copybook template . . . . . . . . . . . 96
Advanced copybook selection . . . . . . . 97 Creating a copybook template with the
Template Workbench
Creating a template from a model template . . 101 Creating dynamic templates . . . . . . . 102
Creating corresponding templates from selected
copybooks . . . . . . . . . . . . . 105
Editing a template . . . . . . . . . . . 106 Updating one or more templates . . . . . . 110
Manipulating the display of fields in records . . . 112
Selecting and
hexadecimal . . . . . . . . . . . . . 116
UPDATE (DSEB only) . . . . . . . . . 956
DROP . . . . . . . . . . . . . . . 958
DROP MEMBER
. 959
Chapter 18. File Manager messages 961 Format of numbered messages . . . . . . . 961
Messages . . . . . . . . . . . . . . . 961
Trademarks . . . . . . . . . . . . . . 981
Related publications for COBOL . . . . . . . 983
Related publications
About this document
This document provides guidance and reference information for users of IBM File
Manager for z/OS working with QSAM data sets, VSAM data sets, IAM data sets,
or PDS members.
File Manager for z/OS contains four “flavors” of File Manager, for working in
different environments or with different data formats:
v File Manager “base” component (described in this document), for working with
QSAM data sets, VSAM data sets, IAM data sets, or PDS members.
v File Manager DB2 component, for working with DB2® data sets
v
File
Manager
IMS
component, for working with IMS™data sets
v FM/CICS for working with CICS® resources.
This document describes the File Manager Base component. For information about
the DB2, IMS, and CICS components, see these documents:
v File Manager User’s Guide and Reference for DB2 Data, SC19-1038
v File Manager User’s Guide and Reference for IMS Data, SC19-1039
v File Manager User’s Guide and Reference for CICS, SC19-1040
In the rest of this document, the term ″File Manager″ refers only to the File
Manager Base component, not to the DB2 or IMS components.
This document is divided into two parts:
Part 1. Working with File Manager
Describes the concepts inherent within File Manager, provides step-by-step
instructions on how to perform tasks using the File Manager panels under
ISPF and describes how to use the File Manager functions in batch jobs,
REXX procedures or TSO clists. The information is presented in a
task-based format, with panel, field, command and function definitions
provided only when they are relevant to the current task. For a complete
description of a particular panel, field, command or function, you should
use the appropriate chapter in Part 2 File Manager References.
Users who are new to File Manager should find that Part 1 presents the
tasks in logical groupings, helping you to use the guide as a learning tool,
as well as enabling you to quickly find the specific task instructions you
need.
Provides a lookup reference for File Manager panels, commands, functions
and messages. The information is presented in four main chapters:
1. File Manager Panel and Field Reference: Lists all of the File Manager
panels, provides a definition for each field in the panel and, where
applicable, lists the value ranges that are valid for each field.
2. File Manager Command Reference: Lists all of the Primary and Prefix
commands and gives a brief description of its syntax, usage and
equivalent function.
3. File Manager Function Reference: Lists all of the File Manager functions
and gives a description of its syntax, usage and available parameters.
© Copyright
IBM
Corp.
2000,
2006
4. File Manager Messages: Provides the full text explanation of all File
Manager error messages.
Both new and experienced users of File Manager can use Part 2 to quickly
look up such things as the exact syntax of a command or function, or the
acceptable values for a field in a panel.
Who should use this document
This document is for three kinds of File Manager users:
v Application programmers who need to test and debug programs
v Service support personnel who need to analyze and fix problems
v System administrators and system operators who need to do routine tasks such
as moving large amounts of data
This document assumes that you are familiar with using ISPF.
To use File Manager functions in batch jobs, you must already be familiar with
JCL.
To use File Manager functions in REXX procedures, you must already be familiar
with the REXX programming language.
Prerequisite and related information
Evaluating File Manager
File Manager Fact Sheet provides an overview of the product to help the
business professional decide if File Manager has the functions needed.
Planning for, installing, customizing, and maintaining File Manager
Refer first to the File Manager Customization Guide which may then refer
you to the File Manager Program Directory (shipped with the product tape)
for some information.
Using File Manager
This document, the File Manager User’s Guide and Reference, is a guide to
using File Manager. When using File Manager under ISPF, you can also
refer to the online help.
For information about related products, see the “Bibliography” on page 983.
Using LookAt to look up message explanations
LookAt is an online facility that lets you look up explanations for most messages
you encounter, as well as for some system abends and codes. Using LookAt to find
information is faster than a conventional search because in most cases LookAt goes
directly to the message explanation.
You can access LookAt from the Internet at: http://www.ibm.com/eserver/ zseries/zos/bkserv/lookat/ or from anywhere in z/OS or z/OS.e where you can
access a TSO/E command line (for example, TSO/E prompt, ISPF, z/OS UNIX
System Services running OMVS).
The LookAt Web site also features a mobile edition of LookAt for devices such as
Pocket PCs, Palm OS, or Linux-based handhelds. So, if you have a handheld
xii File Manager
device with wireless access and an Internet browser, you can now access LookAt
message information from almost anywhere.
To use LookAt as a TSO/E command, you must have LookAt installed on your
host system. You can obtain the LookAt code for TSO/E from a disk on your z/OS
Collection (SK3T-4269) or from the LookAt Web site’s
Download link.
How to read the syntax diagrams
The syntax for File Manager Primary commands is described using the structure
defined below.
v Read the syntax diagrams from left to right, from top to bottom, following the
path of the line.
The symbol indicates the beginning of a statement.
The symbol indicates that a statement is continued on the next line.
The symbol indicates that a statement is continued from the previous line.
The symbol indicates the end of a statement.
v Required items appear on the horizontal line (the main path).
STATEMENT required_item
STATEMENT optional_item
v If you can choose from two or more items, they appear vertically, in a stack.
If you must choose one of the items, one item of the stack appears on the main
path.
If choosing one of the items is optional, the entire stack appears below the main
path.
v An arrow returning to the left above the main line indicates an item that can be
repeated.
v The required part of keywords appear in uppercase letters (for example, SHAdow).
The abbreviated or whole keyword you enter must be spelled exactly as shown
(SHA, SHAD, SHADO, or SHADOW).
v Variables (for example, nlrecs) appear in lowercase letters. They represent
user-supplied names or values.
First Edition (September 2006)
This section describes the major new features provided in File Manager Version 7.
Technical changes are marked in the text by a vertical change bar in the left
margin.
XML
support
A new function has been added to generate well-formed XML from an
input data set (file) and a template. The function is a new feature of the
Copy Utility. The function has an interactive ISPF-based interface and a
batch interface.
For details, see:
v “Generating data in external format - XML representation” on page 211
Creating and updating multiple templates
A new utility, the Template Update Utility, allows you to make bulk
changes to templates and to easily identify templates that are updated by
copybook changes.
Creating multiple templates from a PDS of copybooks
A new utility, the Batch Template Build Utility, allows you to create
multiple templates from a PDS of copybooks.
For details, see:
105
v “BTB (Batch Template Build)” on page 717
Updating multiple templates from a PDS of copybooks
A new utility, the Batch Template Update Utility, allows you to update
multiple templates from a PDS of copybooks.
For details, see:
105
Additional Compare Utility output
The Compare Utility (and the DSM batch function) have been enhanced to:
v Optionally generate four output data sets containing the records
identified as inserted, deleted, changed, or matched. The option is only
supported when a record synchronization option of either keyed or
one-to-one has been selected.
v Provide additional options to control the reporting of inserted, deleted,
changed, and matched records.
v Provide an option to limit the size of the generated report.
For details, see:
© Copyright
IBM
Corp.
2000,
2006
v “Compare Utility: Options panel” on page 412
v “Compare Utility: Output Data Sets” on page 422
LHEX field format in File Manager templates
You can now display and edit a formatted alphanumeric data element in a
single line HEX (LHEX) field format. The LHEX field format is supported
in all functions which use templates to display, edit, or print formatted
alphanumeric fields.
v “Displaying alphanumeric fields in long hexadecimal” on page 116
v “DSG (Data Set Generate)” on page 778
v “Copybook View and Print: View panel” on page 441
v “Create Tape Data panel” on page 444
v “Data Create Utility panel” on page 446
v “Edit Dynamic Template panel” on page 469
v “Field Attributes panel - alphanumeric fields” on page 489
v “Field Selection/Edit panel” on page 498
VSAM secondary index creation
You can now build an alternate index (AIX) for a VSAM file.
For details, see:
Improved
syntax
for
FIND,
CHANGE,
and
EXCLUDE
primary
commands
Enhancements have been made to the syntax for FIND, CHANGE, and
EXCLUDE primary commands. You can now specify:
v An asterisk (*) in place of a string to indicate that the search string
specified on the previous similar command (FIND, CHANGE, or
EXCLUDE as applicable) is to be used as the search string.
In the case of the CHANGE primary command, you can also specify an
asterisk to indicate the replacement string specified on the previous
CHANGE command is to be used as the replacement string.
v One of the keywords, CHARS, PREFIX, SUFFIX, or WORD to control the
portion of the data to be matched to the search string.
v Parameters in any order.
v CHG as a short form of CHANGE.
For details, see:
v “Finding and replacing strings” on page 178
v “CHANGE primary command” on page 626
v “FIND primary command” on page 645
v “EXCLUDE primary command” on page 639
Templates by DDNAME
Additional batch function parameters are now available to provide more
flexibility and support for concatenated datasets.
For details, see:
v “DSC (Data Set Copy)” on page 741
v “DSEB (Data Set Edit Batch) — batch only” on page 767
xvi File Manager
v “DSU (Data Set Update) — batch only” on page 830
v “PBK (Print Copybook)” on page 876
CAPS setting, separate Suppressed and Not Selected options
You can now specify the:
v CAPS setting as a profile option
v SHOW option separately for not-selected and suppressed records.
The Edit/Browse Options panel has also been redesigned to make it easier
to find and select options. Where applicable, the relevant primary
command that affects the option during a Browse or Edit session is shown
on the panel.
For details, see:
v “Changing the case of data” on page 177
v “Displaying “suppressed” records” on page 155
v “Displaying “not-selected” records” on page 157
v “Edit/Browse Options panel” on page 481
VSAM Record Integrity Checking
Additional edit facilities have been introduced to help you work with
VSAM files in a shared environment. These features include:
v Record integrity checking and warning when saving a record.
v The ability to save an individual record, or a set of individual records,
by the use of numbered of grouped line commands.
v New options that let you specify:
– A file is saved after a specified number of updates
– A file is saved after a specified number of updates in the CHANGE
ALL process<
– Whether a warning is displayed when an integrity failure occurs
during a CHANGE ALL command.
v The ability to reread an individual record or all records by issuing a
refresh command.
v The ability to locate records that have encountered an integrity check
during the save process.
For details, see:
v “Working with File Manager and shared files” on page 71
Edit/Browse options
In an Edit or Browse session, you can now use the new PROFILE primary
command to display your current Edit/Browse options.
For details, see:
v “PROFILE primary command” on page 672
SCS VSAM file information
A number of enhancements have been made to way in which you can
view your data sets:
v The date on which a data set was last updated is now shown on the
VSAM Entry Detail panel.
v A new primary command, EXTENT, allows you to produce a list of all
allocated extents on all volumes for a PDSE data set.
v A new primary command, VOLUME, displays volume information for a
VSAM or non-VSAM data set in a pop-up panel.
v You can now use the INFO primary command to see all significant data
set information for a non-VSAM data set in a single panel.
v When you want to list all data sets which match a specified data set
mask, you ca now specify a limit for the number of the data sets to be
processed.
v “Selecting your service” on page 256
v “Displaying volume information” on page 261
v “Displaying extent details for non-VSAM data sets” on page 262
v “VOLUME primary command” on page 705
v “EXTENT primary command” on page 642
v “LOCATE primary command” on page 659
v “SCS (Catalog Services)” on page 881
v “Catalog Services panel” on page 401
v “Non-VSAM Entry Detail panel” on page 534
v “VSAM Entry Detail panel” on page 611
Volume list selection
The Work with VTOC utility (and the equivalent batch function, DVT)
have been enhanced to allow you to select details based on the SMS
storage group, device type, device address (unit), and volume status.
For details, see:
v “Displaying a Volume Table of Contents (VTOC)” on page 268
v “DVT (Display VTOC)” on page 842
v “Display VTOC panel” on page 454
v Figure 130 on page 458
v Figure 220 on page 607
Additional
formatting
options
Enhancements have been made to print formatting in SNGL format for
both batch and online processing.
For details, see:
v “Setting your Print Processing Options” on page 245
v “Printing data sets” on page 246
v “Printing a single record” on page 251
v “Edit/Browse Options panel” on page 481
v “Print Utility panel” on page 544
v “DSP (Data Set Print)” on page 816
Compare Utility - new option to always show selected fields
A new option available with the Compare Utility, Always show SELECTed
fields, causes fields selected in the template to appear in the comparison
xviii File Manager
results, regardless of whether they have changed or not. This can be
helpful in identifying records with differences.
For details, see:
Segmented ID criteria
features:
v Provision of a related ID criteria. This is a criteria based on a field in
another segment’s layout. A level-01 layout can contain multiple related
ID criteria.
v Modification of the existing selection process, such that segmented
selection applies to the record as a whole. This, combined with the
previous point, allows template criteria to be used for data that is
interrelated in some way amongst segments.
v Further modifications to the selection process such that records (and all
segments contained therein) that do not meet selection criteria are not
provided to utilities or to Edit or Browse. (The existing behaviour, where
segments that have been de-selected in the template are not provided to
utilities but are provided to Browse and Edit, remains unchanged.)
For details, see:
v “Field Selection/Edit panel” on page 498
v “Related ID expression panel” on page 555
v “RID Selection panel” on page 559
COBOL compiler
A new primary command, SHOWCOB, allows you to check which COBOL
compiler is currently loaded.
For details, see:
v “Checking which COBOL compiler you’re using” on page 17
Support for Large Block Interface and for volumes with more than 64K tracks
File Manager now provides support:
v For Large Block Interface (LBI) for tapes.
v In full-volume utilities, for disk volumes with more than 64K tracks.
For details, see:
New
COBOL
compiler
option
An additional COBOL compiler option is now available that allows you to
select the COBOL SPECIAL-NAMES paragraph, ″Decimal-point is comma″.
When you select this option, the COBOL compiler exchanges the functions
of the period and the comma in PICTURE character strings and in numeric
literals.
v “Setting your COBOL processing options” on page 93
v “Set COBOL Processing Options panel (option 0.6)” on page 563
v “DSB (Data Set Browse)” on page 736
v “DSC (Data Set Copy)” on page 741
Summary of
v “DSE (Data Set Edit)” on page 762
v “DSEB (Data Set Edit Batch) — batch only” on page 767
v “DSG (Data Set Generate)” on page 778
v “DSM (Data Set Compare)” on page 788
v “DSP (Data Set Print)” on page 816
v “DSU (Data Set Update) — batch only” on page 830
v “PBK (Print Copybook)” on page 876
Chapter 1. File Manager overview .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. .
. 9 Why use a template? . . . . . . . . . . 9 What can you do with a template? . . . . . 10
Where can you use templates? . . . . . . . 11
Chapter 2. Getting started with File Manager . . 13
Starting and exiting File Manager . . . . . . . 13
Starting File Manager . . . . . . . . . . 13
which
COBOL
compiler
Using the File Manager interface . . . . . . . 18
Navigating in File Manager . . . . . . . . 18 Issuing commands . . . . . . . . . . . 19 Specifying quoted strings . . . . . . . . . 20 Specifying a data set and a member name . . . 20
Examples of
Using hexadecimal values in File Manager . . . 28 Getting help . . . . . . . . . . . . . . 28
Displaying field help information . . . . . . 29
Accessing Tutorial Help . . . . . . . . . 29
your
default
processing
options
Set batch job card information (option 0.4) . . . 36 Edit/Browse options (option 0.8) . . . . . . 36
VSAM edit sharing options (option 0.9) . . . . 37
Displaying or editing DBCS characters . . . . 37 National characters . . . . . . . . . . . 38
Chapter 3. Viewing data sets .
.
.
.
.
.
.
data
without
using
templates
. 40
Displaying data with a template . . . . . . 41 Example of displaying data with a template 42
Removing or changing the template . . . . . 44 Viewing packed data . . . . . . . . . . 44 Listing statistics for the current viewing session 45
Displaying your current Edit/Browse options . . 46
Ending a
Making a list the current data set list . . . . 49 Creating
a
new
personal
data
set
list
Progressive retrieval (NRETRIEV primary
Manipulating your
. 54
Selecting a display format . . . . . . . . 55 Setting the initial display format . . . . . 55
Changing the display format . . . . . . 55
Display formats . . . . . . . . . . . 55
Displaying the RBA and record length
information
Scrolling to the first or last record or column 65
Holding fields when scrolling left or right . . 65
Locating a field, column or record number . . 66
Sorting the data . . . . . . . . . . . . 66
Finding specific data . . . . . . . . . . 68
Finding errors
What File Manager considers a shared file . . . 72
Record integrity checking . . . . . . . . . 72
“==MSG>” and “=PROF>” indicators . . . 76
Refreshing the
(Autosave frequency option) . . . . . . . 78
Template types and structure . . . . . . . . 81
Information stored in a template . . . . . . 81
About copybook templates . . . . . . . . 83
Segmented data templates . . . . . . . . 85
Support for PL/I data description entries . . 88
Support for variable-length arrays . . . . . 89 Editing rules for PL/I varying length string
types . . . . . . . . . . . . . . 90 Editing rules for PL/I varying length zero
terminated string
internal
(FASTREXX)
processing
processing . . . . . . . . . . . . . 355
Manager panel . . . . . . . . . . . 355
Enhanced processing modes . . . . . . . 359
Enhanced record processing . . . . . . 359
Performance tips . . . . . . . . . . . 362
Printing data . . . . . . . . . . . . 363
Copying data . . . . . . . . . . . . 363
Writing one or more optionally edited records to
one or more output files, depending on data in
the input record . . . . . . . . . . . 366 Determining
whether
to
copy
or
a
member
IBM File Manager for z/OS™ (base component) provides comprehensive,
user-friendly tools for working with HFS files and QSAM, VSAM and IAM data
sets. These tools include the familiar browse, edit, copy and print utilities found in
ISPF, enhanced to meet the needs of application developers.
This chapter provides an overview of the types of actions you can perform with
File Manager, a list of the types of data sets upon which you can perform these
actions and some concept information about templates, one of the main tools used
to view and edit data sets in File Manager.
File Manager actions
You can use File Manager to display, edit, update, create, copy, compare, print and
erase data. You can manipulate this data as logical units, accessed by the data set
name; or as physical units, accessed at each physical disk or tape location. Adding
to this capability is an interactive interface that allows you to view data in both
TABLE and SINGLE RECORD formats.
When working with data sets, you can:
v View, change, sort, copy and print data as unformatted or formatted with
copybook or dynamic templates
v Perform sophisticated data set comparisons
v Find and change data strings in a single data set or in multiple data sets
v Create new HFS files or QSAM, VSAM or IAM data sets and data set records
v Create REXX procedures for advanced record processing
v Use selected DFSORT® control statements to control the Data Set Copy and Data
Set Print functions
v Create batch jobs, REXX procedures or CLISTs to automate tasks
For many of these tasks, you can use File Manager templates. A template provides a
logical view of a data set, based upon field definitions in a COBOL or PL/I
copybook, or else created dynamically. If you use a template, you can:
v Format data according to record structures defined in COBOL or PL/I
copybooks, or dynamically define your own record structure
v Select the fields and records that you want to work with, adjust how fields are
displayed, select fields for copying, and set the contents of fields for created data
v Code record identification and selection criteria within File Manager panels, or
use File Manager’s REXX interface to code complex criteria
v Copy data between fields of different data type and length; and
v Work with files containing multiple record structures
File Manager also provides utilities that allow you to manipulate data in other
ways:
v With the Tape Utility you can:
– Copy tape files, optionally changing the block size and record format
– Copy a logical volume from an Exported Stacked Volume to a physical tape
volume
© Copyright
IBM
Corp.
2000,
2006
– Update tape records on-screen, while copying the records from one tape to
another
– Bypass tape blocks with data-check errors
– Summarize the contents of a tape
v With the Disk Utility, you can look at and edit a file, based on the contents of the data at each physical disk location. There is support for character and
hexadecimal format. Because the access is done at the level of the physical track,
all file types are supported, including BDAM. With the disk utilities, you can:
– List data sets on a disk
– Edit data on a specific track
– Identify the disk extents of a data set
– Search for data within a disk extent
v You can use the Object Access Method (OAM) Utility to list, browse, print,
update, erase, copy, back up and restore OAM objects.
v The IDCAMS front end (Catalog Services) allows you to control the OS/390
IDCAMS utility from user-friendly File Manager panels.
Data sets and records
File Manager provides production and development logical file manipulation for
HFS files, QSAM and VSAM (including IAM) data sets.
You can browse or edit these types of data sets:
v QSAM data sets: A member of a partitioned data set or a sequential data set
with any of these data set attributes:
– Record format
- For spanned variable-length data: 1–16MB
v VSAM data sets:
– RRDS (fixed-length or variable-length)
– PATH (PATHs related to an alternate index are restricted to browse only)
– AIX
v HFS files: A file contained in the z/OS UNIX Hierarchical File System (HFS)
– Record format
- Binary
- Text mode files are variable length: 1-32752
- Binary mode files are fixed length: 1-32760
File Manager Version 7 is able to use COBOL and PL/I copybooks that are stored
in a PDS, a PDSE, a CA-Panvalet library, or a library accessed using the Library
Management System Exit.
Templates
A File Manager template is a file that provides a particular interpretation of a data
set. The template defines a logical view that you can use to view and manipulate
the data in records as discrete fields. With a template, you can select and format
records and fields when editing, browsing, copying, printing and creating data
sets. Templates can be based upon a COBOL or PL/I copybook or can be created
dynamically. You can apply different templates to the same data, to achieve
different purposes. For example, you might create a number of templates with
different selection criteria in place, and then apply the template that defines the
subset of records that you need for a particular purpose. Also, you can apply the
same template to different data sets, provided that they have similar record and
field structures.
The File Manager Base, DB2 and IMS components all use templates. However,
these templates are not interchangeable between the components. You cannot, for
example, use a “base” template in the File Manager DB2 component. Dynamic
templates are only available within the Base component.
Why use a template?
Typically, data sets containing application data have a well-defined structure,
where each record in the data set consists of several fields. Each field contains a
discrete item of data, such as a person’s name, a product code or a currency
amount (depending on the application). This data can be of various types: some
fields contain character data, others contain numeric data (perhaps encoded in
binary format to conserve storage space).
To work efficiently with these data sets, you need tools that recognize record
structure, allowing you to selectively process individual fields.
For example, if you use a text editor (such as the ISPF editor) to display an
application data set, then each record appears as a string of characters, with no
indication that the records consist of individual fields. Fields containing numeric
data encoded in binary or packed decimal format are represented by their
(typically “non-displayable”) character values, rather than their numeric values.
Even if you know the column boundaries of each field, editing an application data
set in a text editor can be difficult and tedious:
v If you want to find and replace data in a specific field, then you have to be
careful not to change the field length; otherwise, you could move the boundaries
of subsequent fields, and corrupt the record structure.
v If you want to find and replace data in numeric fields where the data has been
encoded in binary or packed decimal format, then you have to specify the find
and replace values in that format (typically, as hexadecimal values), rather than
as numeric values.
v If the file you are editing contains several record types (each with its own
structure), and you only want to find and replace data in one record type, then
you have to exclude other record types from editing.
The Grant Smith record contains the numeric value “94”, stored in a binary
numeric field. To change this from 94 to 48, without using a template, you would
need to:
1. Display the hexadecimal values of the record data.
2. Determine the column positions occupied by the field.
3. Convert the numeric value 48 into its hexadecimal equivalent (X'30').
To change the value of the AGE binary numeric field from 94 to 48, you can
simply overtype 94 with 48, or enter the following command (where #5 is the
“field reference” for the AGE field):
CHANGE 94
Another situation in which you might want to use a template is when you are
copying data. When you use a copy utility that does not recognize record
structure, you are often limited to copying an entire data set, or a number of records. If you want to copy only records with particular field values, or only
particular fields, then you must write a custom program.
When using templates with File Manager, you can specify criteria to select only the
records you want to copy, and to select the fields you want from the list of fields
in the record.
Using a template, you can:
v Format records
You can display, print and compare fields taking into account their data types.
For example, binary numeric fields are displayed as their true numeric values,
not as the character representation of their binary value.
When editing, you can overtype or use CHANGE commands to replace these
formatted numeric field values with different numeric values; File Manager
adjusts the underlying binary value in the data set.
You can select which fields are displayed (when browsing or editing) or printed.
When browsing or editing data, you can limit the scope of commands (such as
FIND and CHANGE) to particular fields.
You can change the order in which fields are displayed (when browsing or
editing) or printed.
For numeric fields, you can display or suppress leading zeros (so that, for
example, 00057 is displayed and printed as 57); the default is to suppress
leading zeros.
To illustrate, here are some records containing a mixture of alphanumeric and numeric fields
displayed in
000015 01Graham Prestcott õ ç
Here is the same record displayed in the File Manager editor using a template:
REC-TYPE NAME EMPLOYEE-NO AGE SALARY MONTH(1) MONTH(2)
#2
#3
#4
#5
#6
#7
#7
<>
v Reformat records
When copying data, you can “map” which fields in the input data set you want
copied to the output data set. You can insert or delete fields, and copy data
between fields of different data types or lengths.
v Identify record types and select records within those types
You can select records using two levels of criteria:
– Record identification criteria
Identify the unique characteristics of a record type, enabling File Manager to
distinguish it from other types of record in the same data set. You can then
select which record types in a data set you want to use.
Before you can specify record identification criteria, you need to examine
your data, and determine what field values uniquely identify a record as
belonging to a particular type.
– Record selection criteria
After a record has been identified as belonging to a particular type, you can
specify record selection criteria to narrow down which records of that type
you want to use.
v Create data
When creating a new data set, or adding a new field when copying a data set,
you can specify field “create attributes” (patterns that File Manager uses to
initialize field values).
Where can you use templates?
The following table lists the tasks, panels and functions that support the use of templates:
Task Panel Function
Edit data
Create data
Update data
DSU
(batch
only)1
Notes:
1. For the DSEB and DSU functions, the template is not used during editing or updating; it
is only used during enhanced batch processing, when you call the File Manager REXX
external function PRINT with SNGL or TABL format.
The difference between using DSU to “update” data versus using DSEB to “edit” data is
that DSU operates on a “per record” basis: each record in a data set is treated separately,
in sequence; whereas you can use DSEB to move between the records in a data set as
you choose,
With any of these panels or functions, you can supply an existing template (created
dynamically or from a copybook), supply a COBOL or PL/I copybook, or create a
new dynamic template. If you supply a copybook, then File Manager compiles it
into a template before use.
Overview
Chapter 2. Getting started with File Manager
This chapter is designed to help the new user to familiarize themselves with the
user interface and general methods for working within File Manager panels.
The major tasks described in this chapter are:
“Starting and exiting File Manager”;
“Using the File Manager interface” on page 18;
“Getting help” on page 28; and
“Setting your default processing options” on page 32
Starting and exiting File Manager
File Manager is an ISPF-developed application and is usually run from within an
ISPF session. Exiting from File Manager returns you to your ISPF session. File
Manager panels can also be invoked from outside of the File Manager application.
A subset of File Manager functions is available in non-ISPF mode (batch
processing). See Chapter 17, “Functions,” on page 707.
The tasks described in this section are:
v “Starting File Manager”;
v “Checking your File Manager version” on page 15;
v “Exiting from File Manager” on page 17; and
v “Invoking File Manager panels from outside File Manager” on page 17.
Starting File Manager For information about running File Manager in non-ISPF mode (batch processing),
see Chapter 17, “Functions,” on page 707.
How you start File Manager in ISPF depends on how it has been installed on your
system. Typically, File Manager is installed as an option on your z/OS Primary
Option Menu:
To start File Manager:
1. Select the File Manager option from the z/OS Primary Option Menu.
Note: If File Manager is not an option on your menu, ask your system
administrator to explain the startup process used at your site.
When you start File Manager, the File Manager Primary Option Menu is
shown, with the current version information displayed in a pop-up message
box.
1 View Display source data or listings
2 Edit Create or change source data
3 Utilities
5 Batch Submit job for language processing
6 Command Enter TSO or Workstation commands
7 Dialog Test Perform dialog testing
8 LM
11 Workplace ISPF Object/Action Workplace
12 OS/390 System OS/390 system programmer applications
13 OS/390 User OS/390 user applications
14 IBMGSA
F File
Option ===>
F________________________________________________________________
Figure 1. z/OS Primary Option Menu panel showing File Manager option
Getting started with File Manager
14 File Manager
RELATED
TOPICS
Checking your File Manager version
To display the full version information for File Manager, enter VER on the
Command line of any panel. The current File Manager version number and the
PTF number for each File Manager component is displayed in a window. The
window also indicates whether or not File Manager is APF-authorized.
Process
Options
Help
3 Utilities
5 Disk/VSAM
7 Templates
Chapter 2.
An alternative way to display version information is to select Help > 7. About
from the Action Bar on any panel. The current File Manager version number and
the PTF number of the File Manager base component is displayed. The window
also shows the copyright information and any notes from IBM that are shipped
with the product.
Process Options Help
0
Settings
Set
processing
options
User
ID
2
4 IBM File Manager for z/OS Version 7 Release 1
5
7 5655-R47 (C) Copyright IBM Corporation 1986, 2006 - All rights reserved
X
“VER (Display Service Level)” on page 915
Process
Options
Help
4 IBM File Manager for z/OS Version 7 Release 1
5
16 File Manager
Checking which COBOL compiler you’re using
File Manager uses the currently loaded COBOL compiler to create a template from
a COBOL copybook.
To display details about the current COBOL compiler, enter SHOWCOB on the
Command line of any panel. File Manager displays details about the current
COBOL compiler in a window.
RELATED TOPICS
“SHOWCOB primary command” on page 689
Exiting from File Manager You can exit from File Manager from the Primary Options Menu panel in any of the following ways:
v Press the Exit function key (F3).
v Enter X (or EXIT or END) on the Command line.
v Select
To exit the application from any panel within File Manager:
v Enter =X on the Command line.
RELATED TOPICS
“END primary command” on page 638
“EXIT primary command” on page 642
Invoking File Manager panels from outside File Manager File Manager panels can also be invoked directly from any REXX procedure, TSO
clist or ISPF Command line. To do