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