VSE to OS/390 Migration Workbook
Page
October
VSE to OS/390 Migration Workbook
Take Note
First Edition October
Contents
Job Control Language JCL Differences and Considerations
Key Documents and Other References
Operating System Implementations
Disk and Tape Storage Considerations
162
Defining MQSeries Object and Operating
Advanced Function Printing and Print Services Facility/MVS
VSE/ESA
Part 3. Converting VSE Languages to OS/390 Languages
Data Division File Description FD
Egcs VSE to Dbcs OS Version 2 Comments
349
Part 4. Converting VSE Utilities to OS/390 Utilities
Part 5. Setting Up the Migration Environment
VSE/Fast Copy and OS/390 DFSMSdss
Prepare the Migration Environment
Orientation to OS/390 Console Operation
Orienting Iccf Users to TSO/ISPF
Systems Management Philosophy and Methodology
Understanding Message Formats and Replies
495
Appendix B. Mapping ISV Products and Functions
565
Appendix E. Related Publications
List of Abbreviations 583
591
Xvii
Figures
Loading a Random Preformatted DAM File under VSE
Xix
Tables
Xx VSE to OS/390 Migration Workbook
Redbook Builders and Key Contributors
Preface
Team That Wrote This Redbook
Http//w3.itso.ibm.com
Authors and Significant Contributors
Comments Welcome
Part 1. Planning the Migration An Introduction
VSE to OS/390 Migration Workbook
Synopsis of This Book
Why Customers Migrate
What do I need to read?
System Programmers Read the following
Business Consolidation
Traditional Reasons for Migrating
Virtual Storage
Mergers/Acquisitions
Capacity Constraints
Supervisor
Cics
Prod
Unused
Cics TOR
ACF
Static Dynamic Partitions SVA 31-Bit 16MB VSE
VSE Vtam
C1 Y1 SVA 24- Bit
Way Processor Support
Image
Task Quantity
MVS Nucleus
Systems Management
Functional Reasons for Migrating to OS/390
Applications Availability
Systems Availability
Connectivity
Staff Availability
Defining the Migration Project Objectives
Sizing the Effort
Introduction to Sizing
Source Programs
Areas of VSE and OS/390 Differences
Source Program Inventory
Batch and Online Program Conversion
Files
Job Control Language
Operations
Comparison of Basic VSE Functions & Components to OS/390
Iocp IOCP, HCD
Erep Mshp SMP/E
A S M
LE/VSE LE/MVS
Cobol PL/I
RPG
Comparison of VSE Functions & Components to OS/390
OS/390 Components/Products/Subsystems
OS/390 Operating Environment
1.1 OS/390 Product Content
Network Computing Services
Distributed Computing Services
Unix System Services
LAN Services
MVS Subsystem and Component Terminology
∙ Data Facility Storage Management Subsystem
∙ Interactive Problem Control System Ipcs
∙ Systems Resources Manager SRM
∙ Systems Management Facility SMF
Supporting Products
What Changes Between VSE and OS/390?
Subsystem Level Comparison/Affinity
Philosophical Changes
Security
Console Operator Interface
Automation
JCL Processing
Management Disciplines
Roles Activities
Activities
Who′ s Normal Activities are Affected?
Kernel/Progressive Approach
Approaches to Migration Disclaimer
Single Switchover Mass Application Migration Approach
In-House Staff
3 VM/ESA Guest Support in Your VSE to OS/390 Migration
Staffing Strategies
CAP-GEMINI
Conversion Tools
Outside Consultants
Application Programming
Educational Requirements Introduction
System Programming
Application Inventory
Scope of Work and Challenges
JCL Conversion
Program Conversion
VSE to OS/390 Migration Workbook
File Migration
VSE to OS/390 Migration Workbook
Automated Operations
Project Management
Cost Considerations
Introduction References
OS/390 Documentation Resources
Web URL
Key Documents and Other References
Overview References
Developing the Plan
Recommendations
Project Management
Take Advantage Of Conversion Tools and Automation
Two Phase Approach
Migration Plan Guide and Outline
Conversion Method
Migration Responsibilities
Project Staffing
Librarian
Migration Assignments
Team
Plan Components Approach
Systems Programmers
Project Manager
Applications Programmers
Tasks
Milestone Events
Progressive versus Mass Conversion Approach Differences
Education
Shared Application Files and Databases
Historical Perspective
Shared Application Code
Operations Support Staffing
Complexity of Implementation
Standardized Conversion Deliverables and Automation
Risk Management
Mass Migration Used as a Conversion Tool
Mass Migration as a Conversion Method
Cobol
RPG
Plan Examples
Estimated Project Schedule
Project Schedule
Estimated Schedule for CNV Responsibilities
Month Number Month Initial
Estimated Schedule for SER Responsibilities
Estimated Schedule for ABC Responsibilities
ABC Responsibilities
SER Responsibilities
Task Name Projected Actual Start End
Project Plan Example
Project Plan Summary
1998 Jan Feb Mar Apr May Jun Jul Aug Sep Oct
Task Name
Project Plan Details
PCL
Task Name Projected Actual Start End
1998 Jan Feb Apr Jun Jul Aug Sep Oct
Task ID
Task ID
Conversion Software Install
Batch File Migration Procedures
JCL
VSE to OS/390 Migration Workbook
Copyright IBM Corp
VSE to OS/390 Migration Workbook
Philosophy of JCL in System/390
Job Control Language JCL Differences and Considerations
2 OS/390′s Job Control Philosophy
1 VSE/ESA′s Job Control Language Philosophy
Job Control Language JCL Differences and Considerations
JCL Statement and Job Layout
High Level Similarities
Job Input
Spooling
JCL Differences Between VSE and MVS
VSE Example
Multiple Instream Data Set Input
JCL Parameter Handling
Data Driven Segmentation of Output
$$ LST CLASS=J,DEST=DANJ,DISP=H
$$ EOJ
Operator Flexibility and Intervention
JCL Expansion
Assgn SYS005,CUU
Comment Lines in the JCL
Pause Statement
Hidden JCL
Allocation of Resources
Resource Allocation at Open Time
Partition and System Standard Labels
5.3 ²Carry-Over²
Permanent Assignments and Power Defaults
Help for the Hidden JCL Problem
Assgn SYS010,FEF
Device Address Specifications
SYS010 DD SYSOUT=
REPORT1 DD SYSOUT=
Communication Region Date and Upsi
Catalogs
Partition Dependent Codes in JCL
Upsi
VSE Job Control Statements
Job Statement
Exec Statement
MTC Statement
Reset Statement
Assgn Statement
Dlbl and Extent
DD Statement
MVS Job Control Statements
Output JCL Statement
MVS Conditional JCL
Cond Parameter on the Exec Statement
Function MVS Equivalent Statement
Comparison of VSE and MVS JCL a Summary
1 of 2. VSE Job Control Statements Summary
2 of 2. VSE Job Control Statements Summary
JCL Statement Purpose
Summary of MVS JCL Statements
MVS Job Control Statements
2. Overview of Power Jecl Statements
Comparison of Power and JES2 Jecl a Summary
Jecl
List Card * $$ LST
Statement Purpose Comments
Summary of JES2 Jecl a Table
1 of 2. JES2 Control Statements
2 of 2. JES2 Control Statements
VSE and MVS JCL Comparison Example
Sample VSE JCL
Sysin DD * 01 Endicott Boeblingen
Sample MVS JCL
Myjob JOB ACCT#,′ Report by PLANT′ , CLASS=F,REGION=4M
Extent DISKO1,0,100,500
Sample VSE plus Carry-Over
Extent DISK14,0,600,500
Outfil BLKSIZE=4350 Sort Ended
Exec PROGRAM2,SIZE=300K
VSE to OS/390 Migration Workbook
Disk and Tape Storage Considerations
Access Method Similarities and Differences Access Methods
DAM or Bdam
Operating System Implementations
2 OS/390 Considerations
Miscellaneous Functions
Data Set Naming Considerations VSE Considerations
System Managed Storage
Storage and Space Management VSE Considerations
Disk and Tape Storage Considerations
Implementing Dfsms
Standard Labels
Tape Similarities and Differences Volume Interchangeability
VOL1 HDR1 TM Data Records TM EOF1 TM TM
VOL1 HDR1 TM Data Records TM EOV1 TM
VOL1
UHL1 UHL8
Standard User Labels
No Labels
Use should be controlled
Nonstandard Labels
Bypass Label Processing Facility in OS/390
OS/390 Single Data Set-Multiple Volumes
OS/390 Single Data Set-Single Volume
VSE With Tapemark Before Data Records
VSE Without Tapemark Before Data Records
Dasd Vtoc Processing
Dasd Similarities and Differences Volume Interchangeability
Indexed Vtoc Considerations OS/390
2 OS/390 Catalogs
Vsam Differences Introduction
Integrated Catalog Facility ICF
Vsam Catalogs
Part 1 of 2. Extract from WSC Flash
Vsam Catalog and Cvol Support Ends in YR2000
3.1 OS/390 Master Catalog
3 OS/390 Catalog Management
3.2 OS/390 User Catalogs
LOADxx Prompt Nucleus Device Suffix Feature
DEPT1 & Jones
DEPT4
Payroll
DEPT2 DEPT3
Do not use Jobcat or Stepcat statements in OS/390
4 OS/390 VSE/VSAM Catalog Compatibility
Converting VSE/VSAM Catalogs to OS/390 ICF Catalogs
Accessing a VSE/VSAM Catalog from an OS/390 System
Vsam Functional Differences
− Delete Ignoreerror
Moving a Vsam Catalog to a Different Dasd Type
Areas of Consideration
FBA Dasd
Shared Volume Ownership
Catalog Structures
Noimbed Option
Synchk Parameter
AMS Commands
XXL Ksds New in VSE/ESA 2.3, greater than 4GB Ksds
Compress New in VSE/ESA 2.2, Vsam Record Compression
VSE/VSAM-managed SAM Files
Vsam CISIZEs and Record Sizes
Noallocation Data Sets
Default Models
JCL Implicit Define
Reusable Data Sets
Partition Independent File Names
VSE/VSAM BACKUP/RESTORE and VSE Fastcopy
Ikqvdu Volume Cleanup
Space Classes
Data Sharing and Integrity
Ikqvchk Catalog Check
OS/390 Vsam Integrity Provided by Cross-Region Shareoptions
Cross-Region Sharing Single CPU Environment
OS/390 Vsam Cross-Region SHR4
Intra-Region Data Set Name Sharing
Single Region Data Set Sharing
Single ACB Open Multiple String Processing
OS/390 Vsam Cross-System Shareoptions
Cross-System and Dasd Sharing
OS/390 Definitions for Dasd Sharing Support
Alternatives to Vsam Data Set Sharing
Dasd Sharing Considerations
Dfsort and Vsam Considerations
Vsam Error and Reason Code Compatibility
Programming Languages and Vsam Support
VSE to OS/390 Migration Workbook
133
Cics
Overview Cics Transaction Server
Key Prerequisites
Cics TS
Virtual Storage Considerations for MVS
General Compatibility Comments
Appl
Cics General System Considerations
Data Bases
TOR AOR1 AOR2
Macro-level programs
Journaling to tape service
Btam devices and controllers
Cics internal security and signon table
Access to Cics system control blocks
Kernel domain Domain
Enqueue domain
Message domain Monitoring domain
Cics Domains
Cics Macro Resource Definition Table Changes
Cics
VSE to OS/390 Migration Workbook
System initialization modifications SIMODs are obsolete
CSD and RDO Considerations
7.1 CSD
CONNECTION/SECURITYNAMEMRO
7.2 RDO
TYPETERM/RECOVNOTIFY
Cics System Data Sets Requirements
Shows MVS data sets used by Cics
Cics System Program Interface and Exits
System Programming Commands
Exits
Collect Statistics
Exec Cics Abend
Command Exit points
All exits
Exec Cics Return
Cics Upsi
Cics Transaction Security
Application Programming
Spool Interface restrictions
SAA AD/Cycle COBOL/370 SAA AD/Cycle C/370 SAA AD/Cycle PL/I
CICS/VSE and TS Coexistence Considerations
Testing and Problem Determination Considerations
Cics with DL/I
Vendor Applications
Preparing to Use the System
Iccf and TSO
User Profiles
155
Permit Parmlib Classtsoauth Idaaaa Accessread
Adduser Aaaa PASSWORDsecret Special
Permit JCL
Permit Oper
Security
Logon Procedures
Message Facilities
Summary
Using the System
Entering and Manipulating Data
Accessing the System
Descriptive Qualifier Data Set Contents
Edit Payrollprtchk NEW Cobol
Ready
Executing Programs at a Terminal
Submitting Jobs for Batch Execution
Converting Iccf Libraries
Using Command Procedures
Migrating from VSE/ICCF to MVS and TSO/E
Sample Iccf Procedure
Sysin DD Data TOP Stack 13 Quit
Load Dtsprocs
Options
Save Iebupdte Edit Iebupdte Next
DEL
Iccf Procedures and Macros
VSE to OS/390 Migration Workbook
169
Databases
DL/I and IMS/VS DB Differences Introduction
Data Base Descriptor DBD
MVS System Requirements
Primary Index of Hidam DB
Secondary Index for HD DB
Interactive Macro Facility IMF Command-Level Coding Hlpi
Program Specification Block PSB
Batch Programming
5.1 RPG
Field Level Sensitivity
Statement Compatibility
PCB after GE Status
NI Status Codes
Operations
Utilities
7.4 DL/I Parameter Statement
Backout Utility/Disk Logging
Database Portability
Alternate DL/I and IMS/ESA Access
Unloading and Reloading the Database
DL/I DBD
Changes Utilities Operations Tuning
Unload DB IMS GEN
Yes
End Users
9 DL/I Multiple Partition Support
Additional Information
Application Developers
System Administrators
Database Administrators DBAs
SQL/DS Dbsu UNLOAD/RELOAD
SQL/DS Dbsu Load
Year
Security Administrators
Other Comparison Areas
Summary of Migration Task
Data Replication and Data Access
Drda Considerations
Transaction Management
Databases
VSE to OS/390 Migration Workbook
ACF/VTAM
Telecommunications Subsystems
185
Vtam Data Sets
Product Installation
NET Proc PERF=13 Exec
Resource Definition and Operation
PGM=ISTINM01,REGION=6000K,TIME=1440,DPRTY=15,13
PERFORM=&PERF
VSE to OS/390 Migration Workbook
Telecommunications Subsystems
Resource Definition
Customization and Programming
Operation
Vtam Tables
Programming
Network Configuration
Program Generation
ACF/NCP
Backlevel Hardware Support
Btam Product Installation
Usage
Migrating TCP/IP
Network Definitions
3 TCP/IP Related User Data
2 TCP/IP Configuration
4 TCP/IP Batch Jobs
User Written TCP/IP Applications
5.2 TCP/IP Applications using the Preprocessor API
5.1 TCP/IP Applications using the Sockets API for Assembler
5.3 TCP/IP Applications using the BSD/C Sockets
5.4 TCP/IP Applications using the LE/VSE C Socket API
OS/390
Bibliography
MQSeries
Prerequisites
MQSeries in Your Operating System Environment
Telecommunications Subsystems
PL/I
Installation and Customization
Cics Considerations
Data Sets
Defining MQSeries Object and Operating
Networking Definitions
VSE to OS/390 Migration Workbook
MQSeries-based Applications
SC33-0807
10.1 JES2 Introduction
Power and JES2
Major Differences
Keep Disposition for Pre-Execution Jobs
Time Event Scheduling for Jobs
Printer Forms Alignment via Psetup
Tape Spooling
Separator Page Difference
Implementing JES2
Setting Up the Required Resources
End-of-page Sensing
FCB Incompatibilities
Power JES2
10.2.1.2 JES2 Spool Volumes
Starting JES2
10.2.1.1 JES2 Checkpoint
Tailoring JES2
10.3 JES2-POWER Functional Comparison
JES2 Input Sources compared to Power
Input Service
Multiple System Support
Input From
Job Stream Disposition
OS/390 Solution
Job Scheduling
Additional Job Scheduling Functions with MVS/JES2
Serializing Job Execution
Time Event Scheduling
Output Service
Output Service
1 of 2. POWER/JES2 Output Service Comparison
Printers Supported
2 of 2. POWER/JES2 Output Service Comparison
Output Segmentation
NEWPAGE=1
Output Disposition
Separator Page Differences
FCB Naming Differences
FCB Prefixes
UCS Naming Conventions
FCB Specification
Interactive User Interfaces ICCF/CMS/TSO
Functional RJE Differences
Remote Job Entry
Remote Workstation Definitions
Interactive
RJE Exits
Network Job Entry
RJE Operations
Application Interfaces
Other Interfaces
Job Information Services
Output Retrieval
JES2 SMF Accounting Records
Accounting Comparisons
Job Accounting
NJE Activity VSE/POWER Account MVS/JES2 SMF Record
RAS Characteristics
NJE Accounting
Accounting Records for NJE Activities
POWER/JES2 Detailed Comparisons
10.3.11 JES2 Testing Techniques
Mapping Power Parameters to JES2 Init Parms
Equivalent JES2 Parms for Power Macro
1 of 2. Power Macro to JES2 Parameter Mapping
Pline Mapping to JES2 Line Parameters for RJE and NJE
2 of 2. Power Macro to JES2 Parameter Mapping
1 of 2. Prmt Macro to JES2 Parameter Mapping
Define BSC Remotes
Pline Macro to JES2 Parameter Mapping
Prmt Macro to JES2 Parameter Mapping
Define SNA Remote Workstations
2 of 2. Prmt Macro to JES2 Parameter Mapping
Define NJE Nodes
Exit Comparisons
Define Compaction Tables
Pnode Macro to JES2 Parameter Mapping
Power Exit to JES2 Exits
POWER-JES2 Command Equivalences
Source Code Modifications
JES2 Patching Facility
Command Short Code Form Verb
Task Management Commands
Network Management
NJE Operator Commands
2 of 2. Network Management Commands
Sending Commands and Messages
File Control Commands
Sending Commands and Messages
Introducing PSF/MVS
Advanced Function Printing and Print Services Facility/MVS
Functional Comparison between PSF/VSE and PSF/MVS
Migration Effort
Defining Channel-attached Printers to MVS
Installing and Configuring PSF/MVS
Defining Network Printers
Attachment Options
11.2.2.2 TCP/IP Attached Printers
PSF Startup Procedures
Defining Printers for PSF Printing
Comparison of Printdev Statement Parameters
FSS Procedure and Printdev Statements
Printdev Parameter Comparison
Migrating Resources from VSE to OS/390
Setting up AFP Resources
Remote-Resident Resources
Defining Resources
Migrating Print Applications
Transferring Print Streams VSE and OS/390 Coexistence
JCL and Jecl Differences
Printing from TSO
Understanding Operational Differences
Command Comparison
Starting and Stopping PSF
High Level Language Programming Interfaces
Other Differences Performance
Installation Exits
2 of 2. VSE OS/390 Command Comparison
References 11.6.1 PSF/VSE Publications
Accounting
11.6.2 PSF/MVS Publications
Redbooks
Internet Locations
Services
VSE to OS/390 Migration Workbook
247
Part 3. Converting VSE Languages to OS/390 Languages
VSE to OS/390 Migration Workbook
249
Cobol
General Comments on Cobol for OS/390 and VM
DOS/VS Cobol
Comparison of IBM Cobol Compilers
VSE to OS/390 Migration Considerations
Useful Publications
Migrating Object Code
Deck
Outdd
Useful Cobol Publications
Converting from DOS/VS Cobol
12.3.1 DOS/VS Cobol Cics Programs
FIELD1 Values are 60 61 FIELD2 Values are 50 51
Common Cobol Coding Problems
PRIMARY-FIELD PIC
Filler Redefines RECORD-A
RECORD-A
RECA-FIRST PIC RECA-SECND
Move 0 to RETURN-CODE
SPECIAL-NAMES Sysin
Configuration Section SPECIAL-NAMES Paragraph
Is ACCEPT-SYSIN
UPSI-0 Is CBL232B on Status is CBL232-BASE UPSI-1
Assign Clause
Procedure Division Input/Output
Linage Clause and END-OF-PAGE Phrase
Close Statement for Tapes
Program Termination
File Handling Considerations
File Status Codes
Exit Program Goback Stop RUN
Converting from VS Cobol
PROCEDURE-POINTER Function
File Attribute Mismatches
Isam
Converting from Cobol for VSE/ESA
VS Cobol II Cics Programs
Some Conversion Considerations for all VSE Cobol Compilers
Vsam
12.8.1 RES/NORES
Compiler Options
Compiler Option Considerations for VS Cobol
Wordnooo
Pgmnamecompat
Rmodeauto
Reserved Word Considerations for DOS/VS Cobol
Reserved Words
FDUMP/NOFDUMP
Flagsaa
Cbltitle
EMI Printing
Compiling and Running Your Converted Cobol Programs
FUNCTIONPROCEDURE-POINTER
Reserved Word Considerations for VS Cobol II and Cobol for
VSE to OS/390 Migration Workbook
Assembler Products
Assembler
General Assembler Conversion Comments
267
MVS Register Conventions
System Interface and Macros
Register Conventions
Initiation
Termination
Save Areas
Application Program Logic
LA 13,SAVEA LA 13,SAVEB Call Progb Call Progc
11,SAVEA 11,SAVEB 11,SAVEC
Proga Start Progb Csect Progc Csect MVS
Call Progb Call Progc
Savea DC
VSE Call
Larex Csect Using
MVS Call
Call SUBRTN1
1213,X′ FF′ Set return indicators Return
1213 Restore the registers
13,413 Get backward chain pointer
Caller′ s save area
Communication Region
Problem Program Area Addresses
Upsi User Program Switch Indicators
Job Name
User Program Communication Bytes
Communications Region Simulation
Progb
Load the phase
15,1 Pass address
Call
EPLOC=PHASENM
VSE Phasenm
EP=PROGB
Cdload
VSE Binary
VSE Standard HM MS S MVS DEC
MVS BIN
Time DEC,OUTAREA,DATETYPE=YYYYMMDD,LINKAGE=SYSTEM
MVS Abend Dump ,STEP
VSE Jdump
Dump
VSE Lock DTL1
VSE Cancel ALL MVS Abend
Unlock DTL1
MVS ENQ MF=E,DTL1
End address Poiner
Resar address
VSE Chkpt
′ S′
ATTACH/DETACH Macros
Multitasking Macros
Entrypoint
Cb locaion address
Number of evens,ECB = address ECBLIST=address
WAIT/POST Macros
Ecb1,ecb2 VSE Wait Lisname
System
13.2.2.3 RCB/ENQ/DEQ Macros
Step Systems
System Systems
Interrupt Handling Routines
Interval Timer Interrupts
Operator Communication Interrupts
VSE Ttimer Cancel MVS Ttimer Cancel ,TU
Tecb Setime
Exit
Getvis and Freevis Macros
Virtual Storage Macros
Vsam Macros
∙ M a C R F =
Exlst Macro and Excpad Routines
RPL Macro Additional MVS Parameters
Data Management Macros
Vsam Error and Reason Code Compatibility
Showcb Macro
MVS Vsam Check Macro
Ioreg
List and Execute Macro Forms
Definition of Blksize
Liocs Card File Definition
13.2.6.4 I/O Error Checking
Bufno =
Mode = E O Devd = ..,MODE=E O
Ctlchr = YES
ASA
Cntrl Macro
Liocs Printer File Definition
Prtov Macro
Card File Programs in VSE and MVS
Control = YES Macrf = PC Ctlchr = YES
Liocs Tape File Definition
Printov = YES
Sepasmb = YES
Reread Leave Rewind Disp
Close Macro
No equivalen. The opion specified in he Disp
VSE MVS Bsam only
BSR, number of blocks
FSR, number of blocks
Trunc Macro
Points Macro
Relse Macro
GET / PUT Macros
Feov Macro
Optcd = Q
Skip
Eropt = ACC SKP ABE
MACRF=RP,WP
Close TAPE,LEAVE
Liocs Device-independent File Definition
Open Tape VSE PUT Close Tape
Liocs Console File Definition
Liocs Sequential File Definition on Direct Access Devices
Erropi = Ignore Eropi = ACC Skip SKP ABE
Recfm = FA
Output Leave Updat Disp Extend Input
Qsam Input
Bsam Inout Disp Updat Leave Outin Outinx
Reread Leave Free Disp
Eret Macro
Write Macro
Read Macro
Write
Check Macro
Filename Address
Feovd Macro
WORKA= YES
Errext = YES Feovd = YES Hold = YES
Eropt = ACC
Optcd = W
Sequential Dasd File Program in VSE and MVS
Liocs Direct Access File Definition
General Considerations
Errext = YES
After = YES
Readid = YES
Readkey = YES
VSE Error Bytes and MVS Exception Code Bits
Error VSE MVS
WAITF, Open and Close Macros
Track Addressing
Track and Record Addressing
Record Addressing
Record Addressing by ID
Record Reference by ID
Record Addressing by KEY
Reference Methods
Reference Method
Record Reference by KEY
DCB DSORG=DA,MACRF=RISC,WIC
Direct Access File Processing
OPTCD=R,BUFL=58
Reference
Decbadd
Open DAMFILE,OUTPUT
Damfile DCB MACRF=WICS,DSORG=DA,OPTCD=R
Open DAMFILE,TAPE WRITER0
Open DAMFILE,UPDAT,TAPE,INPUT
Specified in the DD statement
DCB
Loading a Sequential DAM File under MVS
DECBR0,SZ,R0FILE STC
Open R0FILE,OUTPUT,TAPE WRITER0
DECBR0 CLI
Open DAMFILE,OUTPUT CLI
Three
Count
DISP=OLD DCB=BLKSIZE=50,RECFM=F GO.R0DD DD DSN=UDAM
DCB=DSORG=DA DISP=,KEEP GO.DAMDD DD DSN=UDAM
Loading a DAM File Undefined or Variable-Length Records
Loading a DAM File Fixed-Length Records without keys
Damfile Addition Write DAMFILE,AFTER
Open Damfile Read DAMFILE,KEY
AFTER=YES,ERREXT=YES,RELTRK=YES
Processing a DAM File under VSE
Loading a Random Preformatted DAM File under VSE
Multiple Search / Feedback
Type or Reference
Liocs Indexed Sequential Definition
CCB Macro
Piocs
Overview of Programming Elements
Dtfph Macro
Comparison of Physical Iocs Elements
Migration from VSE to OS/390
RPG
Device Information
Print Files
Tape Labels
File Access Methods
Extent Exit
Processing Options
Calling Cobol Subprograms
Direct access method files are processed with Bdam
Calling PL/I Subprograms
Year
VSE to OS/390 Migration Workbook
333
PL/I
Multitasking
Extended Precision
Dynamic Loading of Dependent Programs
File Organization
15.1.7 %INCLUDE
Parameters Passed to a Main Program
Compiler Options Options Specific to the DOS Compiler
Catalog
Options Specific to the MVS Compiler
Execution Options
Linkages Between Languages Linkages Supported
Exec and Process Cards
Linkages not Supported
Environment Attributes
Not Supported in MVS
²TOTAL² Option
Supported but to be Avoided
SIS Option Sequential Insert Strategy
Calling Sort from PL/I Interfaces Offered
Record
Sort Fields
Storage
Return Code
Plirest
Checkpoint-Restart in PL/I Plickpt
Call Plickpt pl,p2,p3,p4 DOS and MVS
If ONCODE= xxx then do
Dump in PL/I Optimizer Output File
Plicanc
Options Specific to DOS
² File Plidump could not be Opened Ddname MISSING²
Options Specific to MVS
Return Codes in PL/I Setting Return Codes
Compatibility
Return Code Values
Overlay Structures
Automatic Restart
Conversion
Overlay in MVS
Statements not Supported
15.12 PL/I and Cics File Support
CALLing Dump
15.12.6 PL/I-CICS/VS Transaction Abend Codes
PL/I
VSE to OS/390 Migration Workbook
VS Fortran in OS/390
Fortran
Fortran Conversion Considerations
349
VSE to OS/390 Migration Workbook
General Comments on Language Environment
Language Environment LE
Few Words about Cobol and PL/I
351
17.2.1 LE/VSE-conforming Languages
Useful Publications
Migrating from LE/VSE-Conforming Languages
For VSE/ESA
17.3.3 PL/I for VSE/ESA
Cobol for VSE/ESA
Migrating from Non-LE/VSE Run-time Environments
Options Mapping
VS Cobol
17.4.2 C/370
Report and Isasize Options, C/370 and DOS PL/I
370 Migration Considerations
DOS/VS Cobol Migration Considerations
DOS PL/I
VS Cobol II Migration Considerations
DOS PL/I Migration Considerations
Default setting for the Depthcondlmt option, both for
Migration Comments Consideration
Depthcondlmt
1 of 2. ILC Migration Considerations
Migrating Interlanguage Communications Applications
To Migrate You Need To
DOS PL/I
Migrating from LE/VSE
Migrating Assembler Applications
Run-time Options
2 of 2. ILC Migration Considerations
Syslst
Shh Ihh Udddd
Cblqda Flow Interrupt Simvrd Vctrsave
Run-time Options and LE/VSE
Argparse
Run-time Options and LE/VSE 1.4 and Later Releases
Language Option Recommendation
Recommended Settings for Options
Language Environment
Assembler User Exits
User Exits and Abnormal Termination Exits
High-Level Language Exits
Ceecxita Cics
Abnormal Termination Exits
Callable Services and Math Services
Cics
17.5.4 LE/VSE 1.4 Locales
Cobol and Cics
Ceetdli
User Exits and Abnormal Termination Exits
VSE to OS/390 Migration Workbook
Rexx and VM/ESA
Procedure Language Rexx
Rexx and VSE/ESA
Rexx and TSO/E
Environments
Power
18.4.1 VSE/ESA Environment
18.4.2 VM/ESA Environment
18.4.3 TSO/E Environment
Migration Issues
Rexx Exec Sample for the OS/2, TSO and CMS Environments
Rexx
Rexx Bibliography
Rexx and SAA
373
Part 4. Converting VSE Utilities to OS/390 Utilities
VSE to OS/390 Migration Workbook
375
Sort
JCL Statements
VSE to OS/390 Migration Workbook
Control Statements
VSE to OS/390 Migration Workbook
Additional DFSORT/VSE Migration Considerations
Icetool
Compatibility with Previous Releases of Ditto
Ditto
381
MVS/ESA VSE/ESA VM/ESA
Ditto Functions that are No Longer Supported
Function Description Replacement
Ditto Functions that are Not Recommended
Ditto Function Code Synonyms
Functions Keyword Description Replacement
Batch Keywords that are No Longer Supported
Function Synonyms Description
DITTO/ESA Security
Batch Keywords that are Not Recommended
VSE to OS/390 Migration Workbook
Vsam Backup/Restore
Vsam Backup/Restore
21.1.1 OS/390 Vsam Backup/Restore
21.1.2 VSE/VSAM Backup/Restore
VSE to OS/390 Migration Workbook
389
Librarian
Overall Library Support
∙ Interactive usage
22.1.1 OS/390 Ispf Overview
22.1.2 OS/390 Library Management
VSE to OS/390 Migration Workbook
VSE Printlog Utility
LISTLOG/PRINTLOG Printing Log Streams
VSE Listlog Utility Program
23.3 OS/390 Hardcopy Processing
Printing Operlog
Syslog
Printing Syslog
Printing SMF Records
23.5 JES2 System Data Sets Job Log and System Messages
Systems Management Recording
VSE to OS/390 Migration Workbook
397
VSE/Fast Copy and OS/390 DFSMSdss
24.1 VSE/Fast Copy Online and Stand-Alone
DFSMSdss OS/390 Component
∙ DUMP/RESTORE
∙ Compress
∙ Release
399
Part 5. Setting Up the Migration Environment
VSE to OS/390 Migration Workbook
401
Prepare the Migration Environment
Processor Requirements
Install and Configure Required Hardware
Devices Supported by OS/390
Dasd Requirements
403
Other Hardware Requirements
Inter-Systems Connectivity
Terminal Access
Shared Dasd
Tape Drives
Fee-based Methods of Installing OS/390
Order and Install the OS/390 Software
SoftwareXcel Installation Express SIE
Data Transfer and NJE
SoftwareXcel SystemPac/MVS
Entitled Methods of Installing OS/390
Other Offerings
ServerPac
Installation Standards
Set Up Standards, Procedures, and Documentation
Cbpdo
Data Management Standards
MVS Naming Standards
Dasd and Tape Volume Serials
Related Redbooks
Data Sets
JCL Standards
Systems Management Procedures
409
Other MVS Names
Creating an Emergency Backup System
Enforcing Installation Standards
Implementing System Security
Backing Up Your System
Managing Problems
Setting Up Critical Operations Procedures
Managing Change
411
Your Hardcopy Library
Documentation
Your Softcopy Library
Printing Softcopy Books
413
Customize Your New OS/390 System
Verifying the New OS/390 System
Providing Terminal Access to the OS/390 System
Applying Preventive Service
MVS BCP Customization
NetView FTP Access
Providing NJE Connection to the OS/390 System
25.5.2.1 SYS1.PARMLIB Parameters
Other OS/390 Elements
Optional Features for Release
Tailoring Other Components
Base Elements for Release
417
Independent Software Vendor Products
VSE to OS/390 Migration Workbook
Test Environments
Differences in Testing ²Philosophy²
Terminology
419
Test Systems in the Life of the Migration
Production Maintenance Backup Sand-box
Application Development & Test System
Application Program, JCL, and Data Conversion
26.3 VM, LPAR, or Standalone Systems
OS/390 Production Stand-By Maintenance
OS/390 VSE Backup Production Maintenance
Logical Partitioning
Software Partitioning
Our Recommendation
New Users of VM
System Simulation
Advantages of Guest Support in VM/ESA
Reduced Hardware and Migration Cost
Performance Benefits
Access to VM/ESA CMS Applications
Recovery Management
Operations Management
Interactive Computing, Application Development and Support
DB2 Guest Sharing
Use of CMS
Models 3 and 6 Fast Write Transparency
Multiple 3270 Session Support
Synchronizing VSE Applications with OS/390 Versions
Parallel Activities
Building the Initial OS/390 Test System
26.3.3.5 OS/390 Guest Considerations
Maintaining Your OS/390 Libraries and SMP/E Zones
26.5.1 OS/390 Maintenance Environment
26.5.2 OS/390 Test Logical Partition
Shared Dasd between OS/390 Test Systems vs. Cloned Dasd
Shared Dasd vs. Cloned Dasd
Shared Dasd between VSE and OS/390 vs. Cloned Dasd
VSE to OS/390 Migration Workbook
435
Part 6. Running Your OS/390 System
VSE to OS/390 Migration Workbook
437
Orienting Iccf Users to TSO/ISPF
27.1 TSO/ISPF and Sdsf
Editing Data Sets
Submitting Jobs
Using Ispf Utilities
Managing Projects
Creating and Executing Ispf Applications
Retrieving Output
Using Sdsf for Operators
Tracking Jobs
VSE to OS/390 Migration Workbook
Operating Hardware Consoles
Orientation to OS/390 Console Operation
Understanding the Operator Interfaces
443
Managing Display Consoles
Controlling Consoles
Console Modes
DEL=R,SEG=28,CON=N,RNUM=14,RTME=001,MFORM=T,J
Extended MCS Consoles
Using the TSO/E Functions
Display Areas
PFKeys
Understanding Message Formats and Replies
Using Sdsf for System Operation
Displaying System Status
Controlling the OS/390 System
Starting the System
Controlling Devices
Stopping the System
Displaying the Status of Devices
Understanding Device Allocation
Sdsf Device Panels
28.4.3 JES2 Devices
Controlling TSO Users, Jobs and Started Tasks
Displaying Work on Your System
28.5.1.2 JES2 Commands
MVS Commands
Sdsf Panels
RMF and Other Monitors
Controlling Started Tasks
Controlling Time Sharing Users
Controlling Batch Jobs
28.6.1 JES2 RJE Operations
Managing Remote Operations
Host Operations
Remote Workstation Operations
Command Authority for Remote Operators
Using Sdsf Panels for RJE
NJE Operations
Remotes Without Consoles
$D PATHnodename
Using Sdsf Panels for NJE
$D Nxx.′$D NODEyy′
$D MNn,′Please drain your session′
455
Orientation for Utilities
IEBxxx or IEHxxx
DFSMSdss
DFSMSdss Storage Administration Reference, SC26-4929
457
Systems Management Philosophy and Methodology
VSE to OS/390 Migration Workbook
Systems Management Scope What Needs to be Managed?
Change Management Overview
Role of Automation
Methodology
Problem Management Overview
Tasks
Performance Management Overview
Methodology
Operations Management Overview
Methodology
Automating Operational Procedures
Security Management Overview
Configuration Management Overview
Methodology
Accounting Management Overview
Asset Management Overview
Summary
Problem Determination Tools
Diagnosing System Problems
Dumps
Ipcs
Analyzing Traces
Using Ipcs
Traces
Performance Tools
31.4 JES2 Diagnosis
Slip
Catalog Recovery
Analyzing Catalogs for Errors and Synchronization
DFSMS/MVS Diagnosis
DFSMSdfp
DFSMShsm
Checking a Vsam Ksds for Structural Errors
DFSMSrmm
Diagnostic Reference Publications
479
Part 7. Converting your Applications
VSE to OS/390 Migration Workbook
481
Conversion Process
∙ Refer to MVS MS Production Standards, LB11-8080
Conversion Process Introduction
Conversion Process
Secure OS/390 Skills
Prerequisites
Manuals
Migrate the SNA Network Early
32.1.3.6 24x7 Installations
Assumptions
Mass Conversion Overview / Benefits
Repetitive Conversion
Automated Conversion
Automation Limits
Mass Conversion Switchover
Mass Conversion Tools
Cortex MS
Automated Conversion Process
DMT DOS/OS/390 Translator
INT File Integration
EZ-PCL Easy PCL
Switch Switchover
Prep Preparation
ENV Environment
Translate the Languages/Programs
Inventory Validation
JCL Conversion Tools
File Transfer
Preparation Phases
Mass Conversion Phase Overview
∙ Implement System Managed Storage Dfsms
Phase 0 Project Management and Technical Leadership
Project Planning and Orientation
Phase 1 Application Inventory
Determination
Analysis and Resolution of Exceptions
Collection
Supply
32.4.3 OS/390 Standards and Naming Conventions
VSE to OS/390 Migration Workbook
Phase 2 Conversion Specifications
Analyze the VSE Source Material
Determine the Method to Get from Source to Target
Phase 3 Customization or Development of Conversion Tools
Design the MVS Target Output
Manual OS/390 Conversion
VSE Positioning
Program Conversion Considerations
Conversion Phases
Common VSE Coding Practices Causing Conversion Problems
Phase 4 Initial Trial Conversion
Phases of testing
Objectives of testing
Personnel Involvement in Testing
Testing Priorities
Responsibilities
Recommendations
Test Plan
MVS Tools Testing
Dasd Requirements
Subsystem Storage Protect
Conversion Process
32.5.4.4 OS/390 Automated Operations Tools
Unit Testing
Initialization Testing
Batch Unit Testing
Online Unit Testing
Data Migration in Unit Testing
Timing between Online and Batch Testing
Batch
System Testing
Online
Data Migration in Parallel Testing
Parallel/Production Simulation Testing
Data Migration in System Testing
Job Simulation
Implementation Phases
Date Concerns during Parallel Testing
Final JCL Conversion
Phase 6 Actual Conversion and Switchover
Converting the Development Material
Data/File Migration
Switchover
Final Program Conversion
Additional Switchover Tasks
Phase 7 Initial OS/390 Operations
Conversion Services IBM Global Services
Conversion Services and Tools
Automated Migration Services AMS
519
IBM OPTI-AUDIT for VSE
Conversion Tools 33.2.1 VSE/ESA Facilities
Product Details
Product Highlights
IBM Cobol and Cics Command Level Conversion Aid Ccca
Technical Description
Product Positioning
Sisro CORTEX-Migration System CORTEX-MS
Computer Associates
Source Recovery Company
CA-Convertor
CA-DUO
Cobol Recovery Example
Recovery/SRC
Rename/SRC
Reconcile/SRC
527
Part 8. Migration Experience
VSE to OS/390 Migration Workbook
Background
Customer Migration Example
Environment
Hardware
Resources
Inventory
Duration
Phase One
Phase Two
Benefits
533
Part 9. Appendixes
VSE to OS/390 Migration Workbook
535
Appendix A. Education Information
OEM Product Education
When are Courses Scheduled and When are they Needed?
Custom Classes
Who will Provide the Training?
Where will the Training Take Place?
VSE to OS/390 Migration Workbook
IBM Software Migration Project Office Smpo
Appendix B. Mapping ISV Products and Functions
VSE ISV System Management Products and OS/390 Compared
539
Idms
Appendix B. Mapping ISV Products and Functions
VSE to OS/390 Migration Workbook
543
Appendix C. Dfsms Naming Conventions
Data Set Naming Guidelines
High-Level Qualifier HLQ
Components of a Data Set Name
Appendix C. Dfsms Naming Conventions
Relative Importance
File Contents
Data Set Level
User Name
Things Not to Include in the Data Set Name
Department Number
Management Criteria
Application Location
Output Device Type
Expiration Date
Job Name
Access Method
Common Applications Naming Conventions
TSO Naming Conventions
3 DB2 Naming Conventions
Vsam Data Set Naming Conventions
Hlq.DSNDBx.dbname.tblspacename.I0001.A00n
DSNDBx is
C.GnnnnV00
Generation Data Sets
VSE to OS/390 Migration Workbook
553
Appendix D. Special Notices
Adstar
ACF/VTAM
AFP
AIX
VM/ESA VM/XA VSE/ESA Vtam
Following terms are trademarks of other companies
VSE to OS/390 Migration Workbook
International Technical Support Organization Publications
Appendix E. Related Publications
Other Redbooks
OS/390 Product Publications
2 OS/390 Online Product Library
Planning Books
Book Title Publication Number
SK2T-6700
Other Sources Books on the Internet
Other Publications
Redbooks on CD-ROMs
Redbooks 1.2 OS/390 Books IBM Printing Systems
VSE to OS/390 Migration Workbook
561
How to Get Itso Redbooks
How IBM Employees Can Get Itso Redbooks
∙ Telephone Orders
How Customers Can Get Itso Redbooks
∙ Mail Orders Ð send orders to
∙ Fax Ð send orders to
Please send me the following
IBM Redbook Order Form
VSE to OS/390 Migration Workbook
565
Glossary Numerics
VSE to OS/390 Migration Workbook
O s s a r y
Customer Information Control System CICS. An
O s s a r y
VSE to OS/390 Migration Workbook
File
Information Management System/Virtual Storage
Interactive Computing and Control Facility ICCF. An
Language/Product Days Since Dec-31
Language Environment Oct-14
VSE to OS/390 Migration Workbook
O s s a r y
Ordinal Day of Year. See Julian Date
O s s a r y
Rolling window. Synonymous with sliding window
Resource Access Control Facility RACF. An
O s s a r y
System management facilities SMF. See SMF
O s s a r y
Year2000 support. The ability to provide Year2000 readiness
583
List of Abbreviations
Recovery
Command List
Callable Services Library
Control Volume
Extended Common Service
Data Set Services
Environmental error Record
External Symbol Dictionary
Service Facility
Interactive Command Facility
Interactive Problem Control
Indexed Sequential Access
Series
Power END
Print Service Facility
Program Specification Block
Print Service Facility/6000
Queued Sequential Access
SQL Processor Using File
Service Planning Guide
System Services Program
SYStem ADMinistrator
Vsam Volume Data Set Facility
Volume Table of Contents
Vsam Volume Record
EXtended Recovery Facility
ACF/VTAM
Index Special Characters
591
Cancel
Ttimer
Apsrmark MVS
Aptrmark VSE
Index
Diagnostic reference 478 Language Environment 353 MQSeries
Batch TCP/IP 195 unit testing
PSF/MVS
Plicanc Plickpt Plirest
Cobol
Cics
Conversion CA-Convertor
Dadsm Dasd
Courses locations 537 schedules 536 when needed
CORTEX-MS
VSE to OS/390 Migration Workbook
Device Ditto
Entrypoint
E15 Exit Procedure
Data Division File Description FD
Associate
Gonumber
FBA Dasd
Filesec
Fortran
Idcams Iebcopy Iebgener
Isam
Ipcs
Isasize
Ismf Ispf
JES2
Limsconv
LE/VSE
Link
Liocs
Cortex MS
VS Fortran
356
Migration
TCP/IP
NJE
MVS device addresses 80 DFP
Operlog
Printing Operlog 394 Opsys routine 349 OPTI-AUDIT 79
MVS BCP
OS/390 NCP
Vtamlst 190 XCF
Piocs PL/I
PL/I
Syslog
394 SMF records 395 Softcopy books 412
RES/NORES
Project
Racf
RDO
TSO/E
Resources
371 VM/ESA
370 Risk management Risky VSE coding practices 504
Sort
Rexx
Fields
Icetool
VSE to OS/390 Migration Workbook
Index
VS Cobol II
BACKUP/RESTORE
Vsam
Btam
VSE/VSAM BACKUP/RESTORE & VSE
Delete Ignoreerror
OS/VS Cobol
Compress
Vtamlst
VSE Year2000
Please answer the following questions
Itso Redbook Evaluation
621
VSE to OS/390 Migration Workbook SG24-2043-00
XRL/1
XRL/2
Jmacp
XRL/3
XRL/4
XRL/5
XRL/6
XRL/7
XRL/8
XRL/9
XRL/10
Dittind
XRL/11
Operlog
XRL/12
Oploind
ACB
XRL/13
Smfpind
XRL/14
Power
DL/I
NJE
XRL/15
XRL/16
XRL/17
XRL/18
Vosind
XRL/19
Ctrind
Csysind
XRL/20
XRL/21
MVS BCP
XRL/22
Cortex MS
XRL/23
XRL/24
XRL/25
XRL/26
XRL/27