IBM OS-390 User Manual

VSE to OS/390 Migration Workbook

Cliff Bays ** Dave Greenough ** John Hutchinson
Dan Janda ** Kevin Jones ** Gilbert Saint-flour

IBML

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 page 553.

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

Preface

The Team That Wrote This Redbook

Comments Welcome

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

........................ xxi

Redbook Builders and Key Contributors
Authors and Significant Contributors

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii

.................... xxi

...................... xxii

Part 1. Planning the Migration - An Introduction ......................... 1

Chapter 1. Why Customers Migrate

1.1 A Synopsis of This Book

............................. 3

1.2 Traditional Reasons for Migrating

1.2.1 Business Consolidation

1.2.2 Mergers/Acquisitions

1.2.3 Capacity Constraints

1.2.4 Image

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.3 Functional Reasons for Migrating to OS/390

1.3.1 Applications Availability

1.3.2 Systems Management

1.3.3 Connectivity

1.3.4 Systems Availability

1.3.5 Staff Availability

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

......................... 3

........................ 4

. . . . . . . . . . . . . . . . . . . . . . . . . . . 4

.................. 10

. . . . . . . . . . . . . . . . . . . . . . . . . . . 10

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 2. Sizing the Effort

2.1 Introduction to Sizing

2.1.1 Defining the Migration Project Objectives

2.1.2 Areas of VSE and OS/390 Differences

.............................. 13

............................... 13

................. 13

................... 14

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

2.2 OS/390 Components/Products/Subsystems

2.2.1 The OS/390 Operating Environment

2.2.2 Subsystem Level Comparison/Affinity

2.3 What Changes Between VSE and OS/390?

2.3.1 Philosophical Changes

2.4 Who is Affected by This Migration?

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

....................... 26

2.4.1 Job Roles and Normal Activities

2.5 Approaches to Migration

2.5.1 Disclaimer

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

............................. 27

. . . . . . . . . . . . . . . . . . 18

.................... 19

................... 24

................... 24

...................... 26

2.5.2 OS/390 Conversion and Production Implementation Strategies

2.5.3 VM/ESA Guest Support in Your VSE to OS/390 Migration

2.5.4 Staffing Strategies

2.5.5 Conversion Tools

2.6 Educational Requirements

2.6.1 Introduction

2.7 Scope of Work and Challenges

2.7.1 Application Inventory

2.7.2 Program Conversion

2.7.3 JCL Conversion

2.7.4 File Migration

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

.......................... 32

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

.... 16

.... 27

....... 29

 Copyright IBM Corp. 1998 iii

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

2.7.6 Automated Operations

2.8 Cost Considerations

2.9 OS/390 Documentation Resources

2.9.1 Introduction References

2.9.2 Key Documents and Other References

2.9.3 W eb UR L

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

....................... 39

. . . . . . . . . . . . . . . . . . . . . . . . . . . 39

.................. 40

Chapter 3. Developing the Plan

3.1 Overview

3.1.1 References

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.1.2 Recommendations

3.2 Plan Components

3.2.1 Approach

3.2.2 Team

3.2.3 Tasks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

3.2.4 Milestone Events

3.2.5 Education

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

3.3 Progressive versus Mass Conversion

3.3.1 Approach Differences

3.3.2 Historical Perspective

3.3.3 Shared Application Files and Databases

3.3.4 Shared Application Code

3.3.5 Operations Support Staffing

3.3.6 Automated Operations Tools

............................ 41

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

...................... 49

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

................. 50

.......................... 50

......................... 50

........................ 50

3.3.7 Standardized Conversion Deliverables and Automation

3.3.8 Risk Management

3.3.9 Complexity of Implementation

3.4 Plan Examples

3.4.1 Project Schedule

3.4.2 Project Plan Example

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

....................... 51

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

............................. 56

........ 51

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

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

4.1 The Philosophy of JCL in System/390

4.1.1 VSE/ESA′s Job Control Language Philosophy

4.1.2 OS/390′s Job Control Philosophy

4.2 High Level Similarities

............................... 72

4.2.1 JCL Statement and Job Layout

4.2.2 Spooling

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

4.3 JCL Differences Between VSE and MVS

4.3.1 J o b Input

4.3.2 JCL Expansion

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

4.3.3 Operator Flexibility and Intervention

4.3.4 Allocation of Resources

4.3.5 Hidden JCL

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

........................... 78

4.3.6 Device Address Specifications

4.3.7 Catalogs

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

4.3.8 Partition Dependent Codes in JCL

4.3.9 Communication Region - DATE and UPSI

4.3.10 VSE Job Control Statements

4.3.11 MVS Job Control Statements

4.3.12 Comparison of VSE and MVS JCL - A Summary

...................... 69

.............. 70

...................... 70

....................... 72

.................... 73

.................... 76

....................... 80

..................... 81

................. 81

........................ 82

....................... 84

............ 86

... 69

iv VSE to OS/390 Migration Workbook

4.3.13 Summary of MVS JCL Statements .................... 88

4.4 JECL

4.4.2 Comparison of POWER and JES2 JECL - A Summary

4.4.3 Summary of JES2 JECL - A Table

4.5 VSE and MVS JCL Comparison Example

4.5.1 S ample VSE JCL

4.5.2 Sample MVS JCL

4.5.3 Sample VSE plus Carry-Over

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

......... 89

..................... 90

.................... 91

................................ 92

............................... 93

........................ 94

Chapter 5. Disk and Tape Storage Considerations

5.1 Access Method Similarities and Differences

5.1.1 Access Methods

5.1.2 Operating System Implementations

5.1.3 Miscellaneous Functions

5.2 Data Set Naming Considerations

5.2.1 VSE Considerations

5.2.2 OS/390 Considerations

5.3 Storage and Space Management

5.3.1 VSE Considerations

5.3.2 OS/390 Considerations

5.3.3 System Managed Storage

5.3.4 Implementing DFSMS

5.4 Tape Similarities and Differences

5.4.1 Volume Interchangeability

5.4.2 Standard Labels

5.4.3 No Labels

5.4.4 Nonstandard Labels

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

.................... 98

. . . . . . . . . . . . . . . . . . . . . . . . . . . 99

........................ 99

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

....................... 100

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

. . . . . . . . . . . . . . . . . . . . . . . . . . . 100

......................... 100

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

....................... 103

. . . . . . . . . . . . . . . . . . . . . . . . . 103

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

5.4.5 Bypass Label Processing Facility in OS/390

5.5 DASD Similarities and Differences

5.5.1 Volume Interchangeability

5.5.2 DASD (VTOC) Processing

...................... 108

. . . . . . . . . . . . . . . . . . . . . . . . . 108

......................... 108

5.5.3 Indexed VTOC Considerations (OS/390)

5.6 VSAM Differences

5.6.1 Introduction

5.6.2 OS/390 Catalogs

5.6.3 OS/390 Catalog Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

....................... 114

5.6.4 OS/390 - VSE/VSAM Catalog Compatibility

5.6.5 VSAM Functional Differences

5.6.6 Data Sharing and Integrity

....................... 119

......................... 125

5.6.7 Programming Languages and VSAM Support

5.6.8 VSAM Error and Reason Code Compatibility

5.6.9 DFSORT and VSAM Considerations

................... 131

................ 97

.................. 97

.............. 106

................. 109

............... 117

............. 131

.............. 131

Chapter 6. CICS

6.1 Introduction

6.1.1 Overview CICS Transaction Server

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

................... 133

6.1.2 Essential Supplemental Reading and Migration Support Material

6.1.3 General Compatibility Comments

6.1.4 Virtual Storage Considerations for MVS

6.1.5 CICS General System Considerations

6.1.6 CICS Macro Resource Definition Table Changes

6.1.7 CSD and RDO Considerations

6.1.8 CICS System Data Sets Requirements

6.1.9 CICS System Program Interface and Exits

6.1.10 CICS Transaction Security

.................... 135

................. 135

.................. 136

........... 140

...................... 143

................. 145

............... 147

........................ 149

. 134

Contents v

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

6.1.12 Application Programming

6.1.13 CICS/VSE and TS Coexistence Considerations

6.1.14 Testing and Problem Determination Considerations

6.1.15 Vendor Applications

6.2 CICS with DL/I

................................... 154

. . . . . . . . . . . . . . . . . . . . . . . . 150

............ 153

......... 153

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Chapter 7. ICCF and TSO

7.1 Preparing to Use the System

7.1.1 User Profiles

7.1.2 LOGON Procedures

7.1.3 Message Facilities

7.1.4 Security

7.1.5 Summary

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

................................... 158

7.2 Using the System

7.2.1 Accessing the System

7.2.2 Entering and Manipulating Data

7.3 Executing Programs at a Terminal

7.4 Submitting Jobs for Batch Execution

7.4.1 Using Command Procedures

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

7.5.1 Converting ICCF Libraries

7.5.2 ICCF Procedures and Macros

Chapter 8. Databases

8.1 DL/I and IMS/VS DB Differences

8.1.1 Introduction

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

8.1.2 MVS System Requirements

8.1.3 Data Base Descriptor (DBD)

8.1.4 Program Specification Block (PSB)

8.1.5 Batch Programming

8.1.6 Utilities

8.1.7 Operations

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

8.1.8 Database Portability

8.1.9 DL/I Multiple Partition Support

8.1.10 Additional Information

.............................. 155

.......................... 155

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

................................. 158

........................... 159

..................... 159

...................... 161

..................... 162

....................... 163

................ 163

......................... 163

....................... 167

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

........................ 169

........................ 170

........................ 170

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

...................... 178

. . . . . . . . . . . . . . . . . . . . . . . . . . . 178

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

8.2.1 Descriptions of Users

8.2.2 Other Comparison Areas

8.2.3 Summary of Migration Task

............................ 178

......................... 181

........................ 182

............ 178

Chapter 9. Telecommunications Subsystems

9.1 ACF/VTAM

9.1.1 Product Installation

9.1.2 Resource Definition and Operation

9.1.3 Customization and Programming

9.1.4 Network Configuration

9.2 ACF/NCP

9.2.1 Product Installation

9.2.2 Program Generation

9.2.3 Backlevel Hardware Support

9.3 BTAM

9.3.1 Product Installation

9.3.2 Usage

9.4 Migrating TCP/IP

vi VSE to OS/390 Migration Workbook

. . . . . . . . . . . . . . . . . . 185

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

.................... 187

..................... 190

. . . . . . . . . . . . . . . . . . . . . . . . . . . 191

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

....................... 193

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

..................................... 193

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

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

9.4.2 TCP/IP Configuration

9.4.3 TCP/IP Related User Data

9.4.4 TCP/IP Batch Jobs

9.4.5 User Written TCP/IP Applications

9.4.6 Security

9.4.7 Bibliography

9.5 MQSeries

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

9.5.1 MQSeries in Your Operating System Environment

9.5.2 Networking Definitions

9.5.3 Defining MQSeries Object and Operating

9.5.4 MQSeries-based Applications

9.5.5 Bibliography

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

......................... 195

............................. 195

..................... 195

.......... 198

. . . . . . . . . . . . . . . . . . . . . . . . . . . 203

................ 203

. . . . . . . . . . . . . . . . . . . . . . . 205

Chapter 10. POWER and JES2

10.1 JES2 Introduction

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

10.1.1 Major Differences

10.2 Implementing JES2

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

10.2.1 Setting Up the Required Resources

10.2.2 Starting JES2

10.2.3 Tailoring JES2

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

10.3 JES2-POWER Functional Comparison

10.3.2 Input Service

10.3.3 Job Scheduling

10.3.4 Output Service

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

10.3.5 Interactive User Interfaces (ICCF/CMS/TSO)

10.3.6 Remote Job Entry

10.3.7 Network Job Entry

10.3.8 Application Interfaces

10.3.9 Accounting Comparisons

10.3.10 RAS Characteristics

10.3.11 JES2 Testing Techniques

10.4 POWER/JES2 Detailed Comparisons

10.4.1 Mapping POWER Parameters to JES2 Init Parms

10.4.2 Exit Comparisons

10.4.3 POWER-JES2 Command Equivalences

........................... 207

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

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

.................... 211

............. 218

............................. 219

............................. 220

. . . . . . . . . . . . . . . . . . . . . . . . . . . 221

. . . . . . . . . . . . . . . . . . . . . . . . . 223

. . . . . . . . . . . . . . . . . . . . . . . . . . . 224

........................ 225

..................... 225

.......... 225

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

................. 231

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

11.1 Introducing PSF/MVS

11.1.1 Functional Comparison between PSF/VSE and PSF/MVS

11.1.2 Migration Effort

11.2 Installing and Configuring PSF/MVS

11.2.1 Defining Channel-attached Printers to MVS

11.2.2 Defining Network Printers

11.2.3 The PSF Startup Procedures

11.2.4 Defining Printers for PSF Printing

11.2.5 FSS Procedure and PRINTDEV Statements

11.3 Setting up AFP Resources

11.3.1 Migrating Resources from VSE to OS/390

11.3.2 Remote-Resident Resources

11.3.3 Transferring Print Streams - VSE and OS/390 Coexistence

11.3.4 Migrating Print Applications

11.4 Understanding Operational Differences

11.4.1 Starting and Stopping PSF

11.4.2 Command Comparison

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

...... 235

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

..................... 236

.............. 236

........................ 236

....................... 237

.................... 237

.............. 238

........................... 240

............... 240

. . . . . . . . . . . . . . . . . . . . . . . 240

..... 241

....................... 241

................... 242

........................ 242

. . . . . . . . . . . . . . . . . . . . . . . . . . 242

.. 235

Contents vii

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

11.5.1 Performance

11.5.2 Installation Exits

11.5.3 Accounting

11.6 References

11.6.1 PSF/VSE Publications

11.6.2 PSF/MVS Publications

11.6.3 Redbooks

11.6.4 Other Sources

11.6.5 Tools

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

11.6.6 Services

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

. . . . . . . . . . . . . . . . . . . . . . . . . . . 244

........................... 244

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

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

Chapter 12. COBOL

12.1 Introduction

12.1.1 General Comments on COBOL for OS/390 and VM

12.1.2 Comparison of IBM COBOL Compilers

12.2 VSE to OS/390 Migration Considerations

12.2.1 Migrating Object Code

12.2.2 Useful Publications

12.3 Converting from DOS/VS COBOL

12.3.1 DOS/VS COBOL CICS Programs

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

......... 249

................. 250

.................. 250

.......................... 251

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

...................... 252

.................... 252

12.3.2 DOS/VS COBOL Programs Containing REPORT WRITER
Statements

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

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

12.4.1 Common COBOL Coding Problems

12.4.2 ENVIRONMENT DIVISION

. . . . . . . . . . . . . . . . . . . . . . . . . 255

12.4.3 DATA DIVISION - FILE DESCRIPTION (FD)

12.4.4 PROCEDURE DIVISION - Input/Output

12.4.5 File Handling Considerations

12.5 Converting from VS COBOL II

......................... 258

12.5.1 V S COBOL II CICS Programs

12.6 Converting from COBOL for VSE/ESA

12.7 Some Conversion Considerations for all VSE COBOL Compilers

12.7.1 VSAM

12.7.2 DISPLAY Statement

12.8 Compiler Options

12.8.1 RES/NORES

12.9 Reserved Words

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

12.9.1 Reserved Word Considerations for DOS/VS COBOL

................... 253

............... 256

................. 256

...................... 257

...................... 259

.................... 259

.... 259

......... 263

12.9.2 Reserved Word Considerations for VS COBOL II and COBOL for
VSE/ESA

12.10 Compiling and Running Your Converted COBOL Programs

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

...... 265

Chapter 13. Assembler

13.1 Assembler Products

13.2 General Assembler Conversion Comments

13.2.1 System Interface and Macros

13.2.2 Multitasking Macros

13.2.3 Interrupt Handling Routines

13.2.4 Virtual Storage Macros

13.2.5 VSAM Macros

13.2.6 Data Management Macros

viii VSE to OS/390 Migration Workbook

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

................ 267

...................... 268

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

....................... 287

.......................... 289

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

........................ 292

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

14.1 Migration from VSE to OS/390

14.1.1 Device Information

14.1.2 Print Files

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

14.1.3 Tape Labels

14.1.4 Extent Exit

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

14.1.5 Processing Options

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

14.1.6 File Access Methods

14.1.7 Calling COBOL Subprograms

14.1.8 Calling PL/I Subprograms

........................ 329

........................... 330

...................... 331

........................ 331

Chapter 15. P L/I

15.1 Functional Differences

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333

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

15.1.2 Extended Precision

15.1.3 Multitasking

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

15.1.4 Dynamic Loading of Dependent Programs

15.1.5 File Organization

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

15.1.6 Parameters Passed to a Main Program

15.1.7 %INCLUDE

15.2 Compiler Options

15.2.1 Options Specific to the DOS Compiler

15.2.2 Options Specific to the MVS Compiler

15.2.3 Execution Options

15.2.4 The EXEC and PROCESS Cards

15.3 Linkages Between Languages

15.3.1 Linkages Supported

15.3.2 Linkages not Supported

15.4 ENVIRONMENT Attributes

15.4.1 Not Supported in MVS

15.4.2 Supported but to be Avoided

15.4.3 The ″TOTAL″ Option

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

................. 335

................. 336

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

..................... 338

........................ 338

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

.......................... 338

. . . . . . . . . . . . . . . . . . . . . . . . . . . 338

.......................... 339

...................... 340

............................ 340

15.4.4 The SIS Option (Sequential Insert Strategy)

15.5 Calling SORT from PL/I

15.5.1 Interfaces Offered

15.5.2 Parameters to be Passed

15.6 Checkpoint-Restart in PL/I

15.6.1 PLICKPT

15.6.2 PLIREST

15.6.3 PLICANC

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

15.7 DUMP in PL/I Optimizer

15.7.1 Output File

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

15.7.2 Options Specific to DOS

15.7.3 Options Specific to MVS

15.7.4 Compatibility

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

15.8 Return Codes in PL/I

15.8.1 Setting Return Codes

15.8.2 Return Code Values

15.9 Forcing an ABEND

15.9.1 Use of DISP in the JCL

15.9.2 Automatic Restart

15.10 Overlay Structures

15.10.1 Conversion

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

15.10.2 Overlay in MVS

15.11 Storage Management in PL/I

............................ 340

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

......................... 340

........................... 342

............................ 343

......................... 343

......................... 344

.............................. 344

........................... 344

............................ 344

............................... 344

.......................... 344

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345

.............................. 345

........................ 345

........... 333

.............. 334

................ 335

.............. 340

Contents ix

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

15.11.2 Storage Management in MVS

15.12 PL/I and CICS

15.12.1 File Support

................................. 346

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.2 Statements not Supported

15.12.3 CALLing DUMP

15.12.4 Execution Options

15.12.5 Compatibility

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

15.12.6 PL/I-CICS/VS Transaction ABEND Codes

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

..................... 345

....................... 346

............... 346

.... 347

Chapter 16. FORTRAN

16.1 VS FORTRAN in OS/390

16.2 FORTRAN Conversion Considerations

Chapter 17. Language Environment (LE)

17.1 Introduction

17.1.1 General Comments on Language Environment

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

............................ 349

.................... 349

..................... 351

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351

............ 351

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

17.2 VSE to OS/390 Migration Considerations

17.2.1 LE/VSE-conforming Languages

17.2.2 Useful Publications

17.3 Migrating from LE/VSE-Conforming Languages

17.3.1 C for VSE/ESA

17.3.2 COBOL for VSE/ESA

17.3.3 PL/I for VSE/ESA

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

17.4.1 Options Mapping

17.4.2 C/370

17.4.3 VS COBOL II

17.4.4 DOS/VS COBOL

17.4.5 DOS PL/I

17.4.6 V S FORTRAN

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

.................. 352

. . . . . . . . . . . . . . . . . . . . . 352

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

.............. 353

............................... 353

............................ 354

.............................. 354

........... 354

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

................................ 355

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

................................... 356

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

17.4.7 Migrating Interlanguage Communications Applications

17.4.8 Migrating Assembler Applications

17.5 Migrating from LE/VSE

17.5.1 Run-time Options

............................. 359

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

17.5.2 User Exits and Abnormal Termination Exits

17.5.3 Callable Services and Math Services

17.5.4 LE/VSE 1.4 Locales

17.6 CICS

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

17.6.1 COBOL and CICS

17.6.2 Run-time Options

............................ 366

............................. 366

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

17.6.3 User Exits and Abnormal Termination Exits

................... 359

.............. 364

................. 365

.............. 367

....... 358

Chapter 18. Procedure Language REXX

18.1 REXX and VM/ESA

18.2 REXX and VSE/ESA

18.3 REXX and TSO/E

18.4 Environments

18.4.1 VSE/ESA Environment

18.4.2 VM/ESA Environment

18.4.3 TSO/E Environment

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

x VSE to OS/390 Migration Workbook

...................... 369

............................... 369

............................... 369

................................ 369

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

. . . . . . . . . . . . . . . . . . . . . . . . . . . 370

. . . . . . . . . . . . . . . . . . . . . . . . . . . 370

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

.. 371

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

18.5.1 REXX and SAA

18.6 REXX Bibliography

............................... 372

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

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

Chapter 19. SORT

19.1 JCL Statements

19.2 Control Statements

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

19.3 Additional DFSORT/VSE Migration Considerations

19.3.1 Control Statements

19.3.2 ICETOOL

Chapter 20. DITTO

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

20.1 Compatibility with Previous Releases of DITTO

20.2 DITTO Functions that are No Longer Supported

20.3 DITTO Functions that are Not Recommended

20.4 DITTO Function Code Synonyms

....................... 384

............... 383

20.5 Batch Keywords that are No Longer Supported

20.6 Batch Keywords that are Not Recommended

20.7 DITTO/ESA Security

Chapter 21. VSAM Backup/Restore

21.1 VSAM Backup/Restore

21.1.1 OS/390 VSAM Backup/Restore

21.1.2 VSE/VSAM Backup/Restore

Chapter 22. Librarian

22.1 Overall Library Support

22.1.1 OS/390 ISPF Overview

22.1.2 OS/390 Library Management

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

. . . . . . . . . . . . . . . . . . . . . . . . 387

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

..................... 387

. . . . . . . . . . . . . . . . . . . . . . . 387

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

............................ 389

.......................... 390

....................... 391

............... 385

............ 379

.............. 381

.............. 382

.............. 384

Chapter 23. LISTLOG/PRINTLOG - Printing Log Streams

23.1 VSE PRINTLOG Utility

23.2 VSE LISTLOG Utility Program

23.3 OS/390 Hardcopy Processing

23.3.1 SYSLOG

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

23.3.2 Printing SYSLOG

23.4 OPERLOG

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

23.4.1 Printing OPERLOG

............................. 393

......................... 393

......................... 393

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

23.5 JES2 System Data Sets - Job Log and System Messages

23.6 Systems Management Recording

23.6.1 Printing SMF Records

........................... 395

...................... 395

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

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

24.2 DFSMSdss - OS/390 Component

....................... 398

.................. 397

........... 393

........ 395

............... 397

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

Chapter 25. Prepare the Migration Environment

25.1 Introduction

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

25.2 Install and Configure Required Hardware

................. 401

.................. 402

Contents xi

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

25.2.2 Devices Supported by OS/390

25.2.3 DASD Requirements

............................ 402

25.2.4 Other Hardware Requirements

25.2.5 Inter-Systems Connectivity

25.3 Order and Install the OS/390 Software

25.3.1 Fee-based Methods of Installing OS/390

25.3.2 Entitled Methods of Installing OS/390

25.4 Set Up Standards, Procedures, and Documentation

25.4.1 Installation Standards

. . . . . . . . . . . . . . . . . . . . . . . . . . . 407

25.4.2 Systems Management Procedures

25.4.3 Documentation

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

25.5 Customize Your New OS/390 System

25.5.2 MVS BCP Customization

25.5.3 Other OS/390 Elements

.......................... 416

...................... 402

..................... 403

. . . . . . . . . . . . . . . . . . . . . . . . 404

................... 405

................ 405

.................. 406

........... 407

................... 409

.................... 413

......................... 415

Chapter 26. Test Environments

26.1 Introduction

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

26.1.1 Differences in Testing ″Philosophy″

26.1.2 Terminology

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

26.2 Test Systems in the Life of the Migration

26.3 VM, LPAR, or Standalone Systems

26.3.1 Logical Partitioning

26.3.2 Software Partitioning

26.3.3 Our Recommendation

26.3.4 Summary

26.4 Parallel Activities

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

26.4.2 Synchronizing VSE Applications with OS/390 Versions

26.5 Building the Initial OS/390 Test System

26.5.1 OS/390 Maintenance Environment

26.5.2 OS/390 Test Logical Partition

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

26.6 Shared DASD vs. Cloned DASD

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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . 419

.................. 419

.................. 420

..................... 421

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

. . . . . . . . . . . . . . . . . . . . . . . . . . . 423

. . . . . . . . . . . . . . . . . . . . . . . . . . . 424

....... 430

................... 430

................... 431

...................... 431

....... 431

....................... 432

. 432

.... 433

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

Chapter 27. Orienting ICCF Users to TSO/ISPF

27.1 TSO/ISPF and SDSF

27.1.1 Editing Data Sets

27.1.2 Submitting Jobs

27.1.3 Using ISPF Utilities

.............................. 437

.............................. 438

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

............................ 439

27.1.4 Creating and Executing ISPF Applications

27.1.5 Managing Projects

27.1.6 Tracking Jobs

27.1.7 Retrieving Output

27.1.8 Using SDSF for Operators

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

........................ 441

................. 437

............... 440

Chapter 28. Orientation to OS/390 Console Operation

28.1 Introduction

28.1.1 Operating Hardware Consoles

28.2 Understanding the Operator Interfaces

28.2.1 Controlling Consoles

xii VSE to OS/390 Migration Workbook

............. 443

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443

...................... 443

................... 443

. . . . . . . . . . . . . . . . . . . . . . . . . . . 444

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

28.2.3 Extended MCS Consoles

28.2.4 Understanding Message Formats and Replies

28.3 Controlling the OS/390 System

28.3.1 Starting the System

28.3.2 Displaying System Status

28.3.3 Stopping the System

28.4 Controlling Devices

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448

28.4.1 Displaying the Status of Devices

28.4.2 Understanding Device Allocation

28.4.3 JES2 Devices

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

28.4.4 SDSF Device Panels

28.5 Controlling TSO Users, Jobs and Started Tasks

28.5.1 Displaying Work on Your System

28.5.2 Controlling Time Sharing Users

28.5.3 Controlling Batch Jobs

28.5.4 Controlling Started Tasks

28.6 Managing Remote Operations

28.6.1 JES2 RJE Operations

28.6.2 N JE Operations

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

......................... 445

............ 446

........................ 447

............................ 447

......................... 447

........................... 448

.................... 448

.................... 448

............................ 449

.............. 449

.................... 449

..................... 451

.......................... 451

......................... 451

........................ 452

........................... 452

Chapter 29. Orientation for Utilities

29.1 IEBxxx or IEHxxx

29.2 IEBCOPY

29.3 IDCAMS

29.4 IEBGENER

29.5 DFSMSdss

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456

................................ 455

........................ 455

Chapter 30. Systems Management Philosophy and Methodology

30.1 The Philosophy of Systems Management

30.1.1 Systems Management Overview

.................. 457

.................... 457

30.1.2 Systems Management Scope - What Needs to be Managed?

30.1.3 The Role of Automation

30.2 Change Management

30.2.1 Overview

30.2.2 Tasks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

30.2.3 Methodology

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

30.3 Problem Management

30.3.1 Overview

30.3.2 Tasks

30.3.3 Methodology

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

30.4 Performance Management

30.4.1 Overview

30.4.2 Tasks

30.4.3 Methodology

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464

30.5 Operations Management

30.5.1 Overview

30.5.2 Tasks

30.5.3 Methodology

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466

30.6 Security Management

30.6.1 Overview

30.6.2 Tasks

30.6.3 Methodology

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

30.7 Configuration Management

30.7.1 Overview

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

.......................... 460

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

. . . . . . . . . . . . . . . . . . . . . . . . . . 463

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 465

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

. . . . . . . . . . . . . . . . . . . . . . . . . . 469

....... 457

... 459

Contents xiii

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

30.7.3 Methodology

30.8 Asset Management

30.8.1 Overview

30.8.2 Tasks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

30.8.3 Methodology

30.9 Accounting Management

30.9.1 Overview

30.9.2 Tasks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

30.9.3 Methodology

30.10 Summary

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

. . . . . . . . . . . . . . . . . . . . . . . . . . . 471

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

Chapter 31. Diagnosing System Problems

31.1 Problem Determination Tools

31.2 Dumps

31.3 IPCS

31.3.1 Analyzing Dumps

31.3.2 Traces

31.3.3 Analyzing Traces

31.3.4 Using IPCS

31.4 JES2 Diagnosis

31.5 SLIP

31.6 Performance Tools

31.7 LOGREC

31.8 SYSLOG

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

.............................. 474

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

31.9 DFSMS/MVS Diagnosis

31.9.1 DFSMSdfp

31.9.2 DFSMShsm

31.9.3 DFSMSrmm

31.9.4 DFSMSdss

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478

......................... 473

............................. 476

31.10 Diagnostic Reference Publications

.................... 473

..................... 478

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

Chapter 32. Conversion Process

32.1 Conversion Process Introduction

32.1.1 References

32.1.2 Prerequisites

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

32.1.3 Recommendations

32.1.4 Assumptions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486

32.2 Mass Conversion - Background, Benefits and Method

32.2.1 IBM MVS Migration System - Background

32.2.2 Mass Conversion Overview / Benefits

32.2.3 Mass Conversion Tools

32.2.4 Automated Conversion Process

32.2.5 CORTEX MS

................................. 490

32.3 Mass Conversion Phase Overview

32.4 Preparation Phases

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

32.4.1 Phase 0: Project Management and Technical Leadership

32.4.2 Phase 1: Application Inventory

32.4.3 OS/390 Standards and Naming Conventions

32.4.4 Phase 2: Conversion Specifications

32.4.5 Phase 3: Customization or Development of Conversion Tools

32.5 Conversion Phases

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

. . . . . . . . . . . . . . . . . . . . . . . . . . 481

....................... 482

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484

.......... 486

............... 486

................. 487

.......................... 489

..................... 490

...................... 493

..... 494

..................... 495

............. 497

................... 499

... 501

xiv VSE to OS/390 Migration Workbook

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

32.5.2 JCL Conversion

32.5.3 Phase 4: Initial Trial Conversion

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504

.................... 505

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

32.5.5 Initialization Testing

32.5.6 Unit Testing

32.5.7 System Testing

32.5.8 Parallel/Production Simulation Testing

32.6 Implementation Phases

32.6.2 Phase 6: Actual Conversion and Switchover

32.6.3 Switchover

32.6.4 Phase 7: Initial OS/390 Operations

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513

................ 514

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 515

............. 516

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

................... 518

Chapter 33. Conversion Services and Tools

33.1 Conversion Services

33.1.1 IBM Global Services

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519

............................ 519

33.1.2 Automated Migration Services (AMS)

33.2 Conversion Tools

33.2.1 VSE/ESA Facilities

33.2.2 IBM OPTI-AUDIT for VSE

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

......................... 520

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

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

33.2.5 Computer Associates

. . . . . . . . . . . . . . . . . . . . . . . . . . . 525

33.2.6 The Source Recovery Company

................... 519

................. 519

. 522

......... 524

..................... 525

Part 8. Migration Experience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527

Chapter 34. Customer Migration Example

34.1 Background

34.2 Environment

34.3 Inventory

34.4 Resources

34.5 Duration

34.6 Performance

34.7 Benefits

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532

..................... 529

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

Appendix A. Education Information

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

A.1.1 OS/390 Classes
A.1.2 Custom Classes

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536

A.1.3 OEM Product Education
A.2 When are Courses Scheduled and When are they Needed?
A.3 Who will Provide the Training?
A.4 Where will the Training Take Place?

Appendix B. Mapping ISV Products and Functions

B.1 The IBM Software Migration Project Office (SMPO)
B.2 VSE ISV System Management Products and OS/390 Compared

Appendix C. DFSMS Naming Conventions

. . . . . . . . . . . . . . . . . . . . . . . . 535

.. 535

.......................... 536

....... 536

........................ 537

..................... 537

............... 539

............ 539

..... 539

.................... 543

Contents xv

C.1 Data Set Naming Guidelines .......................... 543

C.2 Components of a Data Set Name

C.2.1 High-Level Qualifier (HLQ)
C.2.2 Relative Importance
C.2.3 File Contents
C.2.4 User Name

................................. 546

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547

C.2.5 Data Set Level

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 546

................................ 547

C.3 Things Not to Include in the Data Set Name

C.3.1 Department Number
C.3.2 Application Location
C.3.3 Management Criteria
C.3.4 Output Device Type
C.3.5 Expiration Date
C.3.6 Access Method
C.3.7 Job Name

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 547

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 548

............................ 548

............................. 548

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549

C.4 Common Applications - Naming Conventions

C.4.1 TSO Naming Conventions
C.4.2 VSAM Data Set Naming Conventions
C.4.3 DB2 Naming Conventions
C.4.4 Generation Data Sets

........................... 551

....................... 544

........................ 544

................ 547

................ 549

......................... 549

.................. 550

......................... 550

Appendix D. Special Notices

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

................................... 559

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

Glossary

List of Abbreviations

Index

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565

................................. 583

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 553

. . . . . . . . . . . . . . . . . . . . . . . . . 557

........ 557

........................ 557

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557

.......................... 557

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558

...................... 558

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559

........................... 559

............................. 559

............................. 561

.................. 561

..................... 562

.............................. 563

ITSO Redbook Evaluation

xvi VSE to OS/390 Migration Workbook

............................... 593

Figures

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

2. VAE with Four Address Spaces

3. VSE/ESA Storage Layout

4. OS/390 Storage Layout

5. Migration Team

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

6. Progressive versus Mass Conversion

7. Nonstandard Labels Supported by VSE

8. Extract from WSC Flash 9741

9. OS/390 Master and User Catalog Structure

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

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

12. CICS Domains

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

13. Log Stream Choices Resulting from Hardware and Software Used

14. MVS Data Sets used by CICS

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

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

17. VTAM Start Procedure

............................. 187

18. Comparison of IBM COBOLs

. . . . . . . . . . . . . . . . . . . . . . . . . 7

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

..................... 49

. . . . . . . . . . . . . . . . . . . 107

. . . . . . . . . . . . . . . . . . . . . . . . . 113

. . . . . . . . . . . . . . . . 116

.... 126

............. 136

.. 146

......................... 146

..... 169

.............. 177

......................... 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

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

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

........ 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

27. VSE Subroutine Linkage

28. MVS Subroutine Linkage

29. Sample Initiation Termination Coding

30. VSE and MVS Time Degrees of Precision

31. Comparison of the DTFCD and DCB Macros

32. Card File Macros in VSE and MVS

33. Card File Programs in VSE and MVS

34. Comparison of the DTFPR and DCB Macros

35. Comparison of the DTFMT and DCB Macros

36. Tape File Programs in VSE and MVS

37. Comparison of DTFDI and DCB macros

38. Comparison of the DTFSD and DCB Macros

39. Sequential DASD FILE Program in VSE and MVS

40. Comparison of DTFDA and DCB Macros

41. VSE Error Bytes and MVS Exception Code Bits

42. Record Reference by ID in VSE and MVS

43. Record Reference by KEY in VSE and MVS

44. Updating a DAM File under MVS

45. Adding to a DAM File under MVS

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

............................ 270

........................... 271

.................... 274

................. 279

................ 295

...................... 295

.................... 296

................ 297

................ 302

.................... 303

................... 304

................ 310

............. 311

.................. 312

.............. 313

.................. 317

................ 318

....................... 318

...................... 319

 Copyright IBM Corp. 1998 xvii

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

47. Loading a Sequential DAM File under MVS

48. Loading a Random DAM File under MVS

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

50. Processing a DAM file under VSE

...................... 324

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

52. MVS Feedback Formats

............................ 326

53. Relationship between CCB operands and MVS Equivalents

54. Relationship between DTFPH Macro and MVS equivalents

55. Comparison VSE and MVS Major Elements

................ 320

.................. 320

...... 321

......... 325

....... 327

....... 328

................ 328

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

57. Automated Conversion Process

58. Project Phases

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

....................... 491

xviii VSE to OS/390 Migration Workbook

Tables

1. Comparison of VSE Functions & Components to OS/390 Replacements 16

2. Who′s Normal Activities are Affected?

3. Nine Month Project

4. CNV Responsibilities

5. ABC Responsibilities

6. SER Responsibilities

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

7. VSE Job Control Statements Summary

8. MVS Job Control Statements

. . . . . . . . . . . . . . . . . . . . . . . . . . 88

9. Overview of POWER JECL Statements

10. JES2 Control Statements

............................ 90

11. JES2 Input Sources (compared to POWER)

12. POWER/JES2 Job Scheduling Comparison

13. POWER/JES2 Output Service Comparison

14. FCB Name Prefixes

............................... 217

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

16. Accounting Records for NJE Activities

17. POWER Macro to JES2 Parameter Mapping

18. PLINE MACRO to JES2 Parameter Mapping

19. PRMT MACRO to JES2 Parameter Mapping

20. PRMT MACRO to JES2 Parameter Mapping

21. PNODE MACRO to JES2 Parameter Mapping

22. PCPTAB MACRO to JES2 Parameter Mapping

23. POWER Exit to JES2 Exits

........................... 231

24. Queue Management Commands

25. Task Management Commands

26. Control Commands

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

........................ 232

27. Network Management Commands

28. File Control Commands

............................ 234

29. Sending Commands and Messages

30. PRINTDEV Parameter Comparison

31. VSE - OS/390 Command Comparison

32. Useful COBOL Publications

.......................... 252

33. Action of COBOL Program Termination Statements

34. COBOL and PL/I: What Runs Where?

35. Useful Publications

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

36. REPORT and ISASIZE Options, C/370 and DOS PL/I

37. C/370 Migration Considerations

38. VS COBOL II Migration Considerations

39. DOS/VS COBOL Migration Considerations

40. DOS PL/I Migration Considerations

41. ILC Migration Considerations

......................... 358

. . . . . . . . . . . . . . . . . . . . 26

. . . . . . . . . . . . . . . . . . . . 86

. . . . . . . . . . . . . . . . . . . . 89

................. 212

................. 213

................. 215

.... 219

................... 224

................ 226

................ 228

................ 228

................ 229

............... 230

.............. 230

....................... 232

...................... 233

..................... 234

...................... 239

.................... 242

........... 257

.................... 351

........... 355

....................... 355

................... 356

................. 356

..................... 357

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

45. OS/390 DASD Layout

.............................. 403

46. S/390 Software Product Mapping

........................ 367

....................... 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 page 593 to
the fax number shown on the form.

Use the electronic evaluation form found on the Redbooks Web sites:
For Internet users

For IBM Intranet users http://w3.itso.ibm.com/
Send us a note at the following address:

http://www.redbooks.ibm.com/

[e-mail]

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.2 Traditional 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