FileMarvel V410 User Online Guide and Reference Manual 20120828

FILEMARVEL
Database and File Viewer/Editor
User Online Guide and
Reference Manual
Release V410
FILEMARVEL has all the power and speed that programmers and production support staff need to handle all of their dataset
management jobs.
• FileMarvel is fast, easy to use,
consistent in its commands, and able
to fit into your software budget with
room to spare.
• Online editing and viewing of
VSAM, PDS, PDSE, and sequential
disk and tape datasets speed up
application development and help
pinpoint production and testing
problems.
• FileMarvel works on every type of
VSAM file including KSDS, ESDS,
RRDS, extra-large records, alternate
indexes, and compressed datasets—it
even gives you interactive access to
your DB2 databases.
• FileMarvel lets you view and edit
VSAM, sequential, BDAM, DB2,
and PDS datasets through an ISPF
terminal.
• FileMarvel offers far more useful
facilities than other dataset
management products, and being
ISPF based, it has a more familiar
feel—an ISPF user unfamiliar with
FileMarvel can immediately work
with it with absolutely no training.
• FileMarvel excels at browsing,
editing, changing the layout,
copying, sorting/merging, printing,
and allocating of datasets.
• Displays can be formatted in a
number of ways including hex,
character, and—of particular interest
to application programmers—laid
out to match a COBOL, PL/I, or
assembler copy member.
• You can use FileMarvel to allocate
VSAM datasets for you, based on a
model definition if you like— no
more having to remember (or type!)
IDCAMS commands.
Copyright © 2012 by Connectivity Systems, Inc.
All Rights Reserved
RESTRICTED RIGHTS LEGEND
Use, duplication, or disclosure by the Government is subject to the restrictions as set forth in
subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS
252.227-7013.
This material contains confidential and proprietary material of Connectivity Systems, Inc.
(hereafter also referred to as CSI International and CSI) and may not be used in any way without
written authorization from Connectivity Systems, Inc. This material may not be reproduced, in
whole or in part, in any way, without prior written permission from Connectivity Systems, Inc.
Permission is hereby granted to copy and distribute this document as follows:
• Each copy must be a complete and accurate copy.
• All copyright notices must be retained.
• No modifications may be made.
• Use of each copy is restricted to the evaluation and/or promotion of the FILEMARVEL product
from Connectivity Systems, Inc., or in accordance with a license agreement.
FILEMARVEL
Database and File Viewer/Editor
Release V410
User Online Guide and Reference Manual
August 2012
Published by Connectivity Systems, Inc.
8120 State Route 138
Williamsport OH 43164
Phone: 800-795-4914
Fax: 740-986-6022
E-Mail: info@csi-international.com
Internet: http://www.csi-international.com
Documentation Comments: documentation@csi-international.com
CSI International Technical Support and
Technical Support Escalation
CSI Product Technical
Support
During Business
Hours
Monday through Friday, 9:00 A.M. through 5:00 P.M. EST/EDT
• Telephone
Toll Free:
Local:
800-795-4914
740-420-5400
• E-mail
Questions: support@csi-international.com
• Web
http://csi-international.com/problemreport_zos.htm
Emergency Service
(24/7)
After business hours, and 24 hours on Saturday and Sunday
• Telephone1
Toll Free:
Local:
800-795-4914
740-420-5400
Escalating Technical
Issues
Business Hours
Monday through Friday, 9:00 A.M. through 5:00 P.M. EST/EDT
1. Calls are automatically transferred to a 24/7 answering service that forwards all calls based on
severity.
Copyright © 2012 by Connectivity Systems, Inc.
1
CSI International Technical Support and Technical Support Escalation
Request support escalation by the telephone numbers or e-mail address listed
below:
• Telephone
Toll Free:
Local:
800-795-4914
740-420-5400
• E-mail
Escalation: support@csi-international.com
After Hours (SEV1)
1. Call one of the following telephone numbers.
Toll Free: 800-795-4914
Local:
740-420-5400
2. Tell the operator that you have a “SEV1” issue.
The answering service will follow the following chain:
a. Reach the appropriate Technical Support Rep(s)
b. Reach the appropriate Product Developer (if necessary)
c. Reach the Technical Support Manager (if necessary)
d. Reach the Development Manager (if necessary)
e. Reach the Chief Operating Officer (if necessary)
f. Reach the Chief Executive Officer (if necessary)
3. Calls continue until the best person to resolve your issue is contacted.
Copyright © 2012 by Connectivity Systems, Inc.
2
Table of Contents
Introduction .................................................................................................................................................................................... 6
About This Manual ................................................................................................................................................................ 6
What Is FileMarvel?............................................................................................................................................................... 6
Supported Files ...................................................................................................................................................................... 6
Selective File Save ................................................................................................................................................................. 6
Record Selection Criteria ....................................................................................................................................................... 6
PRIMARY - Primary Option Menu................................................................................................................................................ 7
Invoking FileMarvel............................................................................................................................................................... 7
FastPathing to FileMarvel Functions...................................................................................................................................... 7
Primary Option Menu............................................................................................................................................................. 7
SET - Set Default Options .............................................................................................................................................................. 9
Set Options Panel ................................................................................................................................................................... 9
PROFILE - Set General Profile Information........................................................................................................................ 10
GENERAL - Set General Default Options........................................................................................................................... 10
COPYBOOK - Set Copybook Default Options ................................................................................................................... 10
EDIT - Set Edit Default Options .......................................................................................................................................... 11
PRINT - Set Print Default Options ...................................................................................................................................... 13
JOBCARD - Set Jobcard Information.................................................................................................................................. 13
AUTOEXEC - Specify Autoexec Commands...................................................................................................................... 14
DISTLIST - Specify distribution lists .................................................................................................................................. 15
SELALL - Select All Option Lists ....................................................................................................................................... 15
BROWSE/EDIT – Browse or Edit a Data Set .............................................................................................................................. 17
Edit Entry Panel ................................................................................................................................................................... 17
Extended Search Prompt ...................................................................................................................................................... 20
Copybook Record Selection................................................................................................................................................. 22
Format Modes ...................................................................................................................................................................... 22
Standard Format Mode ................................................................................................................................................ 23
Hexadecimal Format Mode ......................................................................................................................................... 24
Hexadecimal Dump Format Mode............................................................................................................................... 24
Reformat Format Mode ............................................................................................................................................... 24
Reformat Hexadecimal Format Mode ......................................................................................................................... 25
Compact Format Mode................................................................................................................................................ 25
Changing the Copybook Template .............................................................................................................................. 25
Record Scrolling .................................................................................................................................................................. 26
Relative Scrolling................................................................................................................................................................. 26
Locating a Record by Number ............................................................................................................................................. 26
Locating a Record by Key.................................................................................................................................................... 26
Display Edit Line State ........................................................................................................................................................ 26
Resetting Line States............................................................................................................................................................ 27
Locate Special Lines ............................................................................................................................................................ 28
Locate Pending Deletes........................................................................................................................................................ 28
Restoring Records Pending Deletion ................................................................................................................................... 28
Managing Record Length in Variable Length Records ........................................................................................................ 29
Data Generation ................................................................................................................................................................... 29
Copying and Moving Records.............................................................................................................................................. 30
Deleting Records.................................................................................................................................................................. 30
Find, Change And Exclude Commands................................................................................................................................ 30
Find, Change And Exclude Character Strings ............................................................................................................. 32
Restricting Search to Particular Columns .................................................................................................................... 32
Using Logical Operators.............................................................................................................................................. 33
Using Boolean Connectors .......................................................................................................................................... 33
Search Direction and Delimiter Restrictions ............................................................................................................... 33
Search on Excluded and Deleted Records ................................................................................................................... 34
Cursor Sensitive Priming of Search Fields .................................................................................................................. 34
Field Validation ........................................................................................................................................................... 34
Change Multiple Arguments........................................................................................................................................ 34
3
Change All Invalid Fields ............................................................................................................................................ 35
Data Modes.................................................................................................................................................................. 35
Restoring Excluded Records........................................................................................................................................ 35
Extended Find/Change/Exclude Functions .................................................................................................................. 35
Copying Records into an Edit Space.................................................................................................................................... 36
Copy Prompt Panel...................................................................................................................................................... 37
Interactive Copy .......................................................................................................................................................... 39
Printing Files ........................................................................................................................................................................ 40
Printing Selected Records............................................................................................................................................ 40
Print Formats ............................................................................................................................................................... 40
Saving Files.......................................................................................................................................................................... 42
Saving Directly from the Command Line .................................................................................................................... 42
Save Prompt Panel....................................................................................................................................................... 43
Global FIND/CHANGE a PDS............................................................................................................................................ 44
PDS FIND/CHANGE from Member Directory........................................................................................................... 44
PDS FIND/CHANGE List Form from Edit Prompt .................................................................................................... 45
Compile Copybook Selection Panel..................................................................................................................................... 46
Extended Copybook Compile Panel..................................................................................................................................... 46
Record Reformat Prompt Panel............................................................................................................................................ 47
DATASET - Data Set Maintenance.............................................................................................................................................. 49
Data Set Maintenance Selection Panel ................................................................................................................................. 49
ALLOC - Allocate a Data Set .............................................................................................................................................. 50
AMS - Access Method Services Menu................................................................................................................................. 51
DEFVSAM - Defining VSAM Files............................................................................................................................ 51
DEFNONV - Catalog a Non-VSAM Data Set............................................................................................................. 52
ONLINE - Executing AMS Functions On-Line........................................................................................................... 52
DEFGDG – Defining Generation Data Groups.................................................................................................................... 54
DELGDG – Deleting Generation Data Groups.................................................................................................................... 54
CATALOG - Catalog a Data Set.......................................................................................................................................... 55
UNCATLG - Uncatalog a Data Set...................................................................................................................................... 55
DELETE - Delete a Data Set ............................................................................................................................................... 55
RENAME - Rename a Data Set ........................................................................................................................................... 56
COMPRESS - Compress a Partitioned Data Set .................................................................................................................. 56
LISTCAT - List Catalog Information................................................................................................................................... 57
LISTC - List Catalog Level Information .................................................................................................................... 57
LISTD - List Dataset Catalog Information .................................................................................................................. 58
LISTI - List Dataset Attributes .................................................................................................................................... 59
LISTV - Multi-Volume Data Set List .......................................................................................................................... 59
COPYDS - Copy Data Set Utility................................................................................................................................................. 61
Using Copy Data .................................................................................................................................................................. 61
Copy Data Set Prompt Panel................................................................................................................................................ 62
Copy Data Set and Reformatting Records............................................................................................................................ 64
OFFLINE – Batch Job Processing................................................................................................................................................ 66
Offline Options Panel........................................................................................................................................................... 66
COMPARDS - Compare Data Set Utility..................................................................................................................................... 67
Compare Data Set Prompt Panel.......................................................................................................................................... 67
Compare Data Set Record Display....................................................................................................................................... 69
Comparing Specific Fields Using Reformat Templates ....................................................................................................... 71
Comparing Specific Fields Reformat Prompt Panel............................................................................................................. 71
Comparing Using Copybook Templates .............................................................................................................................. 72
Comparing Members of a PDS ............................................................................................................................................ 72
SORTDS - Sort Files Utility........................................................................................................................................................ 73
Sort Files Panel .................................................................................................................................................................... 73
Copybook Sort Field Selection ............................................................................................................................................ 73
Sort Criteria Panel................................................................................................................................................................ 74
Browse/Modify Generated Sort Control Statements ............................................................................................................ 74
Browse Sort Report.............................................................................................................................................................. 75
TEMPLATE – Copybook Usage.................................................................................................................................................. 76
Using Copybooks ................................................................................................................................................................. 76
General Questions about Copybooks ................................................................................................................................... 76
4
Compiling Copybooks.......................................................................................................................................................... 77
Copybook Maintenance Selection Panel .............................................................................................................................. 77
Renaming a Member to a New Member Name .................................................................................................................... 78
COMPILE - Copybook Control Directory ........................................................................................................................... 79
Displaying the Copybook Layout......................................................................................................................................... 80
Creating And Editing Copybook Control............................................................................................................................. 80
Copying A Copybook Template........................................................................................................................................... 82
Displaying the Copybook Layout........................................................................................................................................ 82
SOURCE - Compile Copybook Source Directory ............................................................................................................... 83
OBJECT - Display Compiled Object Template Directory................................................................................................... 85
RELATEDS - Relate Copybooks To Data Files .................................................................................................................. 85
BATCH - Compile a Copybook in Batch............................................................................................................................. 86
Creating a Tailored Copybook Template ............................................................................................................................. 87
Saving a Tailored Copybook................................................................................................................................................ 88
Altering Copybook Options ................................................................................................................................................. 90
Reformat Template Directory .............................................................................................................................................. 90
Findext Template Directory ................................................................................................................................................. 90
AUTOEXEC - User Defined Edit Commands.............................................................................................................................. 92
User Defined Edit Commands.............................................................................................................................................. 92
Develop A User Defined Command..................................................................................................................................... 92
Execute a User Defined Command ...................................................................................................................................... 92
UTILITY – General Tool Set Utilities ......................................................................................................................................... 93
UTILITY Tool Set Primary Panel....................................................................................................................................... 93
DA - Display Active Batch Jobs .......................................................................................................................................... 93
ALLOCDD - Allocate a File On-Line.................................................................................................................................. 93
FREE - Free a File ............................................................................................................................................................... 94
LISTDD - List Allocated Files............................................................................................................................................. 94
LISTVTOC - List Dasd Volume Data Sets .......................................................................................................................... 95
VTOC Dataset Selection List............................................................................................................................................... 96
SPACE - Volume Free Space Utility ................................................................................................................................... 97
LMODMAP – Load Module Analysis ................................................................................................................................. 98
Module Directory Display ........................................................................................................................................... 99
Module Csect Directory............................................................................................................................................. 100
Module Sample Reports ............................................................................................................................................ 101
HELP - On-line Help ................................................................................................................................................................. 103
Help Topic Overview......................................................................................................................................................... 103
Help Topic Directory ......................................................................................................................................................... 103
Appendix A Data Set Wildcard Processing ................................................................................................................................ 105
5
Introduction
About This Manual
This manual describes how to use FileMarvel including documentation of Primary and Edit commands. For information
on how to install FileMarvel, see the FileMarvel Installation Manual. For a demonstration of some of FileMarvel’s
functions, see the FileMarvel Demonstration Manual.
What Is FileMarvel?
FileMarvel provides the ability to access and maintain data files. FileMarvel provides browsing, editing, copying,
printing, sorting, defining, and other data manipulation capabilities for files not handled by ISPF due to the file
organization - (VSAM, BDAM), record size, or storage media (tapes). FileMarvel uses the familiar ISPF interface.
While the main function of ISPF is to manipulate source files, FileMarvel specifically addresses data files. Files can be
accessed using their record layouts (copybooks) and large files can be accessed, even those too large to be contained in
memory. (Special facilities provide access to large files without performance penalties.) Globally search and replace
PDS strings easily and interactively.
FileMarvel is designed to have the same look and feel as ISPF. Most ISPF browse and edit commands are supported.
Additional commands have been added. The ISPF-style HELP is a keystroke away. Type in FMV on the command line
of any ISPF panel and the FileMarvel main menu is displayed. Fastpathing to any FileMarvel facility is available from
any ISPF panel.
Supported Files
In addition to the files supported by ISPF, FileMarvel supports:









Sequential or extended files with record size up to the disk track capacity
Members of a PDS or PDSE
VSAM files (KSDS, ESDS, RRDS)
DB2 data bases
BDAM files
GDG files
Files of unlimited size (without monopolizing computer memory)
Files on tapes (mount authority required)
Non-standard files (via exit routines)
Selective File Save
When editing keyed files (VSAM KSDS files), FileMarvel saves only the necessary records (rather than saving the
entire edit-space as does ISPF). This feature speeds up processing, and its usage is reflected in the save command
feedback message. Instead of displaying "SAVED", the message reports the number of saved records.
Records may be manually selected via a variety of commands and saved to a second dataset. In this way datasets may
be easily split or selectively cloned.
Record Selection Criteria
FileMarvel provides the ability to process a subset of a file. For example, on the browse entry panel records are
processed in key range, in record number range, or combine these criteria with context sensitive searches containing (or
lacking) particular strings. Since FileMarvel's FIND is more powerful than ISPF's FIND, complex and multi-argument
Boolean selection criteria can be copied. When editing VSAM KSDS files, using selection criteria reduces the amount
of memory used by FileMarvel and provides the ability to process large files.
6
PRIMARY - Primary Option Menu
Invoking FileMarvel
Display the FileMarvel main menu by selecting the FileMarvel option on the main ISPF panel, or entering the primary
command FMV on the command line of any ISPF panel. Exit from the function returns to the previous ISPF panel.
FastPathing to FileMarvel Functions
Within FileMarvel any function listed in the Commands Manual may be stacked by entering the function command on
any command entry line. For example:
Command ==> COPYBOOK
Enter from within FileMarvel
Primary Option Menu
Menu options can be invoked by number or name from this or any other FileMarvel panel.
FMV/VxRx-PRIME------------ FileMarvel Primary Option Menu ----------------Option ===>
0
1
2
3
4
5
6
7
8
9
10
11
12
SET
BROWSE
EDIT
DATASET
COPYDS
OFFLINE
COMPARDS
SORTDS
TEMPLATE
BASIC
AUTOEXEC
ESOURCE
UTILITY
-
Set individual options
Browse Seq, PDS, VSAM files
Edit Seq, PDS, VSAM files
Data set utilities
Copy records or files
Offline batch processing
Compare Seq, PDS, VSAM files
Sort files
Add, alter, display template
Design and execute scripts
Execute functions
Extended source code
General utilities
13
14
15
16
17
18
19
20
21
X
S
.
.
.
.
Bulletin
DEMO
Q&A
SUPPORT
WELCOME
Title
Online file demonstration
Questions and answers
FileMarvel Support
Welcome to FileMarvel
Group
SYSTEM
SYSTEM
SYSTEM
SYSTEM
Date
2006/02/06
2005/01/24
2006/02/13
2002/11/07
DEMO
HELP
BASE
UNIX
MAIL
MAPGEN
DUMPMRVL
DATABASE
DATAMINE
EXIT
–
–
–
-
On-line demonstrations
Display help topics
Base product functions
Access Unix files
Send and receive mail
CICS/BMS screen paint
Debug abends
Access Database files
Data Report generator
Leave FileMarvel
SET
Set FileMarvel default options.
BROWSE
Invoke FileMarvel browse.
EDIT
Invoke the FileMarvel editor.
DATASET
Display the data set utilities menu.
COPYDS
Copy entire file or selected records to other files, even across different file organizations. (For
convenience, this option is repeated on the FileMarvel utilities menu.). .
OFFLINE
A selection menu to submit batch jobs offline. Compile copybooks offline as well as print files in
batch mode.
COMPARDS
Compare entire or selective fields for entire files or selected records.
SORTDS
Sort files using copybook definitions.
TEMPLATE
Maintain copybook templates.
BASIC
Develop and execute clist procedures.
AUTOEXEC
Develop commands to execute on any FileMarvel command entry line.
7
ESOURCE
Internal source storage directory used to save and copy JCL and source text from most functions
within FileMarvel.
UTILITY
A set of general utilities
DEMO
Walk through demonstrations for file access, copybook, dump analysis, etc.
HELP
Online help directory of topics for panels and usage.
BASE
Base profuct functions for signon names, groups, etc.
UNIX
System Unix file access.
MAIL
Send and receive mail used for project communication.
MAPGEN
Utility to assist in CICS/BMS map generation
DUMPMRVL
Analyze and debug system dumps and abends.
DATABASE
DB2 file access and modification.
DATAMINE
Online and batch file report generator used for devopment of instant statistical and file reports.
X
Leave FileMarvel and return to previous function.
8
SET - Set Default Options
Set Options Panel
The Set Options Panel may be obtained by entering option 1 from the FileMarvel Primary Options Panel or entering the
command SET from any FileMarvel panel.
The "SET" function permits the user to tailor various FileMarvel options. The options are categorized into areas of
specific functions. Use the "SELALL" command to process all the options serially.
Fastpath command
SET
FMV/VxRx-------------------- Set Individual Options --------------------OPTION ===>
1
2
3
4
5
6
7
8
9
PROFILE
GENERAL
COPYBOOK
EDIT
PRINT
JOBCARD
AUTOEXEC
DISTLIST
SELALL
-
General profile information
Set general default options
Set copybook default options
Set edit default options
Set print default options
Set Jobcard information
Generate autoexec commands
Generate distribution list
Select all option lists
PROFILE
Set general profile information.
GENERAL
Set general default options.
COPYBOOK
Set copybook default options.
EDIT
Set edit default options.
PRINT
Set print default options.
JOBCARD
Set Jobcard Information.
AUTOEXEC
Generate autoexec commands.
DISTLIST
Generate distribution lists.
SELALL
Select all options.
9
PROFILE - Set General Profile Information
FMV/VxRx-SET-GKH1------------- General Profile Information ------------------COMMAND ===>
First name
Last name
Department
Residency
Office phone
Home phone
Fax phone
Nickname
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
BOB
JONES
ACCOUNTS
4TH FLOOR
878-2000
823-2345
878-2001
BOBJ
First name
Last name
Department name
Office location
Office telephone number
Home telephone number
Fax telephone number
Nickname for Mail/Messages
Each FileMarvel user is assigned a profile. The profile identifies the user and contains user specific option settings. It is
recommended that each user provide the above information the first time that they use FileMarvel.
GENERAL - Set General Default Options
FMV/VxRx-SET-GKH1------------- General Option Settings ------------------COMMAND ===>
Panel assist . .
Show global
. .
END action
. .
Auto execution. .
Group assignment.
.
.
.
.
.
Y
Y
Y
Y
GROUP
Y=yes, N=no - display panel assist commands
Y=yes, N=no - list global directory entries
Y=yes, N=no - retain the previous command on END
Y=yes, N=no - execute AUTOEXEC from the command line
Department group assignment name
General option settings are used across functions such as EDIT, BROWSE and COPYBOOK.
PANEL ASSIST
This parameter specifies whether or not panel assist is turned on by default. See the ASSIST
command for more information. Some panels display a list of available commands called
Panel assist.
SHOW GLOBAL
This parameter specifies whether or not group and globally owned copybooks as well as
private copybooks are displayed by default.
END ACTION
Specifies whether or not the originating command will be retained upon return from a
stacked FASTPATH command. The command can be retained for modification and reuse.
AUTO EXECUTION
Specifies whether or not an AUTOexec command will be accepted from any FileMarvel
command entry line.
GROUP ASSIGNMENT This is the group name that this user is associated with. Enter a 1 - 8 character predefined
group name. The FileMarvel coordinator prior to use must define the group name. Enter the
fastpath command GROUPS to display the defined department groups.
A copycode may be owned by a user, a group or be global.
COPYBOOK - Set Copybook Default Options
FMV/VxRx-SET-GKH1------------- Copybook Option Settings -----------------------COMMAND ===>
Compile language.
Group display
.
Field display
.
Field case
.
Redefine fields .
Level 1 groups .
Group breaks
.
Tab attribute
.
Pad character
.
Copybook dataset.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
C
Y
Y
Y
Y
Y
Y
Y
Y
C=Cobol, P=PLI
Y=yes, N=no, display group definitions
Y=yes, N=no, display fields in tiered fashion
Y=yes, N=no, display field labels in lowercase
Y=yes, N=no, display redefined fields
Y=yes, N=no, display all level 1 groups
Y=yes, N=no, set group breaks in Format mode
Y=yes, N=no, skip field on data entry
field pad fill character
Copy.data.set.name
10
Copybook option settings are used during copybook compiles or record displays using copybooks. Most of the options
above control the display of a record in BROWSE or EDIT functions. The default options can be overridden either by
local commands, by the creation of copybook templates, the SAVECBOK command. You can change the options of an
existing copybook with the LISTOPT/LO command.
COMPILE LANGUAGE Set the default compile language for copybook compiles.
GROUP DISPLAY
Sets default for display of group field displays.
Y - Display a group fields by default. N - Do not display group fields by default.
FIELD DISPLAY
Sets default for display of field levels and field names.
Y - Display the fields names in tiered format.
The field names are displayed offset according to the level numbers.
N - Display all the field names in the same column regardless of level number.
FIELD CASE
Sets the default case for field name display.
Y - Display the field names in uppercase.
N - Display all the field names in lowercase.
REDEFINE FIELDS
Sets the default display for fields that are redefined.
Y - Display all redefinitions.
N - Show no redefinitions.
LEVEL 1 GROUPS
Set the default for the display of records with a copybook with multiple 01 levels. You may
select which 01 level to use.
Y - Display all 01 levels.
N - Display only the current 01 level.
GROUP BREAKS
Sets the default for display format of breaks between groups.
Y - Insert a blank line between groups.
N - Do not insert a blank line between groups.
TAB ATTRIBUTE
Set the default for tab attribute at the end of modifiable fields during data entry.
Y - Tab the cursor to the next field when data entry reaches the end of a field.
N - Stop at the end of the field when data entry reaches the end of a field..
PAD CHARACTER
Sets the character used to fill a field during compact mode record displays.
COPYBOOK DATASET Sets the default copybook PDS data set name for locations of COBOL or PLI copybooks for
copybook compiles.
EDIT - Set Edit Default Options
FMV/VxRx-SET-GKH1------------- Edit Option Settings ------------------------COMMAND ===>
Display mode
.
Save prompt
.
Extended prompt .
Key display
.
Recend display .
Linecmd display .
Linecmd tracking.
Linecmd fill
.
Pad character
.
Findtext display.
Findtext stop
.
File search stop.
File load stop .
Expand member . .
Compards char . .
Test caps . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
S
S=standard, H=hex, F=format, C=compact
Y
Y=yes, N=no, issue prompt panels on SAVE,COPY
Y
N=no, P=prompt, E=extended, prompt panel request
Y
N=no, H=hex, C=char, file key display
Y
Y=yes, N=no, flag variable record end
Y
Y=yes, N=no, set line command in BROWSE
Y
Y=yes, N=no, track and mark modified lines
_ Edit line command fill character
40
Two byte hex record expansion character
S
S=standard, N=non-display, X=exclude
00000250 Interrupt pds search after specified members
00100000 Interrupt file search after specified records
00100000 Interrupt file load after specified records
Y
Y=yes, N=no, expand variable pds members
_
Compare data set error indicator character
Y
Y=yes, N=no, test lower case on file load
11
Edit options set defaults for record displays. Most default options can be overridden by local commands within the
functions such as BROWSE or EDIT.
DISPLAY MODE
Sets the initial default display mode for a file record display. The option can be overridden
on prompt panels.
SAVE PROMPT
Controls whether or not a confirmation panel will be displayed when a SAVE command is
issued.
Y - Display a confirmation panel
N - Do not display a confirmation panel.
EXTENDED PROMPT
Used for AUTOEXEC commands or fastpath commands such as EDIT Data.Set.Name.
Specifies what screen is presented EDIT or BROWSE commands.
N - Go directly into EDIT or Browse session
P - Present the EDIT or Browse prompt screen to allow user to specify search criteria.
E - Present the EDIT or Browse extended record search panel to allow user to specify
complex search criteria.
KEY DISPLAY
Sets the default key display format for record displays. Use the LISTKEY/LK local
command to toggle the display.
N - Do not display the key separate from the record.
H - Display the key separate from the record in hexadecimal format.
C - Display the key separate from the record in character format.
RECEND DISPLAY
Sets the default record end indicator for variable record displays
Y - Mark the end of a variable record with a caret.
N - Do not display a record end indicator.
LINECMD DISPLAY
Controls whether or not record numbers are displayed by default during a BROWSE
session. Use the local command LISTNUM/LN to toggle the display.
Y - Display record numbers
N - Do not mark modified records.
LINECMD TRACKING Control whether or not modified records are indicated with the symbol '=MOD=>' by
default.
LINECMD FILL
Sets the character to be used as a 'placeholder' for the PDS directory selection column.
PAD CHARACTER
Specify the pad character used to elongate records when saving to a file defined with longer
records lengths or incoming records when copying from a file defined with shorter record
lengths.
FINDTEXT DISPLAY
Specifies the format of a PDS directory display after a FINDTEXT command is issued.
S - STANDARD. Display all members. Indicates members that satisfy the search criteria
by placing - FOUND in the action field.
N - Non-Display. Will not display the members that DO NOT satisfy the search criteria.
X - Exclude. Excludes the members that do not satisfy the search criteria. The excluded
members are indicated in the member directory in this manner:
_
_
_
_
mem1
01.05 1999/09/30 1999/09/03 14:14
92
92
0 GKH1
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 5 rec(s) excluded
mem7
mem8
01.01 1999/07/06 2000/01/04 13:31
42
42
0 GKH1
FINDTEXT STOP
Sets a limit to the number of members searched for a FINDTEXT command. When this
limit is reached a screen is presented that will provide the option to continue searching or
cancel the search. A value of 99999999 indicates No Limit.
12
FILE SEARCH STOP
Sets a limit to the number of records searched for a FIND command. When this limit is
reached a screen is presented that will provide the option to continue searching or cancel the
search. A value of 99999999 indicates No Limit.
FILE LOAD STOP
Sets the maximum number of records that can be EDITED or BROWSED. A value of
99999999 indicates No Limit.
PRINT - Set Print Default Options
FMV/VxRx-SET-GKH1------------- Print Option Settings ------------------------COMMAND ===>
Print class
Printer id
Hold queue
Release mode
Max pages
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
*
Report print class or an "*" for batch
Destination id or local station id
N
Y=yes, N=no, place in hold queue
Y
Y=yes, N=no, release at function end
00001000 Stop print on page count
Print option settings control how printed output is processed. Any time the PRINTX command is issued, the options set
above will control the processing. The PRINTX REL command “releases” the print queue.
PRINT CLASS
Determines one of two techniques used to process the requested print queue.
Any valid JES print class. A PRINTX command will spool the print to a JES SYSOUT
dataset attached to a TSO userid. The SYSOUT dataset will not be freed to print until log
off unless the PRINTX REL command is issued. The PRINTX REL command closes and
frees the SYSOUT dataset thus freeing it to print.
An “*” indicates that the print from a PRINTX command should be spooled to a temporary
dataset. The PRINTX REL command will submit a batch job, which uses IEBGENER to
print the temporary dataset. Any subsequent PRINTX commands will be spooled to a new
temporary dataset. Using the /*ROUTE JCL statement will also accomplish print routing.
PRINTER ID
Specifies the destination or remote printer.
HOLD QUEUE
Specifies whether or not the print should be spooled to the held queue of the output queue.
Y - Place in held Queue
N - Place in output Queue
RELEASE MODE
Specifies whether or not he print is to be released to the spool when the End PF Key is
pressed.
Y - Automatically process the PRINTX REL
N - Requires the user to manually release the print into the spool by issuing the PRINTX
REL command
MAX PAGES
Specifies the maximum number of pages allowed to be printed. A value of 99999999
indicates No Limit.
JOBCARD - Set Jobcard Information
The job card information is put to use when the PRINTDS function is used. The first time the PRINTDS function is
used the user will be automatically prompted to provide a Jobcard.
Fastpath command
JOBCARD
FMV/VxRx-JOBCARD-GKH1------ Jobcard Modification Panel -----------------------COMMAND ===>
Main Commands: COPY, CANCEL, END, SAVE
----+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+---//INTT006B JOB (X,X,X,X),'INTT006 ',CLASS=X,MSGCLASS=A,
//
NOTIFY=INTT006
//*
COMMENT
13
//PROCLIB DD DISP=SHR,DSN=FMARVEL.PROCLIB
----+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+---The JOBCARD JCL is used anytime FileMarvel submits a batch
To perform a background task (for example printing files).
Enter your JOBCARD JCL using //* as JCL comments for cards you
do not use.
Note: Enter the COPY command to copy JCL from a data set.
A job card statement of four lines is supported. The job card is automatically initialized using your userid and
installation PROCLIB. Fill in installation appropriate parameters. The Jobcard is retained between ISPF sessions.
The following commands are available:
COPY
Copy the first four JCL statements from a specified dataset or member. It is helpful to copy from
existing JCL and changes it as needed.
CANCEL
Return to the previous panel without changing the JCL.
END
Save the amended JCL and return to the previous panel.
SAVE
Save the current JCL and retain the current panel.
AUTOEXEC - Specify Autoexec Commands
The AUTOEXEC feature provides the ability to associate a simple command name of your choosing to a complex or
often used command. Define Edit and Browse commands using Autoexec. Use these commands to execute a predefined command or to display a command on the command line for modification prior to execution. Develop
commands such as BROWSE or commonly used FIND and CHANGE commands. These are stored as AUTOEXEC
commands.
Fastpath command
AUTOEXEC/AUTO
FMV/VxRx-AUTOEXEC-GKH1----- Auto Command Execution --------------------------COMMAND ===>
SCROLL ===> CSR
Line commands: S=select and execute the command, standard edit commands
Autoexec command Exec Command executed
***** ***************************** Top of Data ******************************
BPR
ON
BROWSE TEST.DATASET.PAYROLL.QTR1.1999.Y2K
BPR2
ON
BROWSE TEST.DATASET.PAYROLL2
CFLD1
OFF CHANGE Field-payroll-amount +100.58 +95.25
FFLD1
OFF FIND Field-payroll-amount +100.58 OR +95.25
AUTOEXEC COMMAND
The user defined command name. Enter this command on the command line to
execute it.
EXEC
Execute the command when entered on the
command line.
Place the command on the command line to allow for modification before
execution.
ON
OFF
COMMAND EXECUTED
The command executed or displayed when the autoexec
command is entered.
After commands are developed, exit the AUTOEXEC function to save the entries for later use. Enter any user-defined
command (AUTOEXEC) on the command-input line of a FileMarvel panel. Develop new commands using the
AUTOEXEC panel. Commands can either be executed immediately or placed on the command line for modification
before execution.
14
For example, set up a predefined find statement as shown for FFLD1 below. Enter FFLD1 on the command line. If
EXEC=ON, the command is immediately executed. If EXEC=OFF, the command is displayed on the command line to
allow modification prior to execution.
Examples:
Entered
Result
FFLD1
FIND Field-payroll-amount +100.58 OR +95.25
BPR
Enter browse session on dataset:
TEST.DATASET.PAYROLL.QTR1.1999.Y2K
DISTLIST - Specify distribution lists
Fastpath command
DISTLIST
FMV/VxRx-DISTLIST---------- Distribution Lists --------------------------COMMAND ===>
SCROLL ===> CSR
Commands: Sel list
Linecmds: Del=delete S=select
Member
Date
Description
***** ***************************** Top of Data ******************************
Software 02/01/1999 Software department
Techsupp
02/05/1999 Technical support department
MEMBER
The department member name
DATE
The date the member was created
DESCRIPTION
The description for the department member name
SELALL - Select All Option Lists
Presents all of the above option screens serially.
SELALL commands:
End
Quit
CANCEL
-
Display next option panel.
Exit from SELALL
Cancels all changes and exits from SELALL
The DISTLIST provides the ability to group userids into distribution groups. A list can be used system wide to
distribute mail, reports and the results of Edit sessions.
To create a New List issue the command S Listname.
You will be presented with a Distribution List entry screen.
FMV/L03-DISTLIST-SOFTWARE---------Distribution List Entry ----------------------COMMAND ===>
SCROLL ===> CSR
Commands: DL=distlist, NA=name, NI=nickname, SAVE
Description .
Signon
Signon
Signon
Signon
Signon
Signon
Signon
Signon
***** ***************************** Top of Data ******************************
00001 user1
user2
user3
user4
user5
user6
user7
user8
00002 user9
00003
00004
00005
***** ***************************** Bottom of Data ***************************
The "DISTLIST" member list entry is a list of target userids to which mail, reports, contents of edit workspaces is
distributed. Enter userid's into the member list.
15
Standard edit line commands may be used to manipulate the list. When the list is SAVEed or the End Pfkey is pressed
duplicate Userids will be eliminated.
Commands
-------DL
Display a directory of distribution lists for selection.
NA
Display a directory of userid names for selection.
NI
Display a directory of nicknames for selection.
SAVE
Save the member list.
Line commands
----------Standard edit line commands.
16
BROWSE/EDIT – Browse or Edit a Data Set
Edit Entry Panel
Select the Edit Entry Panel from the FileMarvel Primary Option Menu or enter the Fastpath command EDIT. Specify
the dataset name to be edited, the edit mode, and the copybook to be used. Additional options include the ability to
compile a copybook to permit specific record selection.
Fastpath command
EDIT/ED
'data set name'
FMV/VxRx-EDIT------------------ Edit - Entry Panel ---------------------------COMMAND ===>
Data set name . .
Volume . .
File mode . .
Format mode . .
'FMARVEL.VxRx.DEMOFILE'
Data set name, * or wildcard pattern
For uncataloged data sets
S
S
S=standard M=modify E=extend A=allocate
F=format S=standard H=hex C=compact R=reformat
D=hexdump *=default
COMPILE or USE with FORMAT, COMPACT or REFORMAT format mode:
Template . . CBKCOB
Member name, *=Member list, BLANK=default
Compile . . Y
y=yes, N=no, E=extended
Language . . C
C=COBOL, P=PLI, copybook compile language
Copylib . .
Qualifier.*=data set list
APPLY CRITERIA . . Y
y=yes, N=no, E=extended
Start key . .
End key . .
Start record . . 00000001 Starting record number, if key not specified
Record count . . 000050000 Number of records to process
Find string. .
The entry panel looks much like the standard ISPF edit and browse entry panel.
DATA SET NAME Specifies the dataset name to be edited. Enter a partial name with an * to receive a dataset
selection list. See Appendix A for wildcard processing. The following file types are supported:






FILE MODE
Sequential files
PDS files with member specified
PDS file for a member selection list
VSAM files (KSDS, ESDS, RRDS)
BDAM files
GDG files
Controls how the file will be saved. If the entire dataset is not loaded due to record selection, the File
Mode will be automatically set to MODIFY. The File Mode can also be set via a primary command.
A - allocate
Permits the allocation of a new dataset.
E - extend
A save executed in this edit session will attempt to write the records to the end
of the file. In VSAM/KSDS files the records are added to the file by key and
existing records are not replaced.
S - standard This mode will attempt to rewrite the file sequentially from the records in the edit work space. If
records exist in the file, sequential files are overwritten, VSAM/ESDS files are extended or
VSAM/KSDS/RRDS are flagged as duplicates.
M - modify
Records may be modified, but not relocated. On END only the modified records are replaced in the
file.
FORMAT MODE Controls the initial display mode of this edit session. The display mode may be explicitly changed
during the browse session. Setting the Display mode here will also set the default display for a
copybook if a copybook template is used.
17
F - Format
Provides an edit session using a COPYCODE template to format the dataset. The Copybook
parameter must be set.
S - Standard Provides an edit session in the traditional ISPF style.
H - Hex
Provides an edit session in ISPF hexadecimal format with both the printable characters and their hex
representations.
C - Compact Similar to Format, but is more compact in order to display more fields per screen. Copybook
parameter must be set.
R - Reformat Provides a reorganized view of a record as defined by the reformat template. This view permits fields
or groups of fields moved for ease of viewing. Use the R parameter in the APPLY CRITERIA field to
define a reformat template.
D - Hexdump Provides an edit session in a “dump” format with both the printable characters and their hex
representations.
Default
Will default to the Display mode that has been established in the copybook settings. The default for
the copybook can be set during explicit or implicit copybook compile.
TEMPLATE
Used in Display Modes Format, Compact and Reformat. Enter the copybook or reformat template
source member name or compiled copybook template name to be used during this edit session. Enter
the copybook source member name here if the copycode has not been compiled by FileMarvel. If a
file is already associated with a copybook template, this field is not needed. If no copybook has been
associated with the file and this field is left blank, the file is displayed in standard display mode
regardless of the Display Mode specified.
COMPILE
Indicates whether the copybook specified is to be compiled for use by FileMarvel. When the
copycode is compiled it will create a “copycode template” and will be saved in the FileMarvel
CONTROL file. The copybook is required to be compiled only once. Subsequent file accesses using
this copybook name will use the copybook template most recently compiled.
Y The copybook will be compiled by FileMarvel before the edit session is started.
N The copybook will not be compiled.
E Will provide the Compile Copybook Selection Panel before the edit session is started. The
extended compile is used to define complex copybook templates, e.g. defining multiple record
types within a file.
LANGUAGE
Indicates the language of the source copybook member. For a file already associated with a
copybook, this field is not needed.
C - COBOL
P - PL/I.
COPYLIB
The PDS where the source copybook member specified in the copybook parameter resides. Specify
only the dataset name; do not include the member name. This field is required only if the copybook is
to be compiled. If the copybook has already been compiled, the copycode template will be provided
by the FileMarvel CONTROL dataset.
APPLY CRITERIA The remaining fields pertain to selecting a subset of the file. When
browsing files (of any type) or editing keyed files, a subset of the file can be
processed. This requires less memory and provides accessibility to the desired
records. Specify selection criteria and choose whether or not to apply the criteria. PDS members may
also be selected.
Y
Record/member selection will occur. If the dataset is a PDS, the selection criterion is applied to the
member name. The selection criterion is specified in the fields FROM KEY/TO KEY, FROM RECORD
and RECORD COUNT.
E
Record selection will occur. A Record Selection Extended panel is displayed where multiple selection
criteria can be specified.
18
N
START KEY
No record selection will occur. The entire dataset is presented.
Use with To Key to specify a range of records to select from a VSAM KSDS dataset. Enter the
lowest key to include in the range of records to edit. A partial key may be entered. If the key contains
non-displayable characters enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
Use to specify a range of members to select from a PDS. Enter the name of the first member to
include. A partial name may be entered.
If this field is specified, the To Key must also be specified.
END KEY
Use with From Key to specify a range of records to select from a VSAM KSDS dataset. Enter the
highest key to include in the range of records to edit. A partial key may be entered. If the key
contains non-displayable characters, enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
Use to specify a range of members to select from a PDS Enter the name of the last member to include.
A partial name may be entered.
If this field is specified, the From Key must also be specified.
START RECORD Specifies the starting record number to include in the edit session. If the dataset is a PDS, this is
the starting member number relative to 1 included in the PDS member selection panel.
RECORD COUNT If From Record is specified, this is the maximum number of records to include in the edit
session. If the dataset is a PDS, this is the maximum number of members displayed in the PDS
member selection panel.
FIND STRING A search string in FIND format for a display of selective records. The find string may be used as an
alternative to extended find.
19
Extended Search Prompt
The extended search panel permits the selection of records containing specific strings. The Boolean connectors
AND/OR may be used to apply multiple search criteria. The search parameters are patterned after the FIND command.
After specifying the parameters, press the RFIND PF key or enter the FIND command to activate the search.
FMV/VxRx-EDIT-$CBKCOB
---- Extended Record Search Entry -------------------COMMAND ===>
Commands: CAN, END, FIND, LC, LR, RES
Data set name. . CSI.FMARVEL.VxRx.DEMOFILE
AND/OR Picture
Enter
. . .
FIND
. . .
Parameters . . .
. . .
. . .
. . .
Select mode. . . I
Notify mode. . . Y
APPLY CRITERIA . Y
Start key/mem . .
End key/mem . .
Start record . . 00000001
RECORD count . . 00005000
I=interactive, C=counts, L=list pds format
Y=Yes, N=No, notify on search limit
Y=Yes, N=No, apply criteria below
Starting record number, if key not specified
Number of records to process
Enter the argument strings in FIND format, then press the repeat RFIND pf.
SELECT MODE Resulting display action for the search.
I - Will present an EDIT session as a result of the search. Only the records that match the search criteria
will be included in the edit session.
C - Will not present an EDIT session as a result of the search. Will only display search statistics including
the number of records searched and number of records that match the search criteria.
L - Valid only when searching PDS members. A search performed on a PDS will result in a member
selection list. If set to “Y”, the portion of the member that matches the search criteria is displayed. Section
4.18.2 - PDS FIND/CHANGE From Edit Prompt.
NOTIFY MODE Action taken if a search exceeds the maximum number of records read.
Y - Suspends the search when maximum record search limit is reached and allows searching to
resume.
N - Ignores the record search limit and continues searching until the search is satisfied or end-of-file
is reached.
APPLY CRITERIA Controls whether record/member selection is used.
Y - Record/member selection will occur. If the dataset is a PDS, the selection criterion is applied to
the member name. The selection criteria is specified in the fields START KEY/END KEY,
START RECORD and RECORD COUNT.
N - No record selection will occur. The entire dataset is presented.
START KEY/MEM Use with END Key to specify a range of records to select from a VSAM KSDS dataset. Enter
the lowest key to include in the range of records to edit. A partial key may be entered. If the key
contains non-displayable characters enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
Use to specify a range of members to select from a PDS. Enter the name of the first member to
include. A partial name may be entered.
20
If this field is specified, the To Key must also be specified.
END KEY/MEM Use with From Key to specify a range of records to select from a VSAM KSDS dataset. Enter the
highest key to include in the range of records to edit. A partial key may be entered. If the key
contains non-displayable characters, enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
Use to specify a range of members to select from a PDS Enter the name of the last member to include.
A partial name may be entered.
If this field is specified, the From Key must also be specified.
START RECORD Specifies the starting record number to include in the edit session. If the dataset is a PDS, this is
the starting member number relative to 1 included in the PDS member selection panel.
RECORD COUNT If From Record is specified, this is the maximum number of records to include in the edit
session. If the dataset is a PDS, this is the maximum number of members displayed in the PDS
member selection panel.
21
Copybook Record Selection
The Copybook Record Selection Panel is obtained by specifying “Y” in the Select parameter on the Extended Search
Prompt panel. A copybook must be associated with the dataset being edited for this function.
This panel provides an easy way to prime the FIND parameter list on the Extended Search prompt panel. Fields are
located by scrolling up or down or by entering a FIND command within this panel. Select the fields desired by entering
an "S" in the line command associated with the field name. After all field definitions are selected, press the END PF to
return. The field names selected are placed in the Extended Search Prompt panel.
FMV/VxRx-EDIT-$CBKCOB------ Copybook Record Selection Fields -----------------COMMAND ===>
SCROLL===> CSR
Main commands: CANCEL, END, RESET
Line commands: S=Select field element
Offset Length Level Type
Using Picture
Field Name
* ********************************* Top of Data *******************************
S
40
1
10
Char
X
M-STATUS-FLAG
S
41
1
10
Char
X
M-IDENT-FLAG
.
.
The results of the previous field selection prompt panel are displayed below. Search field values are primed and the
FIND PF key is pressed to initiate the record selection.
FMV/VxRx-EDIT-$CBKCOB
---- Extended Record Search Entry -------------------COMMAND ===> FIND or press the find PF key
Commands: CAN, END, FIND, LC, LR, RES
Data set name. . CSI.FMARVEL.VxRx.DEMOFILE
AND/OR Picture
Enter
. . .
M-STATUS-FLAG A
FIND
. . .
M-IDENT-FLAG I
Parameters . . .
. . .
. . .
. . .
Select mode. . . I
Notify mode. . . Y
APPLY CRITERIA . Y
Start key/mem . .
End key/mem . .
Start record . . 00000001
RECORD count . . 00005000
I=interactive, C=counts, L=list pds format
Y=Yes, N=No, notify on search limit
Y=Yes, N=No, apply criteria below
Starting record number, if key not specified
Number of records to process
Enter the argument strings in FIND format, then press the repeat RFIND pf.
Format Modes
The following display modes are available for an edit session:
Standard
Displays multiple records similar to ISPF. Command STD/ST.
Table
Displays multi records in copybook templates. Command TAB/TA
Hexadecimal
Displays a record in a hexadecimal format similar to ISPF. Command HEX/HX.
Dump
Displays a record in a hexadecimal format, similar to dump format. Command HEXD/HD.
Reformat
Displays a record in a hexadecimal reformat format, similar to hexadecimal but with the selected
fields. Command HEXR/HR.
Formatted
Displays field names, field contents, and field descriptions. Automatic record layout switching among
different record types is supported. Command FMT/FM.
Compact
Similar to formatted mode, but displays as much formatted data on a single panel as possible, without
field descriptions. Command CMP/CM.
22
Reformat
Displays a record in reformatted mode. Fields or groups of fields within a record are selected so only
the desired portions of a record are displayed.
The initial mode of an edit session is specified in Display Mode on the Edit Entry Panel.
The display mode can be changed during an edit session. Standard and hexadecimal modes are always available.
Compact and formatted modes are only available if a copybook has been associated with the file. The following
commands are used to switch between Display Modes:








HEX / HX
HEXD / HD
HEXR/HR
FMT / FM
CMP / CM
REF /RF
STD / ST
TAB / TA
Hexadecimal Mode
Hexadecimal Dump Mode
Hexadecimal Reformat Mode
Formatted Mode
Compact Mode
Reformat Mode
Standard Mode
Copybook Multi record Mode
These commands are entered on the command line to change the Display Mode.
Standard Format Mode
An example of an edit session in Standard Display mode is shown below.
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00071
COMMAND ===> LISTAST/LA
SCROLL ===> CSR
KEY
*******
0000001
0000002
0000003
0000004
0000005
0000006
0000007
0000008
>0010011111
***************************
001001111111111010100000035
001001111111111010400000031
001001111111111011200000031
001001111111111012200000033
001001111111111014400000033
001001111111111014501000031
001001111111111015001000035
001001111111111017001100035
Top of File *******************************
r
r %
r b r
r
r b r k OFB20317
PAYOF 196.92 TR
r b r k OFB20317
01N
r
r %OFB20288
02 o- *123456789
r
r %OFB20288
01C r
q 00000
r b r k OFB20317
r %
*
r
r %
OFB8151
r
r
r %
01
r b
.
.
.The top and bottom of the edit space is indicated by the top and bottom markers "Top of File" and "Bottom of.File". If
.a selection criterion was used to limit the records placed in the edit space; "Top of Selected Records" and "Bottom
. of
Selected Records" are used as top and bottom markers. The LISTAST command toggles a list of available commands.
See the LISTAST and LISTKEY commands in Section 16.3 EDIT Commands.
23
Hexadecimal Format Mode
An example of an edit session in Hexadecimal Display mode is shown below.
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
KEY
>0010011111
******* *************************** Top of File *******************************
0000001 001001111111111010100000035 r
r %
r b r
r
FFFFFFFFFFFFFFFFFFFFFFFFFFF484444844………………………
001001111111111010100000035060000600………………………
0000002 001001111111111010400000031 r b r k OFB20317
FFFFFFFFFFFFFFFFFFFFFFFFFFF…………………………
001001111111111010400000031…………………………
PAYOF 196.92 TR
0000003 001001111111111011200000031 r b r k OFB20317
FFFFFFFFFFFFFFFFFFFFFFFFFFF……………………
001001111111111011200000031……………………
01N
0000004 001001111111111012200000033 r
r %OFB20288
FFFFFFFFFFFFFFFFFFFFFFFFFFF……………………
001001111111111012200000033……………………
02 o- *123456789
The top and bottom of the edit space is indicated by the top and bottom markers "Top of File" and "Bottom of File". If
a selection criterion was used to limit the records placed in the edit space; "Top of Selected Records" and "Bottom of
Selected Records" are used as top and bottom markers. Three lines represents one record; the actual record line
followed by the over/under hexadecimal representation of the actual record.
Hexadecimal Dump Format Mode
An example of an edit session in HexD Display mode is shown below.
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000001 Loc 00001 00675
COMMAND ===>
SCROLL===> CSR
Commands: CM, F(E), FM, HD,X), LK, RF, ST
Dec
Hex
1.2.3.4. 5.6.7.8. 9...11.. 13..15..
1...5....10...15
00001 KEY>
* F0F0F1F0 F0F1F1F1 F0F0>
*
* 0010011111
*
00011 001A
* F1F0F1F0 F0F0F0F0 F0F3F501 9930103C *
* 10100000035.r.. *
00027 002A
* 01992121 6C404040 40404040 40019910 *
* .r..%
.r. *
00043 003A
* 828C0199 30103C01 9930703C 00000000 *
* b..r....r....... *
00059 004A
* 0C000000 000C0000 00000C01 9701231C *
* ............p... *
00075 005A
* 01993070 3C000000 000CF1F6 F8000000 *
* r........168... *
********************************* Bottom of Record*****************************
While in edit in HexD Display mode, changes can be made to the displayable or hexadecimal portion of the screen.
Reformat Format Mode
An example of an edit session in Reformat Display mode is shown below.
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00230
COMMAND ===> LISTAST
SCROLL ===> CSR
1----------25---------225
******* *************************** Top of File *******************************
0000001 0000000001|019991001C|019991001C|
0000002 0000000002|019990225C|020000225C|
0000003 0000000003|019990505C|020000505C|
0000004 0000000004|019991225C|020001225C|
0000005 0000000005|019991022C|020001505C|
0000006 0000000006|019990101C|020000101C|
0000007 0000000007|019990423C|019990423C|
0000008 0000000008|019990304C|020000304C|
The command LISTAST toggles the command assist lines. The reformat display mode provides the ability to obtain a view of a
record based on your requirements. Field within records can be selected and re-positioned within the record. This can to done to
create a new dataset or simply for ease of viewing. The reformat template may be modified at any time by entering the
LISTREF/LR command.
24
Reformat Hexadecimal Format Mode
An example of an edit session in Reformat Display mode is shown below.
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00230
COMMAND ===>
SCROLL ===> CSR
1----------25---------225
******* *************************** Top of File *******************************
0000001 0000000001|019991001C|019991001C|
FFFFFFFFFF FFFFFFFFFC FFFFFFFFFC
0000000001 0199910103 0199990013
0000002 0000000002|019990225C|020000225C|
FFFFFFFFFF FFFFFFFFFC FFFFFFFFFC
0000000002 0199910103 0199990013
0000003 0000000003|019990505C|020000505C|
FFFFFFFFFF FFFFFFFFFC FFFFFFFFFC
0000000003 0199910103 0199990013
The reformat display mode provides the ability to obtain a view of a record based on your requirements. Field within records
can be selected and re-positioned within the record. This can to done to create a new dataset or simply for ease of viewing. The
reformat template may be modified at any time by entering the LISTREF/LR command.
Formatted Format Mode
An example of an edit session in Formatted Display mode is shown below:
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000001 Loc 00001 00675
COMMAND ===>
SCROLL ===> CSR
Commands:
CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds:
CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
Relpos Lvl Field Name
Occ Typ
Length ....+....10...+....20...
000001 12 BT01-COMPANY
<=KEY= CH
3 001
000004 12 BT01-SUB-COMPANY
<=KEY= CH
2 00
000006 16 BT01-MEMBER-NUMBER
<=KEY= ZD
9 111111111
000015 16 BT01-POLICY-SUFFIX
<=KEY= CH
3 001
000018 12 BT01-RECORD-TYPE
<=KEY= CH
2 01
000020 12 BT01-UNIT
<=KEY= CH
5 abcde
Compact Format Mode
An example of an edit session in Compact Display mode is shown below:
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000001 Loc 00001 00675
COMMAND ===>
SCROLL ===> CSR
Commands: F(E), FM, H(D,X), L(C,K,M,O,X), RF, ST, SVCB
BT01-COMPANY.................. 001BT01 RENEWAL-DATE.................. +19930703
BT01-SUB-COMPANY................... 00 BT01-REWRITE-DATE.................... +0
BT01-MEMBER-NUMBER.............. 11111 BT01-AGENT-NUMBER................... 168
BT01-POLICY-SUFFIX................ 101 BT01-CNCL-NOTICE-DATE................ +0
BT01-RECORD-TYPE................... 01 BT01-CNCL-REASON.......................
BT01-UNIT........................ 0000 BT01-CNCL-DATE....................... +0
This mode is similar to Formatted mode. Field descriptions are omitted to fit as many fields on a screen as possible.
Changing the Copybook Template
While in Formatted or Compact Display mode the copybook template can be switched by changing the copybook name
and pressing Enter. For example, a file is edited using one copybook:
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000001 Loc 00001 00675
COMMAND ===> FMT $CBOOK2 or FMT *
Scroll ===> CSR
Commands:
CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds:
CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
Relpos Lvl Field Name
Occ Typ
Length ....+....10...+....20...
000001 12 BT01-COMPANY
<=KEY= CH
3 001
000004 12 BT01-SUB-COMPANY
<=KEY= CH
2 00
000006 16 BT01-MEMBER-NUMBER
<=KEY= ZD
9 111111111
000015 16 BT01-POLICY-SUFFIX
<=KEY= CH
3 X'00000000000'
000018 12 BT01-RECORD-TYPE
<=KEY= CH
2 01
000020 12 BT01-UNIT
<=KEY= CH
5 X'0000000'
000025 08 BT01-TRANS-SEQUENCE
<=KEY= ZD
3 235
000028 04 BT01-RECORD-EFF-DATE
PK
5 X'4040404040'
000033 04 BT01-RUN-DATE
PK
5 +19921216
25
To change the copybook used, use the following method:


If the copybook is known, enter one of the following commands, FMT copybook name or CMP copybook name.
If the name of the copybook template is not known, enter an asterisk in the Copybook name field or use the command
FMT * to access a Compiled Copybook Selection List from which the copybook can be selected.
The edit session will continue using the new copybook.
Record Scrolling
FileMarvel allows scrolling within a record and from record to record. In standard display mode, scrolling is identical to
scrolling under ISPF edit and browse. In all other modes, DOWN scrolls within the record toward the end of the record, UP
scrolls within the record toward the beginning of the record, RIGHT scrolls across records toward the end of the file, and LEFT
scrolls across records toward the beginning of the file.
Use the LISTAST command to toggle an explanation of these commands on or off. The direction of the scrolling commands
and keys depends on the current display mode:
Mode
Down
Standard End of
Hexadecimal
Format
End of
Compact End of
Up
file
End of
Record
Record
Right Left
Begin of file End of Record
Record Begin of Record
Begin of Record
End of
Begin of Record
End of
Begin of record
End of file
Begin of file
file
Begin of file
file
Begin of file
Relative Scrolling
ISPF is limited to scrolling 9999 records. Since FileMarvel handles larger files, relative scrolling is provided.
Relative scrolling is performed using the LOCATE command (abbreviated as LOC or just L). Specify a direction (forward or
backward) followed by the amount to scroll. For example, to scroll forward 100,000 records from the current record, enter the
command:
L +100000
As in ISPF edit, preceding a command with an ampersand (&) in FileMarvel browse or edit keeps the command on the
command line. Combined with relative scrolling, the command allows scrolling fixed distances within the file. For example, to
scroll forward in increments of 10,000 records, use the command:
&L +10000
Locating a Record by Number
To scroll to a particular line in the browse or edit space, enter the LOCATE command followed by the record number. For
example, to position at record 300, enter the command:
L 300
When processing a subset of the file, the number specified reflects the record number in the edit space rather than the absolute
record number in the file.
Locating a Record by Key
To locate a record by its key, use the LOCATE command followed by the key value in quotes. For example, to locate a record
with a key value of "keyno-1", enter the command:
LOC 'keyno-1'
Display Edit Line State
26
The series of LISTxxx commands control the type of records displayed as well as record status indicators (such as modified/not
modified). It is a more granular form of the command RESET. Any of the following LISTxxx commands may be toggled back
and forth.
LISTDEL/LD
the
ON|OFF
For VSAM files lists the queued lines to be deleted when the END pf is pressed to save
file.
LISTKEY/LK
ON/OFF
Displays the key line, which permits the location of specific records for non-VSAM files
and the specific key for VSAM files.
LISTLEN/LN
ON/OFF
Displays the record lengths of each record on the line command.
LISTMOD/LM
ON/OFF
Displays all modified records.
LISTNUM/LN ON/OFF
Displays the line numbers for all records.
LISTEXC/LX
Displays all excluded lines.
ON/OFF
For example, while in an edit session a range of records has been excluded:
FMV/VxRx-EDIT----- FMVTEST1- DLB1.TEST.KSDS ----- Rec 0000000 Cols 00001 00071
COMMAND ===> LX
SCROLL ===> CSR
Commands: CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds: CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
******* *************************** Top of File *******************************
0000001
GLR1
RICHARD
GUA;A
0000002
DEFAULT
SYSTEMS
MARTI
0000003
RLM1
MAY
RON
0000004
FAXTEST
SYSTEMS
MARTI
0000005
GUEST
CONFERENCE ATTENDEIBM T
=EXC=> - - - - - - - - - - - - - - - - - -12 LINE(S) EXCLUDED
0000018
EZH2.201
4.1110UYYSTYBY
0000019
EZH2.202FAX
Y1
<=
If the line indicator for the excluded records is not to be displayed, enter LISTEXC. The line indicator is removed and only the
non-excluded records are displayed. The excluded records are not deleted, just not shown.
A panel similar to the following is displayed:
FMV/VxRx-EDIT-FMVTEST1-GKH1.TEST.KSDS ------------ Rec 0000000 Cols 00001 00071
COMMAND===>LX
SCROLL ===> CSR
Commands: CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds: CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
******* *************************** Top of File *******************************
0000001
GLR1
RICHARD
CUA;A
0000002
DEFAULT
SYSTEMS
MARTI
0000003
RLM1
MAY
RON
0000004
FAXTEST
SYSTEMS
MARTI
0000005
GUEST
CONFERENCE ATTENDEIBM T
0000018
EZH2.201
4.1110UYYSTYBY
0000019
EZH2.202FAX
Y1
<=
Resetting Line States
The RESET command accepts the following parameters to control line command states. Records may be controlled using the
operands listed below.
RESET option
CPY
resets the records flagged as copied.
DEL
resets the VSAM records delete flag so the record(s) will not be deleted from file.
EXC
resets the records flagged as excluded.
27
MSG
resets the records flagged as messages.
MOD
resets the modified display record tags (record will not be updated in update mode but saved in sequential mode).
ALL
resets all records in standard display mode, resets all lines in hex, format and compact display modes.
FILE
issued from Formatted or Compact mode, resets all messages and excluded records.
Locate Special Lines
Lines can be located that have been changed or flagged during the edit session. The following lines can be located:
Operand
DEL
CHG
ERR
EXC
MOD
MSG
Display Description
=DEL=>
Records marked as pending deletion.
=CHG=>
Records changed by a CHANGE command.
=ERR=>
Records flagged as truncation error.
=EXC=>
Records excluded.
=MOD=>
Records modified.
=MSG=>
Message lines inserted by FileMarvel.
Example L ERR
Locate Pending Deletes
In VSAM KSDS or VSAM RRDS files, records marked for delete are maintained until the file is saved. These records are
flagged as pending deletion and until deleted (by saving the file), they can be restored.
Records pending deletion are not visible on the panel. Use the LOCATE DELETE (or L DEL) command to show these records
in the edit space. Use the DISPLAY command to show the DEL record state.
Records pending deletion are always marked with the flag =DEL=>.
To display where all the records pending deletion are located, enter the following command:
LOC DEL ALL
The results would be similar to this:
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
Commands: CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds: CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
******* *************************** Top of File *******************************
0000001 001001111111111010100000035 r
r %
r b r
r
0000002 001001111111111010400000031 r b r k OFB20317
PAYOF 196.92 TR
=DEL=> - 1 Line(s) deleted
0000004 001001111111111012200000033 r
r %OFB20288
02 o- *123456789
0000005 001001111111111014400000033 r
r %OFB20288
01C r
q 00000
=DEL=> - 1 Line(s) deleted
0000007 001001111111111015001000035 r
r %
OFB8151
r
0000008 001001111111111017001100035 r
r %
01
r b
The contents of records pending deletion are displayed using the F (first) and L (last) line commands. The FIND and CHANGE
commands can also be used to redisplay records pending deletion.
To hide the lines pending deletion again, use the RESET command:
RESET
Restoring Records Pending Deletion
28
To remove the pending deletion status for all records, issue the RESET/RES DEL main command:
RES DEL
To remove the pending deletion status from a single record use the RES line command:
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
Commands: CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds: CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
*********************************** Top of File *******************************
0000001 001001111111111010100000035 r
r %
r b r
r
0000002 001001111111111010400000031 r b r k OFB20317
PAYOF 196.92 TR
=DEL=> - 1 Line(s) deleted
0000004 001001111111111012200000033 r
r %OFB20288
02 o- *123456789
0000005 001001111111111014400000033 r
r %OFB20288
01C r
q 00000
=DEL=> - 1 Line(s) deleted
0000007 001001111111111015001000035 r
r %
OFB8151
r
0000008 001001111111111017001100035 r
r %
01
r b
.
Many Line States such as pending line commands, excluded records, and records flagged for change can be reset.
Managing Record Length in Variable Length Records
To display record length in a variable length file in the line command area, enter the LEN command:
LEN
ON|OFF
The result would be similar to the following:
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
Commands: CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds: CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
******* ********************** Top of Selected Records ************************
LL00675 000000060082012908123
1
PH
00
ATHE COMPANY
LL00675 000000070082020208204
1
PH
ln*00
ATHE COMPANY
LL00675 000000080082020208205
1
PH
ln%00
ATHE COMPANY
LL00675 000000080082020208205
1
PH
ln%00
ATHE COMPANY
******* ********************** Bottom of Selected Records *********************
When the record lengths are on display many line commands can be entered. Use the Erase EOF key to clear the line command
field before entering a line command.
The record length can be changed at any time. To change the length of the fourth record in the file with a line command:
FMV/VxRx-EDIT----- $CBKCOB-- CSI.FMARVEL.VxRx.DE Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
Commands: CM, F(E), H(D,X), L(C,K,M,O,X), RF, ST, SVCB
Linecmds: CM, D(n), DD, DG, F(n), HD, L(n), RES, S, ST, X(n), XG, XX
******* ********************** Top of Selected Records ***********************
LL00675 000000060082012908123
1
PH
00
ATHE COMPANY
LL00675 000000070082020208204
1
PH
ln*00
ATHE COMPANY
LL00675 000000080082020208205
1
PH
ln%00
ATHE COMPANY
LL50
000000080082020208205
1
PH
ln%00
ATHE COMPANY
******* ********************** Bottom of Selected Records ********************
If the record length is increased, the record is padded with the pad character specified with the PAD main command. The
default is to pad with nulls (binary zeroes). Use the PAD command to change the PAD value and specify a single character in
quotes or a single hex character. For example, to pad with blanks, enter the command:
PAD ' '
or
PAD X'00'
Data Generation
29
FileMarvel can generate numbers and insert them into a dataset. RENUM accepts parameters specifying the starting column for
renumbering, the length of the number field, the increment to use, and a scope parameter that indicates how many records to
renumber. For example, to insert the numbers 01 through 05 in columns 10 and 11 of the current record and the next four, enter
the command:
REN 10 2 1 REC(5)
The keywords ALL, END, REC, or REC(nn) can also be specified with RENUM. These keywords operate the same way as
they do with EXCLUDE, FIND, and CHANGE. The RENUM command may be used to generate keys for a keyed VSAM test
dataset.
Copying and Moving Records
To copy and move records within a file, FileMarvel supports the standard ISPF C (copy) and M (move) line commands, and A
(after) and B (before) target destinations.
In addition, FileMarvel provides the target destination indicator H (here). The H target destination is similar to A (After), but
multiple H indicators can be specified for a single source to be copied or moved.
FMV/VxRx-EDIT----- $CBKCOB - CSI.FMARVEL.VxRx.D Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
******* *************************** Top of File *******************************
0000001 ORIGINAL 1
C
ORIGINAL 2
0000003 ORIGINAL 3
H
ORIGINAL 4
0000005 ORIGINAL 5
H
ORIGINAL 6
0000007 ORIGINAL 7
0000008 ORIGINAL 8
******* *************************** Bottom of File ****************************
The result would be similar to the following:
FMV/VxRx-EDIT----- $CBKCOB - CSI.FMARVEL.VxRx.D Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
******* ************************** Top of File *******************************
0000001 ORIGINAL 1
0000002 ORIGINAL 2
0000003 ORIGINAL 3
0000004 ORIGINAL 4
0000005 ORIGINAL 2
0000006 ORIGINAL 5
0000007 ORIGINAL 6
0000008 ORIGINAL 2
0000009 ORIGINAL 7
0000010 ORIGINAL 8
******* ************************** Bottom of File ****************************
Move (M and MM) also supports H. The line or lines marked are copied to the locations indicated, and the original line or
lines are deleted.
Deleting Records
In edit, as in ISPF, records can be deleted using the D line command, or using a pair of DD line commands. When VSAM
KSDS or VSAM RRDS are edited, records deleted are not actually deleted until the file is saved. Until then, they can be
redisplayed and restored. Also, if the file is not saved (if a CANCEL command is entered), the records are not deleted.
Find, Change And Exclude Commands
FileMarvel provides enhanced FIND, CHANGE, and EXCLUDE commands. Some of the enhancements are listed below:
Refer to fields by their names in a copycode member
Use logical operators such as NE, GT, LT
Support for packed decimal values
Limit the records to search
30
Extend Boolean logic searches using multiple search criteria. FINDE/FE, CHANGE/CE and EXCLUDE/XE provide entry into
the extended search prompt panels.
FIND, CHANGE and EXCLUDE commands operate similar to the ISPF commands. The commands have been enhanced to
permit a greater degree of flexibility with better results. Searches for single or multiple arguments within a record or file are
supported.
General Syntax:
COMMAND
|field-name| string |logical operator| |boolean-connector| |string1|
|search-delimiter| |column1| |column2| |exclusion-parm|
WHERE:
field-name
Limit the search to this field. This parameter is limited to Edit and Browse sessions associated
with copycode.
String
Find, Change and Exclude Character Strings.
logical-operator
Using Logical Operators.
boolean-connector
Using Boolean Connectors.
search-delimiter
Search Direction And Delimiter Restrictions.
column1 & column2
Restricting Search to Particular Columns.
exclusion-parm
Search On Excluded And Deleted Records.
The commands and associated operands for search and change are discussed below.
FIND/F
Search for an argument string. Cursor sensitive priming is available with this command. When used
within an edit or browse session associated with a copybook enter the command with no operands,
place the cursor on the field to be searched and press enter. The search field name and value will
prime the command lines.
FINDE/FE
Enter the extended search prompt panel to develop multiple search arguments using Boolean logic.
FFIELD/FF
Search for a specific copybook field name.
CHANGE/C
Search for a particular string and change the string to a specified value. Cursor sensitive priming is
available with this command. When used within an edit session associated with a copybook enter the
command without any operands, place the cursor on the field to be searched and press enter. The
search field name and value primes the command line.
CHANGEE/CE Enter the extended search and change prompt panel to develop a group of search arguments using
Boolean logic.
EXCLUDE/X
Search for a particular string and flag the record making the record non-display during this edit
session. Cursor sensitive priming is available with this command. When used within an edit or
browse session associated with a copybook enter the command without any operands, place the cursor
on the field to be searched and press enter. The search field name and value primes the command
line.
EXCLUDEE/XE Enter the extended search prompt panel in order to develop a group of search arguments using
Boolean logic.
XFIELD/XF
Search for a specific copybook field name and exclude the record from display.
31
Find, Change And Exclude Character Strings
Find, Change, and Exclude commands may specify character strings in a variety of ways. When a copybook template is in use,
FileMarvel automatically converts the string specified to the same internal representation as the string in the record. Search
criteria does not need to match the internal representation. This is quite helpful when searching for strings within fields such as
packed decimal.
'
'
Character string. Enclosed by quotes and may contain imbedded blanks.
B
Binary string. The numeric value specified is converted to a binary number. Enclose the binary string
in single quotes. For example B’+356’
X
Hexadecimal string. The value must consist of one or more complete hexadecimal values. Enclose
the hexadecimal string in single quotes. For example, X'40' represents a blank, and X'0000' represents
two bytes of binary zero.
D
Packed decimal. The value must be numeric, optionally preceded by a plus or minus sign. Plus is the
default. Enclose the number in single quotes. Examples: D'123', D'+999', D'-100'.
Q
Bit string. The value must consist of one or more zeroes or ones. The string is automatically leftpadded and right-padded with zeroes to fill one or more complete bytes. Enclose the string in single
quotes. For example, B'11' is equivalent to B'11000000'.
Z
Zoned decimal. The value must be numeric, optionally preceded by a plus or minus sign. Plus is the
default. Enclose the number in single quotes. Examples: Z'123', Z'+999', Z'-100'.
P
Has multiple uses:
 Find Non-display characters. This is used in an edit session with STD mode. For example to find
all non-display data, enter the command:
F P'.' ALL
 Find invalid data. This is used in an edit session with FMT mode. Find data that does not conform
to the field definition. If a copybook is associated with the edit or browse session, find all data that
does not conform to the field specifications using P'.' with the field name:
F WEST-AREA P'.' ALL
 Find the next field. If a copybook is associated with a file but the display format is currently
Standard or Hex, find the location in the record that corresponds to the next field with the
following:
F
P’*’
Restricting Search to Particular Columns
Restrict the find criteria to operate within specified columns. For example, to find all records containing the word "BOLTS"
between columns 240 and 540, issue the following command:
FIND "BOLTS" 240 540 WORD ALL
Limit the find criteria to the occurrence of a string between particular columns, as in this example, or specify the string starts in
a particular column. For example, to find the next record containing the string "TABS" beginning in column 10, issue the
following command:
FIND "TABS" 10
For example, find (and display) all records whose credit rating is equal to 12 with a sequence of commands like this:
X ALL
32
FIND CREDIT-RATE 12 ALL
Using Logical Operators
FileMarvel supports the following logical operators for Find, Change, & Exclude commands:
EQ
Equal (Default)
NE
Not equal
GT
Greater than
LT
Less than
GE
Greater than or equal to
LE
Less than or equal to
For example, to find all records not containing "GOLD" starting in position one, enter the command:
FIND "GOLD" 1 NE ALL
Using Boolean Connectors
Connectors are used in find arguments to create complex search structures.
OR
AND
NOT
Results in a positive search if either search string is found.
Results in a positive search only if all search strings are found.
Results in a positive search if the search string is NOT found in the record being searched.
Search for multiple arguments by using Boolean connectors AND/OR/NOT. Enter the command on the command entry, or
enter FE without operands to use the extended search prompt panel.
FIND arg1
FIND arg1
FIND arg1
FIND arg1
F
arg1
FINDE/FE
or arg2 1 10 NE
AND fieldname arg2
AND arg2 OR arg1 AND arg3
AND arg2 AND NOT arg3
1 10 NE OR fieldname arg2 AND arg3 AND arg4 20 30
(extended prompt)
Search Direction and Delimiter Restrictions
By default, the specified string can occur in any location. However, the string can be restricted to a particular location
with one of the following keywords:
WORD
Delimited before and after by a word delimiter.
PREFIX
Begins after a word delimiter.
SUFFIX
Ends before a word delimiter.
Optionally, use one of the following keywords to indicate records to search or records to exclude:
NEXT
Search all records beginning with the current record at the current cursor position until the first record
meeting the search criteria is found. (Default.)
PREV
Search all records previous to the current cursor position.
FIRST
Search all records beginning with the first record in the file until the first record meeting the search
criteria is found.
33
LAST
Search all records, from the last record to the first record, until the last record meeting the search criteria
is found.
ALL
Search all records in the edit workspace and provide match totals.
END
Search all records beginning with the current record at the current cursor position to the end of file.
REC
Search only the current record starting at the current cursor position.
REC(nn)
Search the next nn records beginning at the current cursor position.
To find the first occurrence of the word "FORD" in the next 30 records enter the command:
FIND "FORD" WORD REC(30)
To change all blanks to binary zeroes from the current position in the current record to the end of the file, enter the command:
CHANGE X'40' X'00' END
Search on Excluded and Deleted Records
Optionally, restrict the search to excluded, non-excluded, or deleted records.
X
Search excluded records.
NX
Search records that have not been excluded. (Default)
DL
Search lines flagged as pending deletion. FIND and CHANGE commands exclude records pending deletion.
However, indicate the commands are to operate on such records using the DL keyword. As in LOCATE, FIND and CHANGE,
matches cause the redisplay of records. The records are still flagged as pending deletion. For example:
FIND 'FORD' ALL DL
X value1 REC(20) DL
Cursor Sensitive Priming of Search Fields
Find, Change and Exclude commands may be primed by cursor position. Enter the primary command and place the cursors on
the field to be searched and press enter. The command will be primed. Modify the command before issuing it, if necessary.
Field Validation
If a copybook is attached to the display and field validation is required, enter the field name followed by the non-display
indicator.
FIND field-name
P'.'
See string type “P” in Section 4.14.1 - Find, Change And Exclude Character Strings.
Change Multiple Arguments
Change multiple values by using Boolean connectors AND/OR. Enter this command on the command entry, or enter CE
without operands to use the extended search prompt panel.
CHANGE arg1 rep1 OR arg2 rep2 1 10 NE
CHANGE arg1 rep2 AND fieldname arg2
CHANGE arg1 rep2 AND arg2 rep2 AND NOT arg3
C arg1 rep1 1 10 NE OR fieldname arg2 AND arg3 NOT 20 30
34
CE
(extended prompt)
Change All Invalid Fields
All invalid fields may be changed to a valid value. If a copybook is attached to the Edit session any data not conforming to the
field specifications in the copycode can be changed to a valid value.
Example:
CHANGE field-name
P'.' +25.10
Data Modes
File Marvel edit and browse is designed for both Text files (such as source code for programs) and data files (such as
VSAM data files). The MODE command is provided to alter the effect of Find/Change/Exclude commands to fit the
data type being edited.
The following data modes are set using the MODE command:
TEXT
Use for source code files. This type of file normally has record numbers associated with it. Record
numbers are controlled by the NUM command. Record numbers are not searched or modified by a
Find/Change/Exclude command. In this mode Edit and Browse have the look and feel of ISPF edit.
If numbering mode is on (via a NUM ON main command), Find/Change commands ignore the numbering
columns specified (in COBOL mode, columns 1 through 6, and in standard mode, columns 73 through
80).
DATA
Use for VSAM data files The entire record is eligible for processing during a Find/Change/Exclude
command. No numbering column is assumed. In this mode VB records cannot be expanded or truncated.
DATAX
Same as DATA, but record lengths can be changed by the CHANGE command. Variable length record
data is moved, expanded, or truncated appropriately. The keyword DATAX applies only to variable
length records.
Restoring Excluded Records
Redisplay excluded records using the RESET (or RES) main command:
RESET
In edit, as in ISPF, use the L (last) and F (first) line commands to restore selected excluded records. Records that match the
criteria of a FIND or CHANGE command are also automatically redisplayed.
Extended Find/Change/Exclude Functions
An extension to the commands Find, Change, and Exclude provides a prompt panel where complex searches can be specified.
Specify multiple arguments using Boolean connectors AND/OR. The search parameters are patterned after the FIND
command.
The following commands provide access to the extended panels:
FINDE/FE
CHANGEE/CE
EXCLUDEE/XE
A panel similar to the following is displayed:
FMV/VxRx-EDIT-$CBKCOB
COMMAND ===>
Data set name
---- Extended Record Search Entry -------------------CSI.FMARVEL.VxRx.DEMOFILE
AND/OR Picture
35
Enter
. . .
place find parameters here
FIND
. . .
parameters . . .
. . .
. . .
. . .
. . .
. . .
Notify
. . . Y
Y=Yes, N=No - notify on search limit
Enter the argument string in FIND format, then press the END pf
to redisplay the record. Enter CANCEL to cancel the request.
After entering the desired search arguments, press the RFIND key to initiate the search.
NOTIFY
Y
N
-
Notify if the search limit is reached.
Do not notify if the search limit is reached.
NOTE: If a copycode member is associated with the dataset. The LC (List Copycode) command is available on this screen to
select fields to be placed in the FIND parameter fields.
Extended Copybook Field Selection Prompt
An aid to developing search argument parameters for the extended search panel is provided. This aid is limited to Edit/Browse
searches associated with a copybook. If a copybook is listed in the top left hand corner of the Extended Record Search Entry
Panel, the Field Selection Prompt panel is available. Issuing the LC (List Copycode) command accesses this panel.
A panel similar to the following will be provided:
FMV/VxRx-EDIT-$CBKCOB------ Copybook Record Selection Fields -----------------COMMAND ===>
SCROLL===> CSR
Main commands: CANCEL, END, RESET
Line commands: S=Select field element
Offset Length Level Type
Using Picture
Field Name
* ********************************* Top of Data *******************************
S
40
1
10
Char
X
M-STATUS-FLAG
S
41
1
10
Char
X
M-IDENT-FLAG
Locate fields by scrolling up or down or by entering a FIND command. Enter an "S" in the line command associated with the
field name(s) desired and press enter. After all the field definitions are selected, press the End PF key. The field names are
placed into the previous extended record search panel.
The results of the previous field selection prompt panel are displayed below. Search copybook fields are primed and ready for
the insertion of the search value for each field name.
FMV/VxRx-EDIT-$CBKCOB
COMMAND ===>
Data set name
---- Extended Record Search Entry -----------------CSI.FMARVEL.VxRx.DEMOFILE
AND/OR Picture
Enter
. . . M-STATUS-FLAG A
FIND
. . . M-IDENT-FLAG 1
parameters . . .
. . .
. . .
. . .
NOTIFY
. . . Y
Y=Yes, N=No
- notify on search limit
Enter the argument string in FIND format, then press the END pf
to redisplay the records. Enter CANCEL to cancel the request.
Copying Records into an Edit Space
Copy files or portions of files into an edit space using the COPY command. Several methods are available:
Copy an entire dataset directly from the command line. Copy an entire dataset into an edit space directly from the command line
by issuing the command:
36
COPY datasetname
Copy directly
COPY ?
Copy external data set prompt panel
COPY *
Copy from internal source directory
Use the Prompt panel to copy all or part of a file. Access by issuing the COPY command with no parameters.
Copy Prompt Panel.
The "COPY" function displays the prompt panel containing the data set name, assist functions, options to compile a
copybook and permits the selection of specific record types. Records or entire files may be copied into the target edit
workspace. Copy all or a part of a dataset into an edit space by using the Copy Prompt Panel.
A panel similar to the following is displayed:
FMV/L02-COPY------------------- Copy - Entry Panel ---------------------------Command ===>
Data set name . .
Volume . .
Copy mode. . .
Format mode . .
COMPILE or USE
Template
Compile
Language
Copylib
with
. .
. .
. .
. .
'FMV.VXRX.SEQ'
Data set name, * or wildcard pattern
For uncataloged data sets
S
S
S=standard, I=interactive
F=format S=standard H=hex C=compact R=reformat
D=hexdump *=default
FORMAT, COMPACT or REFORMAT format mode:
CBKCOB
Member name, *=Member list, BLANK=default
N
Y=yes, N=no, E=extended
C
C=COBOL, P=PLI, copybook compile language
qualifier.*=data set list
APPLY CRITERIA
Start key/mem.
End key/mem. .
Start record .
Record count .
.
.
.
.
.
.
.
.
.
.
N
Y=yes, N=no, E=extended
00000001
00000001
Starting record number, if key not specified
Number of records to process
DATA SET NAME
Enter the name of the dataset to be copied enclosed in single quotes.
VOLUME
Enter the volume serial number where the dataset resides. Use for uncataloged datasets.
COPY MODE
I = Interactive select records to copy interactively. Display and select records from
source dataset.
S = Stardard do not use interactive copy to select records to copy.
FORMAT MODE
This defines the Display mode used to display the dataset to copy from.
F - Format
Provides an edit session using a COPYCODE template to format the dataset. Copybook
parameter must be set.
S - Standard
Provides an edit session in the traditional ISPF style.
H - Hex
Provides an edit session in a “dump” format with both the printable characters and their hex
representations.
C - Compact
Similar to Format, but more compact to display more fields per screen. Copybook
parameter must be set.
R - Reformat
Apply the reformat template.
37
* - Default
Defaults to the Display mode established in the copybook settings. The default for the
copybook is set during explicit or implicit copybook compile.
COPYBOOK
Required for Format and Compact Display Modes. The copybook source member name or
compiled copybook template name to use during the copy selection session. Enter the
copybook source member name if FileMarvel has not compiled the copycode. If a file is
associated with a copybook template, this field may be omitted. If no copybook is
associated with the file and this field is left blank, the file is displayed in standard display
mode regardless of the Display Mode requested.
COMPILE
Indicates if the copybook specified will be compiled. When the copycode is compiled it
creates a “copycode template” and is saved in the FileMarvel CONTROL file. The
Copybook is required to be compiled only once. Subsequent file accesses using this
copybook name will use the copybook template most recently compiled.
Y - The Copybook will be compiled by FileMarvel before the copy selection session is
started.
N - The Copybook will not be compiled.
E - Will display the Copybook Maintenance Selection Panel before the copy selection
session is started.
LANGUAGE
Indicates the language of the source copybook member. If a file is associated with a
copybook, omit this field.
C - COBOL
P - PL/I.
COPYLIB
The PDS where the source copybook member specified in the Copybook parameter resides.
Specify only the dataset name. Do not include the member name. This field is required
only if the copybook will be compiled. If the copybook has already been compiled, the
FileMarvel control dataset will provide the copycode template.
Apply criteria
Controls if record/member selection is used.
Y - Record/member selection will occur. If the dataset to be copied is a PDS, a selection
criterion is applied to the member name. Specify selection criteria in the fields START
KEY/END KEY, START RECORD and RECORD COUNT.
E - Record selection will occur. The Record Selection Extended panel is displayed where
selection criteria can be specified.
N - No record selection will occur. The entire dataset is displayed.
START KEY
Use with to key to specify a range of records to select from a VSAM KSDS dataset. Enter
the lowest key to include in the range of records to edit. A partial key may be entered. If
the key contains non-displayable characters, enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
When used with a PDS this field provides the ability to specify a range of members to select
for inclusion in a PDS member selection list. Enter the name of the first member to include.
A partial name may be entered. The PDS directory will begin with the first member name
that matches this field.
If this field is specified, To Key must also be specified.
END KEY
Use with START KEY to specify a range of records to select from a VSAM KSDS dataset.
Enter the highest key to include in the range of records to edit. A partial key may be
entered. If the key contains non-displayable characters, enter the key in hex in the following
format:
38
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
When used with a PDS this field provides the ability to specify a range of members to select
for inclusion in a PDS member selection list. Enter the name of the last member to include.
A partial name may be entered. The PDS directory will end with the member name that
matches this field.
If this field is specified, END KEY must also be specified.
START RECORD
Specifies the starting record number to select. If the dataset is a PDS, this is the starting
member number relative to 1 to include in the PDS member selection panel.
RECORD COUNT
If START Record is specified, Record Count is the maximum number of records to copy.
If the dataset is a PDS, this specifies the maximum number of members to display in the
PDS member selection panel.
Interactive Copy
Use interactive copy to copy all or part of a file into an edit session. To access interactive copy, select records to copy
from the source dataset display:
COPY MODE
Specify “I” on Interactive Copy on the copy prompt panel
An edit space is displayed containing the records from the source file (or the records meeting the selection criteria). A panel
similar to the following is displayed:
FMV/VxRx-COPY----- VOLS03
- YOUR.COPY.DATASET --Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
******* *************************** Top of File *******************************
0000001 DAN
CHECKING
0000002 KAREN
CHECKING
0000004 JOE
STOCKS
0000005 STEVE
CHECKING
0000006 JACOB
STOCKS
0000007 MIKE
STOCKS
******* *************************** Bottom of File ****************************
Edit commands are available to tailor the workspace before selecting records for copying. For example, use EXCLUDE or X to
exclude certain records, etc.
To select records for copying, use the SELECT (or S) main command or the S line command. The SELECT main command
supports the same parameters as the FIND command. For example, select all records containing the word "STOCKS" with the
command:
SELECT STOCKS ALL
The results are similar to the following:
FMV/VxRx-COPY----- VOLS03
- YOUR.RESULT.DATASET Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
******* *************************** Top of File *******************************
0000001 DAVID
CHECKING
0000002 GONI
CHECKING
=CPY=>
JOE
STOCKS
0000004 KAREN
CHECKING
=CPY=>
STEVE
STOCKS
=CPY=>
TAL
STOCKS
******* *************************** Bottom of File ****************************
By default, the SELECT command ignores excluded records. However, to operate on excluded records, use the keyword X.
For example, to select all excluded records, enter the command:
39
SEL ALL X
To select particular records, use the S line command:
FMV/VxRx-COPY----- VOLS03
- YOUR.COPY.DATASET --Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
******* *************************** Top of File *******************************
0000001 DAN
CHECKING
S000002 KAREN
CHECKING
0000003 JOE
STOCKS
0000004 STEVE
CHECKING
0000005 JACOB
STOCKS
0000006 MIKE
STOCKS
******* *************************** Bottom of File ****************************
The result is similar to the following:
FMV/VxRx-COPY----- VOLS03
- YOUR.RESULT.DATASET Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
******* *************************** Top of File *******************************
0000001
DAN
CHECKING
=CPY=>
KAREN
CHECKING
0000003
JOE
STOCKS
0000004
STEVE
CHECKING
0000005
JACOB
STOCKS
0000006
MIKE
STOCKS
******* *************************** Bottom of File ****************************
When all records to be copied have been selected, press END. The original edit space is redisplayed, with these selected
records highlighted. To locate these records, use the LOCATE command with the CPY keyword, as follows: L CPY
Printing Files
FileMarvel provides the ability to print entire files or selected records. Initiate the print request from within browse or
edit using the PRINTX command or via a batch utility submitted with the PRINTDS function.
FileMarvel printing supports the four display modes and generates output formatted for the appropriate paper width.
Switching between display modes (standard, hex, formatted, and compact) results in four different types of printed
output.
Excluded lines are ignored when printing. A high degree of selectivity when printing records is achieved, since lines
can be excluded based on their content.
Printing Selected Records
To print records from the current edit or browse edit space, use the PRINTX command. In STANDARD mode, by default, all
records are printed. In all other modes, by default, only one record is printed. Specify one of the following keywords to control
printing:
PRINTX will “spool” the print. See discussion on Print Class in Section 3.1 - Set Profile Information.
ALL
Prints the entire file.
END
Prints the file from the current record to the end of the file.
REC
Prints the current record.
REC(nn)
Prints nn records beginning from the current record.
PRINTX REC(30)
To release the current group of queued printed records, enter the command as follows:
PRINTX REL
See discussion on Print Class in Section 3.1 - Set Profile Information.
Print Formats
40
FileMarvel formats the printed output based on the current display mode For example; in hexadecimal mode (which resembles
a dump), the output looks similar to this:
FMVREPTS FM/VxRx
Dec
0001
0033
0065
0097
0129
0161
REC:
Hex
0000
0020
0040
0060
0080
00A0
Format dataset:
0.1.2.3.
F0F0F0F0
404040F1
D6D5C5E2
0000000F
40404040
0820128C
1
LEN:
4.5.6.7.
F0F0F0F1
0000000C
40404040
0251954F
4040F2D6
0820127C
CSI.FMARVEL.VxRx.DEMOFILE
8.9.A.B.
F0F0F8F2
D7C80820
40404040
00000023
0820128C
0000162C
675/X’02A3’ RBA:
C.D.E.F.
F0F1F2F8
128C0333
40404040
584C4040
0820121C
0000000C
10......
F0F1F2F8
584CF0F0
40404040
40404040
0820127C
D0D0D140
14......
F7404040
40404040
40404040
40404040
0820220C
F8F0F5F7
Date:
06/08/98 Time: 13:49:14 Page:
18......
40404040
40C1D1D6
40404040
40404040
0820220C
F5F0F100
0/X’00000000’ KEY: 0000000300
41
1C.....
40404040
C8D540D1
40404000
40404040
0820218C
00000C00
1
....5....10...15...20...25...30.
*000000010082012808107
*
*
1....PH.......<00AJOHN
*
* ONES
. *
* ......N|.....<
*
* 20...........@........
*
*
*
In standard display mode, the output looks similar to this:
FMVREPTS FM/VxRx
Hex
0000
0064
00C8
012C
0190
01F3
Dec
0001
0101
0201
0301
0401
0501
*
*
*
*
*
*
*
REC:
1
Format dataset:
CSI.FMARVEL.VxRx.DEMOFILE
Date: 06/08/98 Time: 13:49:14 Page:
1
1...+....10...+....20...+....30...+....40...+....50...+....60...+....70...+....80...+....90...+....1
000000010082012808107
1....PH.......<00
AJOHN JONES
.....
..n|.....<........................20...........@...................@.0018057501....
...%...........<........
........
........ ......
..
........
........ ........01.... .... ....
....IPB218-8268
07SP01 14YCN
A95
00001111
LEN:
675/X’02A3’ RBA:
*
*
*
*
*
*
*
0/X’00000000’ KEY: 0000000100
In compact mode, the output shows the field names and the heading includes the copybook used:
FMVREPTS FM/VxRx
Format dataset: $CBKCOB
REC-PAYEE-NO................0000000100
K-DATE-ENTERD...................820128
K-AUDITOR...........................08
K-BATCH-NO...........................1
K-DOC-SEQ...........................07
K-ITEM-NO................
REC:
1
LEN:
CSI.FMARVEL.VxRx.DEMOF
Date: 06/08/98 Time: 13:49:14 Page:
1
H-WORK-STATION(2)...................
H-TERMS........................14
H-CKDG(2)............................ H-INV-APPVL.……..................Y
H-CASH-CODE(2)......................
H-TAX-ALLOC-INC.................C
H-AMT-CHG1(2)....................+0.00 H-JE-VOID-FLAG..................N
H-ALLOC-PCTG(2)..................+0.00 H-USAGE-OVR......................
H-CORP(3)...........................
H-CM-REF-NUM...................
675/X’02A3’ RBA:
0/X’00000000’ KEY: 0000000100
Formatted mode looks similar to the following:
FMVREPTS FM/VxRx
Format dataset: $CBKCOB
Offset Length
1
10
11
6
17
2
19
1
20
2
22
13
35
2
37
4
41
1
Level
10
15
15
15
15
10
10
10
10
REC:
LEN:
1
Picture
X(10)
X(6)
X(2)
X
XX
X(13)
X(2)
S9(6)
X
CSI.FMARVEL.VxRx.DEMOF
Field
REC-PAYEE-NO
K-DATE-ENTERD
K-AUDITOR
K-BATCH-NO
K-DOC-SEQ
K-ITEM
K-REC-CD
M-DATE-CHG
M-STATUS-FLAG
675/X’02A3’ RBA:
Date: 06/08/98 Time: 13:49:14 Page:
1
....+....10...+....20...+....30...+....40...+...50...+
0000000100
820128
08
1
07
1
+0
P
0/X’00000000’ KEY: 0000000100
A file statistics page is provided at the end of each report regardless of the format.
FMVREPTS FM/VxRx
-File
Dsorg
Rec length
Key length
Records
Updates
Retrieved
CI size
CI splits
Idx levels
Alloc rba
:
:
:
:
:
:
:
:
:
:
:
File statistics:
SYS00002
Vsam
675
10
62
0
2495
12288
0
0
1204224
CSI.FMARVEL.VxRx.DEMOFILE
Volume
Recfm
:
:
VOLS03
Ksds
Key pos
Inserts
Deletes
I/O reqs
Free CI/CA
CA splits
Extents
Used rba
:
:
:
:
:
:
:
:
0
0
0
108
2
0
1
602112
Dataset
Avail rba :
Date: 06/08/98 Time: 13:49:20 Page:
29
: CSI.FMARVEL.VxRx.DEMOFILE
1155072
Saving Files
All records or a subset of records in the edit space can be saved into their original location or into an existing dataset or
member.
PDS datasets may now be compressed on the fly when the dataset becomes full during a member save.
Save the records in the edit space by either of two methods:
Use the SAVE command directly from the command line. Use the SAVE Prompt panel by issuing SAVE ?.
Selected records can be saved into another dataset.
Saving Directly from the Command Line
To save all the records into their original location, use the SAVE command, as in ISPF:
SAVE
Records marked as pending deletion are not saved, but are deleted at this time and are no longer available. To save the file into
an existing dataset, specify the receiving dataset name. For example:
42
SAVE 'YOUR.SAVE.DATASET'
If the file is a member of a library, save the file into a new or existing member of the same library by specifying its name:
SAVE TESTMEMB
To save the file into a member of another library:
SAVE 'YOUR.SAVE.DATASET'(TESTMEMB)
To display external data set prompt panel.
SAVE ?
To save into the internal source storage directory.
SAVE *
Save Prompt Panel
The "SAVE ?" function displays the prompt panel containing the data set name, assists functions and permits the selection of
specific record types. Records or entire files may be saved from the source edit workspace. To access the Save Prompt Panel
issue the primary command SAVE * from an edit session. A panel similar to the following is displayed:
FMV/L03-SAVE------------------- Save - Entry Panel ---------------------------COMMAND ===>
Data set name. .
'FMV.VXRX.SEQ'
Data set name, * or wildcard pattern
Volume. .
For uncataloged data sets
Save mode. .
S
S=standard, R=replace, E=extend, A=alloc
Exclude mode. .
Y
Y=yes, N=no, save excluded records
40
Two byte hex expansion pad character
Record pad. .
Press enter to save the dataset and return to the edit session.
DATASET NAME
Enter the name of the dataset to be saved, the dataset originally edited, or another dataset or PDS
with the member qualified name qualified.
VOLUME
Use to save to an uncataloged non-VSAM file.
SAVE MODE
Savemode controls the action of the operation on the existing file. Choose one of these options:
S=standard Standard save. Overlay the file with the edit workspace records. However, if duplicate data
exists in the file, notification is given that data exists and the option to cancel the request is
provided.
R=replace
Standard save replace. Overlay the file with the edit workspace records without data exists
notification.
E=extend
For sequential and VSAM files only, this appends the records in the current edit space to the end
of the existing file. For VSAM KSDS/RRDS, existing file records are not overlaid and new
ones are added to the file. For VSAM ESDS, the records are added to the end of the file.
A=allocate
Allocate a new data set prior to saving the existing data.
43
EXCLUDE MODE
If the previous edit work space contains excluded records, either save or ignore the excluded
records.
Y
Yes, save excluded records
N
No, do not save excluded records
PADCHAR
When a short record is written in a fixed length file, this designates the character to use as the
padding character. The default is blank (X'40')
Global FIND/CHANGE a PDS
All or a subset of members of a PDS can be globally searched and changed. There are two methods of executing a Find/Change
on PDS members:
From within a member directory using the FINDTEXT/FT command. Use the extended search function from the Edit Prompt
Panel.
PDS FIND/CHANGE from Member Directory
This function will search each record within a PDS member list for a given string. The “X” line command is used to exclude
members from the search. A subset of members containing the string is displayed. Select the members to make changes.
FINDTEXT string |ALL|
Where: string can be any valid find argument.
A sample member directory screen is shown below:
FMV/VxRx EDIT------- YOUR.TEST.PDS -------------Member 0000001 of 0000065
COMMAND ===>
SCROLL ===> CSR
Commands: COMP, CT, F(E), FT text (ALL), L mem, RES(ACT), SALL, SORT, X(E)
Linecmds: B, D, E, F, L, P, R, S, X
Name
Action
VV.MM Created
Changed
Size Init Mod Userid
* ********************************* Top of File *******************************
_ MEM1
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
_ MEM3
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
_ MEM4
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
_ MEM5
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
_ MEM6
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
_ MEM7
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
_ MEM8
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
The FT command displays all members containing the string “IEBCOPY”. Those members containing the string remain on the
member selection panel, the rest are excluded. A panel similar to the following is displayed:
FMV/VxRx EDIT------- YOUR.TEST.PDS -------------Member 0000001 of 0000065
COMMAND ===>
SCROLL ===> CSR
Commands: COMP, CT, F(E), FT text (ALL), L mem, RES(ACT), SALL, SORT, X(E)
Linecmds: B, D, E, F, L, P, R, S, X
Name
Action
VV.MM Created
Changed
Size Init Mod Userid
* ********************************* Top of File *******************************
_ MEM1
01.06
04/05/95 04/29/95 01:22
26
26
0 TSO12
_ 1 LINE(s) EXCLUDED
_ MEM3
01.06
04/05/95 04/29/95 01:22
26
26
0 TSO12
_ MEM4
01.06
04/05/95 04/29/95 01:22
26
26
0 TSO12
_ 2 LINE(s) EXCLUDED
_ MEM7
01.06
04/05/95 04/29/95 01:22
26
26 0 TSO12
_ MEM8
01.06
04/05/95 04/29/95 01:22
26
26 0 TSO12
Members can be selected for editing. Lines, which match the FT string, are shown; the rest of the member is excluded. This is
dependent on the FINDTEXT installation option.
Selecting a member displays a panel similar to the following:
44
FMV/VxRx-EDIT----- $CBKCOB - CSI.FMARVEL.VxRx.D Rec 0000000 Cols 00001 00071
COMMAND ===>
SCROLL ===> CSR
******* ************************** Top of File *******************************
//IEBCOPY JOB JOBNAME,CLASS=A,MSGCLASS=X,NOTIFY=GKH1
- - - - - - - - - - - - - - - - - - - - 1 LINE(S) EXCLUDED
//STEP1
EXEC PGM=IEBCOPY
- - - - - - - - - - - - - - - - - - - - 8 LINE(S) EXCLUDED
Issue a CHANGE command to alter the member. If multiple members are selected they are edited individually each time the
End PF key is pressed. The Repeat Find key is used to change each member. Alternatively, the CHANGEE/CE command is
issued to use the Extended Change Panel.
PDS FIND/CHANGE List Form from Edit Prompt
Globally FIND/CHANGE a PDS from the Edit Prompt Panel. Enter an "E" in the Edit prompt panel to use the extended search
function. This permits the selection of members containing specific arguments. Use Boolean connectors AND/OR to search
for multiple values within records.
The following example is obtained by specifying ‘L’ in the ‘SELECT MODE’ field of the extended search prompt panel. The
result of the search is a special directory with members and arguments displayed simultaneously. Entering a change command
at this level will change the arguments within the display. The changes are temporary and are altered ONLY when the End PF
key is pressed. Members may be selected and altered individually. However, individual member alterations remove that
member from any subsequent directory display changes. A series of CHANGE commands against the special directory display
can be issued.
FMV/VxRx EDIT------- YOUR.TEST.PDS -------------Line 0000001 of 0000338
COMMAND ===>
Commands: CAN, C(E), F(E), Lmem, RES(ACT)
Linecmds: B, E, F, L, P
....+....10...+....20...+....30...+....40...+....50...+....60...+....70...+..
* ********************************* Top of Selected Records *******************
_ MEM1
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
-----------------------------------------------------------------------------00001 ARGUMENT1
ARGUMENT2
00002 ARGUMENT1
ARGUMENT2
00003 ARGUMENT2
ARGUMENT1
-----------------------------------------------------------------------------S MEM2
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
-------------------------------------------------------------------------------00001 ARGUMENT1
ARGUMENT2
-------------------------------------------------------------------------------_ MEM3
01.06 04/05/95 04/29/95 01:22
26
26
0 TSO12
-------------------------------------------------------------------------------00001 ARGUMENT1
ARGUMENT2
00002 ARGUMENT1
ARGUMENT2
---------------------------------------------------------------------------------------------
Here’s an example of a change command issued on this special member selection panel:
CHANGE ARGUMENT1 VALUE1 ALL
After all the changes have been made, press the End PF key to save the changes to the members. The resulting display shows
the save statistics.
FMV/VxRx EDIT------- YOUR.TEST.PDS -------------Line 0000001 of 0000338
COMMAND ===>
Commands: CAN, C(E), F(E), Lmem, RES(ACT)
Linecmds: B, E, F, L, P
....+....10...+....20...+....30...+....40...+....50...+....60...+....70...+..
* ********************************* Top of Selected Records *******************
_ MEM1
-SAVED
record(s)
3
26
26
0 TSO12
------------------------------------------------------------------------------------------------------------------------------------------------------------_ MEM2
-SAVED
record(s)
1
26
26
0 TSO12
------------------------------------------------------------------------------------------------------------------------------------------------------------_ MEM3
-SAVED
record(s)
2
26
26
0 TSO12
-------------------------------------------------------------------------------------------------------------------------------------------------------------
45
Compile Copybook Selection Panel
The Compile Copybook Selection Panel is an extension of the Browse and Edit prompt panels and permits copybook definition
compilation prior to viewing datasets. This panel is obtained by entering an "E" in the Compile field of a Browse or Edit panel.
When the copycode is compiled it creates a “copycode specification” and is saved in the FileMarvel CONTROL file. The
Copybook compilation is only necessary once. Subsequent file accesses use the most recently compiled copybook.
A panel is displayed similar to the following:
FMV/L02-EDIT---------- Compile Copybook Selection ----------------------------COMMAND ===>
SCROLL ===> CSR
A compile for "TEST" has been requested, select one of the options:
1
2
3
4
5
6
7
-
COMPILE
EXTENDED
RECOMPILE
REUSE
EDITCTL
EDITSOR
CANCEL
Discard the current controls and re-compile.
Discard the current controls and re-compile usimg extended.
Re-compile using existing controls.
Do not re-compile and use existing copybook.
Edit the current copybook control definition.
Edit the current copybook source definition.
Cancel the request and return to previous screen.
If the COPYBOOK controls exist, they are shown below.
********************************** Top of Data ********************************
COPY
MEM(CBKCOB )
COPYLIB
DS( 'YOUR.FMARVEL.VxRx.JCL'
)
RELATEDS
DS( 'YOUR.FMARVEL.VxRx.DEMOFILE'
)
********************************** Bottom of Data *****************************
SELECTIONS:
1 – COMPILE.
Will compile the copycode and overlay the current copybook in FMV.
The copycode control will be compiled as well as the copycode source. Use
this selection if you have changed the copycode source or the copycode control.
The compile will occur and you will be presented with an EDIT/BROWSE session.
2 – EXTENDED.
Will present the Extended Copybook Compile Panel.
3 – Recompile.
Will compile the copycode and overlay the current copybook in FMV.
The copycode source will be compiled; the copycode control will NOT be compiled. Use this
selection if you have changed the copycode source but NOT the copycode control. The compile will
occur and you will be presented with an EDIT/BROWSE session.
4 – REUSE.
Use the existing copycode and control. No compile will take place. You will be presented with an
EDIT/BROWSE session.
5 – EDITCTl.
Will present an edit session on the copycode control.
6 – EDITSOR.
Will present an edit session on the copycode source within FMV.
7 – CANCEL.
Return to the previous screen.
Extended Copybook Compile Panel
The extended on-line copybook compile is an extension of the Browse and Edit prompt panels and permits multi-record
copybook definition compilation prior to viewing datasets. The extended form of copybook compile performs the same
function as the explicit on-line compile. Obtain the panel by entering a "Z" in the compile Copybook Selection Panel.
When the copycode is compiled it creates a “copycode template” and is saved in the FileMarvel CONTROL file. The
Copybook compilation is only necessary once. Subsequent file accesses use the most recently compiled copybook. After the
controls are primed, enter the command COMPILE to execute the compile.
46
A panel is displayed similar to the following:
FMV/VxRx--------------- Extended Copybook Compile -----------------------COMMAND ===>
Extended FORMAT OR COMPACT copybook compile
Copybook
. . . $CBKOB
Language
. . . C
Description . . .
Copylib
members
.
.
.
.
.
.
.
.
Copylib
datasets
. . .
. . .
. . .
Reference member name
C=COBOL, P=PLI copybook compile language
Optional copybook descriptive title
Enter a single or multiple copybook library
members for redefined copybook overlays. The
members redefine record access depending on
the value of a specific field.
.
.
.
.
Copylibs are searched in the order specified
. . .
. . .
. . .
Example DISPLAY record-type WHEN data-name cond(EQ,NE,LT,GT,GE,LE) value
Display
controls
Copybook
Copybook template name for the copybook. It is typically the same as the copybook source
member name.
Language
Type of copybook: COBOL or PL/I
Description
The COPYBOOK directory description. An optional descriptive text to describe the
copybook.
Copylib members
The member name of the copybook source. To describe a dataset with multiple record
types, specify more than one member name here.
Copylib datasets
The copy libraries containing the copybook members. More than one library can be
entered.
Display controls
The display statements indicating the record re-definitions. The DISPLAY statements
follow the same rules specified in the batch mode compiles. See Appendix A.
Record Reformat Prompt Panel
The reformat prompt panel provides the ability to reformat records. Fields within records can be selected and re-positioned
within the record. This can be done to extract data to create a new dataset or simply for ease of viewing.
There is an additional similar function called a Tailored Copybook Template that directly uses an existing compiled copybook
template.
A reformat template controls the reformat. Reformat templates may be defined on a temporary basis or saved for re-use at a
later time. See the SAVE and END commands described below. The SAVE command must be issued in order to permanently
save the template.
Several reformat templates may be created for a file to display different views for the file.
A reformat template is created with the Record Reformat Template Panel shown below. The panel is obtained by:
Enter an "R" in the Select Criteria field in the BROWSE/EDIT Entry Panel.
Enter the command "LISTREF/LR" from within a BROWSE/EDIT session.
A panel similar to the following will be displayed:
FMV/VxRx-EDIT-STANDARD ---- Record Reformat Template------------------------COMMAND ===>
47
Commands: CAN, COPY, END, LC, RES, SAVE
Field Start
1
2
3
4
5
6
Length
1
25
225
45
Description
10
5
5
15
The field definitions are listed below.
FIELD
The field number being defined.
START
The displacement of the beginning of a field to be included in the reformatted record. The
displacement is relative to 1. The Start fields may be specified in any order and from any part of the
record. The Start fields do not have to be in ascending order, in that a record can be re-arranged.
LENGTH
The length of the field. Care must be taken not to exceed the width of the terminal.
lengths exceeding the screen width will be ignored.
Fields with
DESCRIPTION Used as a field reminder when copybook is used.
The available commands are listed below:
CANCEL | CAN Cancel and return to the previous panel.
COPY
Will display the reformat template directory panel in order to copy a previously developed template.
END
Will present an EDIT/BROWSE session using the template. The template is not permanently saved.
LISTCBK | LC
If a copybook is associated, the LC command is available to present a for a copybook field list.
Selections may be made from the list in order to prime the reformat selection fields. Using the LC
command relieves the user of counting bytes manually to determine offsets.
RESET | RES
Reset the all fields to null.
SAVE
Save the template.
SAVE templatename Saves the template using the specified name.
These changes will be remembered across records and the template may be saved for future use using the SAVECB
command. Saving several templates will provide different looks for the file records depending on the need.
The display may be tailored using either the compile options, the "LO" list options command or the "SET" function
command. Fields are converted from the internal values to display values and in EDIT mode the field values may be
modified according to the field rules.
48
DATASET - Data Set Maintenance
Data Set Maintenance Selection Panel
Select the Data Set Maintenance Utilities Option from the FileMarvel Primary Option Menu or enter the Fastpath command
DATASET.
Fastpath command: DATASET
FMV/VxRx-DATASET--------- Data Set Maintenance Functions -----------------OPTION ===>
1
2
3
4
5
6
7
8
9
10
ALLOC
AMS
DEFGDG
DELGDG
CATALOG
UNCATLG
DELETE
RENAME
COMPRESS
LISTCAT
ALLOC
AMS
DEFGDG
DELGDG
CATALOG
UNCATLG
DELETE
RENAME
COMPRESS
LISTCAT
-
Allocate a new VSAM/Non-VSAM data set
Define, delete or change VSAM data sets
Define GDG level entries
Delete GDG level entries
Catalog Non-VSAM data set
Uncatlog Non-VSAM data set
Delete VSAM/Non-VSAM data set
Rename VSAM/Non-VSAM data set
Compress partitioned data sets
List data set catalog information
Allocate a new VSAM or non-VSAM dataset. This is a general allocation utility. Some commonly
used VSAM allocation parameters are not available.
Menu of Selections to perform Access Method Services online. Define, display information, delete
or change VSAM files.
Define Generation Data Group Level Entries.
Delete Generation Data Group level entries.
Catalog Non-VSAM datasets.
Uncatalog Non-VSAM datasets.
Delete VSAM/Non-VSAM datasets. This function is repeated on the AMS menu (Selection 2) they
documented in that section.
Rename VSAM and Non-VSAM datasets. This function is repeated on the AMS menu (Selection 2)
they documented in that section.
Compress partitioned data sets.
List data set catalog information. Provides a selection directory providing the ability to perform a
variety of functions with selection commands.
49
ALLOC - Allocate a Data Set
The ALLOC Utility Panel can be accessed from the Dataset Maintenance Menu, or by selecting a dataset from a dataset
selection panel, or with the Fastpath command ALLOC maintenance. To obtain attributes from a model dataset enter an existing
data set name and press enter, the attributes of the dataset will be primed for allocation of a new dataset.
This is a general allocation utility for both non-VSAM and VSAM datasets. Not all VSAM parameters are available.
Fastpath command: ALLOC
FMV/VxRx-ALLOC----------- Allocate VSAM/NON-VSAM Data set --------------------COMMAND ===>
DATA SET NAME
. . .
VOLUME SERIAL
.
GENERIC UNIT
.
SPACE UNITS
.
PRIMARY QUANTITY .
SECONDARY QUANTITY.
DIRECTORY BLOCKS .
RECORD FORMAT
.
RECORD LENGTH
.
RECORD SIZE
.
KEY LENGTH
.
KEY LOCATION
.
REUSE OPTION
.
SPAN OPTION
.
DELETE DATA SET
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Data set name, * or wildcard pattern
Blank for authorized default volume
Generic dasd group for non-VSAM
BLKS, TRKS, CYLS
In above units
In above units
Zero for sequential or VSAM
KSDS,ESDS,RRDS for VSAM data sets
Average record length for VSAM
Maximum record length for VSAM
Key length for VSAM data sets
Relative to zero position for VSAM
Y=Yes, N=No for VSAM data sets
Y=Yes, No=no for VSAM data sets
D=delete, N=No execute delete data set
DATA SET NAME
Dataset name to allocate. Enter an existing dataset name and press enter to prime the
allocation fields from an existing data set. Enter * for a dataset copybook selection
panel.
VOLUME SERIAL
DASD volume serial. Leave blank for default volume.
GENERIC UNIT
Generic DASD group for non-VSAM.
SPACE UNITS
Space units: BLKS, TRKS or CYLS.
PRIMARY QUANTITY
Primary allocation in SPACE UNITS.
SECONDARY QUANTITY
Secondary allocation in SPACE UNITS.
DIRECTORY BLOCKS
Number of PDS directory blocks.
RECORD FORMAT
Record format: Fixed, Variable, Undefined, Blocked, Spanned (as in VS, variable
spanned), or VSAM KSDS, ESDS or RRDS.
RECORD LENGTH
Non-VSAM record length or VSAM average record length.
RECORD SIZE
Non-vsam block size or VSAM maximum record length.
KEY LENGTH
VSAM key length.
KEY LOCATION
VSAM key location relative to zero.
REUSE OPTION
Y = set REUSE option for VSAM files only. N = do not set REUSE.
50
AMS - Access Method Services Menu
Many functions are available to display allocation attributes and maintain VSAM and non-VSAM datasets. Datasets may be
allocated, deleted, renamed, attributes listed, and dataset selection lists generated.
FileMarvel provides a single panel to display information about VSAM files, defines VSAM files, or deletes VSAM files. For
convenience, some of the utilities available on the FileMarvel Dataset Maintenance Utilities Menu are repeated here. The
functions repeated here are DEFGDG, DELGDG, DELETE and RENAME.
Select the AMS Utility Menu from the Dataset Maintenance Utilities Menu or enter the Fastpath command AMS.
Fastpath command: AMS
FMV/VxRx--------------------------- Access Method Services ------------------------------OPTION ===>
1
2
3
4
5
6
DEFESDS
DEFKSDS
DEFRRDS
DEFNONV
ONLINE
MODELS
-
Define VSAM ESDS data sets
Define VSAM KSDS data sets
Define VSAM RRDS data sets
Define Non-VSAM data sets
Execute AMS commands interactively
Maintain AMS pattern directory
Invoke the menu options by number or by name. For example, select the LISTC function by selecting option 11 or enter the
command LISTC on any FileMarvel panel.
DEFESDS
DEFKSDS
DEFRRDS
DEFNONV
ONLINE
MODELS
Define a VSAM ESDS dataset interactively.
Define a VSAM KSDS dataset interactively.
Define a VSAM RRDS dataset interactively.
Catalog a Non-VSAM datasets interactively.
Execute AMS Commands Online.
AMS Pattern Selection List.
DEFVSAM - Defining VSAM Files
Select the Define Utility Panel from the AMS menu or enter the Fastpath command. You can also define VSAM files or nonVSAM files using the general allocation panels discussed in Section ALLOC Utility or define VSAM files by using
FileMarvel's AMS ON-LINE utility.
The selection used and the fastpath command entered depends on the VSAM file type to define:
DEFKSDS for KSDS files.
DEFESDS for ESDS files.
DEFRRDS for RRDS files.
Entry panels are tailored specifically for the different VSAM file types (KSDS, ESDS, and RRDS).
A panel similar to the following is displayed:
FMV/L03-AMS----------------- Define VSAM KSDS Data sets ----------------------COMMAND ===>
Cluster name
. . .
Pattern cluster . .
Volume . . .
Keylen . . .
Reclen . . .
Units . . .
Prime . . .
CIfree . . .
Shroptn . .
Imbed
. .
YOUR.NEW.DATASET.NAME
Cluster volume
Key length
Average rec len
CYL,TRK,REC
Primary space
pc CI free space
1,2,3,4 shr opt
Y=Yes,N=No
Data set name, * or wildcard pattern
CIsize . . .
Optional CI size
Keyloc . . .
Key pos rel to 0
Recmax . . .
Maximum rec len
Alloc . . .
U=Unique,S=Subalc
Second . . .
Secondary space
CAfree . . .
pc CA free space
Xsystem . .
3,4 xsystem opt2
Replicate .
Y=Yes,N=No
51
Speed
. .
Data name
. .
CI size
. . .
Index name
. . .
CI size
. . . .
.
.
.
.
Catalog name . . . .
Password
. . . . .
S=Speed,R=Recover Reuse . . .
Y=Yes,N=No
Spanned . .
Y=Yes,N=No
*
Enter DATA name or an * for cluster.DATA
*
Enter INDEX name or an * for cluster.INDEX
Catalog and password other than system catalog
You can specify an existing VSAM file as a model in the pattern cluster field and press enter when allocating a new file. Enter
an existing dataset in the MODEL field and press enter. All the applicable fields from the model dataset will be used to prime
the panel. Make any changes necessary before allocating the new dataset.
The option fields shown are translated into IDCAMS control statements. The meaning and use of each field is determined by
the corresponding IDCAMS keywords.
If an error occurs during allocation, the IDCAMS error messages are displayed.
DEFNONV - Catalog a Non-VSAM Data Set
Select the DEFNONV Utility Panel from the AMS menu.
A panel similar to the following is displayed:
FMV/VxRx-AMS---------------- Catalog Non-VSAM Data Sets-----------------------COMMAND ===>
Data set name
. . . CSI.TRS.DATASET
Non-VSAM data set name
Volume
. . .
Volume on which the data set resides
Device
. . .
Device type for volume
Enter the dataset name, parameters and press "ENTER" to execute the request.
DATA SET NAME
Specify the data set name to be cataloged.
VOLUME
Specify the volume the data set resides on.
DEVICE
Specify the generic name of the device of the volume.
ONLINE - Executing AMS Functions On-Line
Select the on-line AMS function utility from the AMS menu. This panel provides the ability to execute IDCAMS functions
interactively an edit is provided to develop and execute IDCAMS command sets. You can copy an AMS "MODEL" that you
can modify to your needs. Enter the command COPY to receive a selection list of available MODELS. The command sets can
be saved in to a dataset of your choice and recalled for later use.
A panel similar to the following is displayed:
FMV/VxRx-------------- Execute AMS Commands Online ---------------------------COMMAND ===>
Main commands: CAN, CLEAR, COPY, EXEC, SAVE
Line commands: Standard edit commands
***** ***************************** Top of Data *******************************
00001
00002
00003
***** ***************************** Bottom of Data ****************************
52
This is a true edit session, all the standard edit main commands and line commands are available. Enter the AMS statements to
execute. For example:
FMV/VxRx-------------- Execute AMS Commands Online ---------------------------COMMAND ===>
Main commands: CLEAR=Delete all lines,
EXEC=Execute AMS statements
MODEL=Copy model statements, RESULT=Display previous results
Line commands: Standard edit commands
***** ***************************** Top of Data *******************************
00001
00002
LISTC LEVEL('FMARVEL.VxRx')
00003
***** ***************************** Bottom of Data ****************************
Enter the EXEC main command to submit the statements to IDCAMS. The results are displayed in a panel like this:
FMV/VxRx------------------ DATA SET ENTRY DISPLAY ----------------------------COMMAND ===>
SCROLL ===> CSR
Press the END key to return to the previous screen.
***** ***************************** Top of Data *******************************
00001
00002
00003
LISTCAT ENTRY(‘CSI.MSXGCF$’)
00004 CLUSTER ------- CSI.MSXGCF$
00005
DATA ------- CSI.MSXGCF$.DATA
00006
INDEX ------ CSI.MSXGCF$.INDEX
00007
TAPELIBRARY ----------0
00008
TAPEVOLUME -----------0
You copy a previously saved MODEL by using COPY command. The saved IDCAMS command sets directory can be
viewed using the MODELS function.
MODELS - Maintaining AMS Models
Models are saved sets of IDCAMS control statements that can be recalled, modified as needed, and executed online.
To display a selection list of IDCAMS models select MODEL from the AMS menu or use the COPY command from the
ONLINE panel.
The result is similar to the following:
FMV/L03-AMS--Model Definition Directory ------------------------------------COMMAND ===>
SCROLL ===> CSR
Commands: SEL member
Linecmds: DEL, Sel/cur
Member
Signon
Updated
Description
*** ******************************* Top of List *******************************
___ DEFALIAS ISDDEB2 1997/12/30 Define alias entry
___ DEFCLUS ISDDEB2 1997/12/30 Define cluster entry
___ DEFGDG
ISDDEB2 1997/12/30 Define GDG entry
___ DEFNONV ISDDEB2 1997/12/30 Define non-VSAM entry
___ DELCLUS ISDDEB2 1997/12/30 Delete cluster entry
___ DELGDG
ISDDEB2 1997/12/30 Delete GDG entry
___ LISTC
ISDDEB2 1997/12/30 Listc display request
___ VERIFY
ISDDEB2 1997/12/30 Verify data set
*** ******************************* Bottom of List ****************************
Using this directory you can create new models, edit models and delete obsolete models.
The FIND command is available to search the directory for text in the member name or description field.
The following select commands are available:
S – Selects the model for edit.
DEL – Deletes the model.
To create a new model, enter the main command S newname. A blank edit session will be displayed:
FMV/L03-AMS-NEWNAME---------AMS Model Definition -----------------------------COMMAND ===>
SCROLL ===> CSR
53
Commands: CANCEL, COPY, SAVE
Description .
***** ***************************** Top of Data *******************************
00001
00002
00003
00004
00005
00006
00007
00008
***** ***************************** Bottom of Data ****************************
This is a true edit session; all the edit commands are available. Use copy commands to copy from sequential datasets or PDS
members by using any of the copy procedures available in edit. Copying Records Into An Edit Space.
DEFGDG – Defining Generation Data Groups
Select the DEFGDG Utility Panel from the AMS menu or enter the Fastpath command DEFGDG. This function can also be
accessed from the Dataset maintenance menu. This utility defines a generation data group.
A panel similar to the following is displayed:
FMV/L03-AMS----------------- Define Data set GDG Levels ----------------------COMMAND ===>
Data set level . .
YOUR.GDG.NAME
Data set group level name
Limit option . . .
001
Limit number for data set entries in group
Empty option . . .
Y
Y=yes uncat all generations when limit reached
N=no uncat oldest generation when limit reached
Scratch option . .
Y
Y=yes del and uncat data set when limit reached
N=no uncatalog data set when limit reached
Enter the data set name, parameters and press "ENTER" to
execute the request.
DATASET LEVEL
Specify the GDG level name.
LIMIT OPTION
The maximum number of datasets in this GDG.
EMPTY OPTION
How the GDG is treated when the number of datasets reaches the number specified in LIMIT.
NEMP (do not empty) uncatalogs the oldest dataset. EMP (empty) uncatalogs all datasets
when the limit is reached.
SCRATCH OPTION SCR (scratch) scratches datasets when they are uncataloged. NSCR (do not scratch) does not
delete the datasets when they are uncataloged.
DELGDG – Deleting Generation Data Groups
Select the DELGDG Utility Panel from the AMS menu. This function can also be accessed from the dataset maintenance menu.
This utility deletes a generation data group. The group level must be empty before a deletion may be completed.
A panel similar to the following is displayed:
FMV/VxRx-AMS---------------- Delete Data set GDG Levels -----------------------COMMAND ===>
54
Specify below a group level name to be created:
LEVEL
. . . CSI.TRS
Data Set group level name
LEVEL Specify the GDG level name.
CATALOG - Catalog a Data Set
Select the CATALOG Utility Panel from the Dataset Utilities Menu. A panel similar to the following is displayed:
Fastpath command: CATALOG
FMV/VxRx-CATALOG------------- Catalog a Non-VSAM Dataset -----------------------COMMAND ===>
Data Set Name. . . 'YOUR.DATASET.NAME'
Data set name to be cataloged
Volume
. . .
Volume on which the data set resides
Enter the data set name, parameters and press "ENTER" to execute the request
DATA SET
Dataset name to catalog. The dataset is not created, it is cataloged only.
VOLUME
Volume serial where the dataset is cataloged.
UNCATLG - Uncatalog a Data Set
Select the UNCATALG Utility Panel from the Dataset Utilities Menu. A panel similar to the following is displayed:
Fastpath command: UNCATALG
FMV/VxRx-UNCATLG------------ Uncatalog a Non-VSAM Dataset --------------------COMMAND ===>
DATA SET. . . 'YOUR.DATASET.NAME'
Data Set name to be uncataloged
The data set must be a Non-VSAM data set. The data set
will be uncataloged but not deleted.
DATA SET
Dataset name of a non-VSAM dataset to uncatalog. The dataset is NOT deleted.
DELETE - Delete a Data Set
Select the DELETE Utility Panel from the AMS Menu. This function can also be accessed from the Dataset Maintenance
Menu. A panel similar to the following is displayed:
Fastpath command: DELETE
FMV/L03-DELETE-------------- Delete VSAM/Non-VSAM Data sets ------------------COMMAND ===>
Data set name
. .
'YOUR.DATSET.NAME'
Data set name to be deleted or
qualifier.*=data set list
55
Perform delete . .
Y
Y=Yes, N=no delete the data set
Uncatalog only . .
N
Y=Yes retain data set, N=No standard delete
For unmounted volumes or the data set is to be uncatloged and
the data set is to be retained on disk, Y=yes (UNCATALOG-ONLY)
must be used.
Enter the data set name, parameters and press "ENTER" to
execute the request.
DATA SET NAME
The data set name to be deleted. If the data set name is not prefixed with a quote, the TSO prefix is
attached but only if the TSO PROFILE has prefixing turned on.
Examples
'TEST.PN09.DSN' fully qualified
PN09.DSN
TSO prefixing
UNCATALOG ONLY Specify whether the data set is to retained.
Y
N
Uncatalog but retain the data set
Uncatalog and delete the data set
PERFORM DELETE Confimation to delete the data set.
Y
N
Perform the delete
Do not perform the delete
RENAME - Rename a Data Set
Select the RENAME Utility Panel from the AMS Menu. This function can also be accessed from the Dataset Maintenance
Menu. A panel similar to the following is displayed:
Fastpath command: RENAME
FMV/VxRx------------ Rename VSAM/NON-VSAM Data Sets ----------------COMMAND ===>
Old dataset name
. . . 'your.dataset.name'
New dataset name
. . .
Volume serial . . .
If the volume is specified, the data set
will not be recatalogued.
Press the ENTER key to rename the data set or the END key to exit.
OLD DATA SET NAME
Name of dataset to rename. Enter an ‘*” to rename all the components of a VSAM
cluster.
NEW DATA SET NAME
Name of the new data set to be renamed to.
VOLUME
If volume is specified the dataset will not be re-cataloged.
Select the RENAME Utility Panel from the AMS Menu. This function can also be accessed from the Dataset
Maintenance Menu. A panel similar to the following is displayed:
COMPRESS - Compress a Partitioned Data Set
Select the COMPRESS Utility Panel from the Dataset Utilities Menu. A panel similar to the following is displayed:
56
Fastpath command: COMPRESS
'data set name'
FMV/VxRx------------ Compress Partitioned Data sets ---------------------COMMAND ===>
PDS Set Name
. . . 'your.pds.dataset.name'
Data set name, * or wildcard pattern
Volume
. . .
For uncataloged data sets
Disposition
. . .
OLD or SHR file disposition
Results
. . .
Y=yes, N=no display compress results
PDS DATA SET
Name of partitioned data set name.
VOLUME
If volume is not cataloged, specify the volume.
DISPOSITION
OLD allocate the data set as old with exclusive control.
SHR allocate the data set as shared.
RESULTS
Display the compress results.
LISTCAT - List Catalog Information
FileMarvel provides a convenient way to display file catalog information on data sets, data set levels and volumes. Select the
LISTCAT Utility Menu from the Dataset Utilities Menu.
Fastpath command: LISTCAT
FMV/VxRx-LISTCAT---------------- List Catalog Functions ------------------------OPTION ===>
1
2
3
4
LISTC
LISTD
LISTI
LISTV
LISTC
LISTD
LISTI
LISTV
-
List
List
List
List
data set directory information
data set detail catalog information
data set attribute information
multi-volume data set information
Select dataset list for browse, edit, delete, information, etc.
List dataset catalog information for a single dataset.
List data set attribute information.
List multi-volume data set information.
LISTC - List Catalog Level Information
Select the LISTC Utility from the Listcat Menu. FileMarvel provides a convenient way to display file catalog information online. Select a processing option from the dataset selection list. A panel similar to the following is displayed:
Fastpath command: LISTC
'data set level'
FMV/L04-LISTC------------- List Catalog Level Information --------------------COMMAND ===>
Data set level . .
‘FMARVEL.VxRx’
List type. . . . .
D
D=data set list, A=all inclusive list
Enter the data set level, parameters and press ENTER to
execute the request.
Specify a dataset name or a portion of the dataset name qualifiers. Replace any qualifier other than the first with an asterisk.
A panel similar to the following will be displayed:
57
FMV/VxRx------------------ DATA SET
COMMAND ===>
Commands: LC level, RES
Linecmds: Alloc, Browse, DEL, Edit,
*** ******************************
___ FMARVEL.VxRx.CLIB
___ FMARVEL.VxRx.CLIBV
___ FMARVEL.VxRx.CONTROL
___ FMARVEL.VxRx.DEMOFILE
___ FMARVEL.VxRx.COPYLIB
___ FMARVEL.VxRx.LLIB
*** ******************************
LEVEL DIRECTORY --------------------------SCROLL ===> CSR
LI, LD, Print, Rename
Top of List ******************************
NONVSAM ISC100 3380 93.139
NONVSAM ISC100 3380 93.139
VSAM
ISC100 3380 93.139
VSAM
ISC100 3380 93.139
NONVSAM ISC100 3380 93.139
NONVSAM ISC100 3380 93.139
Bottom of List ***************************
The selection list is scrollable to the right to reveal more catalog information. For example:
FMV/VxRx------------------ DATA SET LEVEL DIRECTORY --------------------------COMMAND ===>
SCROLL ===> CSR
Commands: LC level, RES
Linecmds: Alloc, Browse,DEL, Edit, LI, LD, Print, Rename
Recfm Shr Keyl Rkp Avgl Maxl Spc Prime Secdy Reus Span
Records >>
*** ****************************** Top of List *******************************
___ KSDS 3,3
44
0 1024 12288 CYL
5
5 N
N
826
___
3,3
44
0
0 2041 TRK
1
1 N
4
___ KSDS 3,3
10
0
675
675 CYL
2
1 N
N
62
___
3,3
10
0
0 2041 TRK
1
1 N
1
*** ****************************** Bottom of List ****************************
Use any browse command to manipulate the list. For example, use the EXCLUDE command to exclude datasets from the
display, CREATE to save the information into another file, or PRINTX to print all or selected records on the list.
Select datasets using any of the following line commands. Multiple datasets may be selected.
A
AE
AK
AR
B
DEL
E
L
P
R
S
SCR
Allocate - VSAM/Non-VSAM allocation utility screen is primed with the characteristics of the selected dataset.
Note: this is a general allocation panel. Some VSAM parameters are missing from this panel. Use AE, AK, or
AR for VSAM specific panels.
Allocate ESDS - VSAM ESDS allocation panel is primed with the characteristics of the selected dataset.
Allocate KSDS - VSAM KSDS allocation panel is primed with the characteristics of the selected dataset.
Allocate RRDS - VSAM RRDS allocation panel is primed with the characteristics of the selected dataset.
Browse - Directly enter a browse session on the selected dataset.
Delete a Dataset.
Edit - Directly enter an Edit session on the selected dataset.
LISTD - List dataset catalog information for a single dataset.
Print - Display Print File entry panel.
Rename - Display dataset rename entry panel.
LISTI - Display dataset allocation information.
Scratch - Display a panel to delete, but NOT uncatalog a non-VSAM dataset.
LISTD - List Dataset Catalog Information
Select the LISTD Utility Panel from the LISTCAT Menu. Use this utility to obtain catalog information for a dataset. A panel
similar to the following is displayed:
Fastpath command: LISTD
'data set name'
FMV/VxRx------------ DATA SET CATALOG DETAIL INFORMATION ---------------------COMMAND ===>
Dataset Level. . . 'FMARVEL.VxRx.DEMOFILE'
Specify data set name below and press ENTER
An example of the result panel follows:
FMV/VxRx------------------ DATA SET ENTRY DISPLAY ----------------------------COMMAND ===>
SCROLL ===> CSR
58
Press the END key to return to the previous screen.
***** ***************************** Top of Data *******************************
00001
00002 CLUSTER ------- CSI.MSXGCF$
00003
DATASET-OWNER-----(NULL)
CREATION--------1996.190
00004
RELEASE--------------- 2
EXPIRATION------1999.366
00005
BWO STATUS--------(NULL)
BWO TIMESTAMP-----(NULL)
00006
PROTECTION-PSWD-----(NULL)
RACF----------------(NO)
00007
DATA-----CSI.MSXGCF$.DATA
00008
INDEX----CSI.MSXGCF$.INDEX
00009
DATA --------CSI.MSXGCF$.DATA
00010
DATASET-OWNER-----(NULL)
CREATION--------1996.190
00011
RELEASE----------------2
EXPIRATION------1999.366
FileMarvel displays the catalog information in a format similar to batch IDCAMS reports. If the information does not fit on a
single panel, it is scrollable.
LISTI - List Dataset Attributes
Select the LISTI Utility panel from the FileMarvel Dataset Utilities Menu. Use this utility to display dataset allocation and
catalog information. A panel similar to the following is displayed:
Fastpath command: LISTI
'data set name'
FMV/VxRx-LISTI----------- Data Set Information ------------------------------COMMAND ===>
Dataset name
. . . 'CSI.MSXGCF$'
Data set name, * or wildcard pattern
Volume serial . . .
For uncatalogued data sets
Standard data set
Management class:
Unit allocation:
TRK
Storage class:
Primary allocation:
1
Volume serial:
VOLS02
Secondary allocation:
1
Device type:
3380
Used allocation:
0
Organization:
VSAM
Current extents:
42
Record format:
KSDS
Directory allocation:
Record length:
100
Directory used:
Block size:
2032
Directory members:
VSAM data set
Key length:
48
Record count:
662
Key location:
0
Records deleted:
396
Reuse option:
N
Records inserted:
1057
Spanned option:
N
Records updated:
24
Share option:
2,3
Records retrieved
14278
CA splits:
41
CI splits:
16
DATA SET NAME The dataset name requested. Entering “*” in this field will bring up a dataset selection list of
datasets associated with the copybook that was most recently used.
VOLUME SERIAL Optional volume serial to enter for uncataloged non-VSAM datasets.
The remainder of the fields on this panel contains the results of the request. Values will be provided only for fields
pertaining to the type of dataset for which information is requested.
LISTV - Multi-Volume Data Set List
Select the LISTV Utility Panel from the FileMarvel Dataset Utilities Menu. Use this utility to obtain a list of volumes to which
a dataset is cataloged. One particularly useful application is obtaining all the volume serial numbers to which a tape dataset is
cataloged. A panel similar to the following is displayed:
Fastpath command: LISTV
'data set name'
FMV/VxRx-LISTV-------------- List Dataset Volumes Information ----------------COMMAND ===>
59
Data set name. . .
Data set name for volume list
Enter the data set name and depress enter to execute the
request. The data set will be unaffected by this function.
An example of results for this utility follows:
FMV/VxRx-LISTV-------------- List Dataset Volumes Information ----------------COMMAND ===>
DATA SET. . . 'your.dataset.name'
VOLCNT
. . .
6
Number of volumes cataloged
Volume
VOLS02
VOLS03
VOLS04
VOLS05
VOLS06
VOLS07
Unit
CART
CART
CART
CART
CART
CART
Sequence
0
1
2
3
4
5
The dataset shown above is cataloged on cartridges.
60
COPYDS - Copy Data Set Utility
Using Copy Data
Select the COPYDS File Utility from the FileMarvel Main Menu. You can use the COPYDS option to copy entire files or
selected records. The input and output files can differ in organization. COPYDS is a convenient method to merge keyed files.
Invoke COPYDS repeatedly and specify a different source dataset to create a merged file.
Target record lengths may either be truncated or elongated. Installation specified pad characters can be used to fill the target
record length.
Records may be expanded, reduced, fields inserted within records and reformatted as desired. Fields within a record may be
moved around using the REFORMAT technique. A field for example, a date may be expanded. For example a file containing a
field with the format MMDDYY may be expanded to MMDDYYYY. The REFORMAT technique may be used to create test
files as well. Another example may be moving COBOL source sequence from position 73-80 to position 1-6. Specific records
may be selected from one file to another using multiple Boolean logic selection criteria.
The following combinations are permitted:
Sequential FB/VB/U
Sequential FB/VB/U
Sequential FB/VB/U
PDS member FB/VB
PDS member U
PDS member FB/VB/U
VSAM KSDS/ESDS/RRDS
VSAM KSDS/ESDS/RRDS
to a
to a
to a
to a
to a
to a
to a
to a
Sequential FB/VB/U
VSAM KSDS/ESDS/RRDS
PDS member FB/VB
PDS member FB/VB
PDS member U
Sequential FB/VB/U
VSAM KSDS/ESDS/RRDS
Sequential FB/VB/U
The following combinations are not permitted:
Sequential FB/VB/U
PDS member FB/VB/U
PDS member FB/VB
to a PDS member U
to a VSAM KSDS/RRDS
to a PDS member U
The Copy Utility panel is shown below:
Fastpath command: COPYDS
61
Copy Data Set Prompt Panel
FMV/L02-COPYDS----------- Copy Data Set - Entry Panel ------------------------Command ===>
Data set one . .
'YDG.VXRX.KSDS'
Source data set name, * or wildcard pattern
For uncataloged data sets
Volume . .
Data set two . .
'YDG.VXRX.SEQ'
Target data set name, * or wildcard pattern
For uncataloged data sets
Volume . .
Copy mode
File mode
Record pad.
Format mode
COMPILE or USE
Template
Compile
. .
. .
. .
. .
with
. .
. .
S
S=standard, I=interactive
S
S=standard, R=replace, E=extend, A=allocate
00
Two byte hexadecimal record expansion character
S
S=standard, R=reformat
REFORMAT convert mode for record reformat:
CBKCOB
Member name, *=member list, BLANK=default
N
Y=yes, N=no, E=extended
APPLY CRITERIA
Start key/mem.
End key/mem. .
Start record .
Record count .
.
.
.
.
.
N
Y=yes, N=no, E=extended
00000001
00000001
Starting record number, if key not specified
Number of records to process
DATA SET ONE
.
.
.
.
.
Specifies the source dataset name to be copied. Enter a partial name with an * to receive a dataset
selection list. The following file types are supported:






VOLUME
Specify the volume if the data set is not cataloged.
DATA SET TWO
Specifies the target dataset name to be copied to. Enter a partial name with an * to receive a
dataset selection list. The following file types are supported:






VOLUME
Sequential files
PDS files with member specified
PDS file for a member selection list
VSAM files (KSDS, ESDS, RRDS)
BDAM files
GDG files
Sequential files
PDS files with member specified
PDS file for a member selection list
VSAM files (KSDS, ESDS, RRDS)
BDAM files
GDG files
Specify the volume if the data set is not cataloged.
COPY MODE Controls how the file will be saved. If the entire dataset is not loaded due to record selection, the File
Mode will be automatically set to MODIFY. The File Mode can also be set via a primary command.
FILE MODE
S - standard
This mode will attempt to rewrite the file sequentially from the records source
dataset. The entire source dataset will be copied unless APPLY CRITERIA is 'Y'
or 'E'
I - interactive
The records in the source dataset will be displayed in order to select specific
records to be copied.
Controls how the target file will be saved or replaced.
62
A - allocate
Permits the allocation of a new dataset.
E - extend
A save executed in this edit session will attempt to write the records to the end of
the file. In VSAM/KSDS files the records are added to the file by key and existing
records are not replaced.
S - standard
This mode will attempt to write the file sequentially from the source file. If
records exist in the file, sequential files are overwritten, PDS members are not
replaced, VSAM/ESDS files are extended or VSAM/KSDS/RRDS are loaded as in
an initial load.
R - replace
This mode will attempt to write the file sequentially from the source file. If
records exist in the file, sequential files are overwritten, PDS members are
replaced, VSAM/ESDS files are extended or duplicate keys VSAM/KSDS/RRDS
are replaced.
RECORD PAD The hexadecimal pad character used to expand a target record if the target record is larger than the
source record.
FORMAT MODE Controls whether a template is to be used in reformatting the record prior to writing the record to
the target file.
S - standard
This mode will attempt to rewrite the file without the use of any templates,
R - reformat
This mode will use the REFORMAT template to reformat the record prior to
writing the records.
COPYBOOK
Enter the copybook or reformat template member name is to be used or compiled during this record
selection session. If a file is already associated with a copybook template, this field is not needed.
Enter '*' for a list of available compiled copybooks.
COMPILE
Indicates whether the copybook or reformat template specified is to be compiled for use by
FileMarvel. When the copycode is compiled it will create a “copycode template” and will be saved in
the FileMarvel CONTROL file. The copybook is required to be compiled only once. Subsequent file
accesses using this copybook name will use the copybook template most recently compiled.
The copybook or reformat template will be obtained from the dataset specified on the Copybook
Dataset parameter on the Copybook Option Settings Panel.
Y - The copybook will be compiled by FileMarvel before the record selection session is started.
N - The copybook will not be compiled.
E - Will provide the Extended Copybook Compile Panel before the edit session is started. The
extended compile is used to define complex copybook templates, e.g. defining multiple record
types within a file.
APPLY CRITERIA The remaining fields pertain to selecting a subset of the file. When browsing files (of any type) or
editing keyed files, a subset of the file can be processed. Specify selection criteria and choose whether
or not to apply the criteria. PDS members may also be selected.
RECORD
Y - Record/member selection will occur. If the dataset is a PDS, the selection criteria is applied to the
member name. The selection criteria is specified in the fields START KEY/END KEY, START
and RECORD COUNT.
N - No record selection will occur. The entire dataset is presented.
E - Record selection will occur. A Record Selection Extended panel is displayed where multiple selection
criteria can be specified.
63
START KEY
Use with To Key to specify a range of records to select from a VSAM KSDS dataset. Enter the lowest
key to include in the range of records to edit. A partial key may be entered. If the key contains nondisplayable characters enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
Use to specify a range of members to select from a PDS. Enter the name of the first member to
include. A partial name may be entered.
If this field is specified, the To Key must also be specified..
END KEY
Use with From Key to specify a range of records to select from a VSAM KSDS dataset. Enter the
highest key to include in the range of records to edit. A partial key may be entered. If the key
contains non-displayable characters, enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
Use to specify a range of members to select from a PDS Enter the name of the last member to
include. A partial name may be entered.
If this field is specified, the From Key must also be specified.
START RECORD Specifies the starting record number to include in the edit session. If the dataset is a PDS, this is
the starting member number relative to 1 included in the PDS member selection panel.
RECORD COUNT If START RECORD is specified, this is the maximum number of records to include in the edit
session. If the dataset is a PDS, this is the maximum number of members displayed in the PDS
member selection panel.
Copy Data Set and Reformatting Records
Records may be expanded, reduced, fields inserted and reformatted during a copy. Fields within a record may be moved around
using the REFORMAT technique. Fields, for example, containing a date may be expanded. For example files containing
MMDDYY may be expanded to MMDDYYYY. The REFORMAT technique may be used to create test files as well.
In order to reformat records, enter an "R" in the Apply Criteria field of the COPYDS prompt panel. The following prompt panel
is displayed:
The reformat prompt panel permits the selection of fields within records and aligning them adjacent for ease of viewing.
Reformat templates may be defined on a temporary basis or saved for re-use at some later time. Basically the fields are defined
and by pressing the END pf , initiates a reformatted copy of the data set.
FMV/VxRx-COPYDS-STANDARD ---- Record Reformat Template------------------------COMMAND ===>
Commands: CAN, COPY, END, LC, RES, SAVE
Field
1
2
3
4
5
6
Start
1
0
225
0
100
75
Length . . R
Length Format Description
10
5
I
5
15
I
25
99999
insert field 1
insert field 2
L=use file lrecl length, R=use reformat length
In the example above the source field records are reformatted to the target record:
Source record
Field 1 for a length of 10
Target record
Field Location 1 for a length of 10 is copied
Field Location 11 for a length of 5 is reserved
64
Field 225 for a length of 5
Field Location 16 for a length of 5 is copied
Field Location 21 for a length of 15 is reserved
Field 100 for a length of 25
Field Location 36 for a length of 25 is copied
Field 75 for the remainder of the record
Field Location 61 for the remainder of the record is copied
The field definitions are listed below.
FIELD
The field number being defined.
START
The displacement of the beginning of a field to be included in the reformatted record. The
displacement is relative to 1. The Start fields may be specified in any order and from any part of the
record. The Start fields do not have to be in ascending order, that way a record can be re-arranged.
LENGTH
The length of the field.
FORMAT
Specifies the format of the field and the manner in which it will be displayed.
LENGTH
Blank
Indicates a character field.
I
Indicates an “insert” field, not part of the original record. This field can be filled in later
during edit. It is a non-display field for future use.
The LENGTH parameter defines the techniques used to create the target record for variable record
length and undefined files.
L
R
Indicates expands the target record to the maximum file lrecl.
Indicates creates the target record as defined by the template.
65
OFFLINE – Batch Job Processing
Offline Options Panel
The Offline Options Panel may be obtained by entering option 5 from the FileMarvel Primary Options Panel or entering the
command OFFLINE from any FileMarvel panel. The OFFLINE function permits the user to submit various batch functions.
The JOBCARD is required for any job submission so it should primed prior to any other selection.
Refer to the Batch Reference manuals for the decription of each function.
Fastpath command
OFFLINE
FMV/VxRx-------------------- FileMarvel Offline Functions -------------OPTION ===>
0
1
2
3
4
5
6
7
8
9
10
11
SET
SOURCE
MANUAL
PRINTDS
CMPLBOOK
SUBMIT
LABEL
COMPARDO
COPYDO
LISTVTOO
SPACEO
LMODMAPO
SET
- Modify the job card
SOURCE
- Offline source library
MANUAL
- Print FileMarvel manuals
PRINTDS
- Print selected records or entire files
CMPLBOOK - Compile copybooks offline
SUBMIT
- Submit batch jobs from a PDS data set
LABEL
- Display cartridge or tape labels
COMPARDO - Compare selected records or entire files
COPYDO
- Copy selected records or entire files
LISTVTOO - Print volume data set list
SPACEO
- Print volume free space
LMODMAPO - Load module statistics and code reversion
Set Jobcard Information.
Offline source storage directory.
Print FileMarvel Manuals.
Print Entire or Partial Files.
Compile Copybooks in Batch Mode.
Submit batch JCL to the OFFLINE processor. .
Display cartridge or tape labels within OFFLINE processing.
Compare two data sets in batch mode.
Copy one data set or records of one data set to another data set.
Print volume data set list.
Print volume free space.
Print load module statistics and revert code
66
COMPARDS - Compare Data Set Utility
Compare Data Set Prompt Panel
Fastpath command: COMPARDS
The Compare Dataset Prompt Panel can be obtained by selecting it from the primary option panel or by the fastpath command.
The "COMPARDS" function permits the comparison of two entire files, selective records within files or selective fields within
records. The Dataset organizations do not have to match. The result of the compare will be displayed showing the records of
both datasets.
Records may be compared inclusively or interactively.
Records may be compared in a standard fashion or copybook formatted fashion.
Specific fields within records may be compared using a COPYBOOK or REFORMAT template.
Specific records may be selected for comparison using a Selection Criteria. Selected fields within selected records may also be
compared.
The following combinations are permitted:
Sequential FB/VB/U
to a Sequential FB/VB/U
Sequential FB/VB/U
to a VSAM KSDS/ESDS/RRDS
Sequential FB/VB
to a PDS member FB/VB
PDS member FB/VB/U
to a PDS member FB/VB/U
PDS member FB/VB/U
to a Sequential FB/VB/U
VSAM KSDS/ESDS/RRDS to a VSAM KSDS/ESDS/RRDS
VSAM KSDS/ESDS/RRDS to a Sequential FB/VB/U
The following combinations are not permitted:
Sequential FB/VB/U
PDS member FB/VB/U
PDS member FB/VB
to a PDS member U
to a VSAM KSDS/RRDS
to a PDS member U
The compare is done on a record by record, byte by byte as the records are read. A display is triggered when a discrepancy is
encountered. If an entire file is compared successfully, a message noting the fact is presented.
FMV/VxRx-COMPARDS------------- Compare Data Sets On-line ------------------COMMAND ===>
Data set name . . 'FMV.VxRx.DEMOFILE'
Data set name, * or wildcard pattern
Volume . .
For uncataloged data sets
Data set two . . 'TEST.FILE.DATASET'
Data set name, * or wildcard pattern
Volume . .
For uncataloged data sets
Compare mode . .
Format mode . .
Record length. .
Consecutive stop
Total error stop
S
S
Y
00000010
00000099
S=standard, E, enhanced, I=interactive
S=standard, F=format, R=reformat
Y=yes, N=no – unequal records are errors
Stop after consecutive errors
Stop after total errors
COMPILE or Use with FORMAT or REFORMAT compare mode for field compares:
Copybook . . CBKCOB
member name, *=member list, BLANK=default
Compile . . Y
Y=yes, N=no, E=extended
Apply criteria.
Start key .
End key .
Start record .
Record count .
. Y
.
.
. 00000001
. 00005000
Y=yes, N=no, E=extended
Starting record number, if key not specified
Number of records to process
67
DATA SET NAME Specifies the dataset name to be compared. Enter a partial name with an * to receive a dataset
selection list. The following file types are supported:






VOLUME
Specify the volume if the data set is not cataloged.
DATA SET TWO
Specifies the second dataset name to be compared. Enter a partial name with an * to receive a
dataset selection list. The following file types are supported:






VOLUME
Sequential files
PDS files with member specified
PDS file for a member selection list
VSAM files (KSDS, ESDS, RRDS)
BDAM files
GDG files
Sequential files
PDS files with member specified
PDS file for a member selection list
VSAM files (KSDS, ESDS, RRDS)
BDAM files
GDG files
Specify the volume if the data set is not cataloged.
COMPARE MODE
Controls the technique used to access the dataset.
S - standard
E – enhanced
I – Interactive
FORMAT MODE
Loads both files into an edit work space permitting the compare to be
controlled manually.
Controls the compare formatting technique used to access the records.
S - standard
F – format
R – reformat
RECORD LENGTH
Standard mode compares both file records and displays records when
discrepancies are found.
Attempt to isolate imbedded records and resynchronize the compare.
Standard mode compares both file records byte for byte and displays
records in standard display mode.
Format mode compares the records using a copybook template with
logical field compares. A copybook must be specified.
Reformat mode compares fields within records using a reformat template.
A reformat template name must be specified.
Determines how unequal records are to be treated i.e., should unequal record lengths be
considered as errors.
Y - Yes, consider unequal records as errors.
N - No, do not consider unequal records as errors.
CONSECUTIVE STOP
A control to terminate the compare after n number of consecutive record discrepancies
occur. Enter a 1-9999999 records count for the stop count.
TOTAL ERROR COUNTA control to terminate the compare after n number of non consecutive record discrepancies
occur. Enter 1-99999999 record count for the stop count.
68
COPYBOOK
Enter the copybook or reformat template member name is to be used or compiled during this record
selection session. If a file is already associated with a copybook template, this field is not needed.
Enter '*' for a list of available compiled copybooks.
COMPILE
Indicates whether the copybook or reformat template specified is to be compiled for use by
FileMarvel. When the copycode is compiled it will create a “copycode template” and will be saved in
the FileMarvel CONTROL file. The copybook is required to be compiled only once. Subsequent file
accesses using this copybook name will use the copybook template most recently compiled.
The copybook or reformat template will be obtained from the dataset specified on the Copybook
Dataset parameter on the Copybook Option Settings Panel.
Y - The copybook will be compiled by FileMarvel before the record selection session is started.
N - The copybook will not be compiled.
E - Will provide the Extended Copybook Compile Panel before the edit session is started. The
extended compile is used to define complex copybook templates, e.g. defining multiple record
types within a file.
APPLY CRITERIA The remaining fields pertain to selecting a subset of the files to be compared.
Y - Record/member selection will occur. The selection criteria is specified in the fields START
KEY/END KEY, START RECORD and RECORD COUNT.
N - No record selection will occur. The entire dataset is presented.
E - Record selection will occur. A Record Selection Extended panel is displayed where multiple
selection criteria can be specified.
START KEY
Use with To Key to specify a range of records to select from a VSAM KSDS dataset. Enter the lowest
key to include in the range of records to compare. A partial key may be entered. If the key contains
non-displayable characters enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
If this field is specified, the To Key must also be specified..
END KEY
Use with From Key to specify a range of records to select from a VSAM KSDS dataset. Enter the
highest key to include in the range of records to compare. A partial key may be entered. If the key
contains non-displayable characters, enter the key in hex in the following format:
X’hhhhhhh….’ Where hhhhhhh = the hexadecimal representation of the key or partial key.
START RECORD Specifies the starting record number to be compared.
RECORD COUNT If START RECORD is specified, this is the maximum number of records to compare.
Compare Data Set Record Display
In this section the results of an online compare is discussed.
Regardless of the COMPARE mode selected (standard or interactive), record format display or selected field compare, the
resulting edit display processing is the same for all cases. On entry a statistics are displayed indicating record load and error
counts. Enter the RESET command to remove the message display. Enter the LISTAST/LA command to display the available
commands.
If an interactive compare mode was requested, enter the command COMPARE/CO to initiate the compare.
The results are shown as groups of three records with the first position of each record number indicating the file sequence
number and an error indicator line flagged as =ERR=>. The error indicator line contains underscores under the discrepancy
69
record positions. The underscore indicator may be altered in the profile SET function. The FIND pf may be used to locate the
next discrepancy. If a new compare is desired, enter the command RESET ALL followed by the command COMPARE/CO
and a new result is issued.
Specific fields may be compared by entering the command LISTREF and setting the selected fields. On return the RESET
ALL and the COMPARE command should be entered to initiate another compare. Display formats may be altered by entering
the commands STD, HEX, REF or HEXR.
The comparison can be resumed by pressing the RCHANGE PF key. You can also resume a comparison by entering the
command RCOMPARE/RC. Comparison resumption is position sensitive. The compare is resumed at the position in the file
that appears at the top left corner of the display.
Record displays may be repositioned as desired via scrolling. In this way you can control where in the dataset the compare is
resumed.
Imbedded or out of sequence records may be manipulated by using line commands as "D" delete line or "M" move line in order
to resynchronize the files. The files are not altered when the END pfkey is pressed so record manipulation may be done as
desired.
COMPARDS STD example:
FMV/L02-COMPARDS-FMV.VXRX.DEMOFILE-TEST.FILE.DATADET--R 00000002 C 00001 00080
COMMAND ===>
SCROLL ===> CSR
0---+----20---+----30---+----40---+----50---+----60---+----70---+----8
-------- -------------------------- Top of Selected Records ------------------File1 reads(
62) File2 reads(
62) Record load(
124)
Match count(
60) Error count(
2)
File compared with errors
Press RFIND pf or enter LOC ERR to locate error
---------------------------------------------------------------------10000002 ......08107
1....PH.......<00
AJOHN JONES
XXXX
20000002 82012808107
1....PH.......<00
AJOHN JONES
=ERR=>
______
____
10000003 82012808107
1....PH.......<00
AJIM JOHNSON
20000003 82012808108
1....PH.......<00
AJIM JOHNSON
=ERR=>
_
The above example displays multiple discrepancies indicated by the underscores.
COMPARDS HEX example:
FMV/L02-COMPARDS-FMV.VXRX.DEMOFILE-TEST.FILE.DATADET--R 00000002 C 00001 00080
COMMAND ===>
SCROLL ===> CSR
0---+----20---+----30---+----40---+----50---+----60---+----70---+----8
-------- -------------------------- Top of Selected Records -----------------10000002 ......08107
1....PH.......<00
AJOHN JONES
XXXX
000000FFFFF44444444444444F0000DC02180354FF44444CDDCD4DDDCE444444EEEE44
00000008107000000000000001000C78802C338C000000011685016552000000777700
20000002 82012808107
1....PH.......<00
AJOHN JONES
FFFFFFFFFFF44444444444444F0000DC02180354FF44444CDDCD4DDDCE444444444444
82012808107000000000000001000C78802C338C000000011685016552000000000000
=ERR=>
______
____
COMPARDS Copybook Format example:
FMV/L02-COMPARDS--GKH1.JOB.CNTL--GKH1.JOB.CNTL------------ R 0000001 C 00006 00077
COMMAND ===>
SCROLL ===> CSR
Commands: FIND(F), LA, LK, RCmp (pf)
REC
===> 00000001
REC
===> 00000001
F Column Field Name
Length ....+....1....+...
---------------------------------- Top of File -------------------------------1
49
30 Field222(3)....................
2C 21
2
49
30 Field222(3)....................
2C 17
__
1
51 ?
30 Field22x(3)....................
S6V2D X'F2F9F5F94040'
2
51 ?
30 Field22x(3)....................
S6V2D X'F1F7F0F94040'
_ _ _
70
1
2
61 ?
61 ?
25 Field23(3)......................
25 Field23(3)......................
S6V2D X'C540F0F4F1F1'
S6V2D X'C540F0F4F1F6'
_
---------------------------------- Bottom of File -----------------------------
COMPARDS Reformat STD example:
FMV/L02-COMPARDS--GKH1.JOB.CNTL--GKH1.JOB.CNTL-----------COMMAND ===>
******
100002
200002
=ERR=>
100003
200003
=ERR=>
R 0000001 C 00006 00077
SCROLL ===> CSR
6----------30-----------------**************************** Top of Selected Records *******************
808107
|.PX.......<00
AJ|
908107
|.PH.......<00
AJ|
_
_
808107
|.XX.......<00
AJ|
808107
|.PH.......<00
AJ|
__
COMPARDS Reformat HEXR example:
FMV/L02-COMPARDS--GKH1.JOB.CNTL--GKH1.JOB.CNTL-----------COMMAND ===>
R 0000001 C 00006 00077
SCROLL ===> CSR
6----------30--------------****** **************************** Top of Selected Records *******************
100002 81070
|..........
|
FFFFF44444 0DC02180354444444
8107000000 00000000000000000
200002 91081
|.PH.......
|
FFFFF44444 340D44554C4444444
9108100000 00540000050000000
=ERR=> _ __
__________
Comparing Specific Fields Using Reformat Templates
Specific fields within records may be compared. A reformat template is used to compare specific fields. The REFORMAT
template subfunction results in a panel with field selection entries. REFORMAT permits a comparison of fields within both
records. The selected fields may be in any order and from any part of the record. Two separate fields, such as date fields, may
be set side by side for visual confirmation.
REFORMAT templates are either temporary i.e., used and discarded or are created and saved in order to be used across files or
sessions. Several templates may be created for a file to display separate views for the file.
Creating or modifying REFORMAT templates is accomplished by entering DISPLAY MODE=R, entering a template name and
setting COMPILE=Y in the copybook field of the COMPARDS prompt field.
Basically, from within the command LISTREF, a series of entries are made for the start of a field, the length of the field and the
display mode. For example, if a comparison of two date fields is required, the template can be set to compare the fields within
the records.
19991020|20001020
or
1999|2000|10|10|20|20
Priming the template and pressing the END pf initiates the compare. When a discrepancy occurs, the records are displayed. No
modification may be made to the records at this time.
The SAVE command must be issued in order to permanently save the template. The COPY command will display a directory of
saved templates from which one may be selected.
Comparing Specific Fields Reformat Prompt Panel
71
The reformat prompt panel permits the selection of fields within records and aligning the fields adjacent to each other for ease
of viewing. Reformat templates may be defined on a temporary basis or defined and then saved for reuse at some later time. The
template requires definition only once but may be modified as required.
FMV/VxRx-EDIT-STANDARD ---- Field Compare Template--------------------------COMMAND ===>
Commands: CAN, COPY, END, RES, SAVE
Field Start
1
2
3
4
1
25
225
59
Length
10
5
5
10
Define the fields as displayed above and press enter. The fields are briefly described below. When the fields are primed
properly, the template may be saved for future use or used as a temporary template to display the records in reformatted mode.
Press the END pf to return to the reformatted record display.
FIELD
The field number being defined.
START
The numeric displacement of the field to be displayed within the record relative to one. The fields do
not have to be in ascending order and may be in mixed order.
LENGTH
The numeric length of the field to be displayed.
Comparing Using Copybook Templates
Entire records or specific fields within records may be compared using a copybook template. Entire records are compared
using the defined fields and on error displayed in COPYBOOK FORMAT mode. The RCOMPARE or the RCHANGE PF may
then be used to resume the comparison.
If comparison of selected fields is desired, enter DISPLAY MODE=F, the copybook and CRITERIA=F which then displays the
extended prompt panel. Entry of field names may then be entered as selection criteria. Commands are available to assist in field
entry. Pressing the RFIND pf then initiates the compare.
Compiling copybook templates is accomplished by entering DISPLAY MODE=F, entering a template name and setting
COMPILE=Y in the copybook field of the COMPARDS prompt field.
Comparing Members of a PDS
PDS members may be compared by entering PDS data sets on the COMPARDS prompt panel resulting in a directory display.
Members are compared by selecting them in pairs. In the example below, six members are selected and compared as pairs. The
compare is executed in the fashion specified in the compare mode (standard vs. interactive).
FMV/L02-COMPARDS--GKH1.PDS1---GKH1.PDS2----------------------------------------COMMAND ===>
SCROLL ===> CSR
-S_
S_
__
__
S_
S_
S_
S_
--
Name
F VV.MM Created
Changed
Time Size Init Mod Userid
-------------------------------- Top of Selected Records ------------------CBKCOB
1 01.05 1996/10/28 2002/02/01 21:42
409
413
0 TSODG
CBKCOB
2 01.05 1996/10/28 2002/02/01 21:42
409
413
0 TSODG
CBKJFCB
1 01.02 1996/10/28 1996/10/28 12:00
69
72
0 ISDDEB
CBKJFCB
2 01.02 1996/10/28 1996/10/28 12:00
69
72
0 ISDDEB
CBKPLI
1 01.06 1996/10/28 2002/02/01 21:42
266
270
0 TSODG
CBKPLI
2 01.06 1996/10/28 2002/02/01 21:42
266
270
0 TSODG
CBKVTOC
1 01.03 1996/10/28 1998/09/13 00:17
145
148
0 ISDDEB
CBKVTOC
2 01.03 1996/10/28 1998/09/13 00:17
145
148
0 ISDDEB
-------------------------------- Bottom of Selected Records ----------------
72
SORTDS - Sort Files Utility
Sort Files Panel
Select SORTDS from the FileMarvel Primary Option Menu or enter the Fastpath command SORTDS.
Use FileMarvel to sort files on-line using symbolic field names. FileMarvel translates the selected symbolic field names into
field start position, length, and format. A sort statement is built to pass to the sort utility. View and edit the sort statement
before it is passed to the sort utility. The generated report is available to view on-line.
A panel similar to the following is displayed:
FMV/VxRx----------------------- SORT DATA SET ONLINE ----------------------------COMMAND ===>
Specify below the data set name to be sorted:
Input data set. . . 'FMARVEL.VxRx.DEMOFILE'
Data set name, * or wildcard pattern
Volume. . .
For uncataloged data sets
Specify below the result data set name, '=' to sort into the same data set
Output data set. . . 'YOUR.TARGET.DATASET'
Data set name, * or wildcard pattern
Volume. . .
For uncataloged data sets
To select sorting fields using a formatted record layout optional:
Copybook.
Compile .
Language.
Copylib .
.
.
.
.
.
. N
. C
.
Member name, *=Member list, BLANK=default
Y=Yes, N=No, E=extended compile copybook now
C=COBOL, P=PLI copybook compile language
Qualifier.*=Data set list
Press the ENTER key to specify sorting criteria or the END key to exit.
INPUT DATA SET
The dataset to sort. Enter '*' to obtain a dataset selection list.
OUTPUT DATASET The dataset to contain the sorted dataset. Enter '*' to obtain a dataset selection list. Enter
ALLOC to allocate a new dataset.
Automatic copybook compile is available at the same time as a sort. The fields for specifying and compiling a copybook are
the same as in the edit entry panel.
If a copybook name is specified, a copybook field selection list is displayed. If copybook fields are not used, a sort criteria
panel is displayed.
Copybook Sort Field Selection
If a copybook name is provided on the SORTDS, a panel similar to the following is displayed.
Specify up to six sort fields in ascending or descending order by entering the “A” or “D” line commands, respectively.
For example:
FMV/VxRx-SORTDS-$ACPMSTR--- Copybook Sort Field Selection --------------------COMMAND ===>
SCROLL ===> CSR
Select up to 6 sorting fields. When done press ENTER or END
Main commands: CANCEL, END, RESet=Reset sort order, or standard browse commands
Line commands: A Ascending order sort D=Descending order sort
Offset
Length Level Type
Using Picture
Field Name
* **********************************Top of Data *******************************
_
0
24
8 Group
BT01-PENDING-KEY
_
0
12
Char
X(03)
BT01-COMPANY
_
3
2
12
Char
X(02)
BT01-SUB-COMPANY
_ ED20:
- ascending order numb 1
BT01-COMPANY
_
5
12
12 Group
BT01-POLICY-NUMBER
_
5
9
16
Zoned
9(09)
BT01-MEMBER-NUMBER
_
14
3
16
Char
X(03)
BT01-POLICY-SUFFIX
_ ED20:
- descending order numb 1
BT01-POLICY-SUFFIX
73
Specify the line commands to determine the sort order. If the sort order does not match the order of the fields on the panel,
press enter to register each field one at a time. Forward and backward scrolling is available. One or more confirmation
messages is displayed each time a field is selected to indicate the order and direction.
Use the RESET main command and reenter the sorting specifications if an error is made. The CANCEL command cancels the
sort request entirely. A panel displays the sort criteria after a six-field maximum is selected.
Press END to display the Sort Criteria Panel.
Sort Criteria Panel
A panel similar to the following is displayed if no copybook name is provided on the SORTDS:
FMV/VxRx-SORTDS------------ SPECIFY SORTING CRITERIA ------------------------COMMAND ===>
Enter SORT on the command line to execute the sort or press the END key to exit
Specify/verify below the field sorting criteria:
1.
2.
3.
4.
5.
6.
Field
Start
00001
00020
_____
_____
_____
_____
Field
Length
00003
00005
_____
_____
_____
_____
Data Format
BI, CH, PD, ZD
CH
CH
__
__
__
__
Browse control statements. . . N
Browse SORT report
. . . N
Sort Order
A, D
A
D
__
__
__
__
Y=Yes, N=No
Y=Yes, N=No
Input: CSI.MSXGCF$
Output: GKH1.JOB.CNTL(IEHLIST)
+--------------------ASSIST-+
| Data Format Codes:
|
|
BI - Binary
|
|
CH - Character
|
|
PD - Packed Decimal
|
|
ZD - Zoned Decimal
|
| Sort Order Codes:
|
|
A - Ascending Order
|
|
D - Descending Order
|
+---------------------------+
Volume: VOLS02 RECFM: V
Volume: VOLS02 RECFM: F
WARNING: Variable files are prefixed with a 4 byte prefix.
Remember to add 4 to the field starting positions.
Specifications that already appear may be changed or new ones added (up to a total of six fields).
To initiate the sort, enter the Primary command SORT on the command line. Sorting performance depends on the installed sort
utility.
Browse control statements
Y - Browse or modify the sort control statements before sorting. See
Section 10.2.1 Browse/Modify Generated Sort Control Statements.
N - Do not browse the sort control statements.
Browse Sort Report
Y - Browse the sort results.
N - Do not browse the generated sort report.
Browse/Modify Generated Sort Control Statements
Specify “Y” on the Browse Control Statements field on the Sort Criteria Panel to browse or modify the sort control statements.
A panel similar to the following is displayed:
FMV/VxRx-SORTDS------------- CONFIRM SORT STATEMENTS -------------------------COMMAND ===>
Review the statements below. Enter SORT on the command line to execute the sort
or press the END key to cancel.
Sort statement:
SORT SIZE=E05000,FIELDS=(00001,00003,CH,A,00020,00005,CH,A)
Record statement:
RECORD TYPE=V,LENGTH=00675
74
Input: CSI.MSXGCF$
Output: YOUR.SORT.DATASET
Volume: VOLS02 RECFM: V
Volume: VOLS02 RECFM: F
Use FileMarvel to generate complex sort utility statements based on record layouts. Initiate the sort or use the generated sort
control cards in the batch sort jobs. This creates statements without having to calculate field length, types, and locations.
Browse Sort Report
Specify “Y” on the Browse Sort Report field on the Sort Criteria Panel to browse the sort report.
An example of a Sort Report follows:
FMV/VxRx-BROWSE--- DUMP01--- GKH1.GKH1.MST.SORTPR Rec 0000000 Cols 00002 00080
COMMAND ===>
SCROLL ===> CSR
10 record(s) loaded
Display mode: S
Format, Standard, Hex, Compact
Copybook name:
member name, *member list
********************************** Top of File *******************************
SYNCSORT 3.5ARI TPF2A US PATENTS: 4210961,5117495, OTHER PAT. PEND.
C) SYNC ESA 3.1.3
CPU MOD
SORT SIZE=E05000,FIELDS=(00001,00003,CH,A,00020,00005,CH,A)
RECORD TYPE=V,LENGTH=00675
WER164B 220K BYTES OF VIRTUAL STORAGE AVAILABLE, 220K BYTES REQUESTED,
WER108I SORTIN
: RECFM=V
; LRECL=
675; BLKSIZE=
679
WER110I SORTOUT : RECFM=V
; LRECL=
675; BLKSIZE=
679
WER168I CONTROL FIELD WITHIN RDW
WER039A INSUFFICIENT VIRTUAL STORAGE
WER211B SYNCSMF CALLED BY SYNCSORT; RC=0000
********************************** Bottom of File ****************************
75
TEMPLATE – Copybook Usage
Using Copybooks
FileMarvel can use field names when accessing data records. To define field names, record layouts are used in the same way
any program uses a record layout.
Before a copybook can be used, it must be compiled. Simple copybooks can be compiled automatically, when browse, edit, or
sort is invoked. More complicated copybooks (i.e. multiple record types) are defined and compiled interactively or in batch.
Copybook can be accessed from a PDS, CA-Librarian or Panvalet.
When the copycode is compiled it creates a “copycode template” and is saved in the FileMarvel CONTROL file. Compilation
is required only once. Subsequent file accesses using this copybook name use the copybook template most recently compiled.
Copycode templates can be modified and new copycode templates created from them. In this way the "view" of a dataset can be
tailored to the needs of the user.
Copycode template options can be modified. After compiling copybook templates, the relationships between files and
copybooks must be managed.
General Questions about Copybooks
COPYBOOK TEMPLATES are compiled copybooks, which overlay data using COBOL or PLI field definitions. Templates
are created by compiling the copybooks implicitly using functions such as BROWSE, EDIT, PRINTDS, or by compiling the
copybooks explicitly using the function COPYBOOK
or by compiling the copybook in batch mode.
What happens when a copybook is compiled?
The copybook template is created and saved for subsequent use to view files in FORMAT or COMPACT display modes. The
copybook template may also be used to print files in batch mode. The compiled templates may be viewed in a directory.
Compile control statements specifies the environmental aspects of a copycode template. A copycode template is the result of
compiling copycode source and compile control statements. The compile controls are saved and may be accessed in a selection
directory. The controls may be used to attach special controls and options by re-compiling the copybook.
Dataset names and copybook templates are related. This relationship can be modified.
What can be done with compiled copybook templates?
The copybook templates may be used to view data sets using functions such as BROWSE, EDIT, PRINTDS, etc.
The copybook templates may be used to print data sets in batch mode.
The copybook templates may be modified to set specific display format options as well as set controls in order to automatically
format and display file records according to field redefinition.
Copybook templates may be modified and new templates can be created from them. In this way the "view" of a dataset can be
tailored to the needs of the user.
How are options set for copybook templates?
The copybooks may be explicitly compiled using COPYBOOK COMPILE or in batch mode by setting the FORMAT keyword
with the associated options.
The compiled copybook template directory may be displayed by using the function COPYBOOK TEMPLATE. Enter the line
command "LO" (list options), modify the template options and save the member.
76
While displaying a file in functions as BROWSE, enter the command "LO" (list options), modify the template options and save
the member.
How are records automatically reformatted for redefined fields?
The copybooks must be explicitly recompiled using the keyword DISPLAY that associates the redefined field depending on a
value with a specific field.
Can copybook source be saved?
Copybook source may be stored and re-used for subsequent compiles by using the function COPYBOOK SOURCE.
The modified source member may be re-compiled by entering the COMPILE command.
What are the functions associated with copybooks?
Functions BROWSE, EDIT, VIEW, PRINTDS, SORTDS, BATCH may be used to view or print reports.
COPYBOOK is used to compile and maintain copybook templates.
RELATEDS is used to maintain the associated data sets with copybook templates.
Compiling Copybooks
Automatic Copybook Compile
If you specify the name of a copybook member and source library on the Edit or Browse panel and no template currently exists
with that name a compile will be automatically performed for you.
Explicit Copybook Compile
FileMarvel supports multiple record types within a single dataset. This information must be explicitly defined. Complex
record relationships are defined by inserting FileMarvel commands within the copybook. The source copybook does NOT need
to be changed. The interactive process to fill in the information is simple and accompanied by assist windows. Once compiled,
this copybook template is used like any other copybook template. For more information concerning explicit compile from the
edit entry panel see Section EDIT Edit Entry Panel and EDIT Extended Copybook Compile Panel.
Copybook Maintenance Selection Panel
The "COPYBOOK" function performs copybook maintenance in preparation for the formatting of records within data set files.
Copybooks must be compiled prior to formatting data set records in format mode. The copybooks are compiled explicitly using
this function or implicitly using the functions such as BROWSE, EDIT, SORT etc. with the results being viewed and
maintained using this COPYBOOK function.
Compiles are initiated with either control cards, which extract the copybooks from external libraries or as saved internal source,
which may be, modified leaving the external source intact.
FMV/VxRx-COPYBOOK----------- Copybook Maintenance Selection-----------------COMMAND ===>
1
2
3
4
5
6
COMPILE
SOURCE
OBJECT
RELATEDS
REFORMAT
FINDEXT
-
Copybook compile directory
Copybook source directory
Copybook object template directory
Relate data sets and copybooks
Reformat template directory
Find template directory
COMPILE
Displays a directory of copybook controls.
SOURCE
Display a directory of internal copycode source.
OBJECT
Displays a directory of compiled templates.
77
RELATEDS
Provides the ability to associate dataset names with templates.
REFORMAT
A directory of saved REFORMAT templates used in file display. When templates are saved in
BROWSE, COMPARDS or EDIT, they are saved in this library. Reformat templates may be created
and modified for use in file access .
FINDEXT
A directory of saved Extended find templates used in file display. When templates are saved in
BROWSE, COMPARDS or EDIT, they are saved in this library. Reformat templates may be created
and modified for use in file access .
Renaming a Member to a New Member Name
A copybook , reformat or findtext member may be renamed to a new member name by entering the line command REN on any
of the directory displayes. The following panel is displayed as a result of the rename line command.
FMV/VxRx-COPYBOOK----------- Template Rename Function -----------------COMMAND ===>
Original member:
Member name. . .
Library. . . . .
Type . . . . . .
ZZ2
TSODG
COMPILE
Old template name
Old template library
Template type
Rename template to new name:
Member name. . .
Library. . . . .
Description . . .
Replace option .
New template name
New template library
N
Y=yes, replace existing member
N=no, do not replace
Panel fields
Original member:
Member
The member name which is to be renamed
Library
The library name in which the member resides
Type
The member entity type
COMPILE
SOURCE
OBJECT
REFORMAT
FINDEXT
Compile controls for a copybook
Compile source for a copybook
Object resulting from a compile
Record REFORMAT template
Extended FIND template
Rename member:
Member
The member name to be renamed to
Library
The library name in which the member resides
Description
The member description used in directory displays
Replace
Enter the option to replace existing members
78
Y
N
Yes, replace existing members
No, do not replace existing members
COMPILE - Copybook Control Directory
Batch Copybook Compile
A batch utility is provided to compile copybooks. Batch compilation is made available for compiling a large number of
copycodes and for long copybooks.
Copycode Template Ownership
GROUP Copybook Templates
Normally, users only have access to their own copybooks. To make a compiled record layout available to all users within their
group or project, it must be set to the group. Group copybook templates may be displayed or excluded from the directory list.
Use the command GROUPS to display the currently defined groups. Use the command UGROUP to define new groups.
Normally, users only have access to their own copybooks. To make a compiled record layout available to all users, it must be
global. Global copybook templates may be displayed or excluded from the directory list.
The copybook compile control directory is obtained by selecting it from the copybook maintenance panel.
A copybook control is a set of control statements that specify environmental options of a copybook. It references and is
associated with copybook source. Compiled together with copybook source produces a copybook template, which can then be
used to overlay a data file. The statement available can be found in Section Appendix A - Compile Control Statements.
This directory provides a selection list of copybook controls.
Perform maintenance functions on the copybook templates from the Copybook Directory:
Create new copybook templates. Change (edit) copybook templates. Use line commands or primary commands in edit to
compile copybooks.
A panel similar to the following is displayed:
FMV/L02-COPYBOOK-------------Copybook Compile Controls -----------------------COMMAND ===>
SCROLL ===> CSR
Commands: Loc member, Sel member, SG=show global, SORT
Linecmds: B, CMP, DEL, E, GBL, GRP, LC, Sel
Member
Lan Ver Created
Changed
Compiled
Reference Userid
Titl
*** ******************************* Top of List *******************************
___ $ABPMSTR COB V1R2 1993/04/23 1993/10/01 1993/08/18 1999/02/11 GLOBAL
ABP
___ $ACPMSTR COB V1R2 1994/01/22 1994/01/31 1994/01/22 1998/04/29 GLOBAL
ACP
___ $CBKFNB COB VXRX 1998/04/28 1998/04/28 1998/05/04 1999/10/06 GLOBAL
FNB
___ CBKCOB
COB VXRX 1999/11/02 1999/11/02 1999/11/02 1999/11/10 GKH1
___ CBKCOB
COB VXRX 1998/08/31 1998/09/25 1998/09/28 1999/10/28 GLOBAL
COB
___ CBKJFCB COB VXRX 1998/08/31 1998/09/19 1998/08/31 1999/09/16 GLOBAL
FORM
___ CBKPLI
PLI VXRX 1998/08/31 1998/08/31 1998/08/31 1998/09/26 GLOBAL
PLI
___ CBKVTOC COB VXRX 1998/09/13 1998/09/13 1998/09/13 1999/11/09 GLOBAL
FORM
___ COPYBOOK COB V1R2 1900/02/29 1900/12/31 1900/02/29 1900/12/31 GKH1
___ RTMCCFIL COB VXRX 1999/10/05 1999/10/05 1999/10/05 1999/10/05 GKH1
*** ******************************* Bottom of List ****************************
Right and left scroll commands are available to view additional columns of information in the directory.
Fields:
Member
Name of the copybook control.
Lang
Compile language for the copybook.
Ver
Version of FileMarvel used to perform the previous compile.
79
Created
Date control was created.
Changed
Date control was last changed
Compiled
Date control was last compiled.
Reference
Date template was last referenced
Userid
Owner of the control. Specifies who has access to this control (and thus the template).
TSO Userid –
The control is owned by this particular userid.
GROUPID –
The control is owned by this group. Enter the command GROUPS to display the groups currently
defined. Enter the command UGROUP to define new groups.
GLOBAL –
The control is owned globally. Any FileMarvel user has access to it.
Title
Descriptive title for copybook
Relateds
Associated data set name.
The following commands are available:
LOC | L
name
Specify a copybook control name or partial name to be located in the selection list.
SEL | S
name
Specify the copybook control name to edit. Specify a new name to create.
Creating and Editing Copybook Control.
SG
ON | OFF | GLOBAL | GROUP
ON – Show GLOBAL as well as privately owned controls.
OFF – Show only privately owned controls.
GLOBAL - Show only GLOBAL owned controls.
GROUP – Show only those controls owned by a group.
SORT
heading-field-name
The SORT command sorts a directory according to the heading field specified.
Example: SORT CHANGED
The following line commands are available:
B
Browse the default dataset for this copybook template.
CMP
Compile this copybook template.
DEL
Delete this copybook template.
EEdit the default dataset for this copybook template.
GBL
Mark this copybook template for global access for all users.
GRP
Mark this copybook template for group access for all users.
LC
List copybook displays the copybook template with field descriptions such as length, type and offsets.
Displaying the Copybook Layout.
LD
LI
REN
S
LISTD dataset
LISTI dataset
Rename a member to another member name.
Select copybook for edit.
Creating And Editing Copybook Control
Use the SELECT command with a new name to create a new copybook template from the copybook template selection list.
80
Example:
S NEWNAME
Use the SELECT command or the “S” line command to edit an existing copybook template.
After a global copybook template is edited and saved, a new copy is created for the user ID. Only this user has access, other
users still have the global copybook available. If a user version of the copybook is set to global, it replaces the existing global
copycode template.
A panel similar to the following is displayed:
FMV/L02-COPYBOOK-NEWNAME-------Compile Copybook Control Member ---------------COMMAND ===>
SCROLL ===> CSR
Commands: CMP, COPY, SAVE
Language . . . . C
C=Cobol, P=PLI
Description. . .
****** **************************** Top of Data *******************************
000001
000002 COPY
copybook member name
000003 COPYLIB copylib dataset name
000004 DISPLAY record-type WHEN data-name cond(EQ,NE,GT,LT,GE,LE) value
000005
=MSG=> *-----> Enter any number of COPY members, COPYLIB dataset names,
=MSG=> *
DISPLAY control statements and enter the COMPILE command.
=MSG=>
=MSG=> *-----> Example:
=MSG=>
=MSG=> *
DISPLAY INV-ACCT-REC WHEN M-IDENT-FLAG =MSG=> *
EQ
A B C OR D
OR =MSG=> *
EQ
HIGH-VALUES OR =MSG=> *
EQ
LOW-VALUES
OR =MSG=> *
WHEN K-BATCH-NO
=MSG=> *
EQ
B'1111' OR X'01' OR +99360 OR P'256'
****** **************************** Bottom of Data ****************************
This is an edit space. All Edit commands are available. The following additional processing commands are available as main
commands:
COMPILE
Compile the copybook control currently displayed.
COPY
Copy another set of copybook templates.
SAVE
Save the copybook templates currently displayed without ending the edit session.
A new copybook starts with modifiable basic dummy statements. Some of the control statements included in the
copybook template are discussed here. For a complete listing of all control statements available see Appendix A:
Compile Control Statements.
COPY
The source copybook member name of the COBOL or PL/1 copycode. It may be the same copybook
used in application programs. Multiple COPY statements may be used.
COPYLIB
The source library dataset name where the COPY member(s) resides. Multiple COPYLIB statements
may be used.
DISPLAY
Defines the relation between particular field values and record structures so automatic switching among
record types will occur. Multiple DISPLAY statements may be used.
FORMAT
The default display mode for files using this copybook (formatted, compact, hexadecimal, or standard).
For compact mode, indicates the leading pad character and automatic skipping at the end of input fields.
(Optional).
TESTDSN
A dataset to use to test the copybook. Use this dataset when the TB (Test Browse), TE (Test Edit), or TI
(Test Information) command is issued on this member from the copybook member list. (Optional)
81
SYSIN
Specify COBOL statements directly in copybook templates to fill omissions or gaps in the copybooks.
(Optional)
EXAMPLE of a Copybook Control:
FMV/L02-COPYBOOK-CBKCOB-------Compile Copybook Control Member ----------------COMMAND ===>
SCROLL ===> CSR
Commands: CMP, COPY, SAVE
Language . . . . C
C=Cobol, P=PLI
Description. . . COB DEMO COPYBOOK
****** **************************** Top of Data *******************************
000001
000002
FORMAT
DISPLAY(COMPACT)
PAD(.)
SKIP(ON)
000003
COPYLIB
DS('DPID.RTST.PDS1')
000004
COPYLIB
DS('DPID.VXRX.JCL')
000005
COPY
MEM(CBKCOB)
000006
DISPLAY
INV-ITEM-REC WHEN M-IDENT-FLAG EQ I
000007
DISPLAY
INV-RCPT-REC WHEN M-IDENT-FLAG EQ R
000008
DISPLAY
INV-ACCT-REC WHEN M-IDENT-FLAG EQ 'A'
000009
MEND
****** **************************** Bottom of Data ****************************
Copying A Copybook Template
Use the COPY command to bring in other copybook templates while in edit. Copy them from the FileMarvel CONTROL file
(the default) or from an outside dataset. The COPY command in this environment has three formats available:
Format 1: COPY xxxxxxxx
Format 2: COPY
Format 3: COPY *
specify xxxxxxxx as the full name of an existing copybook template.
with no parameters provides a selection list of existing copybook templates.
provides the ability to copy from an outside dataset. The Copy Entry Panel is displayed.
A panel similar to the following is displayed:
FMV/VxRx------------ FileMarvel COPYBOOK DIRECTORY ---------------------------COMMAND ===>
SCROLL ===> CSR
Member
Lan Created Changed Compiled Reference Userid
Title
*** ******************************* Top of List *******************************
___ $ABPMSTR COB 04/23/93 GLOBAL
ABP MASTER TEST
___ $ACPMSTR COB 01/22/94 GLOBAL
ACP MASTER TEST
___ CBKCOB
COB 03/10/96 GLOBAL
COB DEMO COPYBOOK
___ CBKJFCB COB 03/10/96 GLOBAL
FORMAT DDNAME JFCB
___ CBKPLI
PLI 03/10/96 GLOBAL
PLI DEMO COPYBOOK
___ CBKVTOC COB 03/10/96 GLOBAL
FORMAT VTOC DSCB
___ IVUTEST COB 04/06/98 GKH1
TEST REDEFINES
___ TESTCBK COB 04/07/98 GKH1
*** ******************************* Bottom of List ****************************
Displaying the Copybook Layout
To display the contents of a compiled copybook template from the selection list select it with “LC” line command.
For example:
FMV/VxRx------------ FileMarvel COPYBOOK DIRECTORY ---------------------------COMMAND ===>
SCROLL ===> CSR
Member
Lan Created Changed Compiled Reference Userid
Title
*** ******************************* Top of List *******************************
LC_ CBKCOB
COB 02/03/98 02/03/98 04/06/98 05/20/98 GLOBAL
COBOL COPYBOOK
___ CBKDEF
COB 02/03/98 02/03/98 04/06/98 04/30/98 GLOBAL
DISPLAY COBOL
___ CBKPLI
PLI 02/03/98 02/03/98 04/06/98 04/10/98 GLOBAL
PLI DEMO COPYB
___ ABPMSTR COB 04/20/98 04/20/98 04/22/98 05/20/98 GLOBAL
*** ******************************* Bottom of List ****************************
A panel similar to the following is displayed:
FMV/L02-COPYBOOK-CBKCOB-------Compiled Copybook Member -----------------------COMMAND ===>
SCROLL ===> CSR
Offset Level A Field Name
Length Type
Picture
********************************** Top of Data ********************************
1
0
CBKCOB ......................
675
-----------------------------------------------------------------------------1
1
INV-MSTR-REC..................
675 GROUP
82
-----------------------------------------------------------------------------1
5
REC-KEY.......................
10 GROUP
1
10
REC-PAYEE-NO..................
10 CHAR
X(10)
-----------------------------------------------------------------------------11
5
INV-NO........................
26 GROUP
-----------------------------------------------------------------------------11
10
K-BATES-NO....................
11 GROUP
11
15
K-DATE-ENTERD.................
6 CHAR
X(6)
17
15
K-AUDITOR.....................
2 CHAR
X(2)
19
15
K-BATCH-NO....................
1 CHAR
X
20
15
K-DOC-SEQ.....................
2 CHAR
XX
-----------------------------------------------------------------------------11
10
FILLER........................
11 GROUP
11
15
K-BATCH-CTL...................
9 CHAR
X(9)
20
15
FILLER........................
2 CHAR
XX
22
10
K-ITEM-NO.....................
13 CHAR
X(13)
35
10
K-REC-CD......................
2 CHAR
X(2)
35
10
K-REC-CD-R....................
2 ZONEDEC 99
-----------------------------------------------------------------------------37
5
MISC-FIELDS...................
14 GROUP
37
10
M-DATE-CHG....................
4 COMP-3
S9(6)
41
10
M-STATUS-FLAG.................
1 CHAR
X
42
10
M-IDENT-FLAG..................
1 CHAR
X
43
10
M-CRT-DATE....................
4 COMP-3
S9(6)
This display shows the structure of the copybook. FileMarvel browse commands are available. Use the EXCLUDE command
to exclude records, FIND command to find records, PRINTX command to print the record layout, and the SAVE command to
save the report into another file.
SOURCE - Compile Copybook Source Directory
This directory displays copycode source that has been copied from an external source. PDS source may be modified and
compiled without modifying to the external source. Source may be modified and compiled without modifying to the external
source. Source may be copied from an external library or saved after a control compile. Internal source permits more flexibility
for tailoring templates.
A panel similar to the following is displayed:
FMV/L02-COPYBOOK-------------Copybook Source Directory -----------------------COMMAND ===>
SCROLL ===> CSR
Commands: Loc member, Sel member, SG=show global, Sort
Linecmds: B, CMP, DEL, E, GBL, LC, Sel
Member
Lan Ver Created
Changed
Compiled
Reference Userid
Titl
*** ******************************* Top of List *******************************
___ TESTCBK COB VXRX 1999/10/06 1999/10/06
GKH1
___ TEST1
COB VXRX 1998/06/03 1998/06/03
GLOBAL
*** ******************************* Bottom of List ****************************
Right and left scroll commands are available to view additional columns of information in the directory.
Fields:
Member
Name of the copybook source.
Lang
Compile language for the copybook.
Ver
Version of FileMarvel used to perform the previous compile.
Created
Date source was created.
Changed
Date source was last changed
Compiled
Date source was last compiled.
Reference
Date template was last referenced
Userid
Owner of the source. Specifies who has access to this source (and thus the
83
template).


TSO Userid –
The source is owned by this particular userid.
GROUPID –
The source is owned by this group. Enter the command GROUPS to display the groups
currently defined. Enter the command UGROUP to define new groups.
GLOBAL –
The source is owned globally. Any FileMarvel user has access to it.

Title
Descriptive title for copybook
Relateds
Associated data set name.
The following commands are available:
LOC | L
name
Specify a copybook source name or partial name to be located in the selection list.
SEL | S
name
Specify the copybook source name to edit. Specify a new name to create.
SG




ON | OFF | GLOBAL | GROUP
ON –
OFF –
GLOBAL –
GROUP –
SORT
Show GLOBAL as well as privately owned sources.
Show only privately owned sources.
Show only GLOBAL owned sources.
Show only those sources owned by a group.
heading-field-name
The SORT command sorts a directory according to the heading field specified.
Example: SORT CHANGED
The following line commands are available:
B
CMP
DEL
E
GBL
GRP
LC
LD
LI
S
Browse the default dataset for this copybook template.
Compile this copybook template.
Delete this copybook template.
Edit the default dataset for this copybook template.
Mark this copybook template for global access for all users.
Mark this copybook template for group access for all users.
List copybook displays the copybook template with field descriptions such as length, type and offsets.
LISTD dataset
LISTI dataset
Select copybook for edit.
FMV/VxRx----------------- COMPILE COPYBOOK SOURCE MEMBER -------------------COMMAND ===>
SCROLL ===> CSR
Main commands: CANCEL, CMP, COPY, SAVE
******* *************************** Top of File ******************************
000001
****************************************************************
000002
*** THIS IS THE COBOL DEFINITION OF THE INVOICE MASTER FILE ***
000003
*** USED AS A DEMONSTRATION FOR THE COPYBOOK FUNCTION.
***
000004
*** FILE NAME: FMARVEL.VXRX.DEMOFILE
LRECL: 675
***
000005
****************************************************************
000006
01 INV-MSTR-REC.
000007
05 REC-KEY.
000008
10 REC-PAYEE-NO
PIC X(10).
000009
05 INV-NO.
000010
10 K-BATES-NO.
000011
15 K-DATE-ENTERD
PIC X(6).
000012
15 K-AUDITOR
PIC X(2).
000013
15 K-BATCH-NO
PIC X.
84
000014
000015
10
15 K-DOC-SEQ
FILLER
PIC XX.
REDEFINES K-BATES-NO.
This is an edit space. All Edit commands are available. The following additional processing commands are available as main
commands:
COMPILE
COPY
SAVE
Compile the copybook templates currently displayed.
Copy another set of copybook templates.
Save the copybook templates currently displayed without ending the edit session.
OBJECT - Display Compiled Object Template Directory
The "COPYBOOK OBJECT" command results in a compiled copybook directory. The compiled copybook members may be
used as templates to overlay records of data sets. Commands are available to delete and display the members.
A panel similar to the following is displayed:
FMV/VxRx------------ COPYBOOK TEMPLATE DIRECTORY ---------------------------COMMAND ===>
SCROLL ===> CSR
Commands: Locate, Select, SG=Show global, RESet, SORT
Linecmds: B, DEL, GBL, GRP, LC, Sel
Member
Lan Created Changed Compiled Reference Userid
Title
*** ******************************* Top of List *******************************
___ CBKCOB
COB 02/03/98 02/03/98 04/06/98 05/20/98 GLOBAL
COBOL COPYBOOK
___ CBKDEF
COB 02/03/98 02/03/98 04/06/98 04/30/98 GLOBAL
DISPLAY COBOL
___ CBKPLI
PLI 02/03/98 02/03/98 04/06/98 04/10/98 GLOBAL
PLI DEMO COPY
___ ABPMSTR COB 04/09/98 04/09/98 04/11/98 04/29/98 GLOBAL
ABP MARVEL TEST
___ ACPMSTR COB 04/08/98 04/08/98 04/11/98 04/28/98 GLOBAL
ACP MARVEL TEST
*** ******************************* Bottom of List ****************************
Commands
SG




ON | OFF | GLOBAL | GROUP
ON –
OFF –
GLOBAL –
GROUP –
SORT
Show GLOBAL as well as privately owned sources.
Show only privately owned sources.
Show only GLOBAL owned sources.
Show only those sources owned by a group.
heading-field-name
The SORT command sorts a directory according to the heading field specified.
Example: SORT CHANGED
Line commands
B
DEL
E
GBL
GRP
LC
LD
LI
browse member
delete copybook
edit dataset
set the template to global status
set the template to group status
list copybook format
LISTD dataset
LISTI dataset
RELATEDS - Relate Copybooks To Data Files
Obtain the copybook to dataset name relationship screen by selecting it from the copybook maintenance selection panel.
85
Use this facility to view and change the relationship between data files and compiled copybook templates. A copybook
template can be created automatically from the edit or browse entry panel or compiled directly. FileMarvel retains copybook
relationship information across sessions.
The relationship is presented as a FileMarvel edit session. Use any edit command to modify the list. For example, use the “R”
line command to copy an existing line, modify it, and use the same copybook template with several different files. Use the “D”
line command to delete obsolete definitions and the CHANGE main command to globally change names if files have been
renamed. In addition to the standard edit line commands; use the line command “B” (browse) to verify the copybook templates
properly map the file. “B” invokes browse in formatted mode using the specified copybook.
Fastpath command: RELATEDS
FMV/L03-RELATEDS----------Dataset/Copybook Relate List -----------------------COMMAND ===>
SCROLL ===> CSR
Commands: CANCEL, SAVE, SORT
Linecmds: B/cursor=browse
Dsname
Copybook
***** ***************************** Top of List *******************************
00001 CSI.RTM
CBKCOB
00002 GKH1.TEST.PDS
CBKCOB
00003 GKH1.FMARVEL.VXRX.DEMOFILE
CBKCOB
00004 CSI.FMARVEL.VXRX.DEMOFILE
CBKCOB
00005 FMARVEL.VXRX.DEMOFILE
COPY2
00006 CSI.MSXGCF$
COPYBOOK
00007
00008
00009
00010
00011
***** ***************************** Bottom of List ****************************
This list shows datasets and their associated copybooks. Note dataset names are fully qualified and do not contain quotes.
BATCH - Compile a Copybook in Batch
Several options are available to perform a FileMarvel copybook template compile. To compile a complex copybook or several
copybook templates at once, use the batch utility. To perform a batch compilation, submit a job using the cataloged JCL
procedure FMVBATCH.
For example:
//
//COMPILE
>>> JOBCARD <<<<
EXEC FMVBATCH
COMPILE FUNC(COPYBOOK) MEMBER(PAYREC)
LANGUAGE(COBOL) USERID(TSO002)
TITLE(Employee payroll records)
COPY
COPY
COPY
COPY
-
PAYEMPL
PAYTEMP
PAYHURLY
PAYOVTM
COPYLIB PAYROLL.JIM.COBOL
COPYLIB PAYROLL.TEST.COBOL
COPYLIB PAYROLL.PROD.COBOL
TESTDSN PAYROLL.TEST.MARVEL
DISPLAY REG-EMPLOYEE WHEN EMPLOYEE-TYPE EQ 1 OR
EMPLOYEE-CONTRACT EQ TOP-MANAGEMENT
DISPLAY TEMP-WORKER WHEN EMPLOYEE-TYPE EQ 2
DISPLAY OVERTIME-INFORMATION WHEN HOURS-WORKED GT 40
DISPLAY HOURLY-EMPLOYEE WHEN EMPLOYEE-TYPE EQ 2
AND DAILY-RATE EQ 0
The COMPILE statement is first and requires the FUNCTION(COPYBOOK) parameter. Use the same options available in a
template edit session.
86
Following the COMPILE statement, enter the same templates available on-line. A MEND statement terminates each set of
templates. Multiple copybook templates may be compiled in a single batch step.
To make this copybook template globally available specify USERID(GLOBAL) in the COMPILE statement.
For a complete listing of all control statements available see Appendix A: Compile Control Statements.
Compiled templates are immediately available to browse, edit, sort, or print files.
Creating a Tailored Copybook Template
A tailored copybook template provides the ability to develop different “views” of a record. Fields can be deleted from an
existing compiled copybook creating a new copybook template called a Tailored Copybook Template. You can define as many
tailored copybook templates as you need.
Tailored copybook templates can be named and saved for later re-use.
There is an additional similar function called a Record Reformat Template that uses record offsets to create new ‘views’ of a
record.
Follow the steps below to create a tailored copybook template:

EDIT or BROWSE a file in FORMAT display mode using a compiled copycode template.

Delete the fields you want removed in the new tailored copybook. The following line a main commands are
available.
Line commands D, DD or DG to delete fields.
Line commands or X, XX or XG to exclude fields.
Main command "RESET ALL" with the operands "ALL" to reset all modifications.
Main command “RESET EXC" to reset excludes
Main command "RESET DEL" to reset deleted lines.
Line command "F" to reset the first excluded line.
Line command "L" to reset the last exclude line.

Enter the main command “SAVECB newname” or “SVCB newname” to save the tailored copybook template. a
newname. The Save Copybook Template Panel will be presented. If you save the tailored copybook it will be
available for later use in the same way that a unmodified copybook template including the FMT command.

Remember that the RELATEDS function can be used to associate templates with data sets.
The panel below is provided as an example of creating a new tailored copybook template
FMV/L02-EDIT-CBKCOB-YOUR.FMARVEL.VXRX.DEMOFILE -----------------read 62 selected 62
COMMAND ===>
SCROLL ===> CSR
KEY
> 0000000100
Column Field Name
Length ....+....1....+....2
000001
01 Inv-mstr-rec.......................
675G
dg0001 *
000001 *
05 Rec-key...........................
10 Rec-payee-no.....................
10G
10C
000011
05 Inv-no............................
26G
000011 +
dd0011
0017
dd0019
000020
10 K-bates-no.......................
15 K-date-enterd...................
15 K-auditor.......................
15 K-batch-no......................
15 K-doc-seq.......................
11G
6C
2C
1C
2C
X'000000000000'
08
1
07
000011 d00011
d00020
10 Filler...........................
15 K-batch-ctl.....................
15 Filler..........................
11G
9C
2C
X'000000000000F0F8F1
07
87
0000000100
000022
000035 +
10 K-item-no........................
10 K-rec-cd.........................
13C
2C
1
Commands
CMP | CM
FMT | FM
HEX | HX
LISTCBK | LC
LISTOPT | LO
SAVECB | SVCB
STD | ST
switch to compact mode
switch to format mode
switch to hexadecimal mode
list copybook displays the compiled copybook template
list option displays associated options with a copybook template
saves a tailored copybook template for re-use across sessions
switch to standard mode
Line commands
D
DD
DG
X
XX
XG
deletes a line
deletes a group of lines
deletes a group field
excludes a line
excludes a group of lines
excludes a group field
Saving a Tailored Copybook
The Save Copybook Template provides the ability to specify options and parameters while saving a
Tailored Copybook Template.
The Panel is obtained by issuing the SAVECB/SVCB command. The modified templates are preserved under the name
specified and may be reused across file displays or sessions.
Copybook options and parameters for existing templates can be changed with the LISTOPT/LO command.
FMV/VxRx-EDIT-STANDARD ---- Save Copybook Template -------------------------COMMAND ===>
Commands: CAN, END, SAVE
Copybook. . .
Owner. . . .
Description .
Test data set
.
.
.
.
.
.
.
.
CBKCOB
ISDDEB2
XXXXX
DPID.RTST.KSDS
Option tailoring
Display format.
Group display .
Field display .
Field case. . .
Redefine fields
Level 1 groups.
Group breaks. .
Tab attribiute.
Pad character .
.
.
.
.
.
.
.
.
.
F
N
N
N
Y
Y
N
N
.
F/C/S/H initial display format
Y/N display group definitions
Y/N display fields in tiered fashion
Y/N display field labels in lowercase
Y/N display redefined fields
Y/N display all level 1 groups
Y/N set group breaks
Y/N skip field on data entry
Field pad fill character
Replace option. .
N
Y/N if member exists, replace it
Enter/verify the parameters and options in this panel and enter the SAVE command to save the new template. The SAVE
command must be explicitly entered to permanently save the template.
Commands
CANCEL | CAN
Cancel any changes and return to the previous panel.
END
Save the changes temporarily for current session.
SAVE
< member>
Save the changes permanently for future use. Save must be explicitly
entered for reuse across sessions.
88
Fields
COPYBOOK
The template name. Will be initialized with the original name of the compiled copybook
template you started with.
OWNER
Specifies the owner of the template. This field can be one of the following:
userid
GLOBAL
groupid
Your TSO userid or signon id library
This template will available globally.
Specify a predefined group. This copybook will belong to that group.
DESCRIPTION
The description of the tailored copybook template.
TEST DATA SET
The test data set name that will be associated with this template.
DISPLAY FORMAT
The default initial display format that will be used with this template.
S
H
F
C
GROUP DISPLAY
standard display
hex display
format display
compact display
Sets default for display of copycode group field displays.
Y
Display group fields by default.
N
Do not display group fields.
FIELD DISPLAY
Sets default for display of field levels and field names.
Y
Display the field levels and field names in a tiered fashion. The field names are displayed
offset according to the level numbers.
N
Display off the field names in the same column regardless of the level number of the field.
FIELD CASE
Display field labels in lower or upper case
Y
Display field labels in lower case
N
Display field labels in upper case
GROUP BREAKS
Sets the default for display format of breaks between copycode groups.
Y
Insert a blank line between copycode groups.
N
Do not insert a blank line between groups.
TAB ATTRIBUTE
Set the default for tab attribute at the end of modifiable fields during data entry.
Y
Tab the cursor to the next field when data entry reaches the end of a field.
N
Stop at the end of the field when data entry reaches the end of a field.
PAD CHARACTER
Sets the character used to fill a field during compare mode record displays. This field can
be a special character or blank.
REPLACE OPTION
Specifies whether or not this template will overlay a currently existing like named template.
89
Y
If member exists, replace it.
N
If member exists, do not replace it.
Altering Copybook Options
The LISTOPT/LO command displays the current option settings for a copybook template. The options may be modified for the
current function by setting the options and pressing the END pf.
The template options may be permanently modified be setting the options and entering the SAVE command. The SAVE
command must be entered to explicitly save the new options.
FMV/VxRx-EDIT-STANDARD ---- Copybook Template Options-----------------------COMMAND ===>
Commands: CAN, END, SAVE
Copybook. . .
Library . . .
Description .
Test data set
.
.
.
.
.
.
.
.
CBKCOB
ISDDEB2
XXXXX
DPID.RTST.KSDS
Option tailoring
Display format.
Group display .
Field display .
Field case. . .
Redefine fields
Level 1 groups.
Group breaks. .
Tab attribiute.
Pad character .
.
.
.
.
.
.
.
.
.
F
N
N
N
Y
Y
N
N
.
F/C/S/H initial display format
Y/N display group definitions
Y/N display fields in tiered fashion
Y/N display field labels in lowercase
Y/N display redefined fields
Y/N display all level 1 groups
Y/N set group breaks
Y/N skip field on data entry
Field pad fill character
The commands and options for this panel same as the Save Copybook Template Panel.
Reformat Template Directory
The “COPYBOOK REFORMAT” template directory contains all the saved reformat templates used in any of the file access
functions. The templates may be created, modified or deleted from this directory. The modifications made to the templates will
be reflected in the next use during file access. Create new reformat entries by selecting a new name from the directory display.
A panel similar to the following is displayed:
FMV/VxRx---------------- Reformat Template Directory -----------------------COMMAND ===>
SCROLL ===> CSR
Commands: Locate, Select
Linecmds: DEL, Sel
Member Userid Created Changed Compiled Title
*** ******************************* Top of List *******************************
___ CBKCOB
userid 02/03/98 02/03/98 userid
COBOL COPYBOOK
___ CBKDEF
userid 02/03/98 02/03/98 userid
DISPLAY COBOL
___ CBKPLI
userid 02/03/98 02/03/98 userid
PLI DEMO COPY
___ ABPMSTR userid 04/09/98 04/09/98 userid
ABP MARVEL
*** ******************************* Bottom of List ****************************
Findext Template Directory
The “COPYBOOK FINDEXT” template directory contains all the saved extended find templates used in any of the file access
functions. The templates may be created, modified or deleted from this directory. The modifications made to the templates will
be reflected in the next use during file access. Create new find template entries by selecting a new name from the directory
display.
A panel similar to the following is displayed:
FMV/VxRx---------------- Extended Find Template Directory ------------------COMMAND ===>
SCROLL ===> CSR
Commands: Locate, Select
Linecmds: DEL, Sel
Member Userid Created Changed Compiled Title
90
***
___
___
___
___
***
******************************* Top of List *******************************
CBKCOB
userid 02/03/98 02/03/98 userid
COBOL COPYBOOK
CBKDEF
userid 02/03/98 02/03/98 userid
DISPLAY COBOL
CBKPLI
userid 02/03/98 02/03/98 userid
PLI DEMO COPY
ABPMSTR userid 04/09/98 04/09/98 userid
ABP MARVEL
******************************* Bottom of List ****************************
91
AUTOEXEC - User Defined Edit Commands
User Defined Edit Commands
Using AUTOEXEC you can define frequently used commands. You can associate long or complex command strings with a
simple, easily remembered name. Define Edit and Browse commands using Autoexec. Use these commands to execute a predefined command or to display a command on the command line for modification prior to execution.
Develop commands to BROWSE EDIT or commonly used FIND and CHANGE commands. These are stored as AUTOEXEC
commands. Use this facility to automate reiterative or complex commands.
Develop A User Defined Command
Select the AUTOEXEC panel from the FileMarvel Primary Option Menu, or enter the Fastpath command AUTOEXEC.
Fastpath command: AUTOEXEC/AUTO
FMV/L02-AUTOEXEC-GKH1-------Auto Commmand Execution --------------------------COMMAND ===>
SCROLL ===> CSR
Linecmds: S/cur=select and execute commands
Short command
Exec Command executed
***** ***************************** Top of Data *******************************
00001 ATRACE
ON
TRACE 1 'GKH1.FMV.TRACE'
00002 FTRACE
ON
FREE FMVTRACE
00003 BTRACE
ON
BR 'GKH1.FMV.TRACE'
00004 EDIT-DEMO
ON
EDIT 'GKH1.FMARVEL.VXRX.DEMOFILE'
***** ***************************** Bottom of Data ****************************
AUTOEXEC command
The user defined command name. Enter this command on the command line to execute it.
Autoexec commands used in Edit or Browse sessions must be EXEC=OFF. Commands
used outside of Edit or Browse sessions can be EXEC=ON.
Exec
Execute the command when entered on the command line.
Place the command on the command line to allow for modification
before execution.
ON OFF -
Command executed
is the command executed or displayed when the autoexec command is entered. After
commands are developed, exit the AUTOEXEC function to save the entries for later use.
Execute a User Defined Command
Enter any user defined command (AUTOEXEC) on the command input line of a FileMarvel panel. Develop new commands
using the AUTOEXEC panel. Commands can either be executed immediately or placed on the command line for modification
before execution.
For example, set up a predefined find statement as shown for FFLD1 below. Enter FFLD1 on the command line. If EXEC=ON,
the command is immediately executed. If EXEC=OFF, the command is displayed on the command line to allow modification
prior to execution.
Entered
Result
FFLD1
BPR
FIND Field-payroll-amount +100.58 OR +95.25
Enter browse session on dataset:
TEST.DATASET.PAYROLL.QTR1.1999.Y2K
92
UTILITY – General Tool Set Utilities
UTILITY Tool Set Primary Panel
Fastpath command: UTILITY
FMV/VxRx----------------- Utility Toolset --------------------------------OPTION ===>
0
1
2
3
4
5
6
7
SET
SET
DA
ALLOCDD
FREE
LISTDD
LISTVTOC
SPACE
LMODMAP
-
Set individual options
Display batch execution
Allocate a file online
Free an online file
List allocated files
List dasd device
List dasd device free space
Load module statistics and code reversion
Set FileMarvel default options.
DA
Display batch jobs during execution.
ALLOCDD
Interactively allocate a dataset to a TSO session.
FREE
Interactively free a dataset from a TSO session.
LISTDD
List datasets currently allocated to a TSO session.
LISTVTOC
List datasets on direct access volumes. Provides a selection directory providing the ability to perform
a variety of functions with selection commands.
SPACE
List free space on direct access volumes.
DA - Display Active Batch Jobs
Select this panel from the Extended Utilities Primary Panel. This panel provides a display of currently active JOBS, STC or
TSO users. A panel similar to the following is displayed:
Fastpath command: DA
FMV/VxRx-DA----------------- Display Executing Jobs --------------------------COMMAND ===>
Main commands: L (ALL, JOB, STC, TSO, jobname)
Jobname
Step
Procstep
Cpu Pfr Prty Status
System: P390 Job:
0 Stc:
36 Tso:
11 Total:
47
Use the LIST/L command to control the type of work displayed.
LIST/L parm
ALL
Display all work.
JOB
Display jobs only.
STC
Display started tasks only.
TSO
Display TSO userids only.
JOBname
Display a specific job, Tsouser or started task by name.
ALLOCDD - Allocate a File On-Line
Select this panel from the Extended Utilities Primary Panel. Interactively allocate a dataset to a TSO userid using ALLOCDD.
A panel similar to the following is displayed:
Fastpath command: ALLOCDD
FMV/VxRx-ALLOCDD--------------- Allocate File Online --------------------------COMMAND ===>
93
DDname . . . . . .
Ddname of the file to be allocated
Data set name. . .
Partitioned, sequential or VSAM data set name
Volume . . . . . .
For uncataloged data sets
Disposition. . . . SHR
SHR/OLD/MOD
Sysout . . . . . .
Sysout print class
Release. . . . . . Y
Y=Yes, N=No Release sysout on closed file
allocation disposition
Enter the ddname, data set, disposition
Or enter the ddname, sysout print class
And depress enter to execute the function.
Data set and Sysout class are mutually
Exclusive and only one may be entered.
DDNAME
DDNAME to be associated with the dataset.
DATA SET
The dataset name, either sequential, VSAM, or a Partitioned dataset. Mutually exclusive with
SYSOUT.
VOLUME
The dataset volume serial number. Use for uncataloged non-VSAM files.
DISPOSITION
Dataset disposition.
SYSOUT
Any valid JES sysout class. Associate the DDNAME with a sysout dataset where this is specified.
Mutually exclusive with DataSet.
RELEASE
Y - Release dataset upon close.
N - Do not release dataset upon close.
FREE - Free a File
Select this panel from the Extended Utilities Primary Panel. Use this function to interactively free a dataset from a TSO userid.
The dataset is not deleted. It is unallocated from a TSO userid. A panel similar to the following is displayed:
Fastpath command: FREE ddname
FMV/VxRx-FREE------------------ Free Online File -----------------------------COMMAND ===>
DDname
. . .
Ddname of the file to be released
Enter the ddname and depress enter to execute the function.
LISTDD - List Allocated Files
Select this panel from the Extended Utilities Primary Panel. Provide a selection list of the DDNAMES and datasets currently
allocated to a TSO userid using this function. From the selection list, Edit, Browse, or Free the dataset to obtain dataset
information. A panel similar to the following is displayed:
Fastpath command: LISTDD
. . . . . . . . . . . . . . . . . . . . . . . . . . .
FMV/VxRx-LISTDD-----------Online File Display -------------------------------COMMAND ===>
SCROLL ===> CSR
Linecmds: Browse, Edit, Free, Select
File
Volume Dataset
Member
* ********************************* Top of List *******************************
_ SYSUADS SCPMV5 SYS1.UADS
_ SYSLBC
SCPMV5 SYS1.BRODCAST
_ SYSPROC VOLS04 CSI.CMDPROC
_
VOLS01 CSI.DB2TOOL.CPC013X.CLIST.FB
_
VOLS01 CLR1.TAPJSF39.CMDPROC
_
VOLS01 CSI.VOLSIVU.CMDPROC
_
VOLS01 CSI.IVU25.CMDPROC
94
Line commands available:
B
E
F
I
-
Browse the dataset.
Edit the dataset.
Free the dataset. The dataset is not deleted. It is unallocated from a TSO userid.
Provides dataset allocation information.
LISTVTOC - List Dasd Volume Data Sets
Select the LISTVTOC Utility Panel from the Dataset Maintenance Menu. LISTVTOC presents a dataset selection list of a
DASD volume. Data selection lists for a single or generic group of volumes are available. Delete, rename, and uncatalog
commands are available. A panel similar to the following is displayed:
Fastpath command: LISTVTOC
"volume"
FMV/L03-LISTVTOC--------------- Volume Data Set Display ---------------------COMMAND ===>
Commands: CAN, END, SUBMIT
Volume . . . . . . .
Volume, group, class or "*" for vollist
Example: STG001
STG*
*
Display option . . . L
L=dslist, D=data sets, S=summary
Sort field option. .
Sort field name or blank
APPLY CRITERIA . . . N
N=No, Y=Yes - use criteria below
From record. . . . . 00000001
Record count . . . . 99999999
Find string. . . . .
Starting record number
Number of records to process
VOLUME
Volume or volume group, class or volume list.
*
Display a volume selection list.
volume
6 character volume serial name. example: VOL001
volume group 1 - 6 character volume serial name followed by a wildcard '*' All volumes containing the
prefix will be scanned for data sets or criteria.
ex. VOL0*
DISPLAY OPTION
L
D
S
Controls the format of the dataset selection list.
List volume summary and data set list
List data set list only
List volume summary only
SORT FIELD OPTION Sort the volume display according to the field name specified. You can sort by any field
name in the dataset selection list.
ASIS
DATASET
DSORG
RECFM
LRECL
BLKSZ
do no sort
data set name
data set organization
record format
record length
block size
95
EXTN
USETRK
CREATED
VOLUME
extents
used tracks
creation date
volume serial
APPLY CRITERIA
Controls whether or not the selection criteria below are to be applied.
Y
N
Use the selection criteria specified below.
Do not use the selection criteria specified below.
FROM RECORD
Specifies the starting record number to process.
RECORD COUNT
Specifies the maximum number of records to process.
FIND STRING
Any valid FIND parameter. Used to select which datasets will be displayed. The string may
be a data set name, a data set index, a string within a data set.
Searches may be done for dsorg, recfm, dates etc., but must be done on the actual volume tables of contents record. To
get field displacements and values switch to a format display within a data set list and locate the displacement and value.
Examples
TEST.PN00 (locate all data sets with TEST.PN00)
SOURCE
(locate all data sets containing SOURCE)
X'02' 83
(locate all pds dsorg data sets)
VTOC Dataset Selection List.
Select a volume from a Volume Selection list or enter a single volser on the VTOC Utility input panel.
A panel similar to the following is displayed:
FMV/VxRx-LISTVTOC------------ DATA SET LIST FOR: DUMP01 ----------------------COMMAND ===>
SCROLL ===> PAGE
Main cmnds: CMP, FMT, HEX, STD, LDSN, LVOL (vol,vol*,CLASS) END, RESET, SCROLL
Line cmnds: A=alloc, AE=esds, AK=ksds, AR=rrds, B=browse, CAT=catlg, DEL=delete
E=edit, L=list, P=print, R=rename, S=info, SCR=scratch, UNC=uncatlg
Data set name
Dsorg Recfm Lrecl Blksz Extn
*** ******************************* Top of List *******************************
___ SYS1.VTOCIX.DUMP01
SEQ
F
2048
2048
1
___ CSI.OLF41.SRCLIB
PDS
FB
80
3120
3
___ CSI.OLF41.LOADLIB
PDS
U
0
4096
1
___ CSI.SNT11.SOURCE
PDS
FB
80 24000
1
___ CSI.XRAY.CNTL
PDS
FB
80 15760
7
___ RJS1.MLI.DUMP
SEQ
F
4160
4160
1
___ CSI.XRAY.COPY.SRCLIB
PDS
FB
80
15760
___ CSI.ADH12.LOADLIB
PDS
FB
0
6144
9
Scroll right to see additional datasets characteristics:
FMV/VxRx-LISTVTOC------------ DATA SET LIST FOR: DUMP01 ----------------------COMMAND ===>
SCROLL ===> PAGE
Main cmnds: CMP, FMT, HEX, STD, LDSN, LVOL (vol,vol*,CLASS) END, RESET, SCROLL
Line cmnds: A=alloc, AE=esds, AK=ksds, AR=rrds, B=browse, CAT=catlg, DEL=delete
E=edit, L=list, P=print, R=rename, S=info, SCR=scratch, UNC=
Usetrk Created Useddate Volume Data set name
*** ******************************* Top of List *******************************
___
90 01/31/96 ?
DUMP01 SYS1.VTOCIX.DUMP01
___
4 01/29/96
05/29/96 DUMP01 CSI.OLF41.SRCLIB
___
6 05/29/96
05/07/98 DUMP01 CSI.OLF41.LOADLIB
___
104 02/12/98
04/23/98 DUMP01 CSI.SNT11.SOURCE
___
103 08/24/95
03/30/98 DUMP01 CSI.XRAY.CNTL
___
751 04/30/98
05/01/98 DUMP01 RJS1.MLI.DUMP
96
11
The following panel shows the volume summary selected by the Display Option field:
FMV/VxRx-LISTVTOC------------ DATA SET LIST FOR: DUMP01 ----------------------COMMAND ===>
Main cmnds: CMP, FMT, HEX, STD, LDSN, LVOL (vol,vol*,CLASS) END, RESET, SCROLL
Line cmnds: A=alloc, AE=esds, AK=ksds, AR=rrds, B=browse, CAT=catlg, DEL=delete
E=edit, L=list, P=print, R=rename, S=info, SCR=scratch, UNC=uncat, V=view
Data set name
Dsorg Recfm Lrecl Blksz Extn
*** ******************************* Top of List *******************************
___ ***-----------------------------------------------------------------------___ *** Unit type => 3390 Tracks/Cyl =>
15 Total tracks => 26550
___ *** Free tracks => 5275 Free cyls => 351 Free extents =>
8
___ *** Ctig tracks => 3375 Ctig cyls => 225 Trk capacity => 47968
___ *** Total dscbs => 742 Free dscbs => 557 Volume
=> P390DX
___ ***-----------------------------------------------------------------------___ USERCAT.P390DX
VSAM U
0 4096 1
___ SYS1.VVDS.VP390DX
VSAM ?
0 4096 1
___ USERCAT.P390DX.CATINDEX
VSAM U
0 4096 1
___ CICS.TZN.CSI.DATA
VSAM U
0 4096 1
___ CICS.TZN.CSI.INDEX
VSAM U
0 4096 1
___ CICS.DZN.CSI.DATA
VSAM U
0 4096 1
___ CICS.DZN.CSI.INDEX
VSAM U
0 4096 1
___ CICS.ADFHMLIB
PDS FB
80 23440 1
Five separate displays are available i.e., STANDARD, HEX, FORMAT, COMPACT, and DATASET list.
Use one of the following line commands to select a dataset or datasets:
A
Allocate - displays the general VSAM/non-VSAM allocation utility screen primed with the selected datasets
characteristics. Note: this is a general allocation panel. Not all VSAM parameters are available. Use AE,
AK, or AR for VSAM specific panels.
AE
Allocate ESDS - Displays the VSAM ESDS allocation panel primed with the selected datasets characteristics.
AK
Allocate KSDS - Displays the VSAM KSDS allocation panel primed with the selected datasets characteristics.
AR
Allocate RRDS - Displays the VSAM RRDS allocation panel primed with the selected datasets
characteristics.
B
Browse - Enter a browse session on the selected dataset.
DEL
Delete a Dataset.
E
Edit - Enter an Edit session on the selected dataset.
L
LISTD - List dataset catalog information for a single dataset.
P
Print - Display the Print File entry panel.
P
Print - Display the Print File entry panel.
R
Rename - Display the dataset rename entry panel.
S
LISTI - Display dataset allocation information.
SCR
Scratch - Display a panel to delete but NOT uncatalog a non-VSAM dataset.
UNC
Uncatalog - Display a panel to uncatalog Non-VSAM dataset.
SPACE - Volume Free Space Utility
97
Select the SPACE Utility from the Dataset Maintenance Menu. The command SPACE displays free space on any on-line direct
access device. Specify single, group, classes, and common device name prefixes to display the free space. Statistics for a
single volume or a generic group are available. Request entire or selective dataset lists for the direct access volumes. A panel
similar to the following is displayed:
Fastpath command: SPACE
"volume"
FMV/VxRx-SPACE----------------- Dasd Free Space Utility ----------------------COMMAND ===>
Volume
. . .
Enter volume, volume list group or class
Classes: PRIVATE, PUBLIC, STORAGE or ALL
Ex. STG001
STG*
PRIVATE
Print
. . . N
Y=Yes, N=No
print volume space in batch mode
Free space may be displayed for a specific
volume, a volume group or a class group.
For VOLUME or VOLUME groups, the free space directory is shown below for volume and volume groups. Add additional
volumes with the LVOL command. Enter line commands to view the dataset lists associated with the specific volumes.
FMV/VxRx-SPACE-------------- Dasd Free Space Directory -----------------------COMMAND ===>
SCROLL ===> CSR
Commands: LVOL (vol, vol*, class)
Sel/cur
Volume Totcyl Tottrk Totext Ctgcyl Ctgtrk Mount
Opncnt Rsvcnt Unit Type
* ********************************* Top of List *******************************
RAM001
1750
26
8
1321
0 PRIVATE
40
0
908 3390
RAM002
1708
6
8
1182
0 PRIVATE
44
0
909 3390
RAM003
1816
427
75
1688
0 PRIVATE
0
0
90A 3390
RAM004
1759
367
61
1695
0 PRIVATE
1
0
90B 3390
RAM005
489
0
1
489
0 PRIVATE
1
0
90C 3390
RAM006
1143
21
4
1062
0 PRIVATE
6
0
90D 3390
RAM007
911
28
3
628
5 PRIVATE
22
0
90E 3390
RAM008
881
14
3
483
9 PRIVATE
12
0
90F 3390
RAM009
1085
23
6
814
0 PRIVATE
11
0
910 3390
RAM010
1156
6
2
1156
0 PRIVATE
10
0
911 3390
Totcyl
Tottrk
Totext
Ctgcyl
Ctgtrk
Total free space cylinders
Total free space tracks not attached to cylinders
Total free space extent count
Largest free space contiguous cylinders
Largest free space contiguous tracks
LMODMAP – Load Module Analysis
The LMODMAP function displays the directory for a link edit partitioned data sets. A linkedit loadlib data set must be
entered resulting in a directory display of the data set. A selection of line commands are available to display and manage the
members. After the pds data set has been allocated, a formatted directory display is generated. Members may be displayed,
deleted, renamed, edited as well as LMODMAP information.
The display may be one of the LMODMAP requests i.e., INFO, HEXDUMP or REVERT. INFO is display only and displays
the module linkedit map information. REVERT is modifiable and reverts the machine code to the assembler mneumonic
opcodes ready for assembly. HEXDUMP is display only and is a machine text code for the module csect.
Fastpath command: LMODMAP
"dataset"
FMV/L03-LMODMAP---------------- Load Module Analysis -------------------------Command ===>
LOADLIB data set name . .
'YDG.VXRX.LLIB
Volume. . . . . . . . . .
For uncataloged data sets
98
Request . . . . . . . . . INFO
Function request
ALL, INFO, HEXDUMP, REVERT
Limit member list
APPLY CRITERIA N
Start mem . . . . . . . . #LM
End mem . . . . . . . . #LM
Y=yes, N=no
Set member start
Set member end
DATA SET NAME
enter a fully qualified data set name in quotes of a linkedit pds
VOLUME
enter the volser for the data set if not catalogued
REQUEST
enter the display request type
ALL
display all request types
INFO
display linkedit load module statistics
HEXDUMP
display csect code in hexadecimal format
REVERT
display csect code in reverted source code
APPLY CRITERIA
whether the selection criteria specified below is to be applied
Y
Use the selection criteria specified below to select members
N
Specifies all selection requests are ignored
START MEM
Specify the lowest member or generic member to begin the display
Example FMVC
END MEM
Specify the hihest member or generic member to end the display
Example FMVDU
You can specify the member member range to limit the number for directory display
Example specific FMVALOC
generic FMVA
Module Directory Display
The LMODMAP function displays the directory for a link edit partitioned data sets. Commands and line commands are
available to select, create, modify, maintain members and display specific request formats. Entering the SELALL | SA, the line
command "S" or setting the cursor (point&shoot) on a line will result in the requested selection display. The original requested
display may be overridden by entering one of the line commands AX, HX, IX or RX.
FMV/L03-LMODMAP-STGA02-YDG.VXRX.LLIB ---------------- ---read 113 selected 113
Command ===>
Commands: COMP, F, FT text (ALL), L(A,OC mem)
Linecmds: AX, B, D, E, HX, IX, P, R, RX, S, X, XX
Name
F TTRN
Size E/P SSI
Alias Attributes
-- -------------------------------- Top of Selected Records ------------------.. FMVALDD
1 0100052C 1900
RENT,REUS,A31
.. FMVALOC
1 00F0042C 66D8
RENT,REUS,A31
99
.. FMVAMS
.. FMVAUTO
.. FMVBASC
1 00EC142C 25DB0
1 00E0052C 33D8
1 00E00D2C 6848
RENT,REUS,A31
RENT,REUS,A31
RENT,REUS,A31
Command summary
RES
SelAll
SelEnd
COMPress
Find
FindText
SAVE
SORT
PrintX
reload pds
select all members
select end members - line and cursor control
compress data set
finds and displays requested values within directory
finds and displays values within members
save dataset display into dataset
sort edit work space
print records
Line command summary
Ax
B
D
E
F
Hx
Ix
L
P
R
Rx
S
X
XX
ist all info and reset original request
bowse member
delete member
edit member for code alteration
first line unexclude
list hex dump and reset original request
list info and reset original request
last line unexclude
print member
rename member - new name required
list reverted source code and reset original request
list original requested info
line exclude display
block exclude
Module Csect Directory
The LMODMAP csect directory displays all csects within a load module. Individual or all csects may be selected in the
requested format. The original format may be overridden with the command LIST. The display may be one of the MODMAP
requests i.e., INFO, HEXDUMP or REVERT. INFO is display only and displays the module linkedit map information.
REVERT is modifiable and reverts the machine code to the assembler mneumonic opcodes ready for assembly. HEXDUMP is
display only and is a machine text code for the module csect.
FMV/L03-LMODMAP-FMVALDD-------Link Edit Csect Directory ----------------------Command ===>
Commands: FIND(F), L operand, SAVE, SelAll
Linecmds: AX, HX, IX, RX, S, Cursor=point&shoot
Csect Type Addr Length Esdid
.. FMVALDD SD 000000 000400 0001
.. MODIPAN SD 000FA0 00095C 0002
.. MODIENX SD 0008F0 0006AE 0003
.. MODIINX SD 000400 0004EA 0004
Command summary
LIST | L
ALL
INFO
HEXDUMP
REVERT
List and set request
all listed below
module statistical info
hex dump format
reverted code
100
Find
PRINTX
SAVE
SelAll SA
SelEnd SE
Finds and displays requested values
print records
save to dataset or member
select all members
select end members
Line command summary
AX | A
IX | I
HX | H
RX | R
S
list all selection info
list info
hexdump display
revert module
default selection
Module Sample Reports
Linkedit statistical information
FMV/L03-LMODMAP-FMVALDD-------Module Linkedit Information --------------------Command ===>
Scroll ===> CSR
Commands: FIND(F), QUIT, SAVE
---------------------------------- Top of Data -------------------------------Directory info for module FMVALDD
TTR of module=010005
Concatenation nbr=00
Alias flag=2C
TTR, 1st txt recd=01000A
TTR of note/scatter list=000000
Nbr note entries=00
Attributes 1=C2E2 RENT REUS
EXEC
Total length=001900
Length of 1st txt recd=1900
E. P. addr=000000
Attributes 2=88
Amode = 31
Auth code=00
Linkedit csect hexadecimal dump
FMV/L03-LMODMAP-FMVALDD-------Module Linkedit Information --------------------Command ===>
Commands: FIND(F), QUIT, SAVE
0000A0 005CD73FE000E000 D203E000C3CCD207 E008C3A09001E010 D203E004C3D098F1
0000C0 D00C5010E01C98F1 D00C5000E018D201 E030C3F247F0C0DC E3D9C1C3181E1B00
0000E0 58F0B0F458F0F014 58F0F0740DEF41ED 005C9801E01048F0 E032BF5F90444780
000100 C228D5035000C3D4 4780C1104400C10C 58F0C3D850F091E0 98019010D202511C
000120 C3A8D200509BC3B0 45F0C13C512E0008 5146002C511C0003 FFFFFFFF90F1D00C
000140 41ED005CD74BE000 E000D203E000C3DC 98F1D00C5010E018 98F1D00C5000E014
Linkedit csect reverted source code
FMV/L03-LMODMAP-FMVALDD-------Module Linkedit Information --------------------Command ===>
Scroll ===> CSR
Commands: FIND(F), QUIT, SAVE
101
TITLE 'REVERTED SOURCE FOR CSECT - FMVALDD '
*
$EQUATE Register equate macro
FMVALDD CSECT
USING *,R15
B 14(,R15)
000000 04 47F0F00E
DC X'09'
000004 01 09
DC C'FMVALDD '
000005 08 C6D4E5C1D3C4C440
DC C' '
00000D 01 40
STM R14,R12,12(R13)
00000E 04 90ECD00C
L R12,952(,R15)
000012 04 58C0F3B8
.
DC
DC
DC
DC
DC
DC
END
C'FMVALDD '
C'SHR '
C'Y
'
F'0'
C'SVETSVEB'
C'LDD '
0003A0 08 C6D4E5C1D3C4C440
0003A8 08 E2C8D94040404040
0003B0 08 E840404040404040
0003B8 04 00000000
0003BC 08 E2E5C5E3E2E5C5C2
0003C4 04 D3C4C440
102
HELP - On-line Help
Help Topic Overview
The "HELP" function displays a specific help topic relating to a function entered or a directory of topics from which topics may
be selected. Topic specific displays discuss the function entered, field, commands and if available, line commands. If you want
to HELP on a topic other than the function you are currently using, enter the topic name on the command line and press the
HELP pfk.
To obtain a directory of all HELP topics
To obtain a directory of all HELP topics enter "?" or "*" on the command entry line and press the HELP pf. Help directories
may be restricted by entering a character A-Z on the command entry line and pressing the HELP pf key. If a limited topic list is
displayed and the entire directory is desired, press the HELP pf.
If the topic is unknown, the command FINDTEXT/FT with a keyword may be used to locate the topic. All topics containing the
keyword will be displayed in the HELP directory.
Help Topic Directory
Enter an "*" or "?" and press the HELP pf to display the help directory.
FMV/VxRx-HELP---------- Help Facility Directory --------------------------COMMAND ===>
SCROLL ===> CSR
Commands: F, FE, FT operands, L, RES(ACT)
Linecmds: F, L, Sel/cur, X
S Topic
Type
Action
Description
. ALLOC
BASIC
Allocate a file
. ALLOC
FUNCTION
Allocate VSAM/non-VSAM dataset
. ALLOCDD FUNCTION
Allocate data set on-line
. AMS
FUNCTION
Access Method Services
. AMSDELG SUBFUNC
AMS DELGDG delete GDG levels
. AMSGDG
SUBFUNC
AMS define GDG levels
Help topic type
FUNCTION
topics pertain to specific functions such as BROWSE, EDIT, selection lists.
SUBFUNC
topics pertain to subordinate functions within specific FUNCTIONS.
BASIC
topics pertain to commands pertaining to batch execution functions.
GENCMD
topics pertain to general commands entered in any FUNCTION.
CBOKCMD
topics pertain to copybook function commands.
EDITCMD
topics pertain to edit main commands.
LINECMD
topics pertain to edit line commands.
Commands
F
string
Find the string within the directory display.
FT
string <ALL>
Find text within members
RES
<ALL | ACT>
Reset the current display
103
Line commands
F
Unexclude first topic
L
Unexclude last topic
S
Select the topic
X
Exclude topic
Fields
S
Line command to select the help topic.
TOPIC
The topic name to be selected.
ACTION
Findtext action field.
TYPE
Topic type.
DESCRIPTION
Description of the topic.
104
Appendix A
Data Set Wildcard Processing
FileMarvel uses a generic filter key (wildcard) in the data set name field. A character string that describes the catalog entry
names for which data aet lists returned. The generic filter key can contain the following symbols and are interpreted as follows:
* A single asterisk by itself indicates that either a qualifier or
one or more characters within a qualifier can occupy that
position. An asterisk can precede or follow a set of characters.
** A double asterisk indicates that zero or more qualifiers can
occupy that position. A double asterisk cannot precede or follow
any characters; it must be preceded or followed by either a
period or a blank.
% A single percent sign by itself indicates that exactly one
alphanumeric or national character can occupy that position.
%% One to eight percent signs can be specified in each qualifier.
Examples:
VSAM.DATA.SET%
will return entry names:
VSAM.DATA.SET1
VSAM.DATA.SET2
will not return:
VSAM.DATA.SET30
VSAM.DATA.SET%%
will return entry names:
VSAM.DATA.SET30
VSAM.DATA.SET31
will not return:
VSAM.DATA.SET1
VSAM.DATA.SET2
VSAM.*.SET
will return entry names:
VSAM.DATA1.SET
VSAM.DATA2.SET
will not return:
VSAM.DATA.SET.KSDS
VSAM.*A
will return entry names:
VSAM.A
VSAM.BA
VSAM.BBA
will not return:
VSAM.B
VSAM.AB
VSAM.DATA.*
will return entry names:
VSAM.DATA.SET1
VSAM.DATA.SET2
will not return:
VSAM.DATA.SET.KSDS
VSAM.DATA*
will return entry names:
VSAM.DATA1
105
VSAM.DATA23
will not return:
VSAM.DATA.SET
VSAM.**
will return entry names:
VSAM
VSAM.DATA.SET1
VSAM.DATA.SET2
VSAM.DATA.SET.KSDS
will not return:
VSAM1.DATA.SET
VSAM.DATA.SET
will return entry name:
VSAM.DATA.SET only
**.DATA
will return entry names whose low level qualifier is DATA:
VSAM.DATA
NONVSAM.WORK.DATA
106
Download PDF