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