IBM OS-390 User Manual

4 (1)
IBM OS-390 User Manual

IBML

VSE to OS/390 Migration Workbook

Cliff Bays ** Dave Greenough ** John Hutchinson

Dan Janda ** Kevin Jones ** Gilbert Saint-flour

International Technical Support Organization

http://www.redbooks.ibm.com

This book was printed at 240 dpi (dots per inch). The final production redbook with the RED cover will be printed at 1200 dpi and will provide superior graphics resolution. Please see ªHow to Get ITSO Redbooksº at the back of this book for ordering instructions.

SG24-2043-00

IBML

International Technical Support Organization

SG24-2043-00

 

VSE to OS/390 Migration Workbook

October 1998

Take Note!

Before using this information and the product it supports, be sure to read the general information in Appendix D, ªSpecial Noticesº on page553.

First Edition (October 1998)

This edition applies to Version 2 Release 3 of IBM Virtual Storage Extended/Enterprise Systems Architecture (VSE/ESA), Program Number 5690-VSE, and to all subsequent releases and modifications until otherwise indicated in new editions. It also applies to Version 2 Release 4 of OS/390 (5647-A01) and to all subsequent releases and modifications until otherwise indicated in new editions.

Comments may be addressed to:

IBM Corporation, International Technical Support Organization Dept. HYJ Mail Station P099

522 South Road

Poughkeepsie, New York 12601-5400

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

© Copyright International Business Machines Corporation 1998. All rights reserved.

Note to U.S. Government Users Ð Documentation related to restricted rights Ð Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.

Contents

Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xvii

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xix

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xxi

The Team That Wrote This Redbook . . . . . . . . . . . . . . . . . . . . . . . .

xxi

Redbook Builders and Key Contributors . . . . . . . . . . . . . . . . . . . .

xxi

Authors and Significant Contributors . . . . . . . . . . . . . . . . . . . . . .

xxii

Comments Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xxii

Part 1. Planning the Migration - An Introduction

. . . . . . . . . . . . . . . . . . . . . . . . .

1

Chapter 1. Why Customers Migrate

. . . . . . . . . . . . . . . . . . . . . . . . .

3

1.1A Synopsis of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2Traditional Reasons for Migrating . . . . . . . . . . . . . . . . . . . . . . . . 4

1.2.1Business Consolidation . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.2.2Mergers/Acquisitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.2.3Capacity Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.2.4 Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9

1.3 Functional Reasons for Migrating to OS/390 . . . . . . . . . . . . . . . . . .

10

1.3.1Applications Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.3.2Systems Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1.3.3Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.3.4Systems Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.3.5Staff Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Chapter 2. Sizing the Effort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

2.1 Introduction to Sizing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

2.1.1

Defining the Migration Project Objectives . . . . . . . . . . . . . . . . .

13

2.1.2

Areas of VSE and OS/390 Differences . . . . . . . . . . . . . . . . . . .

14

2.1.3

Comparison of Basic VSE Functions & Components to OS/390 . . . .

16

2.2 OS/390 Components/Products/Subsystems . . . . . . . . . . . . . . . . . .

18

2.2.1

The OS/390 Operating Environment . . . . . . . . . . . . . . . . . . . .

19

2.2.2

Subsystem Level Comparison/Affinity . . . . . . . . . . . . . . . . . . .

24

2.3What Changes Between VSE and OS/390? . . . . . . . . . . . . . . . . . . . 24

2.3.1Philosophical Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

2.4Who is Affected by This Migration? . . . . . . . . . . . . . . . . . . . . . . . 26

2.4.1Job Roles and Normal Activities . . . . . . . . . . . . . . . . . . . . . . 26

2.5Approaches to Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.5.1Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2.5.2 OS/390 Conversion and Production Implementation Strategies . . . . 27 2.5.3 VM/ESA Guest Support in Your VSE to OS/390 Migration . . . . . . . 29

2.5.4Staffing Strategies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

2.5.5Conversion Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

2.6Educational Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.6.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.7Scope of Work and Challenges . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.7.1Application Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

2.7.2Program Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.7.3JCL Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

2.7.4File Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

© Copyright IBM Corp. 1998

iii

2.7.5Project Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

2.7.6Automated Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

2.8Cost Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

2.9OS/390 Documentation Resources . . . . . . . . . . . . . . . . . . . . . . . 39

2.9.1Introduction References . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

2.9.2

Key Documents and Other References . . . . . . . . . . . . . . . . . .

40

2.9.3

Web URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

40

Chapter 3. Developing the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . .

41

3.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.1.1References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.1.2Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.2Plan Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

3.2.1Approach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

3.2.2Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

3.2.3Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

3.2.4Milestone Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

3.2.5Education . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

3.3 Progressive versus Mass Conversion . . . . . . . . . . . . . . . . . . . . . . 49

3.3.1Approach Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

3.3.2Historical Perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

3.3.3 Shared Application Files and Databases . . . . . . . . . . . . . . . . . 50

3.3.4Shared Application Code . . . . . . . . . . . . . . . . . . . . . . . . . . 50

3.3.5Operations Support Staffing . . . . . . . . . . . . . . . . . . . . . . . . . 50

3.3.6Automated Operations Tools . . . . . . . . . . . . . . . . . . . . . . . . 50

3.3.7 Standardized Conversion Deliverables and Automation . . . . . . . . 51

3.3.8Risk Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

3.3.9Complexity of Implementation . . . . . . . . . . . . . . . . . . . . . . . 51

3.4Plan Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

3.4.1Project Schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

3.4.2Project Plan Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Part 2. Converting the VSE Operating System to the OS/390 Operating System

. .

67

Chapter 4. Job Control Language (JCL) Differences and Considerations

. . .

69

4.1 The Philosophy of JCL in System/390 . . . . . . . . . . . . . . . . . .

. . . .

69

4.1.1 VSE/ESAs Job Control Language Philosophy . . . . . . . . . .

. . . .

70

4.1.2OS/390s Job Control Philosophy . . . . . . . . . . . . . . . . . . . . . . 70

4.2High Level Similarities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

4.2.1JCL Statement and Job Layout . . . . . . . . . . . . . . . . . . . . . . . 72

4.2.2Spooling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

4.3 JCL Differences Between VSE and MVS . . . . . . . . . . . . . . . . . . . . 73

4.3.1Job Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

4.3.2JCL Expansion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

4.3.3 Operator Flexibility and Intervention . . . . . . . . . . . . . . . . . . . . 76

4.3.4Allocation of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

4.3.5Hidden JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

4.3.6Device Address Specifications . . . . . . . . . . . . . . . . . . . . . . . 80

4.3.7Catalogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

4.3.8Partition Dependent Codes in JCL . . . . . . . . . . . . . . . . . . . . . 81

4.3.9 Communication Region - DATE and UPSI . . . . . . . . . . . . . . . . . 81

4.3.10VSE Job Control Statements . . . . . . . . . . . . . . . . . . . . . . . . 82

4.3.11MVS Job Control Statements . . . . . . . . . . . . . . . . . . . . . . . 84

4.3.12 Comparison of VSE and MVS JCL - A Summary . . . . . . . . . . . . 86

iv VSE to OS/390 Migration Workbook

4.3.13

Summary of MVS JCL Statements . . . . . . . . .

. . . . . . . . . . .

88

4.4

JECL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . .

89

4.4.2

Comparison of POWER and JES2 JECL - A Summary

. . . . . . . . .

89

4.4.3

Summary of JES2 JECL - A Table . . . . . . . . . .

. . . . . . . . . . .

90

4.5

VSE and MVS JCL Comparison Example . . . . . . . . .

. . . . . . . . . . .

91

4.5.1Sample VSE JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

4.5.2Sample MVS JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

4.5.3Sample VSE plus Carry-Over . . . . . . . . . . . . . . . . . . . . . . . . 94

Chapter 5. Disk and Tape Storage Considerations

. . . . . . . . . . . . . . . .

97

5.1 Access Method Similarities and Differences

. . . . . . . . . . . . . . . . . .

97

5.1.1

Access Methods . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . .

97

5.1.2

Operating System Implementations . .

. . . . . . . . . . . . . . . . . .

98

5.1.3Miscellaneous Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

5.2Data Set Naming Considerations . . . . . . . . . . . . . . . . . . . . . . . . 99

5.2.1VSE Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

5.2.2OS/390 Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

5.3Storage and Space Management . . . . . . . . . . . . . . . . . . . . . . . 100

5.3.1VSE Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

5.3.2OS/390 Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

5.3.3System Managed Storage . . . . . . . . . . . . . . . . . . . . . . . . . 100

5.3.4Implementing DFSMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

5.4Tape Similarities and Differences . . . . . . . . . . . . . . . . . . . . . . . 103

5.4.1Volume Interchangeability . . . . . . . . . . . . . . . . . . . . . . . . . 103

5.4.2Standard Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

5.4.3No Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

5.4.4Nonstandard Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

5.4.5 Bypass Label Processing Facility in OS/390 . . . . . . . . . . . . . . 106

5.5DASD Similarities and Differences . . . . . . . . . . . . . . . . . . . . . . 108

5.5.1Volume Interchangeability . . . . . . . . . . . . . . . . . . . . . . . . . 108

5.5.2DASD (VTOC) Processing . . . . . . . . . . . . . . . . . . . . . . . . . 108

5.5.3 Indexed VTOC Considerations (OS/390) . . . . . . . . . . . . . . . . . 109

5.6VSAM Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

5.6.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

5.6.2OS/390 Catalogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

5.6.3OS/390 Catalog Management . . . . . . . . . . . . . . . . . . . . . . . 114

5.6.4 OS/390 - VSE/VSAM Catalog Compatibility . . . . . . . . . . . . . . . 117

5.6.5VSAM Functional Differences . . . . . . . . . . . . . . . . . . . . . . . 119

5.6.6Data Sharing and Integrity . . . . . . . . . . . . . . . . . . . . . . . . . 125

5.6.7

Programming Languages and VSAM Support . . . . . . . . . . . . .

131

5.6.8

VSAM Error and Reason Code Compatibility . . . . . . . . . . . . . .

131

5.6.9

DFSORT and VSAM Considerations . . . . . . . . . . . . . . . . . . .

131

Chapter 6. CICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

133

6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

133

6.1.1

Overview CICS Transaction Server . . . . . . . . . . . . . . . . . . .

133

6.1.2

Essential Supplemental Reading and Migration Support Material .

134

6.1.3

General Compatibility Comments . . . . . . . . . . . . . . . . . . . .

135

6.1.4

Virtual Storage Considerations for MVS . . . . . . . . . . . . . . . . .

135

6.1.5

CICS General System Considerations . . . . . . . . . . . . . . . . . .

136

6.1.6

CICS Macro Resource Definition Table Changes . . . . . . . . . . .

140

6.1.7

CSD and RDO Considerations . . . . . . . . . . . . . . . . . . . . . .

143

6.1.8

CICS System Data Sets Requirements . . . . . . . . . . . . . . . . .

145

6.1.9

CICS System Program Interface and Exits . . . . . . . . . . . . . . .

147

6.1.10

CICS Transaction Security . . . . . . . . . . . . . . . . . . . . . . . .

149

Contents v

6.1.11CICS UPSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

6.1.12Application Programming . . . . . . . . . . . . . . . . . . . . . . . . 150

6.1.13 CICS/VSE and TS Coexistence Considerations . . . . . . . . . . . . 153

6.1.14Testing and Problem Determination Considerations . . . . . . . . . 153

6.1.15Vendor Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

6.2CICS with DL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Chapter 7. ICCF and TSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

7.1Preparing to Use the System . . . . . . . . . . . . . . . . . . . . . . . . . . 155

7.1.1User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

7.1.2LOGON Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

7.1.3Message Facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

7.1.4Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

7.1.5Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

7.2Using the System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

7.2.1Accessing the System . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

7.2.2Entering and Manipulating Data . . . . . . . . . . . . . . . . . . . . . 159

7.3Executing Programs at a Terminal . . . . . . . . . . . . . . . . . . . . . . 161

7.4

Submitting Jobs for Batch Execution . . . . . . . . . . . . . . . . . . . . .

162

7.4.1 Using Command Procedures . . . . . . . . . . . . . . . . . . . . . . .

163

7.5

Migrating from VSE/ICCF to MVS and TSO/E . . . . . . . . . . . . . . . .

163

7.5.1Converting ICCF Libraries . . . . . . . . . . . . . . . . . . . . . . . . . 163

7.5.2ICCF Procedures and Macros . . . . . . . . . . . . . . . . . . . . . . . 167

Chapter 8. Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

8.1DL/I and IMS/VS DB Differences . . . . . . . . . . . . . . . . . . . . . . . . 169

8.1.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

8.1.2MVS System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 170

8.1.3Data Base Descriptor (DBD) . . . . . . . . . . . . . . . . . . . . . . . . 170

8.1.4 Program Specification Block (PSB)

. . . . . . . . . . . . . . . . . . . 171

8.1.5Batch Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

8.1.6Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

8.1.7Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

8.1.8Database Portability . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

8.1.9DL/I Multiple Partition Support . . . . . . . . . . . . . . . . . . . . . . 178

8.1.10Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

8.2 SQL/DS to DB2 for OS/390 Migration Consideration . . . . . . . . . . . . 178

8.2.1Descriptions of Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

8.2.2Other Comparison Areas . . . . . . . . . . . . . . . . . . . . . . . . . 181

8.2.3Summary of Migration Task . . . . . . . . . . . . . . . . . . . . . . . . 182

Chapter 9. Telecommunications Subsystems . . . . . . . . . . . . . . . . . . 185

9.1ACF/VTAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

9.1.1Product Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

9.1.2Resource Definition and Operation . . . . . . . . . . . . . . . . . . . . 187

9.1.3Customization and Programming . . . . . . . . . . . . . . . . . . . . . 190

9.1.4Network Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

9.2ACF/NCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

9.2.1Product Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

9.2.2Program Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

9.2.3Backlevel Hardware Support . . . . . . . . . . . . . . . . . . . . . . . 193

9.3BTAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

9.3.1Product Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

9.3.2Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

9.4Migrating TCP/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

viVSE to OS/390 Migration Workbook

9.4.1Network Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

9.4.2TCP/IP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

9.4.3TCP/IP Related User Data . . . . . . . . . . . . . . . . . . . . . . . . . 195

9.4.4TCP/IP Batch Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

9.4.5User Written TCP/IP Applications . . . . . . . . . . . . . . . . . . . . . 195

9.4.6Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

9.4.7Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

9.5MQSeries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

9.5.1

MQSeries in Your Operating System Environment . . . . . . . . . .

198

9.5.2

Networking Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . .

203

9.5.3

Defining MQSeries Object and Operating . . . . . . . . . . . . . . . .

203

9.5.4MQSeries-based Applications . . . . . . . . . . . . . . . . . . . . . . . 205

9.5.5Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

Chapter 10. POWER and JES2 . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

10.1JES2 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

10.1.1Major Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

10.2Implementing JES2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

10.2.1 Setting Up the Required Resources

. . . . . . . . . . . . . . . . . . 209

10.2.2Starting JES2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

10.2.3Tailoring JES2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

10.3 JES2-POWER Functional Comparison . . . . . . . . . . . . . . . . . . . . 211

10.3.2Input Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

10.3.3Job Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

10.3.4Output Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

10.3.5 Interactive User Interfaces (ICCF/CMS/TSO) . . . . . . . . . . . . . 218

10.3.6Remote Job Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

10.3.7Network Job Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

10.3.8Application Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

10.3.9Accounting Comparisons . . . . . . . . . . . . . . . . . . . . . . . . . 223

10.3.10RAS Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

10.3.11JES2 Testing Techniques . . . . . . . . . . . . . . . . . . . . . . . . 225

10.4 POWER/JES2 Detailed Comparisons . . . . . . . . . . . . . . . . . . . . .

225

10.4.1

Mapping POWER Parameters to JES2 Init Parms . . . . . . . . . .

225

10.4.2

Exit Comparisons . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

230

10.4.3

POWER-JES2 Command Equivalences . . . . . . . . . . . . . . . . .

231

Chapter 11. Advanced Function Printing and Print Services Facility/MVS . .

235

11.1Introducing PSF/MVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

11.1.1Functional Comparison between PSF/VSE and PSF/MVS . . . . . . 235

11.1.2Migration Effort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

11.2Installing and Configuring PSF/MVS . . . . . . . . . . . . . . . . . . . . . 236

11.2.1 Defining Channel-attached Printers to MVS . . . . . . . . . . . . . . 236

11.2.2Defining Network Printers . . . . . . . . . . . . . . . . . . . . . . . . 236

11.2.3The PSF Startup Procedures . . . . . . . . . . . . . . . . . . . . . . . 237

11.2.4Defining Printers for PSF Printing . . . . . . . . . . . . . . . . . . . . 237

11.2.5

FSS Procedure and PRINTDEV Statements

. . . . . . . . . . . . . .

238

11.3 Setting up AFP Resources . . . . . . . . . . . .

. . . . . . . . . . . . . . .

240

11.3.1

Migrating Resources from VSE to OS/390

. . . . . . . . . . . . . . .

240

11.3.2Remote-Resident Resources . . . . . . . . . . . . . . . . . . . . . . . 240

11.3.3Transferring Print Streams - VSE and OS/390 Coexistence . . . . . 241

11.3.4Migrating Print Applications . . . . . . . . . . . . . . . . . . . . . . . 241

11.4 Understanding Operational Differences . . . . . . . . . . . . . . . . . . . 242

11.4.1Starting and Stopping PSF . . . . . . . . . . . . . . . . . . . . . . . . 242

11.4.2Command Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . 242

Contents vii

13.2 General Assembler Conversion Comments

11.5Other Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

11.5.1Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

11.5.2Installation Exits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

11.5.3Accounting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6.1PSF/VSE Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6.2PSF/MVS Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6.3Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6.4Other Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6.5Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6.6Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Part 3. Converting VSE Languages to OS/390 Languages . . . . . . . . . . . . . . . . . .

247

Chapter 12. COBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

249

12.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

249

12.1.1

General Comments on COBOL for OS/390 and VM . . . . . . . . .

249

12.1.2

Comparison of IBM COBOL Compilers . . . . . . . . . . . . . . . . .

250

12.2 VSE to OS/390 Migration Considerations . . . . . . . . . . . . . . . . . .

250

12.2.1Migrating Object Code . . . . . . . . . . . . . . . . . . . . . . . . . . 251

12.2.2Useful Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

12.3Converting from DOS/VS COBOL . . . . . . . . . . . . . . . . . . . . . . 252

12.3.1DOS/VS COBOL CICS Programs . . . . . . . . . . . . . . . . . . . . 252

12.3.2DOS/VS COBOL Programs Containing REPORT WRITER

Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

12.4DOS/VS COBOL and COBOL for OS/390 and VM Language Differences 253

12.4.1Common COBOL Coding Problems . . . . . . . . . . . . . . . . . . . 253

12.4.2ENVIRONMENT DIVISION . . . . . . . . . . . . . . . . . . . . . . . . . 255

12.4.3

DATA DIVISION - FILE DESCRIPTION (FD) . . . . . . . . . . . . . . .

256

12.4.4

PROCEDURE DIVISION - Input/Output . . . . . . . . . . . . . . . . .

256

12.4.5File Handling Considerations . . . . . . . . . . . . . . . . . . . . . . 257

12.5Converting from VS COBOL II . . . . . . . . . . . . . . . . . . . . . . . . . 258

12.5.1VS COBOL II CICS Programs . . . . . . . . . . . . . . . . . . . . . . 259

12.6 Converting from COBOL for VSE/ESA . . . . . . . . . . . . . . . . . . . . 259

12.7Some Conversion Considerations for all VSE COBOL Compilers . . . . 259

12.7.1VSAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

12.7.2DISPLAY Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

12.8Compiler Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

12.8.1RES/NORES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

12.9Reserved Words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

12.9.1Reserved Word Considerations for DOS/VS COBOL . . . . . . . . . 263

12.9.2Reserved Word Considerations for VS COBOL II and COBOL for

VSE/ESA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . .

265

12.10 Compiling and Running Your Converted COBOL Programs

. . . . . .

265

Chapter 13. Assembler

13.1 Assembler Products

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

267

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

267

. . . . . . . . . . . . . . . .

267

13.2.1System Interface and Macros . . . . . . . . . . . . . . . . . . . . . . 268

13.2.2Multitasking Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

13.2.3Interrupt Handling Routines . . . . . . . . . . . . . . . . . . . . . . . 287

13.2.4Virtual Storage Macros . . . . . . . . . . . . . . . . . . . . . . . . . . 289

13.2.5VSAM Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

13.2.6Data Management Macros . . . . . . . . . . . . . . . . . . . . . . . . 292

viiiVSE to OS/390 Migration Workbook

Chapter 14. RPG II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

14.1Migration from VSE to OS/390 . . . . . . . . . . . . . . . . . . . . . . . . 329

14.1.1Device Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

14.1.2Print Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

14.1.3Tape Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

14.1.4Extent Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

14.1.5Processing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

14.1.6File Access Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

14.1.7Calling COBOL Subprograms . . . . . . . . . . . . . . . . . . . . . . 331

14.1.8Calling PL/I Subprograms . . . . . . . . . . . . . . . . . . . . . . . . 331

Chapter 15. PL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

333

15.1 Functional Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

333

15.1.1 EGCS (VSE) to DBCS (OS Version 2) Comments . . . . . . . . . . .

333

15.1.2Extended Precision . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

15.1.3Multitasking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

15.1.4

Dynamic Loading of Dependent Programs

. . . . . . . . . . . . . .

334

15.1.5

File Organization . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

334

15.1.6

Parameters Passed to a Main Program

. . . . . . . . . . . . . . . .

335

15.1.7%INCLUDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

15.2Compiler Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

15.2.1

Options

Specific to the DOS Compiler

. . . . . . . . . . . . . . . . .

335

15.2.2

Options

Specific to the MVS Compiler

. . . . . . . . . . . . . . . . .

336

15.2.3Execution Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

15.2.4The EXEC and PROCESS Cards . . . . . . . . . . . . . . . . . . . . . 338

15.3Linkages Between Languages . . . . . . . . . . . . . . . . . . . . . . . . 338

15.3.1Linkages Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

15.3.2Linkages not Supported . . . . . . . . . . . . . . . . . . . . . . . . . . 338

15.4ENVIRONMENT Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

15.4.1Not Supported in MVS . . . . . . . . . . . . . . . . . . . . . . . . . . 339

15.4.2Supported but to be Avoided . . . . . . . . . . . . . . . . . . . . . . 340

15.4.3The ²TOTAL² Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

15.4.4 The SIS Option (Sequential Insert Strategy) . . . . . . . . . . . . . . 340

15.5Calling SORT from PL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

15.5.1Interfaces Offered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

15.5.2Parameters to be Passed . . . . . . . . . . . . . . . . . . . . . . . . . 340

15.6Checkpoint-Restart in PL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

15.6.1PLICKPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

15.6.2PLIREST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

15.6.3PLICANC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

15.7DUMP in PL/I Optimizer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

15.7.1Output File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

15.7.2Options Specific to DOS . . . . . . . . . . . . . . . . . . . . . . . . . 343

15.7.3Options Specific to MVS . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.7.4Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.8Return Codes in PL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.8.1Setting Return Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.8.2Return Code Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.9Forcing an ABEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.9.1Use of DISP in the JCL . . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.9.2Automatic Restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

15.10Overlay Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

15.10.1Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

15.10.2Overlay in MVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

15.11Storage Management in PL/I . . . . . . . . . . . . . . . . . . . . . . . . 345

Contents ix

15.11.1Storage Management in DOS . . . . . . . . . . . . . . . . . . . . . 345

15.11.2Storage Management in MVS . . . . . . . . . . . . . . . . . . . . . 345

15.12PL/I and CICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.1File Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.2Statements not Supported . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.3CALLing DUMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.4Execution Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.5Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.6PL/I-CICS/VS Transaction ABEND Codes . . . . . . . . . . . . . . . 346

15.12.7 PL/I Return from ON-units and CICS Transaction Backout . . . .

347

Chapter 16. FORTRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

349

16.1

VS FORTRAN in OS/390 . . . . . . . . . . . . . . . . . . . . . . . . . . . .

349

16.2

FORTRAN Conversion Considerations . . . . . . . . . . . . . . . . . . . .

349

Chapter 17. Language Environment (LE) . . . . . . . . . . . . . . . . . . . . .

351

17.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

17.1.1General Comments on Language Environment . . . . . . . . . . . . 351

17.1.2Conceptual Differences between LE/VSE and OS/390 Language

Environment . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . .

352

17.2 VSE to OS/390 Migration Considerations

. . . . . . . . . . . . . . . . . .

352

17.2.1LE/VSE-conforming Languages . . . . . . . . . . . . . . . . . . . . . 352

17.2.2Useful Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

17.3 Migrating from LE/VSE-Conforming Languages . . . . . . . . . . . . . . 353

17.3.1C for VSE/ESA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

17.3.2COBOL for VSE/ESA . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

17.3.3PL/I for VSE/ESA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

17.4 Migrating from Non-LE/VSE Run-time Environments . . . . . . . . . . . 354

17.4.1Options Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

17.4.2C/370 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

17.4.3VS COBOL II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

17.4.4DOS/VS COBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

17.4.5DOS PL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

17.4.6VS FORTRAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

17.4.7 Migrating Interlanguage Communications Applications . . . . . . . 358 17.4.8 Migrating Assembler Applications . . . . . . . . . . . . . . . . . . . 359

17.5Migrating from LE/VSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

17.5.1Run-time Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

17.5.2

User Exits and Abnormal Termination Exits . . . . . . . . . . . . . .

364

17.5.3

Callable Services and Math Services

. . . . . . . . . . . . . . . . .

365

17.5.4LE/VSE 1.4 Locales . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

17.6CICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

17.6.1COBOL and CICS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

17.6.2Run-time Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

17.6.3 User Exits and Abnormal Termination Exits . . . . . . . . . . . . . .

367

Chapter 18. Procedure Language REXX . . . . . . . . . . . . . . . . . . . . . .

369

18.1REXX and VM/ESA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

18.2REXX and VSE/ESA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

18.3REXX and TSO/E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369

18.4Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

18.4.1VSE/ESA Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

18.4.2VM/ESA Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

18.4.3TSO/E Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

18.4.4 REXX Exec Sample for the OS/2, TSO and CMS Environments . . 371

x VSE to OS/390 Migration Workbook

18.5Migration Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

18.5.1REXX and SAA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

18.6REXX Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Part 4. Converting VSE Utilities to OS/390 Utilities . . . . . . . . . . . . . . . . . . . . . . .

373

Chapter 19. SORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

375

19.1JCL Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

19.2Control Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

19.3 Additional DFSORT/VSE Migration Considerations . . . . . . . . . . . . 379

19.3.1Control Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

19.3.2ICETOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

Chapter 20. DITTO . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

381

20.1

Compatibility with Previous Releases of DITTO

. . . . . . . . . . . . . .

381

20.2

DITTO Functions that are No Longer Supported

. . . . . . . . . . . . . .

382

20.3

DITTO Functions that are Not Recommended

. . . . . . . . . . . . . . .

383

20.4

DITTO Function Code Synonyms . . . . . . . .

. . . . . . . . . . . . . . .

384

20.5

Batch Keywords that are No Longer Supported

. . . . . . . . . . . . . .

384

20.6

Batch Keywords that are Not Recommended

. . . . . . . . . . . . . . .

385

20.7

DITTO/ESA Security . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

385

Chapter 21. VSAM Backup/Restore . . . . . . . . .

. . . . . . . . . . . . . . .

387

21.1VSAM Backup/Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

21.1.1OS/390 VSAM Backup/Restore . . . . . . . . . . . . . . . . . . . . . 387

21.1.2VSE/VSAM Backup/Restore . . . . . . . . . . . . . . . . . . . . . . . 387

Chapter 22. Librarian . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

22.1Overall Library Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

22.1.1OS/390 ISPF Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 390

22.1.2OS/390 Library Management . . . . . . . . . . . . . . . . . . . . . . . 391

Chapter 23. LISTLOG/PRINTLOG - Printing Log Streams . . . . . . . . . . . 393

23.1VSE PRINTLOG Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

23.2VSE LISTLOG Utility Program . . . . . . . . . . . . . . . . . . . . . . . . . 393

23.3OS/390 Hardcopy Processing . . . . . . . . . . . . . . . . . . . . . . . . . 393

23.3.1SYSLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

23.3.2Printing SYSLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

23.4OPERLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

23.4.1Printing OPERLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

23.5 JES2 System Data Sets - Job Log and System Messages . . . . . . . . 395

23.6Systems Management Recording . . . . . . . . . . . . . . . . . . . . . . 395

23.6.1Printing SMF Records . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

Chapter 24. VSE/Fast Copy and OS/390 DFSMSdss . . . . . . . . . . . . . . .

397

24.1

VSE/Fast Copy (Online and Stand-Alone) . . . . . . . . . . . . . . . . . .

397

24.2

DFSMSdss - OS/390 Component . . . . . . . . . . . . . . . . . . . . . . .

398

Part 5. Setting Up the Migration Environment . . . . . . . . . . . . . . . . . . . . . . . . . .

399

Chapter 25. Prepare the Migration Environment . . . . . . . . . . . . . . . . .

401

25.1

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

401

25.2

Install and Configure Required Hardware . . . . . . . . . . . . . . . . . .

402

Contents xi

25.2.1Processor Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 402

25.2.2Devices Supported by OS/390 . . . . . . . . . . . . . . . . . . . . . . 402

25.2.3DASD Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

25.2.4Other Hardware Requirements . . . . . . . . . . . . . . . . . . . . . 403

25.2.5Inter-Systems Connectivity . . . . . . . . . . . . . . . . . . . . . . . . 404

25.3

Order and Install the OS/390 Software . . . . . . . . . . . . . . . . . . .

405

25.3.1

Fee-based Methods of Installing OS/390 . . . . . . . . . . . . . . . .

405

25.3.2

Entitled Methods of Installing OS/390 . . . . . . . . . . . . . . . . . .

406

25.4

Set Up Standards, Procedures, and Documentation . . . . . . . . . . .

407

25.4.1

Installation Standards . . . . . . . . . . . . . . . . . . . . . . . . . . .

407

25.4.2

Systems Management Procedures . . . . . . . . . . . . . . . . . . .

409

25.4.3

Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

412

25.5

Customize Your New OS/390 System . . . . . . . . . . . . . . . . . . . .

413

25.5.2MVS BCP Customization . . . . . . . . . . . . . . . . . . . . . . . . . 415

25.5.3Other OS/390 Elements . . . . . . . . . . . . . . . . . . . . . . . . . . 416

Chapter 26. Test Environments . . . . . . . . . . . . . . . . . . . . . . . . . . .

419

26.1

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

419

26.1.1

Differences in Testing ²Philosophy²

. . . . . . . . . . . . . . . . . .

419

26.1.2

Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

419

26.2

Test Systems in the Life of the Migration . . . . . . . . . . . . . . . . . .

420

26.3VM, LPAR, or Standalone Systems . . . . . . . . . . . . . . . . . . . . . 421

26.3.1Logical Partitioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

26.3.2Software Partitioning . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

26.3.3Our Recommendation . . . . . . . . . . . . . . . . . . . . . . . . . . . 424

26.3.4Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

26.4Parallel Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

26.4.2

Synchronizing VSE Applications with OS/390 Versions . . . . . . .

430

26.5 Building the Initial OS/390 Test System . . . . . . . . . . . . . . . . . . .

430

26.5.1

OS/390 Maintenance Environment . . . . . . . . . . . . . . . . . . .

431

26.5.2

OS/390 Test Logical Partition . . . . . . . . . . . . . . . . . . . . . .

431

26.5.3

Maintaining Your OS/390 Libraries and SMP/E Zones . . . . . . .

431

26.6 Shared DASD vs. Cloned DASD . . . . . . . . . . . . . . . . . . . . . . .

432

26.6.1

Shared DASD between OS/390 Test Systems (vs. Cloned DASD) .

432

26.6.2

Shared DASD between VSE and OS/390 (vs. Cloned DASD) . . . .

433

 

 

Part 6. Running Your OS/390 System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

435

Chapter 27. Orienting ICCF Users to TSO/ISPF . . . . . . . . . . . . . . . . .

437

27.1TSO/ISPF and SDSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

27.1.1Editing Data Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438

27.1.2Submitting Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

27.1.3Using ISPF Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

27.1.4 Creating and Executing ISPF Applications . . . . . . . . . . . . . . . 440

27.1.5Managing Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

27.1.6Tracking Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

27.1.7Retrieving Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

27.1.8Using SDSF for Operators . . . . . . . . . . . . . . . . . . . . . . . . 441

Chapter 28. Orientation to OS/390 Console Operation . . . . . . . . . . . . . 443

28.1Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443

28.1.1Operating Hardware Consoles . . . . . . . . . . . . . . . . . . . . . . 443

28.2 Understanding the Operator Interfaces . . . . . . . . . . . . . . . . . . . 443

28.2.1Controlling Consoles . . . . . . . . . . . . . . . . . . . . . . . . . . . 444

xiiVSE to OS/390 Migration Workbook

28.2.2Managing Display Consoles . . . . . . . . . . . . . . . . . . . . . . . 444

28.2.3Extended MCS Consoles . . . . . . . . . . . . . . . . . . . . . . . . . 445

28.2.4 Understanding Message Formats and Replies . . . . . . . . . . . . 446

28.3Controlling the OS/390 System . . . . . . . . . . . . . . . . . . . . . . . . 447

28.3.1Starting the System . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447

28.3.2Displaying System Status . . . . . . . . . . . . . . . . . . . . . . . . . 447

28.3.3Stopping the System . . . . . . . . . . . . . . . . . . . . . . . . . . . 448

28.4Controlling Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448

28.4.1Displaying the Status of Devices . . . . . . . . . . . . . . . . . . . . 448

28.4.2Understanding Device Allocation . . . . . . . . . . . . . . . . . . . . 448

28.4.3JES2 Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

28.4.4SDSF Device Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

28.5 Controlling TSO Users, Jobs and Started Tasks . . . . . . . . . . . . . . 449

28.5.1Displaying Work on Your System . . . . . . . . . . . . . . . . . . . . 449

28.5.2Controlling Time Sharing Users . . . . . . . . . . . . . . . . . . . . . 451

28.5.3Controlling Batch Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . 451

28.5.4Controlling Started Tasks . . . . . . . . . . . . . . . . . . . . . . . . . 451

28.6Managing Remote Operations . . . . . . . . . . . . . . . . . . . . . . . . 452

28.6.1JES2 RJE Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

28.6.2NJE Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

Chapter 29. Orientation for Utilities . . . . . . . . . . . . . . . . . . . . . . . . 455

29.1IEBxxx or IEHxxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

29.2IEBCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

29.3IDCAMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

29.4IEBGENER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

29.5DFSMSdss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456

Chapter 30. Systems Management Philosophy and Methodology . . . . . . .

457

30.1 The Philosophy of Systems Management . . . . . . . . . . . . . . . . . .

457

30.1.1Systems Management Overview . . . . . . . . . . . . . . . . . . . . 457

30.1.2Systems Management Scope - What Needs to be Managed? . . . 459

30.1.3The Role of Automation . . . . . . . . . . . . . . . . . . . . . . . . . . 460

30.2Change Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

30.2.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

30.2.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

30.2.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

30.3Problem Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

30.3.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

30.3.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

30.3.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

30.4Performance Management . . . . . . . . . . . . . . . . . . . . . . . . . . 463

30.4.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

30.4.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

30.4.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

30.5Operations Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

30.5.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

30.5.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

30.5.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

30.6Security Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

30.6.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

30.6.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

30.6.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

30.7Configuration Management . . . . . . . . . . . . . . . . . . . . . . . . . . 469

30.7.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

Contents xiii

30.7.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

30.7.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

30.8Asset Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

30.8.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

30.8.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

30.8.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

30.9Accounting Management . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

30.9.1Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

30.9.2Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

30.9.3Methodology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

30.10 Summary . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . .

472

Chapter 31. Diagnosing System Problems

. . . . . . . . . . . . . . . . . . . .

473

31.1Problem Determination Tools . . . . . . . . . . . . . . . . . . . . . . . . . 473

31.2Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

31.3IPCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

31.3.1Analyzing Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

31.3.2Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

31.3.3Analyzing Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

31.3.4Using IPCS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

31.4JES2 Diagnosis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

31.5SLIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

31.6Performance Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

31.7LOGREC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

31.8SYSLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

31.9DFSMS/MVS Diagnosis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

31.9.1DFSMSdfp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

31.9.2DFSMShsm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

31.9.3DFSMSrmm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

31.9.4DFSMSdss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

31.10Diagnostic Reference Publications . . . . . . . . . . . . . . . . . . . . . 478

Part 7. Converting your Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479

Chapter 32. Conversion Process . . . . . . . . . . . . . . . . . . . . . . . . . . 481

32.1Conversion Process Introduction . . . . . . . . . . . . . . . . . . . . . . . 482

32.1.1References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

32.1.2Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

32.1.3Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

32.1.4Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

32.2 Mass Conversion - Background, Benefits and Method . . . . . . . . . .

486

32.2.1

IBM MVS Migration System - Background . . . . . . . . . . . . . . .

486

32.2.2

Mass Conversion Overview / Benefits . . . . . . . . . . . . . . . . .

487

32.2.3Mass Conversion Tools . . . . . . . . . . . . . . . . . . . . . . . . . . 489

32.2.4Automated Conversion Process . . . . . . . . . . . . . . . . . . . . . 490

32.2.5CORTEX MS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490

32.3Mass Conversion Phase Overview . . . . . . . . . . . . . . . . . . . . . . 493

32.4Preparation Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

32.4.1

Phase 0: Project Management and Technical Leadership . . . . .

494

32.4.2

Phase 1: Application Inventory . . . . . . . . . . . . . . . . . . . . .

495

32.4.3

OS/390 Standards and Naming Conventions . . . . . . . . . . . . .

497

32.4.4

Phase 2: Conversion Specifications . . . . . . . . . . . . . . . . . . .

499

32.4.5

Phase 3: Customization or Development of Conversion Tools . . .

501

32.5Conversion Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

xivVSE to OS/390 Migration Workbook

32.5.1Program Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

32.5.2JCL Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504

32.5.3Phase 4: Initial Trial Conversion . . . . . . . . . . . . . . . . . . . . 505

32.5.4Phase 5: OS/390 Regression Tests and Repeated Trial

Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

32.5.5Initialization Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

32.5.6Unit Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

32.5.7System Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513

32.5.8

Parallel/Production Simulation Testing

. . . . . . . . . . . . . . . .

514

32.6 Implementation Phases

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

515

32.6.2

Phase 6: Actual Conversion and Switchover . . . . . . . . . . . . .

516

32.6.3

Switchover

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

517

32.6.4

Phase 7: Initial OS/390 Operations . . . . . . . . . . . . . . . . . . .

518

Chapter 33. Conversion Services and Tools . . . . . . . . . . . . . . . . . . .

519

33.1Conversion Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

33.1.1IBM Global Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

33.1.2 Automated Migration Services (AMS) . . . . . . . . . . . . . . . . . 519

33.2Conversion Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

33.2.1VSE/ESA Facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

33.2.2IBM OPTI-AUDIT for VSE . . . . . . . . . . . . . . . . . . . . . . . . . 520

33.2.3

IBM COBOL and CICS Command Level Conversion Aid (CCCA) .

522

33.2.4

SISRO - CORTEX-Migration System (CORTEX-MS) . . . . . . . . .

524

33.2.5Computer Associates . . . . . . . . . . . . . . . . . . . . . . . . . . . 525

33.2.6The Source Recovery Company . . . . . . . . . . . . . . . . . . . . . 525

Part 8. Migration Experience

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

527

Chapter 34.

Customer Migration Example . . . . . . . . . . . . . . . . . . . . .

529

34.1Background . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

34.2Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

34.3Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

34.4Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

34.5Duration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

34.6Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

34.7Benefits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

Part 9. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

533

Appendix A. Education Information . . . . . . . . . . . . . . . . . . . . . . . .

535

A.1

What Training is Needed and What Training Courses are Available . .

535

A.1.1

OS/390 Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

535

A.1.2

Custom Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

536

A.1.3

OEM Product Education . . . . . . . . . . . . . . . . . . . . . . . . . .

536

A.2

When are Courses Scheduled and When are they Needed? . . . . . . .

536

A.3

Who will Provide the Training? . . . . . . . . . . . . . . . . . . . . . . . .

537

A.4

Where will the Training Take Place? . . . . . . . . . . . . . . . . . . . . .

537

Appendix B. Mapping ISV Products and Functions . . . . . . . . . . . . . . .

539

B.1

The IBM Software Migration Project Office (SMPO) . . . . . . . . . . . .

539

B.2

VSE ISV System Management Products and OS/390 Compared . . . . .

539

Appendix C. DFSMS Naming Conventions . . . . . . . . . . . . . . . . . . . .

543

Contents xv

C.1

Data Set Naming Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . .

543

C.2

Components of a Data Set Name . . . . . . . . . . . . . . . . . . . . . . .

544

C.2.1

High-Level Qualifier (HLQ) . . . . . . . . . . . . . . . . . . . . . . . .

544

C.2.2

Relative Importance . . . . . . . . . . . . . . . . . . . . . . . . . . . .

546

C.2.3

File Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

546

C.2.4

User Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

547

C.2.5

Data Set Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

547

C.3

Things Not to Include in the Data Set Name

. . . . . . . . . . . . . . . .

547

C.3.1

Department Number . . . . . . . . . . . . . . . . . . . . . . . . . . . .

547

C.3.2

Application Location . . . . . . . . . . . . . . . . . . . . . . . . . . . .

548

C.3.3

Management Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . .

548

C.3.4

Output Device Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

548

C.3.5

Expiration Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

548

C.3.6

Access Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

549

C.3.7

Job Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

549

C.4

Common Applications - Naming Conventions . . . . . . . . . . . . . . . .

549

C.4.1

TSO Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . .

549

C.4.2

VSAM Data Set Naming Conventions . . . . . . . . . . . . . . . . . .

550

C.4.3

DB2 Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . .

550

C.4.4

Generation Data Sets . . . . . . . . . . . . . . . . . . . . . . . . . . .

551

Appendix D. Special Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . .

553

Appendix E. Related Publications . . . . . . . . . . . . . . . .

E.1

International Technical Support Organization Publications

E.1.1

OS/390 and MVS Redbooks . . . . . . . . . . . . . . .

E.1.2

Other Redbooks . . . . . . . . . . . . . . . . . . . . . .

E.2

OS/390 Product Publications . . . . . . . . . . . . . . . . .

E.2.1

Planning Books . . . . . . . . . . . . . . . . . . . . . .

E.2.2

OS/390 Online Product Library . . . . . . . . . . . . .

E.3

Other Publications . . . . . . . . . . . . . . . . . . . . . . .

E.4

Other Sources . . . . . . . . . . . . . . . . . . . . . . . . . .

E.4.1

Books on the Internet

. . . . . . . . . . . . . . . . . .

E.5

Redbooks on CD-ROMs . . . . . . . . . . . . . . . . . . . .

How to Get ITSO Redbooks . . . . . . . . . . . . . . . . . . . .

How IBM Employees Can Get ITSO Redbooks . . . . . . . . .

How Customers Can Get ITSO Redbooks . . . . . . . . . . . .

IBM Redbook Order Form . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . .

557

. . . . . . . .

557

. . . . . . . . .

557

. . . . . . . . .

557

. . . . . . . . .

557

. . . . . . . . .

558

. . . . . . . . .

558

. . . . . . . . .

559

. . . . . . . . .

559

. . . . . . . . .

559

. . . . . . . . .

559

. . . . . . . . .

561

. . . . . . . . .

561

. . . . . . . . .

562

. . . . . . . . .

563

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

565

List of Abbreviations

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

583

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

591

ITSO Redbook Evaluation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

593

xvi VSE to OS/390 Migration Workbook

Figures

1.VAE with Three Address Spaces . . . . . . . . . . . . . . . . . . . . . . . . 6

2. VAE with Four Address Spaces . . . . . . . . . . . . . . . . . . . . . . . . . 7

3.VSE/ESA Storage Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

4.OS/390 Storage Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

5.Migration Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6.

Progressive versus Mass Conversion

. . . . . . . . . . . . . . . . . . . . .

49

7.

Nonstandard Labels Supported by VSE

. . . . . . . . . . . . . . . . . . .

107

8.Extract from WSC Flash 9741 . . . . . . . . . . . . . . . . . . . . . . . . . 113

9. OS/390 Master and User Catalog Structure . . . . . . . . . . . . . . . . 116

10.OS/390 VSAM Integrity Provided by Cross-Region Shareoptions . . . . 126

11.Example of an MVS CICS/OS System using MRO . . . . . . . . . . . . . 136

12.CICS Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

13. Log Stream Choices Resulting from Hardware and Software Used . . 146

14.MVS Data Sets used by CICS . . . . . . . . . . . . . . . . . . . . . . . . . 146

15.

DL/I Functions Requiring Attention when Migrating to IMS/VS . . . . .

169

16.

Steps in Migrating DL/I Databases to IMS/ESA . . . . . . . . . . . . . .

177

17.VTAM Start Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

18.Comparison of IBM COBOLs . . . . . . . . . . . . . . . . . . . . . . . . . 250

19.Compiler Options Comparison DOS/VS COBOL and COBOL for OS/390

and VM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

20.Recommended COBOL for OS/390 and VM Compiler Options for

Converted VS COBOL II Programs . . . . . . . . . . . . . . . . . . . . . . 262

21.Compiler Options Comparison VS COBOL II and COBOL for OS/390

and VM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

22.Reserved Words in COBOL for OS/390 and VM and not in DOS/VS

COBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

23.Reserved Words in COBOL for OS/390 and VM for Unsupported

Features . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . .

264

24. Compiler Directing Words in COBOL for OS/390 and VM

. . . . . . . .

264

25.Reserved Words in COBOL for OS/390 and VM and not in VS COBOL II 265

26.Reserved Words in COBOL for OS/390 and VM for Object-Oriented

COBOL Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

27.VSE Subroutine Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

28.MVS Subroutine Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . 271

29.

Sample Initiation Termination Coding . . .

. . . . . . . . . . . . . . . . .

274

30.

VSE and MVS Time Degrees of Precision

. . . . . . . . . . . . . . . . .

279

31.

Comparison of the DTFCD and DCB Macros

. . . . . . . . . . . . . . . .

295

32.Card File Macros in VSE and MVS . . . . . . . . . . . . . . . . . . . . . . 295

33.

Card File Programs in VSE and MVS . . . . . . . . . . . . . . . . . . . .

296

34.

Comparison of the DTFPR and DCB Macros . . . . . . . . . . . . . . . .

297

35.

Comparison of the DTFMT and DCB Macros . . . . . . . . . . . . . . . .

302

36.

Tape File Programs in VSE and MVS . . . . . . . . . . . . . . . . . . . .

303

37.

Comparison of DTFDI and DCB macros . . . . . . . . . . . . . . . . . . .

304

38.

Comparison of the DTFSD and DCB Macros . . . . . . . . . . . . . . . .

310

39.

Sequential DASD FILE Program in VSE and MVS . . . . . . . . . . . . .

311

40.

Comparison of DTFDA and DCB Macros . . . . . . . . . . . . . . . . . .

312

41.

VSE Error Bytes and MVS Exception Code Bits . . . . . . . . . . . . . .

313

42.

Record Reference by ID in VSE and MVS . . . . . . . . . . . . . . . . . .

317

43.

Record Reference by KEY in VSE and MVS . . . . . . . . . . . . . . . .

318

44.Updating a DAM File under MVS . . . . . . . . . . . . . . . . . . . . . . . 318

45.Adding to a DAM File under MVS . . . . . . . . . . . . . . . . . . . . . . 319

© Copyright IBM Corp. 1998

xvii

46.

Loading a Sequential DAM File under VSE . . . . . . . . . . . . . . . . .

319

47.

Loading a Sequential DAM File under MVS . . . . . . . . . . . . . . . .

320

48.

Loading a Random DAM File under MVS . . . . . . . . . . . . . . . . . .

320

49.

Loading a DAM File of U. or V. Length Records under MVS . . . . . .

321

50.Processing a DAM file under VSE . . . . . . . . . . . . . . . . . . . . . . 324

51. Loading a Random (Preformatted) DAM File under VSE . . . . . . . . . 325

52.MVS Feedback Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326

53.Relationship between CCB operands and MVS Equivalents . . . . . . . 327

54.

Relationship between DTFPH Macro and MVS equivalents . . . . . . .

328

55.

Comparison VSE and MVS Major Elements . . . . . . . . . . . . . . . .

328

56.Callable Services in LE/VSE 1.4 with Differing Names in OS/390

Language Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

57.Automated Conversion Process . . . . . . . . . . . . . . . . . . . . . . . 491

58.Project Phases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

xviii VSE to OS/390 Migration Workbook

Tables

1.

Comparison of VSE Functions & Components to OS/390 Replacements

16

2.

Whos Normal Activities are Affected? . . . . . . . . . . . . . . . . . . . .

26

3.Nine Month Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

4.CNV Responsibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

5.ABC Responsibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

6.SER Responsibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

7. VSE Job Control Statements Summary . . . . . . . . . . . . . . . . . . . . 86

8.MVS Job Control Statements . . . . . . . . . . . . . . . . . . . . . . . . . . 88

9. Overview of POWER JECL Statements . . . . . . . . . . . . . . . . . . . . 89

10.JES2 Control Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

11.JES2 Input Sources (compared to POWER)

12.POWER/JES2 Job Scheduling Comparison

13.POWER/JES2 Output Service Comparison

. . . . . . . . . . . . . . . . .

212

. . . . . . . . . . . . . . . . .

213

. . . . . . . . . . . . . . . . .

215

14.FCB Name Prefixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

15.

POWER/ICCF, VM/CMS, and JES2/TSO Functional Comparison . . . .

219

16.

Accounting Records for NJE Activities . . . . . . . . . . . . . . . . . . .

224

17.

POWER Macro to JES2 Parameter Mapping . . . . . . . . . . . . . . . .

226

18.

PLINE MACRO to JES2 Parameter Mapping . . . . . . . . . . . . . . . .

228

19.

PRMT MACRO to JES2 Parameter Mapping . . . . . . . . . . . . . . . .

228

20.

PRMT MACRO to JES2 Parameter Mapping . . . . . . . . . . . . . . . .

229

21.

PNODE MACRO to JES2 Parameter Mapping . . . . . . . . . . . . . . .

230

22.

PCPTAB MACRO to JES2 Parameter Mapping . . . . . . . . . . . . . .

230

23.POWER Exit to JES2 Exits . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

24.Queue Management Commands . . . . . . . . . . . . . . . . . . . . . . . 232

25.Task Management Commands . . . . . . . . . . . . . . . . . . . . . . . . 232

26.Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

27.Network Management Commands . . . . . . . . . . . . . . . . . . . . . . 233

28.File Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

29.Sending Commands and Messages . . . . . . . . . . . . . . . . . . . . . 234

30.PRINTDEV Parameter Comparison . . . . . . . . . . . . . . . . . . . . . . 239

31. VSE - OS/390 Command Comparison . . . . . . . . . . . . . . . . . . . . 242

32.Useful COBOL Publications . . . . . . . . . . . . . . . . . . . . . . . . . . 252

33. Action of COBOL Program Termination Statements . . . . . . . . . . . 257

34.COBOL and PL/I: What Runs Where? . . . . . . . . . . . . . . . . . . . . 351

35.Useful Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

36. REPORT and ISASIZE Options, C/370 and DOS PL/I . . . . . . . . . . . 355

37.C/370 Migration Considerations . . . . . . . . . . . . . . . . . . . . . . . 355

38.

VS COBOL II Migration Considerations . . . . . . . . . . . . . . . . . . .

356

39.

DOS/VS COBOL Migration Considerations . . . . . . . . . . . . . . . . .

356

40.DOS PL/I Migration Considerations . . . . . . . . . . . . . . . . . . . . . 357

41.ILC Migration Considerations . . . . . . . . . . . . . . . . . . . . . . . . . 358

42.Option Recommendations Differing between LE/VSE 1.1 and OS/390 Language Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

43.Option Recommendations Differing between LE/VSE 1.4 and OS/390 Language Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

44.Option Recommendations for CICS Differing between LE/VSE and

OS/390 Language Environment . . . . . . . . . . . . . . . . . . . . . . . . 367

45.OS/390 DASD Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403

46.S/390 Software Product Mapping . . . . . . . . . . . . . . . . . . . . . . . 539

© Copyright IBM Corp. 1998

xix

xx VSE to OS/390 Migration Workbook

Preface

The purpose of this document is to provide information and guidance to personnel involved in a VSE to OS/390 operating system change; that is, a VSE to OS/390 migration.

The primary focus is on VSE program and file conversions, and on operational differences between the two systems. Chapters on each of the source languages are included. DB/DC conversions, and operational differences between POWER and JES2 are also addressed.

Within each chapter, not only are the differences pointed out, but OS/390 implementation and suggested use recommendations are made wherever possible. These recommendations can help the migrating customer ²better² design their use of OS/390.

Throughout this document, the term MIGRATION refers to the entire process of transition from a VSE environment to an OS/390 environment. The term CONVERSION describes the process of translating and updating VSE applications and data to meet the requirements of OS/390.

The Team That Wrote This Redbook

This redbook was produced by a team of specialists from around the world working with the International Technical Support Organization Poughkeepsie Center.

Our thanks to Judith Jay for bringing a renewed focus to the issues, concerns and effort required to migrate from VSE to OS/390.

Redbook Builders and Key Contributors

Cliff Bays IBM, Endicott

Bimshire Davis IBM, Chicago

Don Durand IBM, Poughkeepsie

Dan Ebaugh IBM, Gaithersburg

Patrick Fournier Managing Partner, Automated Migration Services, Walnut

Creek, CA

Dave Greenough IBM, Vermont

John Hutchinson IBM, Gaithersburg

Dan Janda IBM, Endicott

Judith Jay IBM, White Plains

Kevin Jones IBM, Endicott

Herbert Kratzer IBM, Germany

Tom Plunkett Senior Director of Systems Engineering, Automatic Data

Processing, Inc., Roseland, NJ

Gilbert Saint-flour Technical Manager, Automated Migration Services,

Livingston, NJ

John Sutera IBM, Endicott

Guenter Weigelt IBM, Germany

© Copyright IBM Corp. 1998

xxi

Authors and Significant Contributors

Riaz Ahmad IBM, Gaithersburg

Boris Barth IBM, Germany

Bette Brody IBM, Gaithersburg

Jerzy Buczak IBM, Cary

Charlie Burger IBM, San Jose

John Casey IBM, Dallas

Walt Farrell IBM, Poughkeepsie

Steve Gracin IBM, Endicott

Judson Howard IBM, Los Angeles

Stanley Jones IBM, Endicott

Bill Keene IBM, Dallas

Ulrich Kettner IBM, Germany

Bob Leicht IBM, Endicott

Richard Lewis IBM, Gaithersburg

Jim McCoy IBM, Gaithersburg

Tom Murphy IBM, Endicott

Karl Pesendorfer IBM, Vienna, Austria

Dave Pilcher IBM, Boulder

Linda Richter IBM, Poughkeepsie

Bernd Rueckert IBM, Germany

Liz Rushton IBM, Sydney, Australia

Roger Smith IBM, Poughkeepsie

Howard Turetzky IBM, Boulder

Jon vonWolfersdorf IBM, Endicott

Frank Yaeger IBM, San Jose

Holly Yamamoto-Smith IBM, San Jose

Comments Welcome

Your comments are important to us!

We want our redbooks to be as helpful as possible. Please send us your comments about this or other redbooks in one of the following ways:

Fax the evaluation form found in ªITSO Redbook Evaluationº on page593 to the fax number shown on the form.

Use the electronic evaluation form found on the Redbooks Web sites:

For

Internet users

http://www.redbooks.ibm.com/

For

IBM Intranet users

http://w3.itso.ibm.com/

Send us a note at the following address: redbook@us.ibm.com

xxii VSE to OS/390 Migration Workbook

Part 1. Planning the Migration - An Introduction

© Copyright IBM Corp. 1998

1

2 VSE to OS/390 Migration Workbook

Chapter 1. Why Customers Migrate

This chapter discusses the following topics:

1.2, Traditional Reasons for Migrating

1.3, Functional Reasons for Migrating to OS/390

1.1 A Synopsis of This Book

What do I need to read?

Executives: Read the following:

Part 1, ªPlanning the Migration - An Introductionº on page 1 Part 8, ªMigration Experienceº on page 527

System Programmers: Read the following:

Part 1, ªPlanning the Migration - An Introductionº on page 1

Part 2, ªConverting the VSE Operating System to the OS/390 Operating Systemº on page 67

Part 4, ªConverting VSE Utilities to OS/390 Utilitiesº on page 373 Part 5, ªSetting Up the Migration Environmentº on page 399 Part 6, ªRunning Your OS/390 Systemº on page 435

Operators: Read the following:

Part 6, ªRunning Your OS/390 Systemº on page 435

Application Programmers: Read the following:

Part 3, ªConverting VSE Languages to OS/390 Languagesº on page 247 Part 7, ªConverting your Applicationsº on page 479

This document is divided into nine parts:

Part 1, Planning the Migration - An Introduction

The scope of effort required to migrate from VSE to OS/390 will vary from one organization to another. Many factors must be considered when making the decision of when and how to migrate. This part discusses the reasons for migrating, factors to consider when sizing the effort, and developing a migration plan.

Part 2, Converting the VSE Operating System to the OS/390 Operating System

In this part the conversion of the VSE system including JCL, data storage methods, CICS, ICCF, telecommunications, spooling, and printing is discussed. Additionally, a comparison of the use of CMS and TSO is presented for those currently running VSE under VM.

Part 3, Converting VSE Languages to OS/390 Languages

Conversion of the various language compilers to their equivalent OS/390 language is discussed in this part. Also, any execution time differences are discussed.

© Copyright IBM Corp. 1998

3

Part 4, Converting VSE Utilities to OS/390 Utilities

Conversion of the VSE utilities to their equivalent OS/390 utilities is discussed in this part.

Part 5, Setting Up the Migration Environment

No two Information Processing environments are alike. Hardware, software, scheduling, personnel needs will be different in all cases. This part discusses preparing for and tailoring the test environment, and various hardware/software combinations and activities that can be performed in parallel.

Part 6, Running Your OS/390 System

The OS/390 environment is much different than the VSE environment. This part provides an orientation to the use of TSO/ISPF, OS/390 console operation, and OS/390 utilities. Additionally, the systems management philosophy with OS/390 and diagnosing problems with OS/390 are discussed.

Part 7, Converting your Applications

This part discusses the application program conversion process and some of the conversion tools available.

Part 8, Migration Experience

An example of a migration plan for the ABC company is discussed in this part.

Part 9, Appendixes

The appendixes provide useful information including a list of helpful publications, education information, and a chart mapping Independent Software Vendor products to OS/390 products.

1.2Traditional Reasons for Migrating

Users migrating to MVS and OS/390 over the years have done so for a variety of reasons. While the purpose of this document is to concentrate on the hows of migrating and not so much the whys, it is interesting to note some of the more typical or traditional reasons that customers migrate to OS/390.

1.2.1 Business Consolidation

Corporations, more recently, have found themselves involved in business consolidation activities. Be it for economic and/or efficiency reasons companies have been faced with the challenge of effectively addressing this type of change. Consolidating the Information Technology infrastructure is just one of these challenges. Many have found that combining the system workloads from various parts of the newly consolidated organization has produced I/T system requirements beyond the capacity of the VSE operating system. For example, attempting to combine multiple VSE images into a single system image has often created situations where multiple processor (n-way) capacity is needed. Prior to the Turbo Dispatcher (n-way processor support) in VSE/ESA V2, OS/390 (or MVS/ESA) provided the only solution. Another issue associated with combining multiple images into a single system image has been the number of VSE partitions. Similar to the case of the Turbo Dispatcher, prior to dynamic partitions in VSE/ESA V1, OS/390 (or MVS/ESA) provided a solution to this issue.

4 VSE to OS/390 Migration Workbook

1.2.2 Mergers/Acquisitions

As with corporate consolidations, mergers and acquisitions present an equal number of challenges when having to incorporate the I/S organizations of the companies involved. A challenge that clearly presents itself is when the organizations involved run different host based operating systems (such as OS/390 and VSE/ESA). In cases where it has been decided to merge the I/S organizations rather than run as autonomous entities, the issue of which operating system should become the single production operating system arises. It is often decided that because of its robust/enhanced functionality the operating system be OS/390. This, then, requires that the VSE subsystems and applications be converted to OS/390.

1.2.3 Capacity Constraints

Users running DOS/VSE and/or VSE/SP encountered system capacity constraints due to the architectural design limits imposed by VSE. The need for additional system capacity and resources due to things such as application and end user growth found many VSE users coming up against these constraints. OS/390 provided the much needed relief for users who found themselves in this situation. Fortunately, with the introduction of VSE/ESA V1 many of these constraints were removed.

VSE users now find that many of the reasons, due to architectural limits, that forced a conversion to OS/390 actually no longer exist. The following sections describe some of these constraints in greater detail.

1.2.3.1 Virtual Storage

VSE/SP provided 24-bit addressing which supported 16 megabytes of virtual storage. Users with the requirement for a large CICS partition, for example, were forced to go to multiple CICS partitions when putting up a single large CICS partition was not possible. This sometimes caused additional problems as it was often difficult to split a single CICS application into multiple CICS partitions. However, where possible, users chose to implement multiple CICS regions using the CICS Multiple Region Option (MRO). Still, with the addition of multiple CICS regions (MROs), comes the added expense of managing the MROs. And, as the MROs numbers increase, you need system management tools, such as CICSPlex System Manager for MVS/ESA (CICSPlex SM) to ease the system management burden caused by multiple CICS systems.

MVS, or OS/390, provided users with virtual storage constraint relief through 31-bit addressing capabilities. However, some users found relief with virtual address extensions (VAE) in VSE/SP V3. VSE/ESA V1 introduced 31-bit

addressing support. This now gives VSE users the ability to address up to 2GB of virtual storage. Hence, it is now possible for VSE users with large CICS partition requirements to have this requirement satisfied by VSE.

Chapter 1. Why Customers Migrate 5

 

 

 

 

SVA -

2,304K

 

 

 

 

 

 

 

F1

-

VSE/POWER

-

832K

8,832K

Shared Address

 

 

Space Area

F2

-

ACF/VTAM

-

3,648K

 

 

 

 

 

 

F7

-

DATABASE

-

2,048K

 

 

 

 

 

 

 

 

 

UNUSED

UNUSED

 

 

 

UNUSED

 

128K

 

64K

 

 

 

 

512K

 

 

 

 

 

 

 

 

 

 

F6 1.5M F9 1,536K

 

 

 

 

 

 

 

 

 

 

CICS

 

 

Private Address

 

PROD

 

7,168K

Space Area

F5 1.5M

CICS

 

 

 

 

 

 

PRD1

 

 

 

 

 

F4 1.5M

 

 

 

 

 

 

FA 5,504K F3 7.1M

 

 

BG 1.5M

 

 

 

 

 

 

 

 

 

SUPERVISOR -

 

384K

 

 

 

 

0

 

Figure 1. VAE with Three Address Spaces

Figure 1 depicts a typical VSE virtual storage configuration using Virtual Addressability Extension (VAE) introduced in VSE/SP V2. In this configuration the largest possible address space is approximately 7MB. Therefore, a single partition running in its own address space is limited to 7MB. Initially support was for only three address spaces. This was later enhanced to nine.

6 VSE to OS/390 Migration Workbook

Loading...
+ 643 hidden pages