IBM OS/390 P

OS/390 documentation resources

introduction references 39

key documents & other references 40

Web URL 40

OS/390 hardcopy processing 393

OS/390 software - order and install

entitled methods of installing OS/390

CBPDO 407

ServerPac 406

fee-based installation methods 405

installing OS/390 fee-based 405

other offerings 406

SoftwareXcel Installation Express (SIE) 405

SoftwareXcel SystemPac/MVS 406

OS/VS COBOL 131

other

components - tailoring 416

differences 243

differences POWER-JES2 209

hardware requirements 403

monitors 450

MVS names 409

offerings 406

OS/390 elements 416

sources 244

spool interfaces 222

utilities 244

our recommendation 424

OUTDES macro 241

output

device type 548

disposition 217

file 343

retrieval 222, 441

segmentation 75, 216

service 215

OUTPUT JCL statement 84

outside consultants 30

overlapped activities 430

overlay in MVS 345

overlay structures 345

overriding JCL 76

overview

accounting management 471

change management 460

CICS transaction server 133

problem management 461

programming elements 327

systems management 457

P

PAGEIN macro 290

parallel activities 430

overlapped activities 430

parallel activities 430

synchronizing VSE with OS/390 applications 430

Parallel Sysplex 427

parameter

handling 75

mapping POWER - JES2 225

passing 335

to be passed 340

partition dependent codes in JCL 81

partition independent file names 124

partition standard labels 78

partitioning 422

passing parameters into main program 335

patching facility JES2 231

PAUSE statement 77

PCB after GE status 172

PDUMP macro 279

performance 243

performance customer migration 531

performance management 463

methodology 464

overview 463

tasks 463

performance tools 475

permanent assignments 79

PFIX & PFREE macros 290

PFKeys 445

philosophy of OS/390 job control 70

philosophy of systems management 457

philosophy of VSE/ESA JCL 70

physical IOCS element comparison 328

pilot conversion 52, 487

PIOCS 327

PL/I

called by RPG II 331

calling SORT 340

checkpoint-restart 342

CICS & PL/I 346

CICS/VS transaction ABEND codes 346

COBOL vs. PL/I 351

DOS PL/I 356

functional differences

%INCLUDE 335

dynamic loading of dependent programs 334

EGCS (VSE) to DBCS (OS Version 2)

comments 333

extended precision 334

file organization 334

multitasking 334

parameters passed to a main program 335

interfaces 340

Optimizer DUMP 343

PL/I for VSE/ESA 354

PLICANC 343

PLICKPT 342

PLIREST 342

program conversion 345

programming interfaces 242

return codes 344

return from CICS transaction backout 347

return from ON-units 347

610 VSE to OS/390 Migration Workbook

Contents

Main IBML VSE to OS/390 Migration Workbook Page Page First Edition (October 1998) Contents Part 1. Planning the Migration - An Introduction Part 2. Converting the VSE Operating System to the OS/390 Operating System iv Page vi Page Part 3. Converting VSE Languages to OS/390 Languages viii Page x Part 4. Converting VSE Utilities to OS/390 Utilities Part 5. Setting Up the Migration Environment Part 6. Running Your OS/390 System xii Page Part 7. Converting your Applications xiv Part 8. Migration Experience Part 9. Appendixes xvi Figures xviii Tables Page Preface The Team That Wrote This Redbook Redbook Builders and Key Contributors Authors and Significant Contributors Comments Welcome xxii redbook@us.ibm.com Page Page Chapter 1. Why Customers Migrate 1.1 A Synopsis of This Book 1.2 Traditional Reasons for Migrating 1.2.1 Business Consolidation 4 1.2.2 Mergers/Acquisitions 1.2.3 Capacity Constraints 1.2.3.1 Virtual Storage Page Page Page 1.2.3.2 N-way Processor Support 1.2.3.3 TaskQuantity 1.2.4 Image 1.3 Functional Reasons for Migrating to OS/390 1.3.1 Applications Availability 10 1.3.2 Systems Management 1.3.3 Connectivity 1.3.4 Systems Availability 1.3.5 Staff Availability 12 Chapter 2. Sizing the Effort 2.1 Introduction to Sizing Conversion Migration 2.1.1 Defining the Migration Project Objectives 2.1.2 Areas of VSE and OS/390 Differences 2.1.2.1 SourcePrograms 14 Source Program Inventory Batch and Online Program Conversion 2.1.2.2 Job Control Language 2.1.2.3 Files 2.1.2.4 Operations 2.1.3 Comparison of Basic VSE Functions & Components to OS/390 16 Table 1 (Page 2 of 3). Comparison of VSEFunctions & Components to OS/390 Replacements 2.2 OS/390 Components/Products/Subsystems 18 2.2.1 The OS/390 Operating Environment 2.2.1.1 OS/390 Product Content Base Elements System Services Systems Management 20 Systems Management Services Application Enablement Services OS/390 Introduction and Release Guide Distributed Computing Services 2.2.1.2 MVS Subsystem and Component Terminology Job Entry Subsystem/2 (JES2) Job Entry Subsystem/3 (JES3) 22 System Modification Program Extended (SMP/E) 2.2.1.3 Supporting Products Data Facility Data Set Services (DFDSS) Data Facility Hierarchical Storage Manager (DFHSM) Data Facility Sort (DFSORT) MVS/Data Interfile Transfer, Testing, and Operations Utility (DITTO) 2.2.2 Subsystem Level Comparison/Affinity 2.3 What Changes Between VSE and OS/390? 24 2.3.1 Philosophical Changes 2.3.1.1 Security 2.3.1.2 Automation 2.3.1.3 Console Operator Interface 2.3.1.4 JCL Processing 2.3.1.5 Management Disciplines 2.4 Who is Affected by This Migration? 2.4.1 Job Roles and Normal Activities 26 2.5 Approaches to Migration 2.5.1 Disclaimer 2.5.2 OS/390 Conversion and Production Implementation Strategies 2.5.2.1 Kernel/Progressive Approach 2.5.2.2 Single Switchover - Mass Application Migration Approach 28 2.5.3 VM/ESA Guest Support in Your VSE to OS/390 Migration VM/ESA V2R2.0 General Information VM/ESA V2R1.0 Running Guest Operations 2.5.4 Staffing Strategies 2.5.4.1 In-House Staff 2.5.5 Conversion Tools 30 2.6 Educational Requirements 2.6.1 Introduction 2.6.1.1 System Programming 2.6.1.2 Application Programming 2.6.1.3 Operations 2.7 Scope of Work and Challenges 2.7.1 Application Inventory 32 2.7.2 Program Conversion 2.7.3 JCL Conversion 34 2.7.4 File Migration In-place 36 2.7.5 Project Management 2.7.6 Automated Operations 2.8 Cost Considerations 38 2.9 OS/390 Documentation Resources 2.9.1 Introduction References Page Chapter 3. Developing the Plan 3.1 Overview 3.1.1 References MVS Migration System - Planning Chart MVS Migration System - General Information 3.1.2 Recommendations 3.1.2.2 Take Advantage Of Conversion Tools and Automation 3.1.2.3 Migration Plan - Guide and Outline 42 MVS MS Planning Guide MVS-MS Planning 3.1.2.6 Project Staffing 3.1.2.7 Librarian 3.1.2.8 Migration Responsibilities 3.1.2.9 Migration Assignments 44 3.2 Plan Components 3.2.1 Approach 3.2.2 Team 3.2.2.1 Project Manager 3.2.2.2 Systems Programmers 46 3.2.2.3 Applications Programmers 3.2.2.4 Operations 3.2.3 Tasks 3.2.4 Milestone Events 3.2.5 Education 3.3 Progressive versus Mass Conversion 3.3.1 Approach Differences 3.3.2 Historical Perspective 3.3.3 Shared Application Files and Databases 50 3.3.4 Shared Application Code 3.3.5 Operations Support Staffing 3.3.7 Standardized Conversion Deliverables and Automation 3.3.8 Risk Management 3.3.9 Complexity of Implementation 3.3.9.1 Mass Migration as a Conversion Method 3.3.9.2 Mass Migration Used as a Conversion Tool 52 3.4 Plan Examples 3.4.1 Project Schedule 3.4.1.1 Estimated Project Schedule 54 Table 3. Nine Month Project 3.4.1.2 Estimated Schedule for CNV Responsibilities 3.4.1.3 Estimated Schedule for ABC Responsibilities The following is an estimated schedule for the ABC responsibilities. The actual Table 5. ABC Responsibilities 3.4.1.4 Estimated Schedule for SER Responsibilities The following is an estimated schedule for the SER responsibilities. The actual 3.4.2 Project Plan Example 3.4.2.1 Project Plan - Summary 56 Page 3.4.2.2 Project Plan - Details 58 Page 60 Page 62 Page 64 Page Page Page Page Chapter 4. Job Control Language (JCL) Differences and Considerations 4.1 The Philosophy of JCL in System/390 4.1.1 VSE/ESAs Job Control Language Philosophy Job Stream 70 Job Step Job Page 4.2 High Level Similarities 4.2.1 JCL Statement and Job Layout 72 4.2.1.1 Continuation Cards 4.2.1.2 JOB Statement Starts a Job 4.2.2 Spooling 4.2.2.1 Internal Reader 4.3 JCL Differences Between VSE and MVS 4.3.1 Job Input 4.3.1.1 Multiple Instream Data Set Input 4.3.1.2 Data Driven Segmentation of Output 4.3.1.3 JCL Parameter Handling 4.3.2 JCL Expansion 4.3.2.1 Early Error Detection 76 4.3.2.2 Overrides 4.3.3 Operator Flexibility and Intervention 4.3.3.3 Comment Lines in the JCL 4.3.3.4 PAUSE Statement 4.3.4 Allocation of Resources 4.3.4.1 Resource Allocation at Open Time 78 4.3.5 Hidden JCL 4.3.5.1 Partition and System Standard Labels 4.3.5.2 Permanent Assignments and POWER Defaults 4.3.5.3 Carry-Over 4.3.5.4 Help for the Hidden JCL Problem http://www.software.ibm.com/ad/va2000 http://www.software.ibm.com/ad/cobol VSE/ESA Enhancements Version 2 Release 3 4.3.6 Device Address Specifications // ASSGN SYS010,FEF //SYS010 DD SYSOUT=... or//REPORT1 DD SYSOUT=... 4.3.7 Catalogs 4.3.8 Partition Dependent Codes in JCL 4.3.8.1 Procedures 4.3.8.2 Data Set Names 4.3.9 Communication Region - DATE and UPSI 4.3.10 VSE Job Control Statements 82 4.3.10.1 Job Statement 4.3.10.2 EXEC Statement 4.3.10.3 TLBL Statement 4.3.10.4 MTC Statement file-id 4.3.10.5 ASSGN Statement 4.3.10.6 RESET Statement 4.3.10.7 DLBL and EXTENT 4.3.11 MVS Job Control Statements 84 4.3.11.1 DD Statement 4.3.11.2 OUTPUT JCL Statement 4.3.11.3 MVS Conditional JCL Page 4.3.12 Comparison of VSE and MVS JCL - A Summary Below is a summary of VSE JCL statements and possible equivalents in MVS. 86 Table 7 (Page 1 of 2). VSE Job Control Statements Summary Table 7 (Page 2 of 2). VSE Job Control Statements Summary 4.3.13 Summary of MVS JCL Statements Table 8. MVS Job Control Statements 88 4.4 JECL 4.4.1.1 LIST Card - * $$ LST 4.4.1.2 Data Statement - * $$ DATA 4.4.2 Comparison of POWER and JES2 JECL - A Summary Table 9 (Page 2 of 2). Overview of POWER JECL Statements 4.4.3 Summary of JES2 JECL - A Table Table 10 (Page 1 of 2). JES2 Control Statements 90 4.5 VSE and MVS JCL Comparison Example 4.5.1 Sample VSE JCL 4.5.2 Sample MVS JCL 4.5.3 Sample VSE plus Carry-Over Page Page 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 98 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 100 5.3.3 System Managed Storage DFSMS/MVS General Information Implementing System-Managed Storage DFSMS/MVS General Information Implementing System-Managed Storage DFSMS/MVS Planning for Installation 5.3.4 Implementing DFSMS 102 Get DFSMS FIT: Fast Implementation Techniques DFSMS FIT: Fast Implementation Techniques Process Guide NaviQuest User 5.4 Tape Similarities and Differences 5.4.1 Volume Interchangeability 5.4.2 Standard Labels 104 5.4.2.1 Standard User Labels 5.4.3 No Labels do 5.4.4 Nonstandard Labels 5.4.5 Bypass Label Processing Facility in OS/390 106 Using Magnetic Tapes 5.5 DASD Similarities and Differences 5.5.1 Volume Interchangeability 5.5.2 DASD (VTOC) Processing 108 VSE/AF Data Management Concepts The Format-5 DSCB 5.5.3 Indexed VTOC Considerations (OS/390) DFSMSdfp Advanced Services DFSMSdfp Advanced 5.6 VSAM Differences 5.6.1 Introduction 5.6.2 OS/390 Catalogs 110 5.6.2.1 Integrated Catalog Facility (ICF) 5.6.2.2 VSAM Catalogs 112 Page Managing Catalogs 5.6.3 OS/390 Catalog Management OS/390 MVS System Data Set Definitions 114 5.6.3.1 OS/390 Master Catalog 5.6.3.2 OS/390 User Catalogs Page 5.6.4 OS/390 - VSE/VSAM Catalog Compatibility Only VSAM user catalogs may be ported between environments 5.6.4.1 Accessing a VSE/VSAM Catalog from an OS/390 System 5.6.4.2 Converting VSE/VSAM Catalogs to OS/390 ICF Catalogs 118 5.6.4.3 Moving a VSAM Catalog to a Different DASD Type must 5.6.5 VSAM Functional Differences 5.6.5.1 Areas of Consideration 5.6.5.2 FBA DASD 5.6.5.3 Catalog Structures 120 s Reference VSE/VSAM Programmer 5.6.5.4 AMS Commands VSAM CISIZEs and Record Sizes 122 invalid VSE/VSAM-managed SAM Files Default Models NOALLOCATION Data Sets JCL Implicit DEFINE Reusable Data Sets Partition Independent File Names 124 dependent VSE/VSAM BACKUP/RESTORE and VSE FASTCOPY IKQVDU - Volume Cleanup 5.6.6 Data Sharing and Integrity 5.6.6.1 Cross-Region Sharing - Single CPU Environment 126 OS/390 VSAM Cross-Region SHR(4) 5.6.6.2 Single Region Data Set Sharing Single ACB Open - Multiple String Processing 128 if Intra-Region Data Set Name Sharing 5.6.6.3 Cross-System and DASD Sharing DFSMSdfp Storage Administration Reference Using Data Sets SHAREOPTIONS (X 4) SHAREOPTIONS (X 3) 5.6.6.4 DASD Sharing Considerations Alternatives to VSAM Data Set Sharing 130 5.6.7 Programming Languages and VSAM Support 5.6.7.1 COBOL for OS/390 & VM DFSMS/MVS DFSMSdfp Diagnosis Reference 5.6.7.2 OS/VS COBOL 5.6.7.3 RPG II 132 Chapter 6. CICS 6.1 Introduction 6.1.1 Overview CICS Transaction Server 6.1.2 Essential Supplemental Reading and Migration Support Material Release Guide for CICS Transaction Server 134 Transaction Server Migration Guide CICS Transaction Server Migration Guide 6.1.3 General Compatibility Comments 6.1.4 Virtual Storage Considerations for MVS 6.1.5 CICS General System Considerations CICS ONC RPC Guide CICS Internet and External Interface 138 Page 6.1.6 CICS Macro Resource Definition Table Changes CICS Macro Definition 140 CICS System Definition Guide Page 142 6.1.7 CSD and RDO Considerations CICS Resource Definition Guide 6.1.7.1 CSD 6.1.7.2 RDO CICS Supplied Transaction 144 6.1.8 CICS System Data Sets Requirements CICS Installation Guide CICS System Definition Guide Page 6.1.9 CICS System Program Interface and Exits 6.1.9.1 System Programming Commands CICS Customization Guide CICS Application Programming Guide System Programming Reference 148 CICS Customization Customization Guide CICS Customization 6.1.10 CICS Transaction Security UACC(READ) CICS/VSE Security Migration Aid 6.1.11 CICS UPSI 6.1.12 Application Programming 150 CICS Application CICS/ESA Distributed Transaction Programming Guide 152 SAA AD/Cycle COBOL/370 (5688-197) SAA AD/Cycle C/370 (5688-216) SAA AD/Cycle PL/I (5688-235). CICS/VSE Application Migration Aid Guide V2 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 Chapter 7. ICCF and TSO 7.1 Preparing to Use the System 7.1.1 User Profiles OS/390 Security Server (RACF) Security Administrator TSO/E Customization 156 7.1.2 LOGON Procedures 7.1.3 Message Facilities 7.1.4 Security 7.1.5 Summary TSO/E Customization 158 RACF General Information 7.2 Using the System 7.2.1 Accessing the System TSO/E Primer 7.2.2 Entering and Manipulating Data EDIT PAYROLL(PRTCHK) NEW COBOL TSO Extensions Command Reference 160 ISPF Getting Started 7.3 Executing Programs at a Terminal 7.4 Submitting Jobs for Batch Execution 162 7.4.1 Using Command Procedures TSO/E CLISTs 7.5 Migrating from VSE/ICCF to MVS and TSO/E 7.5.1 Converting ICCF Libraries Page Page Page MVS/Extended Architecture Data Administration: Utilities 7.5.2 ICCF Procedures and Macros Page Chapter 8. Databases 8.1 DL/I and IMS/VS DB Differences 8.1.1 Introduction 8.1.2 MVS System Requirements 8.1.3 Data Base Descriptor (DBD) 170 HDAM DB Primary Index of HIDAM DB 8.1.4 Program Specification Block (PSB) 8.1.5 Batch Programming 8.1.5.1 RPG II 8.1.5.2 Interactive Macro Facility (IMF) 8.1.5.3 Command-Level Coding (HLPI) 8.1.5.4 Statement Compatibility IMS/ESA Installation Volume 2: System Definition and Tailoring 172 8.1.5.5 Field Level Sensitivity 8.1.5.6 PCB after GE Status 8.1.6 Utilities IMS/ESA Utilities Reference: Database Manager 8.1.6.1 Rewind Option for Reorganization Utilities 8.1.6.2 Checkpoint Option with HD Reorganization Unload Utility 8.1.6.3 Secondary Index Creation 8.1.7.2 Backout Utility/Disk Logging 8.1.7.3 UPSI 8.1.7.4 DL/I Parameter Statement 8.1.8 Database Portability 8.1.8.1 Alternate DL/I and IMS/ESA Access 7. 6. 5. 8.1.8.2 Unloading and Reloading the Database DL/I Data Base Administration Guide 176 Page 8.1.9 DL/I Multiple Partition Support 8.1.10 Additional Information 178 IBM SQL Reference Interoperability between VSE DL/I and OS/390 IMS DBCTL 8.2.1.2 Application Developers ISQL SPUFI 8.2.1.3 Database Administrators (DBAs) 8.2.1.4 System Administrators 180 8.2.1.5 Security Administrators 8.2.2 Other Comparison Areas 8.2.2.1 Year 2000 8.2.2.2 DRDA Considerations 8.2.2.3 Data Replication and Data Access 182 8.2.3 Summary of Migration Task Page Page Chapter 9. Telecommunications Subsystems 9.1 ACF/VTAM eNetwork Communications Server for OS/390 Customization eNetwork Communications Server for OS/390 Programming eNetwork Communications Server for OS/390 Resource Definition Samples 9.1.1 Product Installation VTAM Installation and Migration Guide 186 data definition data set 9.1.2 Resource Definition and Operation 188 Page 9.1.2.1 Resource Definition 9.1.2.2 Operation 190 Tuning VTAM for Your Environment 9.1.3 Customization and Programming Network Implementation Guide 9.1.3.1 VTAM Tables VSE/ESA Networking Support 9.1.3.2 Programming 9.1.4 Network Configuration 9.2 ACF/NCP 9.2.1 Product Installation 192 9.2.2 Program Generation NCP, SSP, and EP Generation and Loading Guide 9.2.3 Backlevel Hardware Support 9.3 BTAM 9.3.1 Product Installation the BTAM/SP BTAM-ES Programming Reference 9.4.1 Network Definitions 194 9.4.2 TCP/IP Configuration 9.4.2.1 TCP/IP Customization 9.4.2.2 TCP/IP Standard Applications 9.4.3 TCP/IP Related User Data 9.4.4 TCP/IP Batch Jobs 9.4.6 Security 9.4.7 Bibliography TCP/IP for VSE/ESA User The Native TCP/IP Solution for VSE VSE/ESA as a Web Server Writing Interlanguage Communication Applications 9.5.1 MQSeries in Your Operating System Environment 9.5.1.1 Prerequisites 198 200 http://ncc.hursley.ibm.com/javainfo/download/index.html 9.5.1.2 Installation and Customization MQSeries for MVS/ESA System Management Guide MQSeries for MVS/ESA System Management 9.5.1.3 CICS Considerations 9.5.1.4 Data Sets 202 9.5.2 Networking Definitions 9.5.3 Defining MQSeries Object and Operating 4. 204 5. MQSeries Command Reference 6. MQSeries Distributed Queuing Guide 9.5.4 MQSeries-based Applications MQSeries Application Programming Reference 9.5.5 Bibliography 206 Chapter 10. POWER and JES2 10.1 JES2 Introduction 10.1.1 Major Differences 10.1.1.1 KEEP Disposition for Pre-Execution Jobs 10.1.1.2 Time Event Scheduling for Jobs 10.1.1.3 Tape Spooling 208 10.1.1.4 Printer Forms Alignment via PSETUP 10.1.1.5 Separator Page Difference 10.2 Implementing JES2 10.2.1 Setting Up the Required Resources 10.2.1.1 JES2 Checkpoint 10.2.1.2 JES2 Spool Volumes 10.2.2 Starting JES2 OS/390 JES2 Initialization and Tuning Guide 10.2.2.1 The JES2 Procedure JES2 Job Related Exits JES2 Exits 10.2.3 Tailoring JES2 10.2.3.1 JES2 Initialization Parameters 10.2.3.2 JES2 Operator Commands 10.2.3.3 JES2 Installation Exits 10.3 JES2-POWER Functional Comparison 10.3.2 Input Service 10.3.3 Job Scheduling 10.3.3.1 Job Stream Disposition OS/390 Solution 10.3.3.2 Serializing Job Execution 10.3.3.3 Time Event Scheduling 214 automatic command scheduling 10.3.3.4 Additional Job Scheduling Functions with MVS/JES2 10.3.4 Output Service Table 13 (Page 1 of 2). POWER/JES2 Output Service Comparison 10.3.4.1 Printers Supported 10.3.4.2 Output Segmentation 216 10.3.4.3 Tape Spooling 10.3.4.4 Printer Forms Alignment via PSETUP 10.3.4.5 Separator Page Differences 10.3.4.6 End-of-page Sensing 10.3.4.7 Output Disposition 10.3.4.8 FCB Naming Differences 10.3.5 Interactive User Interfaces (ICCF/CMS/TSO) 10.3.6 Remote Job Entry 10.3.6.1 Functional RJE Differences 10.3.6.2 Remote Workstation Definitions 10.3.6.3 RJE Operations 10.3.6.4 RJE Exits 10.3.7 Network Job Entry NJE Installation, Operation and Use with JES2 and Other Systems 10.3.7.1 NJE Definitions NJE Installation, Operation and Use with JES2 and Other Systems 10.3.7.2 NJE Operations 10.3.8 Application Interfaces 10.3.8.1 Spool Space Allocation 10.3.8.2 Programmable Spool Interfaces 222 Using the Subsystem Interface MVS Auth Assembler Services Guide 10.3.9 Accounting Comparisons 10.3.9.1 Job Accounting JES2 SMF Accounting Records System Management Facilities NJE Accounting 10.3.10 RAS Characteristics 224 10.3.11 JES2 Testing Techniques 10.3.11.1 Poly-JES JES2 Init & Tuning Reference 10.4 POWER/JES2 Detailed Comparisons 10.4.1 Mapping POWER Parameters to JES2 Init Parms 226 Table 17 (Page 2 of 2). POWER Macro to JES2 Parameter Mapping 10.4.1.2 PLINE Mapping to JES2 LINE Parameters for RJE and NJE SNA lines are defined by specifying UNIT=SNA. BSC EP or CTC lines have several options: Table 18. PLINE MACRO to JES2 Parameter Mapping 10.4.1.3 Define BSC Remotes This table shows the conversion of POWER PRMT parameters to JES2 RMT remotes. 228 Table 19 (Page 1 of 2). PRMT MACRO to JES2 Parameter Mapping Table 19 (Page 2 of 2). PRMT MACRO to JES2 Parameter Mapping 10.4.1.4 Define SNA Remote Workstations This table shows the conversion of POWER PRMT parameters to JES2 RMT remotes. Table 20. PRMT MACRO to JES2 Parameter Mapping 10.4.1.5 Define NJE Nodes This table shows the conversion of POWER PNODE parameters to JES2 parameters. 10.4.2 Exit Comparisons 10.4.2.1 Source Code Modifications 10.4.2.2 The JES2 Patching Facility OS/390 JES2 Commands 10.4.3 POWER-JES2 Command Equivalences VSE/POWER Administration and Operation 10.4.3.1 Queue Management Commands Table 24. Queue Management Commands 232 10.4.3.2 Task Management Commands Table 25. Task Management Commands 10.4.3.3 Control Commands Table 26. Control Commands 10.4.3.4 NJE Operator Commands This section is a summary of NJE operator commands. Network Management 234 Sending Commands and Messages 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 AFP: Printer Information 11.1.1.1 Printers Supported 11.2 Installing and Configuring PSF/MVS 236 PSF/MVS Systems Programmers Guide 11.2.1 Defining Channel-attached Printers to MVS PSF/MVS Systems Programmers Guide 11.2.3 The PSF Startup Procedures 11.2.4 Defining Printers for PSF Printing 11.2.5 FSS Procedure and PRINTDEV Statements 11.2.5.1 Comparison of PRINTDEV Statement Parameters Table 30. PRINTDEV Parameter Comparison 11.3 Setting up AFP Resources 11.3.1 Migrating Resources from VSE to OS/390 240 11.3.1.1 DefiningResources AFP Application Programming Interface: Programming Guide and Reference 11.3.3 Transferring Print Streams - VSE and OS/390 Coexistence 11.3.4 Migrating Print Applications PSF/MVS: Application 11.3.4.1 JCL and JECL Differences 11.3.4.2 Printing from TSO 11.4 Understanding Operational Differences 11.4.1 Starting and Stopping PSF 11.4.2 Command Comparison Table 31 (Page 2 of 2). VSE - OS/390 Command Comparison [ 11.5 Other Differences 11.5.1 Performance See Chapter 17 Using Installation Exits in the 11.5.2 Installation Exits supplied by PSF PSF/MVS Systems Programmers 11.5.3 Accounting 11.6 References 11.6.1 PSF/VSE Publications 244 11.6.2 PSF/MVS Publications 11.6.3 Redbooks 11.6.6 Services http://www.printers.ibm.com/asg.html/ Page Page Page Chapter 12. COBOL 12.1 Introduction COBOL for VSE/ESA VS COBOL II DOS/VS COBOL 12.1.2 Comparison of IBM COBOL Compilers 12.2 VSE to OS/390 Migration Considerations 250 12.2.1 Migrating Object Code COBOL for VSE/ESA Programming Guide Taking Advantage of IBM Language Environment for VSE/ESA 12.2.2 Useful Publications 12.3 Converting from DOS/VS COBOL 12.3.1 DOS/VS COBOL CICS Programs 252 12.3.2 DOS/VS COBOL Programs Containing REPORT WRITER Statements 12.4 DOS/VS COBOL and COBOL for OS/390 and VM Language Differences 12.4.1 Common COBOL Coding Problems COBOL for OS/390 and VM Compiler and Run-Time Migration Guide 05 PRIMARY-FIELD PIC XX. 88 FIELD1 VALUES ARE 60 61 62. 88 FIELD2 VALUES ARE 50 51 52. Page 12.4.2 ENVIRONMENT DIVISION 12.4.2.1 CONFIGURATION SECTION - SPECIAL-NAMES Paragraph 12.4.2.2 INPUT-OUTPUT SECTION - I-O-CONTROL 12.4.3 DATA DIVISION - FILE DESCRIPTION (FD) 12.4.4 PROCEDURE DIVISION - Input/Output 12.4.4.1 Program Termination 12.4.5 File Handling Considerations 12.4.5.1 File Status Codes COBOL for OS/390 and VM Compiler and Run-Time Migration Guide 12.4.5.2 File Attribute Mismatches 12.4.5.3 ISAM 12.5 Converting from VS COBOL II 12.5.1 VS 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 260 12.8.1.1 DOS/VS COBOL Compiler Options not Available with COBOL for OS/390 and VM 12.8.1.2 Compiler Option Considerations for VS COBOL II COBOL for OS/390 and VM Programming Guide Figure 20. Recommended COBOL for OS/390 and VM Compiler Options for Converted VS COBOL II Programs 262 COBOL for OS/390 and VM Programming Guide 12.9 Reserved Words 12.9.1 Reserved Word Considerations for DOS/VS COBOL Page 12.9.2 Reserved Word Considerations for VS COBOL II and COBOL for VSE/ESA 12.10 Compiling and Running Your Converted COBOL Programs Page Chapter 13. Assembler 13.1 Assembler Products A Guide to Using MVS/XA Interface Facilities OS/390 MVS Extended Addressability Guide High-Level Assembler for MVS and VM General Information 13.2.1 System Interface and Macros 268 13.2.1.1 Initiation 13.2.1.2 Termination Register Conventions Page Page Page Page 13.2.1.3 CommunicationRegion Job Name User Program Communication Bytes UPSI (User Program Switch Indicators) Problem Program Area Addresses 13.2.1.4 Communications Region Simulation 276 COMRG and MVCOM Macros LOAD Macro (VSE) LOAD PROGB LOAD the phase LR 15,1 pass address CALL (15),parm1,parm2 invoke PROGB Page Page Page Page Page 13.2.2 Multitasking Macros 13.2.2.1 ATTACH/DETACH Macros ENTRYPOINT 284 13.2.2.2 WAIT/POST Macros 13.2.2.3 RCB/ENQ/DEQ Macros 13.2.3 Interrupt Handling Routines 13.2.3.1 Interval Timer Interrupts 13.2.3.2 Operator Communication Interrupts 13.2.4 Virtual Storage Macros 13.2.4.1 GETVIS and FREEVIS Macros 13.2.4.2 RELPAG Macro 13.2.4.3 PFIX and PFREE Macros 13.2.4.4 SETPFA Macro 13.2.5 VSAM Macros 13.2.5.1 ACB Macro ICI VSAM Administration LSR 13.2.5.2 EXLST Macro and EXCPAD Routines 13.2.5.3 RPL Macro (Additional MVS Parameters) ASY WAITX DFSMS/MVS Macro Instructions For Data Sets 13.2.6 Data Management Macros 13.2.6.1 List and Execute Macro Forms 13.2.6.2 Definition of BLKSIZE 13.2.6.3 IOREG 13.2.6.4 I/O Error Checking 13.2.6.5 LIOCS Card File Definition 294 Page 13.2.6.6 LIOCS Printer File Definition 13.2.6.7 LIOCS Tape File Definition CLOSE Macro 298 Page VSE 300 MVS POINTS Macro RELSE Macro TRUNC Macro FEOV Macro GET / PUT Macros Page 13.2.6.8 LIOCS Device-independent File Definition 13.2.6.9 LIOCS Console File Definition 13.2.6.10 LIOCS Sequential File Definition on Direct Access Devices Page RELSE Macro 306 TRUNC Macro ERET Macro READ Macro WRITE Macro CHECK Macro POINTW / POINTR Macros 308 POINTS Macro Page Page 13.2.6.11 LIOCS Direct Access File Definition Page Page WRITE Macro 314 WAITF, OPEN and CLOSE Macros 13.2.6.12 Track and Record Addressing Track Addressing Record Addressing Record Addressing by ID Record Addressing by KEY 316 Reference Methods Record Reference by ID Record Reference by KEY Page Page Page Page Page Loading a DAM File (Fixed-Length Records without keys) Loading a DAM File (Undefined or Variable-Length Records) Page Page Figure 52. MVS Feedback Formats 13.2.6.13 LIOCS Indexed Sequential Definition 326 13.2.6.14 PIOCS Overview of Programming Elements CCB Macro DTFPH Macro 13.2.6.15 Comparison of Physical IOCS Elements 328 Chapter 14. RPG II 14.1 Migration from VSE to OS/390 14.1.1 Device Information 14.1.2 Print Files 14.1.3 Tape Labels 14.1.4 Extent Exit 330 Indexed sequential files Sequential files Page Page Chapter 15. PL/I IBM PL/I for MVS & VM Compiler and Run-Time Migration Guide Release 1.1 OS PL/I Version 2 Language Reference DBCS support EGCS support 15.1.2 Extended Precision 15.1.3 Multitasking 334 PRIORITY(T1) = PRIORITY(TI) + 2; 15.1.4 Dynamic Loading of Dependent Programs 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.1.1 CATALOG 15.2.2 Options Specific to the MVS Compiler 15.2.2.5 SMESSAGE or LMESSAGE 15.2.2.6 IMPRECISE 15.2.2.7 INTERRUPT 15.2.2.8 TERMINAL 15.2.3 Execution Options 15.2.3.1 ISASIZE 15.2.3.2 REPORT 15.2.3.3 COUNT FLOW 15.2.3.4 SPIE STAE 15.2.4 The EXEC and PROCESS Cards 338 15.3 Linkages Between Languages 15.3.1 Linkages Supported ERROR IN PL/I ERROR HANDLER 15.3.2 Linkages not Supported 15.4.1 Not Supported in MVS 15.4.1.10 NOTAPEMK NOLABEL 15.4.2 Supported but to be Avoided 340 BLKSIZE KEYLENGTH KEYLOC 15.4.3 The TOTAL Option 15.4.4 The SIS Option (Sequential Insert Strategy) Page 15.5.2.9 SORT TECHNIQUES 15.6 Checkpoint-Restart in PL/I 15.6.1 PLICKPT 15.6.2 PLIREST 15.6.3 PLICANC 15.7 DUMP in PL/I Optimizer 15.7.1 Output File FILE PLIDUMP COULD NOT BE OPENED - DDNAME MISSING. 15.7.2 Options Specific to DOS 15.7.3 Options Specific to MVS A Dump all tasks O Dump only the task requesting the dump E Use of an exit 344 15.7.4 Compatibility 15.8 Return Codes in PL/I 15.8.1 Setting Return Codes 15.9.2 Automatic Restart 15.10 Overlay Structures 15.10.1 Conversion 15.10.2 Overlay in MVS 15.11 Storage Management in PL/I 15.11.1 Storage Management in DOS 15.12 PL/I and CICS 15.12.1 File Support 15.12.2 Statements not Supported 346 15.12.3 CALLing DUMP 15.12.4 Execution Options 15.12.7 PL/I Return from ON-units and CICS Transaction Backout without Page Chapter 16. FORTRAN 16.1 VS FORTRAN in OS/390 16.2 FORTRAN Conversion Considerations Page Chapter 17. Language Environment (LE) 17.1 Introduction 17.1.1 General Comments on Language Environment OS/390 Language Environment Concepts Guide 17.1.1.1 A Few Words about COBOL and PL/I 17.1.2 Conceptual Differences between LE/VSE and OS/390 Language Environment LE/VSE Concepts Guide Release 4 352 LE/VSE Concepts Guide Release 1 OS/390 Language Environment Concepts Guide 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 354 LE/VSE Programming Reference Release 4 OS/390 Language Environment Migration Guide 17.4.2 C/370 17.4.3 VS COBOL II 17.4.4 DOS/VS COBOL 17.4.5 DOS PL/I 356 Table 40. DOS PL/I Migration Considerations 17.4.6 VS FORTRAN Language Environment V1R5 FORTRAN Migration Guide 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 CEE3616I The string I12 was not a valid suboption of the run-time option ABPERC. 360 LE/VSE 1.1 LE/VSE 1.4 OS/390 Language Environment Programming 17.5.1.1 Run-time Options and LE/VSE 1.1 17.5.1.2 Run-time Options and LE/VSE 1.4 and Later Releases 17.5.1.3 Recommended Settings for Options OS/390 Language Environment Migration Guide Run-Time Migration Guide Release 4 LE/VSE Programming Guide Release 1 OS/390 Language Environment Migration Guide 17.5.2 User Exits and Abnormal Termination Exits 17.5.2.1 Assembler User Exits 364 17.5.2.2 High-Level Language Exits 17.5.2.3 Abnormal Termination Exits 17.5.3 Callable Services and Math Services 17.5.3.1 CEETDLI 366 17.5.4 LE/VSE 1.4 Locales OS/390 C/C++ V2R4.0 17.6 CICS 17.6.1 COBOL and CICS 17.6.2 Run-time Options 17.6.3 User Exits and Abnormal Termination Exits Page 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 370 address ISPEXEC SELECT CMD(%myexec) if address() = CMD then /* OS/2 environment */ 18.4.1 VSE/ESA Environment 18.4.3 TSO/E Environment 18.4.4 REXX Exec Sample for the OS/2, TSO and CMS Environments 18.5 Migration Issues 18.5.1 REXX and SAA 18.6 REXX Bibliography 372 Page Page Chapter 19. SORT DFSORT Application Programming Guide DFSORT Application Programming 19.1 JCL Statements Page 19.2 Control Statements DFSORT Application 378 19.3 Additional DFSORT/VSE Migration Considerations 19.3.1 Control Statements 19.3.2 ICETOOL DFSORT Application Programming Guide 380 Chapter 20. DITTO 20.1 Compatibility with Previous Releases of DITTO 20.2 DITTO Functions that are No Longer Supported 382 20.3 DITTO Functions that are Not Recommended 20.4 DITTO Function Code Synonyms The following table lists supported synonyms for DITTO function codes. 384 20.5 Batch Keywords that are No Longer Supported 20.6 Batch Keywords that are Not Recommended 20.7 DITTO/ESA Security Page Chapter 21. VSAM Backup/Restore 21.1 VSAM Backup/Restore DFSMSdss Storage Administration Reference DFSMShsm Managing Your Own Data 21.1.1 OS/390 VSAM Backup/Restore 388 Chapter 22. Librarian Librarian 22.1 Overall Library Support Logical library structure Library data format 22.1.1 OS/390 ISPF Overview OS/390 ISPF User 390 OS/390 ISPF Getting Started 22.1.2 OS/390 Library Management Page Chapter 23. LISTLOG/PRINTLOG - Printing Log Streams 23.1 VSE PRINTLOG Utility OS/390 MVS Planning: Operations IBM VSE/ESA System Utilities VSE/ESA Guide for Solving Problems 23.3.1 SYSLOG 23.3.2 Printing SYSLOG 394 OS/390 MVS Setting Up a Sysplex 23.4 OPERLOG Page Page Chapter 24. VSE/Fast Copy and OS/390 DFSMSdss 24.1 VSE/Fast Copy (Online and Stand-Alone) IBM VSE/ESA System Utilities 24.2 DFSMSdss - OS/390 Component 398 Page Page Chapter 25. Prepare the Migration Environment 25.1 Introduction http://www.training.ibm.com/ibmedu/roadmaps/mainframe/os390/. 25.2 Install and Configure Required Hardware 25.2.1 Processor Requirements 402 FBA to ECKD Migration Aid - Internal Disk for the Multiprise 2000 25.2.2 Devices Supported by OS/390 25.2.4 Other Hardware Requirements OS/390 MVS Recovery and Reconfiguration Guide 25.2.5 Inter-Systems Connectivity 25.2.5.1 Shared DASD 404 25.2.5.2 Tape Drives 25.2.5.3 Terminal Access 25.3 Order and Install the OS/390 Software 25.3.1 Fee-based Methods of Installing OS/390 25.3.1.1 SoftwareXcel Installation Express (SIE) 25.3.1.2 SoftwareXcel SystemPac/MVS Custom-Built Offerings Planning 25.3.2 Entitled Methods of Installing OS/390 25.3.2.1 ServerPac 25.3.2.2 CBPDO 25.4 Set Up Standards, Procedures, and Documentation 25.4.1 Installation Standards 25.4.1.1 Data Management Standards http://www.training.ibm.com/ibmedu/roadmaps/mainframe/storsys/ Related Redbooks 25.4.1.2 MVS Naming Standards Data Sets 408 Generation Data Groups DASD and Tape Volume Serials 25.4.2 Systems Management Procedures 25.4.2.1 Enforcing Installation Standards 25.4.2.2 Implementing System Security 410 RACF V2.2 Installation and Implementation Guide MVS 3.1.3 and RACF 1.9 Security Implementation Guide 25.4.2.5 Setting Up Critical Operations Procedures 25.4.2.6 Managing Change 25.4.2.7 Managing Problems 25.4.3 Documentation OS/390 Installation Planning Kit 412 S/390 Redbooks Collection OS/390 V2R4.0 Printing Softcopy BOOKs 25.5 Customize Your New OS/390 System 25.5.1.1 Verifying the New OS/390 System 25.5.1.2 Applying Preventive Service 25.5.1.3 Providing Terminal Access to the OS/390 System 414 25.5.1.4 NetView FTP Access NetView FTP V2 MVS Installation, Operation, and Administration 25.5.2 MVS BCP Customization 25.5.2.1 SYS1.PARMLIB Parameters OS/390 MVS Initialization and Tuning 25.5.2.2 MVS Exits 25.5.2.3 Tailoring Other Components 25.5.3 Other OS/390 Elements 416 OS/390 Parallel Sysplex Test Report 25.5.3.1 Base Elements for Release 4 25.5.3.2 Optional Features for Release 4 Page Page Chapter 26. Test Environments OS/390 Software Management Cookbook 26.1 Introduction 26.1.1 Differences in Testing Philosophy 26.1.2 Terminology 26.2 Test Systems in the Life of the Migration 26.3 VM, LPAR, or Standalone Systems ES/9000 Multi-Image Processing from a VM/ESA Perspective Volume 1 26.3.1 Logical Partitioning 422 26.3.2 Software Partitioning 26.3.3 Our Recommendation 424 26.3.3.1 Shared DASD 26.3.3.2 New Users of VM 26.3.3.3 The Advantages of Guest Support in VM/ESA Guest Support 426 other operating systems System Simulation Performance Benefits Reduced Hardware and Migration Cost 428 DB2 Guest Sharing 3990 Models 3 and 6 Fast Write Transparency Multiple 3270 Session Support 26.3.3.4 Use of CMS 26.3.3.5 OS/390 Guest Considerations 26.3.4 Summary 430 26.4 Parallel Activities 26.4.1.1 Overlapped Activities 26.4.2 Synchronizing VSE Applications with OS/390 Versions 26.5.1 OS/390 Maintenance Environment Software Management Cookbook 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) 432 Page Page Page Page Chapter 27. Orienting ICCF Users to TSO/ISPF 27.1 TSO/ISPF and SDSF OS/390 ISPF User SDSF Guide and Reference 27.1.1 Editing Data Sets 438 OS/390 ISPF Edit and Edit Macros. 27.1.2 Submitting Jobs 27.1.3 Using ISPF Utilities 27.1.4 Creating and Executing ISPF Applications OS/390 ISPF Dialog Developer 440 OS/390 V2R5.0 ISPF Application Server User OS/390 V2R5.0 ISPF Parts for VisualAge. 27.1.6 Tracking Jobs 27.1.7 Retrieving Output 27.1.8 Using SDSF for Operators Page 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 28.2.2 Managing Display Consoles 444 28.2.2.1 Console Modes K S,DEL=R,SEG=28,CON=N,RNUM=14,RTME=001,MFORM=(T,J) 28.2.3 Extended MCS Consoles 28.2.3.1 Using the TSO/E Functions 28.2.3.2 Using SDSF for System Operation 446 OS/390 MVS System Messages, Volumes 1 to 5 28.2.4 Understanding Message Formats and Replies R nn, reply 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 Stopping JES2 448 28.4 Controlling Devices 28.4.1 Displaying the Status of Devices 28.4.3 JES2 Devices 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.1.1 MVS Commands 28.5.1.2 JES2 Commands 450 28.5.1.3 SDSF Panels 28.5.1.4 RMF and Other Monitors 28.5.2 Controlling Time Sharing Users 28.5.3 Controlling Batch Jobs 28.5.4 Controlling Started Tasks OS/390 MVS System Commands 28.6 Managing Remote Operations 28.6.1 JES2 RJE Operations 452 28.6.1.1 HostOperations 28.6.1.2 Remote Workstation Operations 28.6.2 NJE Operations Command Authority for Remote Operators JES2 Commands SDSF Customization and Security SDSF Guide and Reference 28.6.2.1 Using SDSF Panels for NJE 454 Chapter 29. Orientation for Utilities 29.1 IEBxxx or IEHxxx DFSMS/MVS Summary of Access Method Services for ICF DFSMS/MVS Access Method Services for VSAM DFSMS/MVS Utilities 29.5 DFSMSdss DFSMS/MVS DFSMSdss Storage Administration Guide 456 DFSMSdss Storage Administration Reference Chapter 30. Systems Management Philosophy and Methodology 30.1 The Philosophy of Systems Management 30.1.1 Systems Management Overview 458 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 460 30.2.2 Tasks 30.2.3 Methodology 30.3 Problem Management 30.3.1 Overview 30.3.2 Tasks 30.3.3 Methodology 462 30.4 Performance Management 30.4.1 Overview 30.4.2 Tasks 464 30.4.3 Methodology 30.5 Operations Management 30.5.1 Overview 30.5.2 Tasks 30.5.3 Methodology 30.5.3.1 Automating Operational Procedures TME 10 NetView Automation Guide Integrated Centralized Automation/Advanced Operation 30.6 Security Management 30.6.1 Overview 30.6.2 Tasks 468 30.6.3 Methodology 30.7 Configuration Management 30.7.1 Overview 30.7.2 Tasks 30.7.3 Methodology 470 30.8 Asset Management 30.8.1 Overview 30.8.2 Tasks 30.8.3 Methodology 30.9 Accounting Management 30.9.1 Overview 30.9.2 Tasks 30.9.3 Methodology 472 30.10 Summary IBM Networking and Systems Management Redbooks Collection 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 474 31.3.4 Using IPCS 31.4 JES2 Diagnosis 31.5 SLIP 31.6 Performance Tools 31.7 LOGREC 31.8 SYSLOG 31.9 DFSMS/MVS Diagnosis 476 DFSMS/MVS Access Methods Services for ICF DFSMS/MVS DFSMSrmm Diagnosis Guide 31.9.2 DFSMShsm DFSMS/MVS DFSMShsm Diagnosis DFSMShsm Diagnosis Guide 31.9.3 DFSMSrmm 31.9.4 DFSMSdss 478 31.10 Diagnostic Reference Publications Page Page Chapter 32. Conversion Process MVS MS - Production Standards 32.1 Conversion Process Introduction 482 32.1.1 References MVS Migration System - General Information IBM Washington System Center Flash # 9741 MVS MS - Production Standards MVS Migration System - Planning Chart 32.1.2 Prerequisites 32.1.3 Recommendations 484 32.1.3.1 Project Management 32.1.3.2 Take Advantage of Conversion Tools and Automation 32.1.3.5 Migrate the SNA Network Early 32.1.3.6 24x7 Installations 32.1.3.7 Two Phase Approach 32.1.4 Assumptions 486 MVS-MS General Information Manual 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.2.1 Automated Conversion 32.2.2.2 Repetitive Conversion 488 32.2.2.3 Mass Conversion (Switchover) 32.2.2.4 Automation Limits 32.2.3 Mass Conversion Tools 32.2.4 Automated Conversion Process 32.2.5 CORTEX MS 490 Page 32.2.5.1 Inventory Validation 32.2.5.2 Translate the Languages/Programs 492 COBOL Conversion Tools Assembler Conversion Tools 32.3 Mass Conversion Phase Overview 32.4 Preparation Phases Implement System Managed Storage (DFSMS) 32.4.1 Phase 0: Project Management and Technical Leadership 32.4.1.1 Project Planning and Orientation 494 32.4.2 Phase 1: Application Inventory 32.4.2.1 Determination 32.4.2.2 Collection 496 32.4.2.3 Supply 32.4.2.4 Analysis and Resolution of Exceptions 32.4.3 OS/390 Standards and Naming Conventions 498 32.4.4 Phase 2: Conversion Specifications MVS-MS Production Standards 32.4.4.1 Analyze the VSE Source Material MVS MS Planning Guide - Appendix A 500 32.4.4.2 Design the MVS Target Output 32.4.4.3 Determine the Method to Get from Source to Target 32.4.5 Phase 3: Customization or Development of Conversion Tools VSE Positioning 502 Manual OS/390 Conversion 32.5 Conversion Phases 32.5.1 Program Conversion 32.5.1.1 Program Conversion Considerations Additional programming changes and considerations 32.5.1.2 Common VSE Coding Practices Causing Conversion Problems 32.5.2 JCL Conversion 504 32.5.3 Phase 4: Initial Trial Conversion Initial Trial Conversion trial conversions 32.5.4 Phase 5: OS/390 Regression Tests and Repeated Trial Conversions 506 32.5.4.1 Responsibilities 32.5.4.2 Recommendations Testing Priorities Personnel Involvement in Testing MVS Tools Testing 32.5.4.3 Test Plan 508 Page 32.5.4.4 OS/390 Automated Operations Tools 510 32.5.5 Initialization Testing 32.5.6 Unit Testing 32.5.6.1 Online Unit Testing 32.5.6.2 Batch Unit Testing 512 32.5.6.3 Data Migration in Unit Testing 32.5.6.4 Timing between Online and Batch Testing 32.5.7 System Testing Online Batch 32.5.7.1 Data Migration in System Testing 32.5.8 Parallel/Production Simulation Testing 514 32.5.8.1 Data Migration in Parallel Testing Job Simulation Date Concerns during Parallel Testing 32.6 Implementation Phases 32.6.1.1 Converting the Development Material 32.6.2 Phase 6: Actual Conversion and Switchover 516 32.6.2.1 Final JCL Conversion 32.6.2.2 Final Program Conversion 32.6.3 Switchover 32.6.3.1 Data/File Migration 32.6.3.2 Additional Switchover Tasks 32.6.4 Phase 7: Initial OS/390 Operations 518 Chapter 33. Conversion Services and Tools all http://www.s390.ibm.com/vseservices 33.1 Conversion Services 33.1.1 IBM Global Services 33.1.2 Automated Migration Services (AMS) 33.2 Conversion Tools 33.2.1 VSE/ESA Facilities http://www.software.ibm.com/ad/va2000 http://www.software.ibm.com/ad/cobol 520 VSE/ESA Enhancements Version 2 Release 3 33.2.2 IBM OPTI-AUDIT for VSE 33.2.2.1 Product Highlights 33.2.2.2 Product Details 33.2.3 IBM COBOL and CICS Command Level Conversion Aid (CCCA) 522 33.2.3.1 Product Positioning 33.2.3.2 Technical Description 33.2.4 SISRO - CORTEX-Migration System (CORTEX-MS) 524 33.2.5 Computer Associates 33.2.5.1 CA-Convertor 33.2.5.2 CA-DUO 33.2.6 The Source Recovery Company 33.2.6.1 Recovery/SRC 33.2.6.2 Rename/SRC 526 33.2.6.3 Reconcile/SRC 33.2.6.4 VersionMatch/SRC Page Page Chapter 34. Customer Migration Example 34.1 Background 34.2 Environment 34.2.1.1 Hardware 34.3 Inventory 34.4 Resources 530 34.5 Duration 34.5.1.1 Phase One 34.5.1.2 Phase Two 34.6 Performance 34.7 Benefits 532 Page Page 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 A.1.3 OEM Product Education 536 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? Page 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 Table 46 (Page 2 of 3). S/390 Software Product Mapping 540 Note: PID #s and Product Functions should be checked by the user prior to ordering any software. Table 46 (Page 3 of 3). S/390 Software Product Mapping Appendix B. Mapping ISV Products and Functions 541 Page Appendix C. DFSMS Naming Conventions C.1 Data Set Naming Guidelines C.2 Components of a Data Set Name C.2.1 High-Level Qualifier (HLQ) 544 Page C.2.2 Relative Importance C.2.3 File Contents 546 C.2.4 User Name C.2.5 Data Set Level 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 548 C.3.4 Output Device Type C.3.5 Expiration Date C.3.6 Access Method no C.3.7 Job Name 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 550 DSNDBI DSNDBD C.4.4 Generation Data Sets A.B.C.GnnnnV00 Page Appendix D. Special Notices 554 The following terms are trademarks of other companies: 556 Appendix E. Related Publications OS/390 Information Roadmap See GC28-1727, E.1 International Technical Support Organization Publications For information on ordering these ITSO publications see How to Get ITSO Redbooks on page 561. E.2.1 Planning Books The following hard-copy books are part of the 558 Other OS/390 Books: OS/390 Installation Planning Kit E.3 Other Publications E.4 Other Sources E.4.1 Books on the Internet http://www.s390.ibm.com/os390 http://www.redbooks.ibm.com/ E.4.1.1 Redbooks Page How to Get ITSO Redbooks How IBM Employees Can Get ITSO Redbooks How Customers Can Get ITSO Redbooks 562 IBM Redbook Order Form Page Glossary Numerics A 566 B C 1995 and 0195 represents the year 2095 568 D E 570 F G H I 572 J K L 574 M N O 576 P Page Q R 578 S 15-99 580 T U V W 582 Y List of Abbreviations 584 Page 586 Page 588 Page 590 Index Special Characters Numerics A 592 B C 594 Page 596 D 598 Page E 600 F G H I 602 (continued) See also J 604 (continued) See also K L (continued) M 606 Page N O 608 Page P 610 Page 612 Q R S 614 Page 616 T U V 618 Page W X 620 Y ITSO Redbook Evaluation Page /XRL/1 /XRL/2 /XRL/3 /XRL/4 /XRL/5 /XRL/6 /XRL/7 /XRL/8 /XRL/9 /XRL/10 /XRL/11 /XRL/12 /XRL/13 /XRL/14 /XRL/15 /XRL/16 /XRL/17 /XRL/18 /XRL/19 /XRL/20 /XRL/21 /XRL/22 /XRL/23 /XRL/24 /XRL/25 /XRL/26 /XRL/27