Professional Documents
Culture Documents
File Aid: Computer Sciences Corporation India (P) Ltd. Indore - 452 010, India
File Aid: Computer Sciences Corporation India (P) Ltd. Indore - 452 010, India
File Aid
Date: 11/10/2002
Table Of Contents
1. Overview......................................................................................................................................................................3
2. Introduction..................................................................................................................................................................3
3. File Aid Key Features..................................................................................................................................................3
4. Getting started with File Aid........................................................................................................................................4
5. File Aid Execution CLISTS........................................................................................................................................5
6. Browsing A Data File..................................................................................................................................................6
7. Allocating a VSAM cluster..........................................................................................................................................8
8. Full screen Editing.....................................................................................................................................................11
9. Comparing Files..........................................................................................................................................................14
10. Scanning and Updating Datasets............................................................................................................................20
File Aid
Date: 11/10/2002
1. Overview
File-AID/MVS is designed to be accessed from an ISPF menu such as the
ISPF/PDF
PRIMARY OPTION MENU. The option code is usually F. A special logon PROC or
allocation CLIST may be required at your site in order to define the File-AID
libraries to your TSO session. Your site may choose its own logon method and
ISPF menu for access to File-AID.
2. Introduction
File-Aid is designed for applications and systems programmers. It is an
interactive, full-screen system for editing, browsing, defining, copying,
reformatting, comparing, and printing VSAM, IAM, ISAM, PDS, BDAM, and
sequential files under TSO/ISPF.
File-Aid's functions enable us to significantly reduce the time required to
perform day-to-day data file manipulation tasks such as creating and
modifying test data, resolving production data problems, and performing adhoc file conversions and comparisons.
3) File Aid has powerful, easy to use, copying and reformatting capabilities
which exist in both batch and on-line modes.
- no language to learn and no programming required
- records may be selected for copying using selection criteria based
on record counts and/or specific values in individual fields
- selection criteria can be used in the Browse, Edit, Copy, Print, or
Compare functions
4) File Aid runs as a single dialog under ISPF. It uses Menu driven, fullscreen, interactive ISPF-like displays. It has user defined PF (program
function) key support. It can operate "split-screen" with ISPF/PDF. It is a
fully interactive product with batch capabilities and easy to learn and
use utility.
C
F
P
S
U
T
X
CHANGES
- Display summary of changes for this release
File-AID - File-AID data management system
PRODUCTS - COMPUWARE Products
SDSF
- System Display and Search Facility
USER
- User Dialogs
TUTORIAL - Display information about ISPF/PDF
EXIT
- Terminate ISPF using log and list defaults
CLIST
F1
parameter) **
F2
F31
F32
F33
F34
F35
F36
F37
File Aid
Date: 11/10/2002
FUNCTION
File-AID 1 Browse
File-AID
File-AID
File-AID
File-AID
File-AID
File-AID
File-AID
File-AID
NOTES
(Expects DSN
2 Edit
(Expects DSN parameter) **
3.1 Library Utility
(Expects DSN parameter) **
3.2 Dataset Utility
(Expects DSN parameter) **
3.3 Copy Utility
(Expects DSN parameter) **
3.4 Catalog Utility
3.5 VSAM Utility
(Expects DSN parameter) **
3.6 Search/Update Util. (Expects DSN parameter)
3.7 VTOC Utility
Version No.: 1.0
Page 5 of 24
F38
parameter) **
F39
F5
F51
parameter) **
F52
F53
F54
F55
F6
F7
F8
F9
F10
FABATCH
inputs/outputs.
(Expects DSN as
screen or file.
FALISTA
FASTART
Character
Formatted
Vertical formatted.
Unformatted (not available for DBCS terminals).
Character Mode:
The character browse mode provides a full-screen view of the data. From
character mode, you can use the FMT primary command to redisplay the data
in formatted mode, the VFMT primary command to redisplay the data in
Vertical Formatted mode, or UNFMT primary command to redisplay the data
in
Unformatted mode.
File Aid
Date: 11/10/2002
Formatted Mode:
The formatted browse mode lets you view data using a record layout. This
mode presents data one record at a time and formats each record field-byfield.
Vertically Formatted Mode:
The vertical formatted browse mode also provides a full-screen view of the
data. This mode, however, uses the record layout fields as column headers.
Un formatted Mode:
The unformatted browse mode provides a full-screen display of your data one
record at a time without record layout formatting. File-AID displays 70
characters of data per line until all data for the record is shown or the screen
is filled.
Accessing the Browse Function (Option 1)
The Browse function is shown as option 1 on the File-AID Primary Option
Menu.
1. Enter a 1 in the OPTION field on the File-AID Primary Option Menu
2. Press <Enter>. File-AID displays the Browse - Dataset Specification
screen as illustrated in Figure
===> C
File Aid
Date: 11/10/2002
(E = Existing; T = Temporary;
F2=SPLIT
F8=DOWN
===> N
M = Modify; Q = Quick; N =
===>
===>
F3=END
F9=SWAP
F6=RCHANGE
F12=RETRIEVE
Browse Mode
Browse Dataset
Record Layout and XREF Information
Selection Criteria Usage Information.
1. Type an F in the Browse Mode field to request the Formatted mode for
viewing your data records.
2. Type the dataset name and pattern character FASAMP.* in the Dataset
name or HFS path field.
3. Type an S in the Record layout usage field to indicate that you are using
a single layout member to describe your data records.
4. Type the dataset name FASAMP.LAYOUTS in the Record layout dataset
field.
5. Type the member name in the layout Member name field. If you do not
specify a member, File-AID displays a list of members. You can then
select a
member from this list.
6. Type a T in the Selection criteria usage field to indicate that you
want to create a new temporary selection criteria specification.
Selection criteria enables you to select specific records in a data file for
processing. Usage option T (Temporary) dynamically invokes the Selection
Criteria function and presents the Selection Criteria Menu When you specify
either T or Q in the Selection criteria usage field on the Browse - Dataset
Specification screen, File-AID permits you to save your temporary selection
criteria by issuing the SAVE command. File-AID displays a screen to give you the
opportunity to save your criteria permanently in a selection criteria dataset.
7. Press <Enter>. File-AID displays the Dataset List illustrated.
File Aid
Date: 11/10/2002
To select from the list of the datasets obtained, put a S against the dataset
to select.
* S is the only valid line command and may be specified for only one dataset.
* The Dataset List of matching names is displayed whenever you use a
pattern character to specify a dataset name on any File-AID screen.
FASAMP.EMPMAST
(Required for options S & T)
Version No.: 1.0
Page 9 of 24
(O = Online; B = Batch)
Allocating a Cluster
The Allocate cluster option (A) lets you allocate new VSAM clusters and
IAM datasets online or in batch. All VSAM dataset types (KSDS, ESDS,
RRDS,
and LINEAR) are supported.
Steps Involved:
1. Type an A in the OPTION field.
2. Type FASAMP.EMPLOYE1 in the Dataset name field under the Specify
Dataset Information section.
File Aid
Date: 11/10/2002
The vertical formatted edit mode also provides a full-screen view of the
data. This
mode, however, uses the record layout fields as column headers. From
vertical
formatted mode, you can use the CHAR primary command to redisplay the
data in
character mode, the FMT primary command to redisplay the data in
Formatted mode,
or UNFMT primary command to redisplay the data in Unformatted mode.
Unformatted Mode
The unformatted browse mode provides a full-screen display of your data
one record
at a time without record layout formatting. File-AID displays 70 characters
of data per
line until all data for the record is shown or the screen is filled.
Unformatted mode is accessed by selecting Browse or Edit mode U
(Unformatted) or
entering the UNFMT primary command from Character, Formatted, or
Vertical
Formatted mode of Browse or Edit. From Unformatted mode, use the CHAR
primary
command to redisplay the data in Character mode, the FMT primary
command to
redisplay the data in Formatted mode, or VFMT primary command to
redisplay the
data in Vertical Formatted mode.
Note: Unformatted mode is not available for DBCS terminals.
Accessing the Edit Function: (option 2).
1. To access the Edit function, enter a 2 in the OPTION field on the File-AID
Primary
Option Menu .
2. Press <Enter>. File-AID displays the Edit - Dataset Specification screen.
Specifying the dataset to Edit:
Use the Edit - Dataset Specification screen to define your edit request,
which consists
of:
* Edit Mode
* Edit Dataset
* Audit trail usage
* Record Layout and XREF Information
File Aid
Date: 11/10/2002
===> C
XREF Information:
===> S
(S = Single; X = XREF; N = None)
===> FASAMP.LAYOUTS
===> EMPLOYEE (Blank or pattern for member list)
===>
===>
(Blank or pattern for member list)
9. Comparing Files
The File-AID Compare function compares any two similar files and produces
reports
showing any differences. Special features let you use existing keys or your
own sort
fields to synchronize the files. You can also supply record layouts to the
Compare
function that can be used for:
* Reporting differences field by field
* Specifying certain fields to be excluded from the compare
* Specifying sync keys using field names.
You may optionally use standard File-AID selection criteria to select only a
subset of
records to be compared. Other features let you control the format and level
of results
reporting and to limit the number of records compared or the number of
differences to
report.
Like many other File-AID utilities, you can specify online or batch
processing of your
compare.
File Aid
Date: 11/10/2002
===> F
(F = Formatted; U = Unformatted;
L = Load Library)
Specify OLD Dataset Information:
Dataset name or HFS path ===> 'userid0.FASAMP.COMPARE'
Member name
===>
(Blank or pattern for member list)
Volume serial
===>
(If dataset is not catalogued)
Specify Record Layout and XREF Information:
Record layout usage
===> S
(S = Single; X = XREF; N = None)
Record layout dataset
===> 'userid0.FASAMP.LAYOUTS'
Member name
===> EMPLOYEE (Blank or pattern for member
list)
XREF dataset name
===>
Member name
===>
(Blank or pattern for member list)
Specify Selection Criteria Information:
Selection criteria usage
===> N
Selection dataset name
===>
Member name
===>
(E = Existing; T = Temporary;
M = Modify; Q = Quick; N = None)
(Blank or pattern for member list)
Steps to be followed.
1. Type an F in the Compare Mode field.
2. Type FASAMP.COMPARE in the "OLD" Dataset name field.
3. Type an S in the Record layout usage field.
4. Type 'userid0.FASAMP.LAYOUTS' in the Record layout dataset field.
5. Type EMPLOYEE in the Member name field.
6. Press <Enter>. File-AID displays the Compare - NEW Dataset
Specification screen.
File Aid
Date: 11/10/2002
(E = Existing; T = Temporary;
M = Modify; Q = Quick; N = None)
(Blank or pattern for member list)
File Aid
Date: 11/10/2002
screen allows you to specify the compare criteria dataset information that
is required
when you choose to use existing compare criteria.
You may specify optional Data Solutions changes criteria to age dates,
convert
currencies, translate, generate, encrypt/decrypt, or otherwise modify data
from the
Compare "OLD" file. The Compare mode must be Formatted to use this
feature.
In this example, simply press <Enter> to process online (the default).
Compare - Execution Options Screen
File-AID ---------- Compare - Execution Options ------------------------------COMMAND ===>
Specify Execution Options:
Process online or batch
===> O
(O = Online; B = Batch)
(E = Existing; T = Temporary/New;
M = Modify; Q = Quick; N = None)
(Blank or pattern for member list)
===> S
(S = Sorted/Keyed; R = ReadAhead; 1 =
Records to compare
Differences to compare
Associate Corresponding
===> Y
N=No)
Ignore Prefix
OLD file ===>
Ignore Suffix
OLD file ===>
File Aid
Date: 11/10/2002
F
Uses record layouts to show differences (Formatted) field by field.
Old fields
are printed next to new fields in side-by-side columns.
H
(Hex) Prints each differing record showing character and vertical
hexadecimal
values for each byte of data. Differences are underlined.
C
Prints each differing record showing only (Character) printable
characters
(default).
M
data in
Print
Print
Print
Print
CHANGED
INSERTED
DELETED
MATCHED
records
records
records
records
The Compared Fields Option allows you to specify one of the following
options:
A (All) Print all fields that are selected for comparison (this is the default).
C
Print only the fields that are selected for(Changed) comparison and
are changed.
File Aid
Date: 11/10/2002
The Field Statistics Report option allows you to specify one of the following
options
Y (Yes) Create a list of compared fields and report the number of times
changes were
found for that field and the percentage that this field's changes
represent of
the total number of changed records.
N (No)
*
*
*
*
===> O
(O = Online; B = Batch)
(Option U online)
===> N
(Y = Yes; N = No)
===> Y
(Y = Yes; N = No)
===> ALL
(All or number of changes)
For all options, you may set the "Process online or batch" field to perform
your
Search/Update request online (O) at your terminal, or to generate JCL for
FileAID/Batch execution as a background (B) job in MVS.
When running option U (Update) online, special processing options you
may
request include:
* An audit trail report of changes applied
* A preview of your changes (which you may optionally print after
viewing)
* A limit to the number of changes you wish to preview or apply.
Full support for updating Panvalet and Librarian libraries is available in the
U
(Update) option. When you select online processing, you may see a
preview of the
change statements. Updating is always performed in batch as a
background job in
MVS. File-AID automatically generates the correct JCL for the appropriate
update
utility. If you just wish to scan Panvalet or Librarian libraries, you may
choose either
the M option to work with a member list matching your FIND command
entries, or
the B option to generate a display or report summarizing the members
matching your
selection criteria.
Generating a PDS Find/Change Member List of Selected Members
This example lists all members of your sample JCL partitioned dataset
(PDS) library
(FASAMP.JCL) that contain a job step that executes program name FILEAID
(for
example, EXEC PGM=FILEAID). Then it shows you how to use the CHANGE
command to update selected members.
You use option M (Member) - PDS Find/Change and Member list processing.
Temporary unformatted selection criteria (usage code Q) is defined to
determine the
initial list of matching members.
File Aid
Date: 11/10/2002
===> O
(O = Online; B = Batch)
(Option U online)
===> N
(Y = Yes; N = No)
===> Y
(Y = Yes; N = No)
===> ALL
(All or number of changes)
1.
2.
3.
4.
5.
You want all members (the default), just press <Enter> to continue to the
next screen.
More About PDS Processing Options (PPO)
* In several File-AID functions, you may specify a range of PDS
members to be processed by the current function. In addition to the 3.6
Search/Update utility, you may use the member selection features in the
following:
File Aid
Date: 11/10/2002
Browse (1)
Edit (2)
Copy (3.3)
Print Data (5.1)
Print XREF (5.2)
Print Selection Criteria (5.3)
Print Layouts (5.4)
When selecting record layouts in any function and a blank or pattern
member name is specified.
File Aid
Date: 11/10/2002