Getting Help Editor data formats

IBM To display help information from File Manager: To switch the display to a different format, change the
Format field to one of these values:
F1 Function key: same as the HELP
command CHAR (character) One record per line. Unformatted.
IBM File Manager for z/OS TABL (table) One record per line. Formatted
Base Feature Many fields on File Manager panels
have field-level help available. Place
(individual fields are shown).
Requires a template (or copybook).
your cursor on the field before pressing SNGL (single) One field per line. Formatted.
F1 to display it. Requires a template (or copybook)
HEX One record per three lines (one text
HELP Command. Display the help dialog
Quick Reference Card LHEX
line and two hexadecimal lines).
One hex-only record per line.

The display can also be changed to a different format

Using the Editor and Viewer using these commands in the editor:
FC Command or prefix command.
Starting the File Editor or Viewer Format CHAR.
FT Command or prefix command.
For detailed descriptions of commands, command syntax, and Use Edit to display and update records. Use View to display Format TABL.
options, refer to the File Manager for z/OS Users Guide manual. records only. Most editor commands can be used in the FS Command or prefix command.
A complete set of manuals can be obtained from the IBM File viewer, but changes to data are not saved in the viewer. Format SNGL.
Manager website. FH Command or prefix command.
http://www.ibm.com/software/awdtools/filemanager From the File Manager main menu, select option 1 for View, or Format HEX.
select the Library link 2 for Edit FL Command or prefix command.
Format LHEX.
ZOOM Command. Zoom in to one record or
zoom out.
The following paragraph does not apply to the United Kingdom or HEX ON Command. Display hexadecimal
data lines under the text lines.
any other country where such provisions are inconsistent with Entering file names when starting the editor HEX OFF Command. Do not display
local law: hexadecimal data lines under the
Using quotation marks:
INTERNATIONAL BUSINESS MACHINES CORPORATION text lines.
- When you enter a file name starting with a single quotation
PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY
mark, the exact file name is used as entered. An ending quotation
OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING,
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-
mark is optional. Editor Commands to locate records and fields
- When you enter a file name without a single quotation
INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A LOCATE rec-num Command. Position to (locate)
mark, the prefix string from your TSO profile is automatically or record number rec-num.
PARTICULAR PURPOSE. Some states do not allow disclaimer
added to the beginning of the file name. Enter a TSO HELP
of express or implied warranties in certain transactions, therefore, L rec-num Example: L 50
PROFILE command for information about your TSO profile.
this statement may not apply to you.
These wild card characters can be entered in a file name L string Command. Position to (locate) a
This information could include technical inaccuracies or when starting the editor to display a list of matching files: field name that contains string.
typographical errors. Changes are periodically made to the Example: L CUST
information herein; these changes will be incorporated in new ** Any number of characters, any number
of qualifiers L field-ref-# Command. Position to (locate) a
editions of the publication. IBM may make improvements and/or
field by its reference number.
changes in the product(s) and/or the program(s) described in this Any number of characters, within only
at any time without notice.
* one qualifier (between periods)
Example: L #12
L field-ref-#(subscript) Command. Position to (locate) an
% Only one character array data field by its reference
Examples: number and subscripts.
For Use with File Manager for z/OS Version 12 'TEST.**' These are examples show wild card Examples: L #12(5) L #15(5,10)
'TEST.AD**' characters entered as part of a file
L .label Command. Position to (locate) a
'TEST.*.CUST1' name. record you have labeled.
Copyright International Business Machines Corporation 'TEST.AD*.%U%%1'
Examples: L .ABC
2012. All rights reserved. 'TE**'
Revised June 25, 2012
Display record counts and file statistics
RECSTATS Command. Show record counts, file
size, and other statistics
Editor Commands to FIND and CHANGE data Frequently used prefix (line) commands Specifying a template for record formatting
FIND string Command: Find data that matches See the Users Guide for a complete list. A copybook or template can be specified on the Edit and
or string. String can be entered with or ? Display a list of available prefix View entry panels. It is used to format fields in records:
F string without quotation marks. commands (line commands) - Enter the copybook or template file and member name
Example: F ABC A After (use with C or M, for example) in the Copybook or Template data set name field
B Before (use with C or M, for example) - Enter 1 (above) in the Processing options Copybook /
CHANGE string Command: Find data that matches (note 1)
C or CC or Cn Copy record(s) Template field
to-string string and change it to to-string. Strings (note 1)
D or DD or Dn Delete record(s)
or can be entered with or without
In Insert record(s)
C string to-string quotation marks.
M or MM
(note 1)
or Mn Move record(s)
Editing a template
Example: C ABC XYZ (note 1) A template can be edited to specify record selection criteria,
O or OO or On Overlay record(s)
Examples of strings: (note 1) select fields to be displayed, re-order fields on the display,
R or RR or Rn Repeat record(s)
ABC (without quotes) change the display format of a field, and other tasks.
V View suppressed records
ABC (with quotes) (note 1)
X or XX or Xn Exclude record(s)
ABcdeFC (case sensitive) To edit a template, on the Edit Entry panel, specify / (slash)
XC1C240 (hexadecimal) Note 1: Enter on two lines to specify the first and last of a range of records in the Edit Template option.
123 (numeric) In addition, optionally enter these shortcuts in the Type
123.45 (numeric) field:
P. (picture specification) Editor Commands to copy records to other files 1 - shortcut to the By field record identification panel
CUT Command. Place records onto a 2 - shortcut to the By field record selection panel
Here are some optional parameters for FIND and CHANGE. Optional parameters: clipboard that are selected by C, S - display the Advanced Copybook Selection panel
See the Users Guide for a complete list: clipboard-name CC/CC, Cn (copy) or M, MM/MM, Mn
APPEND (move) prefix commands. These commands can be used from the editor:
ALL Find or change all occurrences and
REPLACE TE Command. (Template Edit) Edit the
display a count. Example:
NX current template
F ABC ALL
X
DE Command. Same as TE, but
field-ref-numbers Search only in specified fields.
PASTE Command. Insert records into the file shortcut to the By field record
Examples:
Optional parameters: from a clipboard created by a CUT. selection panel
F ABC #4 (field #4)
clipboard-name Specify the location with an A (after) or
F ABC (#5 #6 #10) (multiple fields)
KEEP B (before) prefix command. TV Command. (Template View) Display
F ABC #4 - #10 (range of fields)
DELETE the template workbench
column1 column2 Search only between these columns.
REPLACE Command. Replace all records in
Example: F ABC 10 20
another existing file and copy records VIEW, SHADOW, and SHOW commands
PREV Search up from the current location
from this file selected by C, CC/CC, Cn VIEW Command. Display suppressed
FIRST Search starting from the top
(copy) or M, MM/MM, Mn (move) prefix records of the type selected by the
LAST Search up starting from the bottom
commands. cursor
.lbl1 .lbl2 Search only between two labels
X Search only excluded records
CREATE Command. Similar to REPLACE, but V Prefix command. Similar to VIEW
NX Search only not-excluded records
creates a new file.
WORD Match only an entire word
SHADOW or Command. Display or hide shadow
PREFIX Match only if a word begins with string
APPEND Command. Similar to REPLACE, but SHAD lines (Excluded, Suppressed, and
SUFFIX Match only if a word ends with string
leaves existing records in the other file. Examples: Not Selected lines)
SHAD ALL ON Display all types of shadow lines
Other Find and Change commands: SHAD ALL OFF Hide all types of shadow lines
Commands to print records from the editor SHAD X OFF Hide excluded lines
FX Command: Display the extended Find
command pop-up window to enter a RP Command. (Record Print) Print the
long search string SHOW For suppressed or not selected
Options: record selected by the cursor records:
RPn Print n records - In CHAR format, display them as
CX Command: Display the extended RP ALL Print all records
Change command pop-up window data lines or as shadow lines
- In TABL format, display them as
RD Command. (Record Dump) Same as individual or grouped shadow lines
FE string Command: Find numeric data in error RP, but also print hexadecimal values.
(invalid numeric data). Scoping - In SNGL format, display them or
Examples: skip them when scrolling records
parameters can be used. PB Command. (Print Browse) Browse the SHOW SUP ON Show suppressed records (the not
print output data set. Note: In the Print currently viewed type of record)
CE string value Command: Find numeric data in error settings of your File Manager settings, SHOW SUP OFF Do not show suppressed records
(invalid numeric data) and change it to the Output destination option must be SHOW ALL ON Show suppressed and not selected
value. Scoping parameters can be set to data set.
used. records
 Online File Manager utilities for common tasks File Manager Batch Processing Examples
To do this task: This online utility can be used:
IBM
Edit a file Edit utility menu option 2 Example 1: Copy all records
These JCL and control statements are similar to what are created
IBM File Manager for z/OS View a file View utility menu option 1 automatically by the online File Manager COPY utility.
//FILEMGR EXEC PGM=FILEMGR
Base Feature Delete a file DS List utility menu option 3.4 use //SYSPRINT DD SYSOUT=*
the DEL command //FMNTSPRT DD SYSOUT=*
//SYSTERM DD SYSOUT=*
Create a new file DS List utility menu option 3.4 use //SYSIN DD *
Quick Reference Card the DEF command $$FILEM SET HEADERPG=NO,PAD=OFF
$$FILEM DSC DSNIN=USER1.ADLAB.CUST1,
Create a new file DS List utility menu option 3.4 enter $$FILEM PACK=NONE,
based on an existing a file name with optional wild cards to $$FILEM IGNLEN=YES,
Online Utilities model file display a file list. Then enter DEF as a $$FILEM DISP=OLD,
line command next to the model file. $$FILEM DSNOUT=USER1.ADLAB.CUST1.CPY
and Batch Processing Examples
Copy a file Copy utility menu option 3.3
Example 2: Copy all records
Copy and reformat a Copy utility menu option 3.3 use a This is similar to example 1, except the control cards are
file copybook (or template) that describes simplified and use the default options, and file names are
For detailed and complete descriptions of utilities, and batch JCL the input file records, and use a specified in DDs rather than control cards.
and control statements, refer to the File Manager for z/OS Users different copybook (or template) that //FILEMGR EXEC PGM=FILEMGR
Guide manual. A complete set of manuals can be obtained from describes the records as they should //SYSPRINT DD SYSOUT=*
the IBM File Manager website. be after reformatting //FMNTSPRT DD SYSOUT=*
http://www.ibm.com/software/awdtools/filemanager
//SYSTERM DD SYSOUT=*
select the Library link Print a file Print utility menu option 3.2 //DDIN DD DSN=USER1.ADLAB.CUST1,DISP=SHR
//DDOUT DD DSN=USER1.ADLAB.CUST1.CPY,DISP=OLD
Search for data in a Find/Change utility menu option 3.6 //SYSIN DD *
file $$FILEM DSC
/*
The following paragraph does not apply to the United Kingdom or Search a PDS or Find/Change utility menu option 3.6
any other country where such provisions are inconsistent with library for data in
members Example 3: Copy all records
local law: This is similar to example 2, except the names of the input
INTERNATIONAL BUSINESS MACHINES CORPORATION Make changes to a Find/Change utility menu option 3.6 and output DDs are not the defaults.
PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY file, or to multiple //FILEMGR EXEC PGM=FILEMGR
OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, PDS or library //SYSPRINT DD SYSOUT=*
BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON- members //FMNTSPRT DD SYSOUT=*
INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A //SYSTERM DD SYSOUT=*
PARTICULAR PURPOSE. Some states do not allow disclaimer //DD01 DD DSN=USER1.ADLAB.CUST1,DISP=SHR
Display a list of files DS List utility menu option 3.4 enter
of express or implied warranties in certain transactions, therefore, //DD01O DD DSN=USER1.ADLAB.CUST1.CPY,DISP=OLD
a file name with optional wild cards to
this statement may not apply to you. //SYSIN DD *
display a file list
$$FILEM DSC INPUT=DD01,OUTPUT=DD01O
/*
This information could include technical inaccuracies or Display information Loadlib utility menu option 3.10
typographical errors. Changes are periodically made to the about load modules
information herein; these changes will be incorporated in new
editions of the publication. IBM may make improvements and/or Display layout Copybook utility menu option 3.13
changes in the product(s) and/or the program(s) described in this information about a
at any time without notice. copybook

Compare two files Compare utility menu option 3.11

For Use with File Manager for z/OS Version 12
Copyright International Business Machines Corporation
2012. All rights reserved.
Revised June 25, 2012
Automatically generating JCL and control
statements for File Manager batch processing
In TSO, use the online panels/dialog for the File Manager utility
you want to use. Look for a Batch Execution selection or option.
Select this option by entering / (slash) next to it. Then continue
through the dialog. When the dialog completes, JCL and control
statements are automatically generated and displayed.
Example 4: Copy selected records from one file Example 7: Record selection for a list of values Frequently used REXX functions
to another, with optional reformatting Note: JCL is the same as in example 2 Here are a few commonly used REXX functions used with File
This example shows several methods of selecting records: //SYSIN DD * Manager. See the Users Guide for a list of functions and
- The optional TDDIN DD specifies an input template or $$FILEM DSC PROC=* their options:
copybook. An input template can contain record selection IF FLDI(6,17,C,CU,'THIS') THEN RETURN
criteria. Only selected records are copied. IF FLDI(6,17,C,CU,'THAT') THEN RETURN FLD ( start, length, type )
- The optional TDDOUT DD specifies an output template or IF FLDI(6,17,C,CU,'THOSE') THEN RETURN - Returns the value of a field in the input record
copybook. An output template may be used to reformat RETURN DROP - Examples:
records if it has layout(s) different from the input template. /+ if FLD(1,5) = Smith then return
- POSITION= specifies the beginning record number - - - alternate coding: - - - if FLD(28,5,P) > 75000 then return
//SYSIN DD *
- KEY= specifies the beginning key value
$$FILEM DSC PROC=* FLDI ( start, length, type, operator, value-list )
- NLRECS= specifies the max number of records to be copied
//FILEMGR EXEC PGM=FILEMGR IF FLDI(6,17,C,CU,'THIS','THAT','THOSE'), - Performs a conditional test against a field in the input record
//SYSPRINT DD SYSOUT=* THEN RETURN - Examples:
//FMNTSPRT DD SYSOUT=* RETURN DROP if FLDI(1,20,C,CU,SMITH,JONES) then return
//SYSTERM DD SYSOUT=* /+ if FLDI(28,5,P,>,75000) then return
//DDIN DD DSN=USER1.ADLAB.CUST1,DISP=SHR
//TDDIN DD DISP=SHR,DSN=USER1.TEMPLATE(CUST1) Example 8: Copy and split a file FLD_OUT ( in-start, in-length, out-start, out-length, pad )
//DDOUT DD DSN=USER1.ADLAB.CUST1.COPY,DISP=SHR This example shows how a file can be copied to two other files at - Overlays the output record with a field from the input record
//TDDOUT DD DISP=SHR,DSN=USER1.TEMPLATE(CUST1R) the same time with different selections for each. - Examples:
//SYSIN DD * //FILEMGR EXEC PGM=FILEMGR FLD_OUT(100,20,1,20)
$$FILEM DSC , //SYSPRINT DD SYSOUT=* FLD_OUT(100,20,1)
$$FILEM POSITION=5000, Use Position= or //FMNTSPRT DD SYSOUT=*
$$FILEM KEY='key-value-XYZ', Key= but not both //SYSTERM DD SYSOUT=* OVLY_OUT ( expression, start, length, type, pad )
$$FILEM NLRECS=1000 //DDIN DD DSN=USER123.ADLAB.CUST1,DISP=SHR - Overlays the output record with a literal or expression
/* //DDOUT DD DSN=USER1.ADLAB.CUST1.CPY,DISP=OLD - Examples:
//DDOUT2 DD DSN=USER1.ADLAB.CUST1.CPY2,DISP=OLD OVLY_OUT('ABCD',1)
Example 5: Use REXX for record selection //SYSIN DD * OVLY_OUT(50000,10,5,P)
This example shows how to add a REXX program to a File $$FILEM DSC PROC=*
Manager utility. These sample REXX programs select records. IF FLDI(1,0,C,'CO','THIS') , PRT_OUT ( format, count )
- RETURN DROP returns with the record NOT selected THEN DO - Prints the current record in the specified format. Count limits
- RETURN returns with the record selected WRITE() /* write to default DDOUT */ the maximum number of records that will print.
- Note: RETURN is assumed at the end of the program END - Examples:
Note: JCL is the same as in example 2 ELSE DO PRT_OUT(HEX,5)
//SYSIN DD * WRITE(DDOUT2) /* else write to DDOUT2 */ PRT_OUT(TABL)
$$FILEM DSC PROC=* END
IF FLD(17,3) /= 'ABC' THEN RETURN DROP RETURN DROP /* avoids duplicates to DDOUT */ TALLY ( start, length, type, label )
/+ Note: case sensitive /+ - Accumulates the value of a field in the input record. The
- - - alternate coding (same result) - - - result is automatically printed.
//SYSIN DD * - Example:
Example 9: Copy and print If FLDI(1,1,,,E) then TALLY(15,4,B,Sum of type E)
$$FILEM DSC PROC=* This example shows how to copy all records, and print the first 25
IF FLD(17,3) = 'ABC' THEN RETURN records in hexadecimal format.
RETURN DROP WRITE ( ddname_list )
Note: JCL is the same as in example 2
/+ Note: case sensitive - Writes the current output record to the specified output files
//SYSIN DD *
$$FILEM DSC PROC=* - Examples:
WRITE()
Example 6: Comparing various data types $$FILEM SET DUMP=UPDOWN
WRITE(DDOUT1)
This example shows an how to compare against various types of $$FILEM DSC PROC=*
fields in the input record. PRT_OUT('HEX',25) /* DUMP 25 records */
Note: JCL is the same as in example 2 /+
//SYSIN DD * Where to get reference information about File
$$FILEM DSC PROC=* Manager batch processing
IF FLD(10,4) = 'THIS' &, /* case sensitive */ The IBM File Manager for z/OS User's Guide and Reference
FLD(20,4,U) = 'THAT' &, /* not case sens. */ manual describes batch processing in detail and provides
FLD(30,2) = 'C1C2'X &, /* hexadecimal */ examples. Refer to Chapter 13 - Enhancing File Manager
FLD(40,5,P) = 1234 &, /* packed decimal */ processing for general information. For a list of File Manager
FLD(50,4,B) = 567 &, /* binary numeric */ base feature batch utilities, refer to the File Manager Functions
FLD(60,6,Z) = 89 &, /* zoned decimal */ section of Chapter 16 Functions. For reference information for
FLD_TYPE(70,6,P)=1, /* chk valid num data */ REXX functions, refer to the External REXX functions section of
THEN RETURN Chapter 16 Functions. File Manager manuals are available at
RETURN DROP www.ibm.com/software/awdtools/filemanager
/+