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