Sei sulla pagina 1di 1215

IBM File Manager for z/OS

User’s Guide and Reference

Version 10 Release 1

SC19-2857-00

IBM File Manager for z/OS

User’s Guide and Reference

Version 10 Release 1

SC19-2857-00

Note! Before using this information and the product it supports, be sure to read the

Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page 1165.

this information and the product it supports, be sure to read the general information under “Notices”

First Edition (November 2009)

This edition applies to Version 10 Release 1 Modification Level 0 of IBM File Manager for z/OS (program number 5655-V52) and to all subsequent releases and modifications until otherwise indicated in new editions.

Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address given below.

This publication is available on the Web at:

www.ibm.com/software/awdtools/filemanager/

A form for readers’ comments appears at the back of this publication. If the form has been removed, address your

comments to:

IBM Corporation

H150/090

555 Bailey Avenue San Jose, CA

95141-1003

U.S.A.

or

fax your comments from within the U.S., to: 800-426-7773 or, from outside the U.S., to: 408-463-2629.

or

use the form on the Web at:

www.ibm.com/software/awdtools/rcf/

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 2000, 2010. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

About this document

xi

 

Who should use this Prerequisite and related information Using LookAt to look up message explanations . How to read syntax diagrams

.

.

.

.

.

 

.

xii

xii

 

.

xiii

 

xiii

Summary of changes

xvii

First Edition (November 2009)

xvii

Part 1. Working with File Manager

1

Chapter 1. File Manager overview

.7

File Manager actions. Data sets and records

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

 

.

.7

.

.8

Templates

. Why use a template?

. What can you do with a template? Where can you use templates? .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.9

.9

10

.

.

11

Chapter 2. Getting started with File

Manager .

.

.

.

.

.

.

.

.

.

.

.

.

. 13

Starting and exiting File Manager .

.

.

.

.

.

.

13

. Checking your File Manager version .

Starting File Manager

.

. Checking which COBOL compiler you’re using

.

.

.

.

.

.

.

 

.

.

13

15

17

Exiting from File Manager

.

.

.

.

.

.

17

Invoking File Manager panels from outside File

 

Manager

.

.

.

.

.

.

.

.

.

.

.

.

17

Using the File Manager interface Navigating in File Manager .

.

.

.

.

.

.

.

.

.

.

.

.

18

.

.

18

. Specifying quoted strings .

Issuing commands

.

.

Specifying a data set and a member name . Manipulating your view of selection lists

.

.

.

.

.

.

.

.

.

.

.

.

.

19

.

.

20

.

.

20

||

.

.

25

Selecting a range of PDS(E) members .

.

.

.

.

30

Using hexadecimal values in File Manager .

. Displaying field help information .

.

.

.

Getting help

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

33

34

.

.

34

Accessing Tutorial Help Viewing error messages

. Set print processing options (option 0.1) .

.

.

.

. Setting your default processing options .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

35

.

.

.

.

.

.

37

37

39

Setting your System Processing Options (option

 

.

. Set batch job card information (option 0.4) .

0.2) .

. Set tape processing options (option 0.3) .

. Language and compiler specifications (option 0.5) 41

Editor options (option 0.6)

42

39

41

41

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

41

. VSAM edit sharing options (option 0.7) .

.

.

.

.

.

. Temporary Data Set Allocations (option 0.8)

.

.

42

Output Data Set Allocations (option 0.9) .

.

.

.

42

||

Trace options (option 0.10)

.

.

.

.

.

.

.

.

42

Displaying or editing DBCS characters

.

.

.

.

42

National characters

.

.

.

.

.

.

.

.

.

43

Chapter 3. Viewing and changing data

sets .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 45

Starting and ending editor sessions

 

.

.

.

.

.

.

47

Starting an editor session without using

 

templates

.

.

.

.

.

.

.

.

.

.

47

Starting an editor session with a template

 

.

.

.

49

Viewing and changing packed data

.

.

.

.

.

52

Listing statistics for the current editor session .

 

.

54

Displaying your current editor options

 

.

.

.

.

55

Ending an editor session .

.

.

.

.

.

.

.

.

56

Displaying the RBA and record length information

57

Managing the prefix area

 

.

.

.

.

.

.

58

Manipulating your view of the data

.

.

.

.

.

.

60

Using primary commands in an editor session.

 

.

61

Selecting a display format

.

.

.

.

.

.

.

.

61

Displaying a column identification line

 

.

.

.

.

65

Zooming in to see all of a record

 

.

.

.

.

.

.

67

Displaying the record length.

.

.

.

.

.

.

.

69

Scrolling to see data

.

.

.

.

.

.

.

.

.

.

72

Scrollable input and display fields for long .

names .

.

.

.

.

.

.

.

.

.

.

.

.

.

75

.

.

.

.

.

.

.

.

77

Sorting the data Finding specific data

. Excluding records from display.

.

.

.

 

.

.

.

.

.

.

.

.

.

.

.

.

79

82

Working with File Manager and shared files

 

.

.

.

84

Overview of shared file features

 

.

.

.

.

.

.

84

What File Manager considers a shared file .

 

.

.

84

Record integrity checking.

.

.

.

.

.

.

.

.

84

Refreshing the contents of a record

 

.

.

.

.

.

88

Editing techniques

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

92

In-place-in-memory edit

.

.

.

.

.

.

.

93

In-place edit

.

.

.

.

.

.

.

93

In-memory edit

.

.

.

.

.

.

.

93

Auxiliary edit KSDS edit Editing large files

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

94

95

95

Editing load modules .

.

.

.

.

.

.

.

95

Changing data .

.

.

.

.

.

.

.

.

.

.

.

.

95

Changing data in individual records .

 

.

.

.

.

96

Change data in multiple records

 

.

.

.

.

.

.

97

Locating labeled records .

.

.

.

.

.

.

.

.

.

98

Changing the case of data

Finding and replacing strings

.

.

.

.

.

.

.

.

.

.

.

.

.

.

98

99

Changing invalid numeric fields in your data

 

103

Limiting the effect of editing changes

 

.

.

.

.

.

103

.

.

.

.

.

.

.

.

104

Setting bounds Setting column ranges

. Limiting the search to specified fields

Excluding records .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

105

106

107

. Labelling record ranges .

.

.

.

.

.

.

.

.

108

Editing records within data sets

.

.

.

.

.

.

.

110

Inserting records

.

.

.

.

.

.

.

.

.

.

.

111

Deleting records

.

.

.

.

.

.

.

.

.

.

.

111

Recovering deleted records .

.

.

.

.

.

.

.

112

Moving

.

.

.

.

.

.

.

.

112

. Overlaying data in existing records .

Copying and repeating records

.

.

.

.

.

.

.

.

.

113

114

Copying data to and from a clipboard .

.

.

.

116

Copying data from another data set .

.

.

.

.

117

Splitting and joining lines

.

.

.

.

.

.

.

118

Changing the length of a record

.

.

.

.

.

120

Chapter 4. Creating and editing

 

templates

.

.

.

.

.

.

.

.

.

121

Template types and structure

.

.

.

.

.

.

121

Information stored in a template .

.

.

.

.

.

121

About copybook templates .

.

.

.

.

.

.

.

.

.

123

Segmented data templates .

.

.

.

.

.

125

.

.

.

.

.

.

.

.

128

About dynamic templates Data description support

. Using HLASM copybooks with File Manager

.

.

.

.

.

Managing templates

.

.

.

.

.

.

.

.

.

.

128

132

134

. Setting your template processing options

.

.

.

134

Specifying or updating the source definition for

a copybook template

.

.

.

.

.

.

.

140

. Advanced copybook selection .

.

.

.

.

.

.

141

Creating a copybook template with the

 

Template Workbench

.

.

.

.

.

.

.

.

144

Setting up a template to be used with

 

segmented data

.

.

.

.

.

.

.

.

.

.

.

145

Creating a template from a model template

.

.

145

Creating dynamic templates

.

.

.

.

.

.

.

146

Creating corresponding templates from selected

 

copybooks

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

149

Editing a template

Updating one or more templates .

.

.

.

.

.

.

.

.

.

.

150

154

Manipulating the display of fields in records .

.

.

156

Selecting and deselecting fields

.

.

.

.

.

.

156

Changing the field display order .

.

.

.

.

.

157

Changing field headings.

.

.

.

.

.

.

.

.

.

.

.

158

Changing field attributes

.

.

.

.

.

158

Displaying alphanumeric fields in long

 

hexadecimal .

. Managing templates with the Template Workbench

.

.

.

.

.

.

.

.

.

.

.

160

161

. Editing related ID criteria

Editing a template (E)

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

161

161

Updating a template from a copybook (U).

.

.

167

Running a panel using a copybook or template

(RC or RT)

.

.

.

.

.

.

.

.

.

.

168

. Mapping fields (MC or MT)

.

.

.

.

.

.

.

169

Generating and editing field mapping (GM, GE

and EM)

.

.

.

.

.

.

.

.

.

.

169

. Mapping contiguous fields .

.

.

.

.

.

.

.

.

.

170

Specifying scrambling options .

.

.

.

.

.

170

Selecting a field for specifying scrambling

options

.

.

.

.

.

.

.

.

.

.

.

.

.

170

. Mapping fields between templates

.

.

.

.

.

.

174

Default field mapping

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

174

Editing the field mapping

.

.

.

.

.

177

Field mapping rules

.

.

.

.

.

182

Copybook View and Print Utility (option 3.13 or

 

7.2) .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

183

Chapter 5. Filtering records with

templates

.

.

.

.

.

.

.

.

.

185

Selecting records with templates

.

.

.

.

.

.

.

.

185

Selecting records by record type .

.

.

185

Specifying record identification criteria .

.

.

.

186

Specifying record selection criteria

.

.

.

.

.

.

.

.

.

.

188

Specifying offset values

.

.

188

Defining criteria expressions

Entering criteria as a freeform expression .

.

.

.

.

189

190

Entering criteria by

.

.

.

.

.

.

.

191

About expression processing

Examples of REXX comparison expressions

.

.

.

.

195

205

Filtering record display using templates

.

.

.

.

206

Displaying “suppressed” records .

.

.

.

.

.

.

.

206

Changing display of the record type.

.

.

207

Displaying “not-selected” records

.

.

.

.

.

208

Hiding or showing records in SNGL display

format .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

210

Using the SHOW command in an editor session

210

Viewing segmented

.

.

.

.

.

211

Adjusting your view to allow for header

information

.

.

.

.

.

.

.

.

.

213

Chapter 6. Managing data sets

217

Working with data set lists .

.

.

.

.

.

.

.

.

217

. Managing personal data set lists .

Accessing data set lists

. Retrieving details from a data set list

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

218

219

222

Allocating program function keys

.

.

.

.

.

223

Creating data sets and records.

. Creating data without using a template

.

.

.

.

.

.

.

.

.

.

.

224

224

Creating data sets using a template .

.

.

226

Allocating a new data set

.

.

.

.

.

228

Setting the Data Create Attributes in your

template

.

.

.

.

.

.

.

.

.

.

228

Creating, replacing, and adding data using existing

 

data

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

228

Creating a new member or data set using data

 

from an edit session

.

.

.

.

.

.

229

Replacing a member or data set using data from

an edit session

.

.

.

.

.

.

.

.

231

Adding data to a data set using data from an

edit session

.

.

.

.

.

.

.

.

.

232

Using all the data from an edit session to create

 

a new member or data set .

.

.

.

.

.

.

.

233

Copying data sets .

. Copying without using a template

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

235

236

. Copying using a copybook or template .

Renaming members as you copy .

.

.

.

.

.

.

.

240

241

Scrambling data

.

.

.

.

.

.

.

.

.

.

.

244

Copying records with segmented data templates Generating data in external format - XML

244

representation

.

.

.

.

.

.

.

.

245

Copying files or members containing JCL .

.

.

248

Using a DFSORT or REXX procedure

.

.

.

.

248

REXX member selection

.

.

.

.

.

250

Finding and changing data in multiple PDS

members .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

252

Building your member list for processing .

.

.

253

Refining the list of selected members

.

.

.

.

254

Specifying where your results are stored

.

.

.

255

Specifying your processing options .

.

.

.

.

.

255

Specifying multiple arguments for FIND

.

.

257

Using the CHANGE command in the

Find/Change Utility

.

.

.

.

.

.

.

258

FSF.

FSR.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

326

327

. Specifying context in the output listing . Changing data with a REXX procedure .

.

.

.

.

.

.

259

260

LOCATE .

.

RD .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

327

327

Working with files or members containing JCL

.

.

260

REW

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

327

Comparing data sets .

.

.

.

.

.

.

.

.

.

.

263

RFIND

.

.

.

.

.

.

.

.

.

.

.

.

.

.

327

Comparing data sets without using a template

264

RP

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

327

Comparing data sets using templates

.

.

.

.

266

RUN .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

327

Record synchronization .

.

.

.

.

.

.

.

.

270

TOF

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

328

Creating key sequencing for use in a

multi-segment Comparison output .

.

. Formatted comparison of unlike fields .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

272

273

277

ZOOM

. Tape Browse (option 4.1)

. Tape Data Copy Function (option 4.2)

.

.

.

.

.

.

.

.

.

.

.

Tape to Tape (option 4.2.1) .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

328

328

329

330

Comparing load modules .

.

Setting your Print Processing Options

.

.

.

.

.

.

.

.

.

.

.

.

278

280

280

282

Tape to Tape Reblocked (option 4.2.2)

Tape to VSAM (option 4.2.4)

.

.

.

.

.

.

.

330

Printing from File Manager.

.

.

.

.

.

.

Tape to Labeled Tape (option 4.2.3) .

.

.

.

.

.

.

.

.

330

331

Printing data sets

.

.

.

.

.

.

.

.

.

Tape to Sequential Data (option 4.2.5)

.

.

.

.

331

Using a DFSORT or REXX procedure

REXX member selection .

. Printing a single record .

Printing DBCS data

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

284

285

287

288

. Sequential Data to Tape (option 4.2.7)

VSAM to Tape (option 4.2.6)

.

.

Exported Stacked Volume Copy (option 4.2.8)

Copying tape data across a network .

.

.

.

.

.

.

.

.

.

.

.

.

332

332

332