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

International Technical Support Organization

VSE to OS/390 Migration Workbook

October 1998

SG24-2043-00

IBML

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.

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.1 A Synopsis of This Book

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

1.2 Traditional Reasons for Migrating

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

1.2.1 Business Consolidation

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

1.2.2 Mergers/Acquisitions

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

1.2.3 Capacity Constraints

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

1.2.4 Image

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

1.3 Functional Reasons for Migrating to OS/390

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

1.3.1 Applications Availability

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

1.3.2 Systems Management

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

1.3.3 Connectivity

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

1.3.4 Systems Availability

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

1.3.5 Staff 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.3 What Changes Between VSE and OS/390?

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

2.3.1 Philosophical Changes

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

2.4 Who is Affected by This Migration?

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

2.4.1 Job Roles and Normal Activities

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

2.5 Approaches to Migration

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

2.5.1 Disclaimer

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.4 Staffing Strategies

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

2.5.5 Conversion Tools

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

2.6 Educational Requirements

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

2.6.1 Introduction

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

2.7 Scope of Work and Challenges

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

2.7.1 Application Inventory

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

2.7.2 Program Conversion

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

2.7.3 JCL Conversion

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

2.7.4 File Migration

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

 Copyright IBM Corp. 1998 iii

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

2.7.6 Automated Operations

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

2.8 Cost Considerations

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

2.9 OS/390 Documentation Resources

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

2.9.1 Introduction References

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

2.9.2 Key Documents and Other References

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

2.9.3 Web URL

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

Chapter 3. Developing the Plan

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

3.1 Overview

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

3.1.1 References

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

3.1.2 Recommendations

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

3.2 Plan Components

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

3.2.1 Approach

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

3.2.2 Team

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

3.2.3 Tasks

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

3.2.4 Milestone Events

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

3.2.5 Education

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

3.3 Progressive versus Mass Conversion

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

3.3.1 Approach Differences

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

3.3.2 Historical Perspective

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

3.3.3 Shared Application Files and Databases

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

3.3.4 Shared Application Code

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

3.3.5 Operations Support Staffing

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

3.3.6 Automated Operations Tools

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

3.3.7 Standardized Conversion Deliverables and Automation

........ 51

3.3.8 Risk Management

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

3.3.9 Complexity of Implementation

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

3.4 Plan Examples

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

3.4.1 Project Schedule

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

3.4.2 Project 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/ESA′s Job Control Language Philosophy

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

4.1.2 OS/390′s Job Control Philosophy

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

4.2 High Level Similarities

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

4.2.1 JCL Statement and Job Layout

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

4.2.2 Spooling

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

4.3 JCL Differences Between VSE and MVS

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

4.3.1 Job Input

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

4.3.2 JCL Expansion

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

4.3.3 Operator Flexibility and Intervention

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

4.3.4 Allocation of Resources

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

4.3.5 Hidden JCL

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

4.3.6 Device Address Specifications

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

4.3.7 Catalogs

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

4.3.8 Partition Dependent Codes in JCL

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

4.3.9 Communication Region - DATE and UPSI

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

4.3.10 VSE Job Control Statements

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

4.3.11 MVS 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.1 Sample VSE JCL

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

4.5.2 Sample MVS JCL

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

4.5.3 Sample 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.3 Miscellaneous Functions

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

5.2 Data Set Naming Considerations

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

5.2.1 VSE Considerations

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

5.2.2 OS/390 Considerations

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

5.3 Storage and Space Management

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

5.3.1 VSE Considerations

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

5.3.2 OS/390 Considerations

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

5.3.3 System Managed Storage

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

5.3.4 Implementing DFSMS

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

5.4 Tape Similarities and Differences

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

5.4.1 Volume Interchangeability

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

5.4.2 Standard Labels

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

5.4.3 No Labels

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

5.4.4 Nonstandard Labels

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

5.4.5 Bypass Label Processing Facility in OS/390

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

5.5 DASD Similarities and Differences

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

5.5.1 Volume Interchangeability

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

5.5.2 DASD (VTOC) Processing

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

5.5.3 Indexed VTOC Considerations (OS/390)

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

5.6 VSAM Differences

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

5.6.1 Introduction

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

5.6.2 OS/390 Catalogs

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

5.6.3 OS/390 Catalog Management

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

5.6.4 OS/390 - VSE/VSAM Catalog Compatibility

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

5.6.5 VSAM Functional Differences

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

5.6.6 Data 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.11 CICS UPSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

6.1.12 Application Programming

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

6.1.13 CICS/VSE and TS Coexistence Considerations

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

6.1.14 Testing and Problem Determination Considerations

......... 153

6.1.15 Vendor Applications

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

6.2 CICS with DL/I

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

Chapter 7. ICCF and TSO

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

7.1 Preparing to Use the System

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

7.1.1 User Profiles

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

7.1.2 LOGON Procedures

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

7.1.3 Message Facilities

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

7.1.4 Security

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

7.1.5 Summary

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

7.2 Using the System

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

7.2.1 Accessing the System

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

7.2.2 Entering and Manipulating Data

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

7.3 Executing 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.1 Converting ICCF Libraries

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

7.5.2 ICCF Procedures and Macros

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

Chapter 8. Databases

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

8.1 DL/I and IMS/VS DB Differences

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

8.1.1 Introduction

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

8.1.2 MVS System Requirements

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

8.1.3 Data Base Descriptor (DBD)

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

8.1.4 Program Specification Block (PSB)

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

8.1.5 Batch Programming

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

8.1.6 Utilities

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

8.1.7 Operations

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

8.1.8 Database Portability

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

8.1.9 DL/I Multiple Partition Support

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

8.1.10 Additional Information

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

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

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

8.2.1 Descriptions of Users

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

8.2.2 Other Comparison Areas

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

8.2.3 Summary of Migration Task

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

Chapter 9. Telecommunications Subsystems

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

9.1 ACF/VTAM

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

9.1.1 Product Installation

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

9.1.2 Resource Definition and Operation

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

9.1.3 Customization and Programming

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

9.1.4 Network Configuration

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

9.2 ACF/NCP

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

9.2.1 Product Installation

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

9.2.2 Program Generation

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

9.2.3 Backlevel Hardware Support

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

9.3 BTAM

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

9.3.1 Product Installation

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

9.3.2 Usage

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

9.4 Migrating TCP/IP

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

vi VSE to OS/390 Migration Workbook

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

9.4.2 TCP/IP Configuration

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

9.4.3 TCP/IP Related User Data

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

9.4.4 TCP/IP Batch Jobs

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

9.4.5 User Written TCP/IP Applications

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

9.4.6 Security

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

9.4.7 Bibliography

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

9.5 MQSeries

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.4 MQSeries-based Applications

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

9.5.5 Bibliography

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

Chapter 10. POWER and JES2

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

10.1 JES2 Introduction

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

10.1.1 Major Differences

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

10.2 Implementing JES2

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

10.2.1 Setting Up the Required Resources

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

10.2.2 Starting JES2

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

10.2.3 Tailoring JES2

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

10.3 JES2-POWER Functional Comparison

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

10.3.2 Input Service

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

10.3.3 Job Scheduling

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

10.3.4 Output Service

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

10.3.5 Interactive User Interfaces (ICCF/CMS/TSO)

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

10.3.6 Remote Job Entry

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

10.3.7 Network Job Entry

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

10.3.8 Application Interfaces

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

10.3.9 Accounting Comparisons

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

10.3.10 RAS Characteristics

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

10.3.11 JES2 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.1 Introducing PSF/MVS

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

11.1.1 Functional Comparison between PSF/VSE and PSF/MVS

...... 235

11.1.2 Migration Effort

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

11.2 Installing and Configuring PSF/MVS

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

11.2.1 Defining Channel-attached Printers to MVS

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

11.2.2 Defining Network Printers

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

11.2.3 The PSF Startup Procedures

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

11.2.4 Defining 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.2 Remote-Resident Resources

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

11.3.3 Transferring Print Streams - VSE and OS/390 Coexistence

..... 241

11.3.4 Migrating Print Applications

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

11.4 Understanding Operational Differences

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

11.4.1 Starting and Stopping PSF

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

11.4.2 Command Comparison

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

Contents vii

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

11.5.1 Performance

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

11.5.2 Installation Exits

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

11.5.3 Accounting

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

11.6 References

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

11.6.1 PSF/VSE Publications

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

11.6.2 PSF/MVS Publications

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

11.6.3 Redbooks

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

11.6.4 Other Sources

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

11.6.5 Tools

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

11.6.6 Services

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.1 Migrating Object Code

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

12.2.2 Useful Publications

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

12.3 Converting from DOS/VS COBOL

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

12.3.1 DOS/VS COBOL CICS Programs

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

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

12.4.2 ENVIRONMENT DIVISION

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

12.4.3 DATA DIVISION - FILE DESCRIPTION (FD)

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

12.4.4 PROCEDURE DIVISION - Input/Output

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

12.4.5 File Handling Considerations

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

12.5 Converting from VS COBOL II

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

12.5.1 VS COBOL II CICS Programs

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

12.6 Converting from COBOL for VSE/ESA

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

12.7 Some Conversion Considerations for all VSE COBOL Compilers

.... 259

12.7.1 VSAM

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

12.7.2 DISPLAY Statement

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

12.8 Compiler Options

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

12.8.1 RES/NORES

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

12.9 Reserved Words

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

12.9.1 Reserved Word Considerations for DOS/VS COBOL

......... 263

12.9.2 Reserved 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

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

13.1 Assembler Products

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

13.2 General Assembler Conversion Comments

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

13.2.1 System Interface and Macros

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

13.2.2 Multitasking Macros

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

13.2.3 Interrupt Handling Routines

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

13.2.4 Virtual Storage Macros

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

13.2.5 VSAM Macros

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

13.2.6 Data Management Macros

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

viii VSE to OS/390 Migration Workbook

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

14.1 Migration from VSE to OS/390

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

14.1.1 Device Information

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

14.1.2 Print Files

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

14.1.3 Tape Labels

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

14.1.4 Extent Exit

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

14.1.5 Processing Options

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

14.1.6 File Access Methods

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

14.1.7 Calling COBOL Subprograms

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

14.1.8 Calling 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.2 Extended Precision

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

15.1.3 Multitasking

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.2 Compiler Options

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

15.2.1 Options Specific to the DOS Compiler

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

15.2.2 Options Specific to the MVS Compiler

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

15.2.3 Execution Options

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

15.2.4 The EXEC and PROCESS Cards

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

15.3 Linkages Between Languages

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

15.3.1 Linkages Supported

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

15.3.2 Linkages not Supported

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

15.4 ENVIRONMENT Attributes

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

15.4.1 Not Supported in MVS

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

15.4.2 Supported but to be Avoided

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

15.4.3 The ″TOTAL″ Option

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

15.4.4 The SIS Option (Sequential Insert Strategy)

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

15.5 Calling SORT from PL/I

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

15.5.1 Interfaces Offered

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

15.5.2 Parameters to be Passed

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

15.6 Checkpoint-Restart in PL/I

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

15.6.1 PLICKPT

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

15.6.2 PLIREST

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

15.6.3 PLICANC

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

15.7 DUMP in PL/I Optimizer

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

15.7.1 Output File

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

15.7.2 Options Specific to DOS

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

15.7.3 Options Specific to MVS

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

15.7.4 Compatibility

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

15.8 Return Codes in PL/I

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

15.8.1 Setting Return Codes

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

15.8.2 Return Code Values

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

15.9 Forcing an ABEND

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

15.9.1 Use of DISP in the JCL

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

15.9.2 Automatic Restart

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

15.10 Overlay Structures

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

15.10.1 Conversion

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

15.10.2 Overlay in MVS

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

15.11 Storage Management in PL/I

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

Contents ix

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

15.11.2 Storage Management in MVS

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

15.12 PL/I and CICS

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

15.12.1 File Support

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

15.12.2 Statements not Supported

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

15.12.3 CALLing DUMP

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

15.12.4 Execution Options

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

15.12.5 Compatibility

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

15.12.6 PL/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.1 Introduction

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

17.1.1 General Comments on Language Environment

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

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

Environment

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

17.2 VSE to OS/390 Migration Considerations

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

17.2.1 LE/VSE-conforming Languages

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

17.2.2 Useful Publications

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

17.3 Migrating from LE/VSE-Conforming Languages

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

17.3.1 C for VSE/ESA

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

17.3.2 COBOL for VSE/ESA

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

17.3.3 PL/I for VSE/ESA

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

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

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

17.4.1 Options Mapping

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

17.4.2 C/370

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

17.4.3 VS COBOL II

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

17.4.4 DOS/VS COBOL

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

17.4.5 DOS PL/I

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

17.4.6 VS FORTRAN

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

17.4.7 Migrating Interlanguage Communications Applications

....... 358

17.4.8 Migrating Assembler Applications

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

17.5 Migrating from LE/VSE

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

17.5.1 Run-time Options

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

17.5.2 User Exits and Abnormal Termination Exits

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

17.5.3 Callable Services and Math Services

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

17.5.4 LE/VSE 1.4 Locales

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

17.6 CICS

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

17.6.1 COBOL and CICS

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

17.6.2 Run-time Options

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

17.6.3 User Exits and Abnormal Termination Exits

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

Chapter 18. Procedure Language REXX

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

18.1 REXX and VM/ESA

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

18.2 REXX and VSE/ESA

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

18.3 REXX and TSO/E

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

18.4 Environments

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

18.4.1 VSE/ESA Environment

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

18.4.2 VM/ESA Environment

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

18.4.3 TSO/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.5 Migration Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371

18.5.1 REXX and SAA

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

18.6 REXX Bibliography

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

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

Chapter 19. SORT

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

19.1 JCL Statements

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

19.2 Control Statements

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

19.3 Additional DFSORT/VSE Migration Considerations

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

19.3.1 Control Statements

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

19.3.2 ICETOOL

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.1 VSAM Backup/Restore

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

21.1.1 OS/390 VSAM Backup/Restore

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

21.1.2 VSE/VSAM Backup/Restore

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

Chapter 22. Librarian

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

22.1 Overall Library Support

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

22.1.1 OS/390 ISPF Overview

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

22.1.2 OS/390 Library Management

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

Chapter 23. LISTLOG/PRINTLOG - Printing Log Streams

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

23.1 VSE PRINTLOG Utility

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

23.2 VSE LISTLOG Utility Program

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

23.3 OS/390 Hardcopy Processing

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

23.3.1 SYSLOG

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

23.3.2 Printing SYSLOG

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

23.4 OPERLOG

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

23.4.1 Printing OPERLOG

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

23.5 JES2 System Data Sets - Job Log and System Messages

........ 395

23.6 Systems Management Recording

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

23.6.1 Printing 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.1 Processor Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 402

25.2.2 Devices Supported by OS/390

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

25.2.3 DASD Requirements

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

25.2.4 Other Hardware Requirements

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

25.2.5 Inter-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.2 MVS BCP Customization

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

25.5.3 Other 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.3 VM, LPAR, or Standalone Systems

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

26.3.1 Logical Partitioning

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

26.3.2 Software Partitioning

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

26.3.3 Our Recommendation

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

26.3.4 Summary

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

26.4 Parallel 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.1 TSO/ISPF and SDSF

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

27.1.1 Editing Data Sets

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

27.1.2 Submitting Jobs

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

27.1.3 Using ISPF Utilities

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

27.1.4 Creating and Executing ISPF Applications

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

27.1.5 Managing Projects

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

27.1.6 Tracking Jobs

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

27.1.7 Retrieving Output

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

27.1.8 Using SDSF for Operators

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

Chapter 28. Orientation to OS/390 Console Operation

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

28.1 Introduction

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

28.1.1 Operating Hardware Consoles

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

28.2 Understanding the Operator Interfaces

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

28.2.1 Controlling Consoles

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

xii VSE to OS/390 Migration Workbook

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

28.2.3 Extended MCS Consoles

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

28.2.4 Understanding Message Formats and Replies

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

28.3 Controlling the OS/390 System

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

28.3.1 Starting the System

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

28.3.2 Displaying System Status

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

28.3.3 Stopping the System

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

28.4 Controlling Devices

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

28.4.1 Displaying the Status of Devices

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

28.4.2 Understanding Device Allocation

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

28.4.3 JES2 Devices

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

28.4.4 SDSF Device Panels

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

28.5 Controlling TSO Users, Jobs and Started Tasks

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

28.5.1 Displaying Work on Your System

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

28.5.2 Controlling Time Sharing Users

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

28.5.3 Controlling Batch Jobs

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

28.5.4 Controlling Started Tasks

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

28.6 Managing Remote Operations

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

28.6.1 JES2 RJE Operations

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

28.6.2 NJE Operations

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

Chapter 29. Orientation for Utilities

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

29.1 IEBxxx or IEHxxx

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

29.2 IEBCOPY

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

29.3 IDCAMS

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

29.4 IEBGENER

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

29.5 DFSMSdss

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

Chapter 30. Systems Management Philosophy and Methodology

....... 457

30.1 The Philosophy of Systems Management

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

30.1.1 Systems Management Overview

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

30.1.2 Systems Management Scope - What Needs to be Managed?

... 459

30.1.3 The Role of Automation

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

30.2 Change Management

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

30.2.1 Overview

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

30.2.2 Tasks

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

30.2.3 Methodology

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

30.3 Problem Management

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

30.3.1 Overview

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

30.3.2 Tasks

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

30.3.3 Methodology

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

30.4 Performance Management

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

30.4.1 Overview

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

30.4.2 Tasks

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

30.4.3 Methodology

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

30.5 Operations Management

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

30.5.1 Overview

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

30.5.2 Tasks

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

30.5.3 Methodology

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

30.6 Security Management

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

30.6.1 Overview

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

30.6.2 Tasks

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

30.6.3 Methodology

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

30.7 Configuration Management

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

30.7.1 Overview

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

Contents xiii

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

30.7.3 Methodology

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

30.8 Asset Management

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

30.8.1 Overview

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

30.8.2 Tasks

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

30.8.3 Methodology

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

30.9 Accounting Management

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

30.9.1 Overview

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

30.9.2 Tasks

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

30.9.3 Methodology

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

30.10 Summary

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

Chapter 31. Diagnosing System Problems

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

31.1 Problem Determination Tools

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

31.2 Dumps

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

31.3 IPCS

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

31.3.1 Analyzing Dumps

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

31.3.2 Traces

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

31.3.3 Analyzing Traces

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

31.3.4 Using IPCS

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

31.4 JES2 Diagnosis

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

31.5 SLIP

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

31.6 Performance Tools

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

31.7 LOGREC

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

31.8 SYSLOG

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

31.9 DFSMS/MVS Diagnosis

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

31.9.1 DFSMSdfp

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

31.9.2 DFSMShsm

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

31.9.3 DFSMSrmm

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

31.9.4 DFSMSdss

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

31.10 Diagnostic Reference Publications

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

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

Chapter 32. Conversion Process

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

32.1 Conversion Process Introduction

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

32.1.1 References

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

32.1.2 Prerequisites

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

32.1.3 Recommendations

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

32.1.4 Assumptions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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.3 Mass Conversion Tools

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

32.2.4 Automated Conversion Process

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

32.2.5 CORTEX MS

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

32.3 Mass Conversion Phase Overview

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

32.4 Preparation 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.5 Conversion Phases

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

xiv VSE to OS/390 Migration Workbook

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

32.5.2 JCL Conversion

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

32.5.3 Phase 4: Initial Trial Conversion

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

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

Conversions

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

32.5.5 Initialization Testing

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

32.5.6 Unit Testing

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

32.5.7 System 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.1 Conversion Services

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

33.1.1 IBM Global Services

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

33.1.2 Automated Migration Services (AMS)

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

33.2 Conversion Tools

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

33.2.1 VSE/ESA Facilities

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

33.2.2 IBM 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.5 Computer Associates

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

33.2.6 The Source Recovery Company

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

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

Chapter 34. Customer Migration Example

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

34.1 Background

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

34.2 Environment

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

34.3 Inventory

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

34.4 Resources

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

34.5 Duration

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

34.6 Performance

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

34.7 Benefits

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

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

E.1 International Technical Support Organization Publications

........ 557

E.1.1 OS/390 and MVS Redbooks

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

E.1.2 Other Redbooks

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

E.2 OS/390 Product Publications

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

E.2.1 Planning Books

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

E.2.2 OS/390 Online Product Library

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

E.3 Other Publications

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

E.4 Other Sources

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

E.4.1 Books on the Internet

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

E.5 Redbooks on CD-ROMs

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

How to Get ITSO Redbooks

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

How IBM Employees Can Get ITSO Redbooks

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

How Customers Can Get ITSO Redbooks

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

IBM Redbook Order Form

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

Page is loading ...

IBM OS/390, Time Clock OS/390 User manual

Related papers

Other documents