A Guide to JES3 to JES2 Migration

A Guide to JES3 to JES2 Migration

by Lydia Parziale, Luiz Fadel, Lutz Kuehner, Ricardo Paranhos
Released November 2019
Publisher(s): IBM Redbooks
ISBN: 9780738458205

Read it now on the O’Reilly learning platform with a 10-day free trial.

O’Reilly members get unlimited access to books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial

Book description

This IBM® Redbooks® publication provides information to help clients that have JES3 and want to migrate to JES2. It provides a comprehensive list of the differences between the two job entry subsystems and provides information to help you determine the migration effort and actions.
This book considers the features of JES2 as available on releases of IBM z/OS® V2R3 and V2R4. It should be used with JES3 to JES2 Migration Considerations, SG24-8083.
This publication is divided into three parts:


  • Part 1, "Planning to migrate from JES3 to JES2" on page 1, gives you information to make the decision and plan your migration.
  • Part 2, "Use case study" on page 111, provides a Use Case Study that is based on an actual customer experience in a successful migration.
  • Part 3, "Appendixes" on page 193, provides an appendix with sample tools that can help the migration process and exploitation of some of the new JES2 functions.

This book is aimed at operations personnel, system programmers, and application developers

Table of contents

  1. Front cover
  2. Notices
    1. Trademarks
  3. Preface
    1. Authors
    2. Now you can become a published author, too!
    3. Comments welcome
    4. Stay connected to IBM Redbooks
  4. Part 1 Planning to migrate from JES3 to JES2
    1. Positioning for migration
  5. Chapter 1. Why JES2?
    1. 1.1 Introduction
    2. 1.2 Job Entry Subsystem
    3. 1.3 JES2 availability
      1. 1.3.1 MAS members
      2. 1.3.2 JES2 resiliency
    4. 1.4 JES2 job management
      1. 1.4.1 Email Delivery Service
    5. 1.5 JES2 security
      1. 1.5.1 Data encryption
      2. 1.5.2 Passphrase support
    6. 1.6 JES2 and JES3 compatibility
  6. Chapter 2. Terminology differences
    1. 2.1 JES3 terminology
    2. 2.2 Different use of terms
      1. 2.2.1 Non-specific JES2 and JES3 references
      2. 2.2.2 Collections of JESes
      3. 2.2.3 JES startup processing
      4. 2.2.4 JES parameter statements
      5. 2.2.5 SYSOUT processors
      6. 2.2.6 Remote workstations
      7. 2.2.7 JES threads
      8. 2.2.8 Multiple JES2 instances
      9. 2.2.9 JES initialization statements
  7. Chapter 3. Convergence of JES2 and JES3
    1. 3.1 JES2 to JES3 compatibility
      1. 3.1.1 JES2 health monitor
      2. 3.1.2 JES initialization deck checker
      3. 3.1.3 JES2 Health Check for Checkpoint Reconfiguration
      4. 3.1.4 Job Execution Control
      5. 3.1.5 Deadline scheduling
      6. 3.1.6 Priority aging
      7. 3.1.7 Support to eight-character job class name
      8. 3.1.8 Disk Reader Support
      9. 3.1.9 JES2 Multi Job NJE Job Streams
      10. 3.1.10 JES2 //*ROUTE XEQ Support
    2. 3.2 JES2-only functions
      1. 3.2.1 Job correlator
      2. 3.2.2 SPOOL migration
      3. 3.2.3 Encrypting and compressing spool data sets
      4. 3.2.4 JES2 Policies
      5. 3.2.5 Instruction Execution Protection
      6. 3.2.6 z/OSMF asynchronous job notifications
    3. 3.3 JES3-only functions
      1. 3.3.1 Data Set Name disposition conflict resolution
      2. 3.3.2 Spool partitioning
      3. 3.3.3 Job class group
      4. 3.3.4 Printer naming conventions usage
      5. 3.3.5 Main Device Scheduling
      6. 3.3.6 JES3 device control and device fencing
  8. Chapter 4. JES2 functions to help migration
    1. 4.1 JES3 to JES2 migration options
    2. 4.2 Job Execution Control concept
      1. 4.2.1 Job group concept
      2. 4.2.2 Deadline scheduling
    3. 4.3 JES3 JECL processing support in JES2
      1. 4.3.1 Activating JES3 JECL support
      2. 4.3.2 //*NET support detail
      3. 4.3.3 //*ROUTE XEQ support detail
    4. 4.4 Privileged support
    5. 4.5 JES2 initialization data set checker
    6. 4.6 SMF 84 record support
    7. 4.7 Eight-character JOB CLASS and JOB CLASS GROUP support
      1. 4.7.1 JOB CLASS GROUP support
    8. 4.8 Interpreter after converter support
    9. 4.9 Functions similar to deadline scheduling
      1. 4.9.1 HOLDUNTL on SCHEDULE JCL statement
      2. 4.9.2 STARTBY on SCHEDULE JCL statement
      3. 4.9.3 WITH= on SCHEDULE JCL statement
    10. 4.10 SPOOL management
    11. 4.11 JES2 Disk Reader
      1. 4.11.1 SUBMITLIB concatenation
      2. 4.11.2 SUBMITRDR initialization statement
      3. 4.11.3 $SUBMIT command
    12. 4.12 JES2 Multi-Job NJE Stream
  9. Chapter 5. JES procedure and initialization decks
    1. 5.1 Introduction
    2. 5.2 Initialization statements
      1. 5.2.1 Verifying the JES initialization deck
    3. 5.3 JES procedures
      1. 5.3.1 JES2 procedure
      2. 5.3.2 JES3 procedure
      3. 5.3.3 Other procedures
    4. 5.4 Automation considerations
    5. 5.5 JES2 policies
      1. 5.5.1 Policy definition syntax rules
      2. 5.5.2 Policy type supported by JES2
      3. 5.5.3 Commands that are used to manage POLICYLIB
      4. 5.5.4 Commands that are used to manage policies
      5. 5.5.5 JES2 policy example
  10. Part 2 Use case study
  11. Chapter 6. Customer experience case study
    1. 6.1 Migration steps overview
    2. 6.2 Planning and assumptions
    3. 6.3 JES2 system design
    4. 6.4 Educating stakeholders
    5. 6.5 Removing and replacing JES3 exits
    6. 6.6 Transforming JES3 special functions
    7. 6.7 Transforming JCL and JECL
    8. 6.8 Migrating system automation
      1. 6.8.1 New JES2 messages
      2. 6.8.2 CKPT reconfiguration
      3. 6.8.3 Replacement for JES3 unique functions
    9. 6.9 Migrating security
      1. 6.9.1 JES3 prefixed profiles
      2. 6.9.2 New JES2 command profiles
      3. 6.9.3 SDSF and EJES considerations
    10. 6.10 Migrating your printer
      1. 6.10.1 FSS address spaces
    11. 6.11 Performance experience
      1. 6.11.1 CPU use comparison
      2. 6.11.2 Dynamic checkpoint
    12. 6.12 Hints and tips
      1. 6.12.1 JCL errors
      2. 6.12.2 S722 abends in JCL
      3. 6.12.3 Lost printer names after transfer
      4. 6.12.4 Monitoring default job class A
      5. 6.12.5 Monitor JES2 resources
      6. 6.12.6 Modifying JES3 OUTSERV
      7. 6.12.7 NJE performance
      8. 6.12.8 REXX SPIN
      9. 6.12.9 NJE parms for time differences
      10. 6.12.10 Print delays
      11. 6.12.11 APPC abends
    13. 6.13 Ready to migrate
      1. 6.13.1 Preparing your sysplex
      2. 6.13.2 Shutting down JES3 sysplex
      3. 6.13.3 Restarting sysplex with JES2 MAS until TSO
      4. 6.13.4 Preparing NJE connection to JES2 MAS
      5. 6.13.5 Starting SPOOL migration
      6. 6.13.6 JES2 test cases
      7. 6.13.7 Restarting subsystem
      8. 6.13.8 Releasing your BATCH
      9. 6.13.9 Quitting your JES2 license
    14. 6.14 Project considerations
      1. 6.14.1 Project organization
      2. 6.14.2 Project timeframe
  12. Part 3 Appendixes
  13. Appendix A. Sample JES3 exit to analyze JECL usage
    1. Sample JES3 user exit 33
  14. Appendix B. Comparison of JES3 and JES2 commands
    1. List of commonly used JES3 and JES2 commands
  15. Appendix C. Sample SMF84 Report program
    1. Source code of SMF84RPT program
  16. Appendix D. DJC conversion and JEC examples
    1. DJC conversion test results
    2. Using JES2 JEC
  17. Appendix E. SPOOL partitioning exits sample code
    1. E.1 Sample exits overview
    2. E.2 Exit 11 program source code
    3. E.3 Exit 12 program source code
    4. E.4 Other code used by exits
  18. Appendix F. Alternative conversion programs
    1. z/OSEM
    2. ThruPut Manager Automation Edition
  19. Appendix G. Additional material
    1. Locating the web material
    2. Using the web material
  20. Related publication
    1. IBM Redbooks
    2. Help from IBM
  21. Back cover

Product information

  • Title: A Guide to JES3 to JES2 Migration
  • Author(s): Lydia Parziale, Luiz Fadel, Lutz Kuehner, Ricardo Paranhos
  • Release date: November 2019
  • Publisher(s): IBM Redbooks
  • ISBN: 9780738458205