04a FAID Chapter01
04a FAID Chapter01
FILE-AID FACILITIES
File-AID Objectives
You will learn: The similarities and differences between ISPF/PDF versus File-AID/SPF. PRIMARY OPTION MENU. PARAMETER SELECTION MENU. ISPF parameter options. Evaluate and select system parameters. SELECTION CRITERIA PARAMETERS. Manage print parameters. Manage processing parameters. Apply audit file allocation parameters. Default setting panel.
File-AID Facilities
Ch 1: Page i
File-AID Facilities
File-AID is an interactive software tool that increases data processing productivity in both program development and daily file and record maintenance.
File-AID: Emulates the presentation of the ISPF/PDF screens. Provides On-line access to files unavailable to the ISPF/PDF user. Extends the power of the current ISPF/PDF environment with new and additional features.
1.1
Reasons for using ISPF/PDF include: Quick and easy access to data.
Processes all standard z/OS access methods and file formats. Selective record processing. JCL conversions. File-format conversions.
Ch 1: Page 1
File-AID
File-AID Facilities
1.2
ISPF/PDF Sequential and partitioned only.
Can copy from sequential or partitioned to another sequential or partitioned dataset. Sequential or PDS member. File size restriction. Sequential or PDS member. Record length restriction of 255 bytes. Copy of dataset is being edited and then saved.
Must use IDCAMS. PDF 3.4 will display dataset but little processing is allowed. No direct way without Batch Utility. Must use IDCAMS.
Ch 1: Page 2
File-AID 2
FILE-AID 9.2.0 ------------OPTION ===> 0 1 2 3 5 6 7 8 9 10 C T X PARAMETERS BROWSE EDIT UTILITIES PRINT SELECTION XREF VIEW REFORMAT COMPARE CHANGES TUTORIAL EXIT -
SPECIFY ISPF AND FILE-AID PARAMETERS DISPLAY FILE CONTENTS CREATE OR CHANGE FILE CONTENTS FILE-AID/SPF EXTENDED UTILITIES PRINT FILE CONTENTS CREATE OR CHANGE SELECTION CRITERIA CREATE OR CHANGE LAYOUT CROSS REFERENCE VIEW INTERPRETED RECORD LAYOUT CONVERT FILE FROM ONE FORMAT TO ANOTHER COMPARE FILE CONTENTS DISPLAY SUMMARY OF FILE-AID CHANGES DISPLAY INFORMATION ABOUT FILE-AID TERMINATE FILE-AID AND RETURN TO ISPF
Ch 1: Page 3
File-AID
File-AID Facilities
3
FILE-AID ----------------OPTION ===> 0 1 2 3 4 5 6 ISPF SYSTEM SELECTION PRINT PROCESSING AUDIT HFS -
ISPF PARAMETERS AND FILE-AID PF KEYS FILE-AID SYSTEM PARAMETERS SELECTION CRITERIA DEFAULT PARAMETERS PRINT DEFAULT PARAMETERS PROCESSING OPTION DEFAULT PARAMETERS AUDIT FILE ALLOCATION PARAMETERS HIERARCHICAL FILE SYSTEM OPTIONS
3.1
Command ===>
ISPF Settings More: Options Enter "/" to select option Command line at bottom Panel display CUA mode / Long message in pop-up Tab to action bar choices Tab to point-and-shoot fields / Restore TEST/TRACE options Session Manager mode / Jump from leader dots Edit PRINTDS Command / Always show split line Enable EURO sign Member list options Enter "/" to select option / Scroll member list / Allow empty member list Allow empty member list (nomatch) Print Graphics Family printer type 2 Device name . . . . Aspect ratio . . . 0 General Input field pad . . B Command delimiter . ; +
Ch 1: Page 4
File-AID
File-AID Facilities
3.2
FILE-AID ------------------COMMAND ===>
SYSTEM PARAMETERS
-----------------------------RELEASE DATE: 03/18/2010
SYSTEM PARAMETERS
CLIENT NUMBER: 000598 CLIENT NAME : SOCIAL SECURITY ADMINISTRATION SPECIFY FUNCTION DEFAULTS: DISPLAY CANCEL CONFIRMATION DISPLAY "RECORDS NOT SELECTED" LINE CHARACTER SET ENABLE SCREEN JUMPS WITHIN FILE-AID VSAM INTERMEDIATE NAME SPECIFY WORK FILE/CUT FILE ALLOCATIONS: SPACE UNITS PRIMARY QUANTITY SECONDARY QUANTITY NUMBER OF VOLUMES COMPARE KSDS WORK FILE VOLSER CONCATENATION LIST DSN ===> SMS CLASS INFORMATION: STORAGE ===> DATA ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> ===> Y Y DFLT Y #6001 TRKS 10 5 1
(TRKS, CYLS OR BLKS) (IN ABOVE UNITS) (IN ABOVE UNITS) (1 - 59) (BLANK OR VOLSER)
MANAGEMENT
===>
Ch 1: Page 5
File-AID
File-AID Facilities
3.3
FILE-AID ------------- SELECTION CRITERIA PARAMETERS -------------------------COMMAND ===> SPECIFY SELECTION CRITERIA OPTION DEFAULTS: RECORD SELECTION WILL CONTINUE UNTIL NUMBER OF RECORDS TO SEARCH ===> ALL YOU HAVE READ THIS MANY RECORDS NUMBER OF RECORDS TO SELECT ===> ALL OR SELECTED THIS MANY RECORDS SPECIFY PROCESSING DIRECTION USED BY BROWSE, EDIT, COPY, PRINT, SEARCH/UPDATE: SEQ/VSAM PROCESSING DIRECTION ===> F (F = FORWARD; B = BACKWARD) SPECIFY UNFORMATTED SELECTION CRITERIA DEFAULTS: RELATIONAL OPERATOR ===> EQ (ENTER ANY VALID RELATIONAL OPERATOR) LOGICAL CONNECTOR ===> AND (AND OR OR)
3.4
FILE-AID ------------------COMMAND ===> NUMBER OF LINES/PAGE SYSOUT CLASS NUMBER OF COPIES TRUNCATE FOR VPRINT CMD
PRINT PARAMETERS
-------------------------------
ENTER ONE OF THE FOLLOWING OPTIONAL DESTINATIONS: DESTINATION PRINTER - - - OR - - EXTERNAL JES NODE ID TARGET VM/TSO IDENT - - - OR - - SYSOUT WRITER NAME - - - OR - - PRINT DATASET NAME DISPOSITION VOLUME SERIAL ===> ===> ===> ===> ===> ===> OLD ===> (LOCAL OR REMOTE PRINTER) (PREDEFINED JES NODE AND SYMBOLIC ID OF INTENDED RECEIVER OF OUTPUT) (INSTALLATION ASSIGNED OUTPUT WRITER) (DSORG=PS, RECFM=VBA, LRECL=187) (NEW; SHR; MOD; OLD)
Ch 1: Page 6
File-AID
File-AID Facilities
3.5
File-AID ------------------------COMMAND ===>
Processing Parameters
Specify Record Information Default Used by Search/Update: Include record information ===> NO (Y = Yes; N = No) Specify Partitioned Dataset Defaults Used by Copy and Search/Update: Replace like-named members ===> YES (Y = Yes; N = No) Copy/Edit entire member ===> YES (Y = Yes; N = No) Copy empty members ===> NO (Y = Yes; N = No) Maintain PDS statistics ===> YES (Y = Yes; N = No; A = Add)
(Y = Yes; N = No)
3.6
FILE-AID ------------- AUDIT FILE ALLOCATION PARAMETERS ----------------------COMMAND ===> SPECIFY AUDIT TRAIL FILE ALLOCATION INFORMATION: SPACE UNITS ===> TRKS (TRKS; CYLS; BLKS) PRIMARY QUANTITY ===> 15 (IN ABOVE UNITS) SECONDARY QUANTITY ===> 75 (IN ABOVE UNITS) SPECIFY SMS CLASS INFORMATION: STORAGE ===> DATA ===> MANAGEMENT ===>
Ch 1: Page 7
File-AID
File-AID Facilities
4
COMMAND ===> _ Function defaults for: Include record information Seq/VSAM process direction Number of records to search Number of records to select
N F 0 250
Browse and edit selection parameter defaults: Length/Operator ===> EQ (eq ne gt lt ge le no mx) AND/OR ===> AND (and or) Browse intermediate work Allocation type Primary allocation Secondary allocation file ===> ===> ===> allocation defaults: TRKS (trks cyls) 10 (in above units) 5 (in above units)
VSAM intermediate name ===> ZADSADM Additional user catalog ===> Catalog connector name ===>
Ch 1: Page 8
File-AID Facilities
The valid pattern characters allowed in File-AID pattern datasets names are: the asterisk - * question mark - ? percent sign - % slash - / plus - +
5.1
Asterisk *
Asterisk - *
The asterisk is a qualifier-name wildcard. It represents any single-level qualifier, or partial-level qualifier when preceded by 1 to 7 explicit characters.
List all the datasets with a first-level qualifier of USERID1, a second-level qualifier beginning with TEST, and any number, including zero, of remaining qualifiers:
Ch 1: Page 9
File-AID
File-AID Facilities
5.2
Question mark Percent sign ? %
The question mark and the percent sign are both single-character wildcards. Either character represents a single character in the specified position of the qualifier. A single-character wildcard can be used up to 8 times within a qualifier, but a character must exist in that position.
These examples both match datasets with a high-level qualifier of USERID and second-level qualifier of TESTAA and TESTTAB, but not TESTOUT or TEST. They also match USERID.TESTAA.NODE and USERID.TESTTAB.NODE.NODE.
5.3
Slash /
Slash - /
The slash specifies the number of levels in the dataset name. Dataset names with more levels than those specified in the dataset names are not listed. The / must be the last element in the dataset name. The / and the + cannot both be used in the same dDataset name.
This example matches USERID.TEST.ALPHA and USERID.TEST.BETA. It does not match USERID.TEST.ALPHA.BETA because there are too many levels or USERID.TEST because there are too few levels.
Ch 1: Page 10
File-AID
File-AID Facilities
5.4
Plus +
Plus (+)
The plus tells File-AID to ignore any intermediate-level qualifiers. Use the + after the high-level qualifier and before the lowest-level qualifier to have File-AID ignore any intermediate qualifier. In effect, it matches zero or more qualifiers in the name. Only one + can be used per name. The portion of the name before the + represents a pattern for the high-level qualifier(s) of the dataset name; the portion after the + represents a pattern for the low-level qualifier(s). When the + is used, only dataset names that begin and end exactly as the pattern does are displayed. The / and the + cannot both be used in the same pattern dataset name. The + implies a / at the end of the pattern dataset name.
This example matches USERID1.BETA.TEST, USERID1.TEST, or USERID1.FILEAID.ALPHA.SEQ.TEST, since they all begin with USERID1 and end with TEST. It does not match USERID1.BETA.TEST.CLUSTER, because the + indicates that TEST must be the last qualifier in the dataset name. In only the VTOC utility - 3.7, the + (plus) may be used as the high-level qualifier in the search name. Example: Dataset name ==> +.JCL.CNTL
This example locates all datasets starting with anything but ending in .JCL.CNTL.
Ch 1: Page 11
File-AID Facilities
A data file dataset contains the data to browse, edit, copy, from/to, search/update, print, reformat from/to, or compare.
File-AID can process datasets created through any standard z/OS method, including: Sequential Partitioned ISAM BDAM VSAM - KSDS, ESDS, and RRDS VSAM - LINEAR can be allocated only. IAM
Ch 1: Page 12