Professional Documents
Culture Documents
Control-M For OS/390 and z/OS: CA-7 Conversion Guide
Control-M For OS/390 and z/OS: CA-7 Conversion Guide
Supporting
CONTROL-M for OS/390 and z/OS Version 6.1.00
Telephone Fax
Copyright 2004 BMC Software, Inc. All rights reserved. BMC Software, the BMC Software logos, and all other BMC Software product or service names are registered trademarks or trademarks of BMC Software, Inc. IBM is a registered trademark of International Business Machines Corporation. DB2 is a registered trademark of International Business Machines Corporation. All other trademarks belong to their respective companies. BMC Software considers information included in this documentation to be proprietary and confidential. Your use of this information is subject to the terms and conditions of the applicable End User License Agreement for the product and the proprietary and restricted rights notices included in this documentation.
read overviews about support services and programs that BMC Software offers find the most current information about BMC Software products search a database for problems similar to yours and possible solutions order or download product documentation report a problem or ask a question subscribe to receive e-mail notices when new product versions are released find worldwide BMC Software support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbers
product information product name product version (release number) license number and password (trial or permanent)
operating system and environment information machine type operating system type, version, and service pack or other maintenance level such as PUT or PTF system hardware configuration serial numbers related software (database, application, and communication) including type, version, and service pack or maintenance level
s s s
sequence of events leading to the problem commands and options that you used messages received (and the time and date that you received them) product error messages messages from the operating system, such as file system full messages from related software
Contents
About This Guide About the Conversion Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conventions Used in This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 1 Conceptual Overview 11 12 13 16 19
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Triggering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prose Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Virtual Resource Management (VRM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M/Restart Automated Rerun and Restart Processing . . . . . . . . . . . . CONTROL-M Scheduling Table Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Production Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Production Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . New Day Processing and Schedule Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DEMAND[H] and POST Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workload Balancing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . JCL Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Special Override Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CA-DRIVER Procedures and JCL Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Network Communications Facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M Event Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chapter 2 Conversion Process Flow
20 21 22 22 23 24 24 25 25 26 27 28 28 28 30 31 33 34 35 35 36 37
39
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 JOB0 - Produce the CA-7 LJOB, LSCHD, Base Calendar and Job-to-Resource Reports 42 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 JOB1 - Produce the updated CA-7 LJOB Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Contents
Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 JOB3 - Create CONTROL-M Scheduling Tables and CMEM Rules . . . . . . . . . . . . . . 50 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 JOB4 - Convert JCL Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 JOB5 - Convert Virtual Resource Management Components . . . . . . . . . . . . . . . . . . . . 61 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 JOB6 - Update CONTROL-M Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 JOB7 Create CONTROL-M Group Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 JOB8 - Convert CA-DRIVER Procedures and JCL Libraries (Optional). . . . . . . . . . . . 66 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Chapter 3 Conversion Steps 69
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Pre-Conversion Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Step 1 - Create the Conversion SOURCE and LOAD Libraries . . . . . . . . . . . . . . . . . . 72 Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck . . . . . . 73 Step 3 - Modify and Run the JOB0 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Step 4 - Modify Parameters in the DEFAULTS Member . . . . . . . . . . . . . . . . . . . . . . . . 75 Step 5 - Modify and Run the ASMLINK Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Step 6 - Modify and Run the JOB1 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Step 7 - Modify and Run the JOB2 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Step 8 - Modify and Run the JOB3 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Step 9 - Modify and Run the JOB4 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Step 10 - Modify and Run the JOB5 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 Step 11 - Modify and Run the JOB7 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 Step 12 - Modify and Run the JOB8 Member (Optional) . . . . . . . . . . . . . . . . . . . . . . . . 84 Step 13 - Customize CONTROL-M and Install User Exits . . . . . . . . . . . . . . . . . . . . . . 85 Step 14 - Final Adjustments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
6 CONTROL-M for OS/390 and z/OS CA-7 Conversion Guide
Step 15 - Check Conversion Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Step 16 - Customize the New Day Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Chapter 4 Conversion Details 91
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Component Conversion Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Component Conversion Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 1. JOB and MEMBER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 2. JCLID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 3. SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 4. JCL-OVRD and # JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 5. VERIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 6. MAINT and # MNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 7. HOLD and DEMAND[H] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 8. EXEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 9. PRTY, # RES and DEMAND[H] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 10. COND-CODE, RO and # SCC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 11. TYPE1 and TYPE2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 12. CLASS, # RES and DEMAND[H] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 13. SCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 14. ROLL, INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 15. SBTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 16. DOTM and LDTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 17. Scheduling Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 18. Job Triggering and # NTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 19. DEP-JOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 20. DEP-JOB=/jobname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 21. DSN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 22. NWK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 23. USER REQUIREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 24. PROSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 25. Virtual Resource Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 26. # JI, # JO, and # JEND, # XI, # XO, and # XEND Statements . . . . . . . . . . . . . . . 117 27. JCL Job Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 28. DEMAND[H] and POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 29. CA-11 Non-Restartable Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 30. INSERT-RMS and //*CA-11 Comment Statements . . . . . . . . . . . . . . . . . . . . 122 31. CA-11 U11RMS Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 32. NXTCYC SET-OFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 33. RESCHNG and # RES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 34. This item number is not currently in use. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 35. OWNER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 36. SCHID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 37. JCL Initialization Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 38. SHOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 39. CMEM Rule Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 40. MAINID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 41. INITR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 42. JES ROUTE PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Contents 7
43. This item number is not currently in use.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 44. DEP-JOB=? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 45. DONT SCHEDULE BEFORE/AFTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 46. # HLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 47. # NOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 48. # MSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 49. # VER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 50. This item number is not currently in use.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 51. DPROC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 52. (D)STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 53. (D)GOTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 54. (D)SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 55. (D)IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 56. DATA, DEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 57. (D)NEST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 58. (D)ABORT/DFLUSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 59. Variable Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 60. Date Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 61. Attribute Functions (L, T) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Unique CONTROL-M Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 CATEGORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 DO SYSOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 MAXWAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Appendix A Conversion Parameters Appendix B Messages Appendix C Planning The Conversion 143 163 183
1: Organize the Conversion Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 2: Analyze Your Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 3: Consider Current Practices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 4: Read the Conversion Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Appendix D The CTMUTIL Conversion Utility Appendix E Interfaces With Related Products Appendix F Problem Reporting Index 191 193 195 197
Tables
Information in CMEM Rule for DATASET Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 Primary Jobs in the Conversion Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 JOB2 Control Statements Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 JOB2 Scheduling Table Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 JOB2 Base Calendar Name List Record Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 JOB3 JCL Job Class Translation Table Record Layout . . . . . . . . . . . . . . . . . . . . . . . . . . 53 JOB3 CPUID Translation Table Record Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Divided LIbraries Produced . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Parameters to Be Adjusted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Components of the CA-7 Job Definition Screen (JOB) . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Components of the CA-7 Job Scheduling Screen (SCHD, JOB) . . . . . . . . . . . . . . . . . . 94 Components of the CA-7 Job Triggering Screen (SCHD, JTRG) . . . . . . . . . . . . . . . . . 94 Components of the CA-7 Dataset Triggering Screen (SCHD, DTRG) . . . . . . . . . . . . 94 Components of the CA-7 Job Predecessor/Successor Screens (JOBCONN) . . . . . . . 94 Components of the CA-7 Documentation Screens (PROSE) . . . . . . . . . . . . . . . . . . . . 95 Components of the CA-7 Commands Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Components of the CA-7 Virtual Resource Management Screen (RM/RSRC) . . . . . 95 Components of the CA-7 Modification to Resolved Schedule Dates Screen . . . . . . . 95 Components of the CA-7 or CA-11 JCL Parameter, Statement, or Step . . . . . . . . . . . 96 Components of the CA-7 or CA-11 Initialization File Statement . . . . . . . . . . . . . . . 96 Components of the CA-7 CALENDAR Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Components of CA-7 Workload Balancing Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 CA-DRIVER Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 CA-7 $SCC Conversion Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 Scheduling Information Conversion Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Occasions for SHOUT Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Supported CA-DRIVER Reserved-Name Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 137 Site Date Format Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 Supported CA-DRIVER Date Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 Supported CA-DRIVER Attribute Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 Conversion Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 CA-DRIVER Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Tables
10
Appendix B Messages
Messages and codes of the conversion process
Index
builds CONTROL-M scheduling tables based on CA-7 database definitions and CA-7 and CA-11 JCL override statements builds all necessary CONTROL-M calendars builds CONTROL-M CMEM Rule Table definitions based on CA-7 data set triggering events converts CA-7 (scheduled) override statements, Batch Terminal Steps, and CA-11 U11RMS Steps in JCL libraries to CONTROL-M format converts CA-DRIVER libraries to CONTROL-M format enables customers to automatically set unique CONTROL-M options in the scheduling tables provides a set of independent utilities that can be very useful during and after the conversion process issues messages about problems and errors encountered in the CA-7 definitions
12
The conversion tool is delivered in source format. If special requirements exist, the conversion tool can be tailored locally.
WARNING
The commands, instructions, procedures, and syntax illustrated in this guide presume that the keyboards at your site are mapped in accordance with the EBCDIC character set. Certain special characters are referred to in this documentation, and you must ensure that your keyboard enables you to generate accurate EBCDIC hex codes. This is particularly true on keyboards that have been adapted to show local or national symbols. You should verify that
$ is mapped to x'5B' # is mapped to x'7B' @ is mapped to x'7C'
If you have any questions about whether your keyboard is properly mapped, contact your system administrator.
Preconfigured PFKeys
Many commands are preconfigured to specific keys or key combinations. This is particularly true with regard to numbered PF keys, or pairs of numbered PFKeys. For example, the END command is preconfigured to, and indicated as, PF03/PF15. To execute the END command, press either the PF03 key or the PF15 key. Instructions to enter commands may include
s s s
only the name of the command, such as, enter the END command only the PF keys, such as, press PF03/PF15 or both, such as, press PF03/PF15, or enter the END command
13
Names of Commands, Fields, Files, Functions, Jobs, Libraries, Members, Missions, Options, Parameters, Reports, Subparameters, and Users
The names of commands, fields, functions, jobs, libraries, members, missions, options, parameters, reports, subparameters, users, and most files, are shown in standard UPPERCASE font.
User Entries
In situations where you are instructed to enter characters using the keyboard, the specific characters to be entered are shown in this UPPERCASE BOLD text, for example, type EXITNAME.
Syntax statements
In syntax, the following additional conventions apply:
s
A vertical bar ( | ) separating items indicates that you must choose one item. In the following example, you would choose a, b, or c:
a | b| c
An ellipsis ( . . . ) indicates that you can repeat the preceding item or items as many times as necessary. Square brackets ( [ ] ) around an item indicate that the item is optional. If square brackets ( [ ] ) are around a group of items, this indicates that the item is optional, and you may choose to implement any single item in the group. Square brackets can open ( [ ) and close ( ] ) on the same line of text, or may begin on one line of text and end, with the choices being stacked, one or more lines later. Braces ({ }) around a group of items indicates that the item is mandatory, and you must choose to implement a single item in the group. Braces can open ( { ) and close ( } ) on the same line of text, or may begin on one line of text and end, with the choices being stacked, one or more lines later.
14
Screen Characters
All syntax, operating system terms, and literal examples are presented in this typeface. This includes JCL calls, code examples, control statements, and system messages. Examples of this are:
s
calls, such as
CALL CBLTDLI
s
system messages, both stand-alone, such as You are not logged on to database database_name, and those embedded in text, such as the message You are not logged on to database database_name, are displayed on the screen.
Variables
Variables are identified with italic text. Examples of this are:
s
In syntax or message text, such as Specify database database_name In regular text, such as replace database database_name1 with database database_name2 for the current session In a version number, such as EXTENDED BUFFER MANAGER for IMS 4.1.xx
Special elements
This book includes special elements called notes and warnings:
NOTE
Notes provide additional information about the current subject.
15
Related Publications
WARNING
Warnings alert you to situations that can cause problems, such as loss of data, if you do not follow instructions carefully.
Related Publications
CONTROL-D User Guide
A complete guide to CONTROL-D features, options and implementation.
16
Related Publications
Computer Associates International publications: CA-7 Database Maintenance Guide CA-7 Management Reporting Guide CA-7 Production User Guide CA-7 Systems Programmer Guide CA-7 System User Guide CA-7/NCF User Guide CA-7/RPT User Guide CA-11 Systems Programmer Guide CA-11 User Guide
IBM publications: JCL Reference System Codes System Messages (Volumes 1-5) Linkage Editor and Loader Using Datasets Utilities Assembler H Language Reference Assembler H Programmers Guide
17
Related Publications
18
Chapter
Conceptual Overview
This chapter includes the following topics: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Triggering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prose Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Virtual Resource Management (VRM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M/Restart Automated Rerun and Restart Processing . . . . . . . . . . . . CONTROL-M Scheduling Table Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Production Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Production Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . New Day Processing and Schedule Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DEMAND[H] and POST Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workload Balancing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . JCL Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Special Override Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CA-DRIVER Procedures and JCL Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Network Communications Facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M Event Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 21 22 22 23 24 24 25 25 26 27 28 28 28 30 31 33 34 35 35 36 37
Chapter 1
Conceptual Overview
19
Overview
Overview
This conceptual overview is intended for production control personnel who are familiar with CA-7 and CONTROL-M terminology. The CA-7 to CONTROL-M conversion tool is provided by BMC Software to assist in the creation of the primary product elements for CONTROL-M. It is designed to expedite the conversion process by automatically translating the most commonly built CA-7 scheduling elements into functionally equivalent processes in CONTROL-M. The following issues are described in this chapter:
s
Application Definition Logic used by the conversion tool for converting components of CA-7 application definitions to corresponding CONTROL-M components CONTROL-M Calendar Creation Logic used by the conversion tool for creating CONTROL-M calendars CONTROL-M/Restart Automated Rerun and Restart Processing Logic used by the conversion tool for automating rerun and restart processing as provided by CONTROL-M/Restart CONTROL-M Scheduling Table Creation Logic used by the conversion tool for creating CONTROL-M scheduling tables Production Control Issues important to daily production management, such as the New Day procedure, on-demand and temporary job scheduling, and workload balancing CONTROL-M Event Manager Logic used by the conversion tool for creating CONTROL-M CMEM rules JCL Processing Logic used by the conversion tool to convert CA-7 and CA-11 scheduled JCL override statements and steps, as well as JES statements, to CONTROL-M format. CONTROL-M support for the CA-7 Special Override library is also described. CA-DRIVER Logic used by the conversion tool to convert the CA-DRIVER components used to automate JCL and control card setup Network Communication Facility Describes CONTROL-M standard and extended NJE job tracking support
20
Application Definition
Application Definition
In CA-7, defining an application requires the use of numerous definition screens. These screens include:
s
the Job Definition (JOB) screen, used to define data related to CPU jobs the Job Scheduling (SCHD, JOB) screen, used to define the scheduling information of a job the Job Triggering (SCHD, JTRG) screen, used to define jobs that trigger other jobs the Dataset Triggering (SCHD, DTRG) screen, used to define data set events that trigger jobs the Job Predecessor/Successor Triggering (JOBCONN) screen, used to define job connections (prerequisites) the CPU Job Documentation (PROSE) screen, used to enter job-level documentation the Modification To Resolved Schedule Dates screen the Virtual Resource Management (RM) screen
In addition, numerous other components are required to complete the application definition. These include:
s
a CALENDAR Macro to define CA-7 Base calendars Workload Balancing macros to dynamically balance CPU work based on user-defined processing objectives the CA-7 Initialization file a User Option Table macro to define CA-11 requirement s
Chapter 1
Conceptual Overview
21
Application Definition
the Job Scheduling Definition screen (Screen 2) the IOA Conditions/Resources screen (Screen 4) the IOA Calendar facility (Screen 8) the CONTROL-M Event Manager (CMEM) (Screen C)
Each component of the CA-7 application definition is discussed in the following pages in relation to the management of corresponding components under CONTROL-M.
Job Definition
In CA-7, job definition is performed using the Job Definition (JOB) screen that contains information relevant to a specific job. Each job definition is a separate entity in the CA-7 database. CA-7 job definitions can specify JCL member names that differ from the name of the job. CA-7 forces the submitted job name to match the name of the defined job. In CONTROL-M, job information, such as scheduling criteria, runtime criteria, and so on, is stored in job scheduling definitions, and in Group Entities for Group scheduled jobs. Job scheduling definitions and Group Entities are defined using the Job Scheduling Definition screen, and are stored in partitioned data sets (PDSs) called scheduling table libraries. In CONTROL-M, job control is independent of the job name in the JCL JOB statement. CONTROL-M controls the job using the JCL member name, which is specified in the MEMNAME parameter of the CONTROL-M job scheduling definition. For more information, see 1. JOB and MEMBER on page 98 and 2. JCLID on page 99. In CONTROL-M, application job grouping is performed by defining, in one Group scheduling table, all related CA-7 jobs, that is, all jobs that have a triggering relationship.
Scheduling
In CA-7, after application jobs are defined as described in the preceding section, scheduling information is specified using the CPU Job Scheduling Parameter Edit (SCHD,JOB) screen. The schedule is determined by the first job of the application, referred to as the head-of-tree job. The remainder of the application jobs are associated with the head-of-tree job by means of triggering, which is discussed in the following section.
22
Application Definition
A CA-7 scheduled job can be defined with a number of different schedule IDs. Each schedule ID can define different scheduling dates, execution environments, sets of jobs, JCL statements, and so on. In CONTROL-M, jobs can be scheduled individually or can be included in a Group schedule. A job can be defined in several scheduling tables, or several times in the same scheduling table, with different scheduling criteria in each job scheduling definition. The conversion tool creates a Group scheduling table for each CA-7 job grouping. The Group Entity in the Group scheduling table is used to define sets of basic scheduling criteria to be applied to a Group of job scheduling definitions. Each set of basic scheduling criteria in the Group Entity is assigned a unique label, specified in the SCHEDULE TAG parameter, which is used for referencing that set of criteria. For more information, including details regarding the SCHEDULE TAG parameter, see 36. SCHID on page 125. For more information on Group scheduling, see the CONTROL-M for OS/390 and z/OS User Guide.
Job Triggering
In CA-7, job triggering is usually performed after the schedule IDs are defined, as described in the preceding section. Triggering defines the execution sequence of the application jobs. The CA-7 Job Triggering (SCHD,JTRG) screen is used to define a list of triggered jobs for a specific job. Job triggering can be limited to a specific schedule ID. SCHID=000 means that the triggered job is initiated by a job with any schedule ID. By default, the schedule ID of a job is passed to the triggered job unless otherwise specified in the TRGID parameter. In CONTROL-M, the execution sequence is controlled by means of prerequisite conditions. A prerequisite condition is a descriptive name given to a certain situation, event, or condition. The prerequisite condition is the basic mechanism used by CONTROL-M to control job execution flow. In CONTROL-M terminology, an IN condition is specified for a job when the job must wait for the occurrence of an event. A condition can be added to the IOA Conditions file when an event occurs, such as job completion. Conditions can be added or deleted after successful job completion, based on user specification, using the OUT statement of the job scheduling definition. For more information about prerequisite condition concepts, see the CONTROL-M for OS/390 and z/OS User Guide. Conditions are entities in their own right, since they are not related to specific jobs. A condition exists after it is added, and does not exist after it is deleted. When a condition is added, that condition is satisfied for all jobs specifying it as an IN condition. Conditions can be listed, added and deleted using the IOA Conditions screen (Screen 4).
Chapter 1
Conceptual Overview
23
Application Definition
Each prerequisite condition is associated with a specific scheduling date. This scheduling date is used to differentiate between different runs of the same job for different scheduling dates. CONTROL-M identifies conditions in the system that must be confirmed manually by operations personnel. These conditions are called manual conditions. Addition and deletion of manual conditions is performed in the IOA Manual Conditions screen (Screen 7). The conversion tool converts CA-7 job triggering, starting from the head-of-tree job, into CONTROL-M IN and OUT conditions, to establish the same application tree structure. The conversion tool takes into account the CA-7 schedule ID, as shown in the SCHID parameter, and the Triggering schedule ID, as shown in the TRGID parameter, when building an application tree structure that it converts to a CONTROL-M scheduling table.
Job Connections
In CA-7, the next stage of an application definition is to define specific job connections, which are prerequisite conditions, using the Job Predecessor/Successor (JOBCONN) screens. CA-7 distinguishes between various types of job connections. For example, a JDEP connection is an automatic dependency between one job and the completion of another job, while a USR connection is a descriptive text connection that requires manual operator intervention before the connected job can execute. In CONTROL-M, job connections are implemented using the same IN and OUT prerequisite condition mechanism discussed in Job Triggering on page 23.
Prose Information
In CA-7, documentation is specified in the documentation (PROSE) screens. In CONTROL-M, documentation is specified in the Job Scheduling Definition screen. The conversion tool copies CA-7 PROSE information into a member of a CONTROL-M documentation library, preparing it for viewing and/or updating in the Job Scheduling Definition screen.
24
Application Definition
resource control at the job, system, or step level job submission control for jobs that use shared or exclusive resources job corequisite requirements resource control for physical data sets, virtual data sets, or a group of data sets
In CONTROL-M, virtual resource management is implemented using Control resources, Quantitative resources, and manual IN conditions that are defined in the Job Scheduling Definition screen. If Virtual Resource Management is used at your site, the conversion tool converts the resource information and places it into CONTROL-M scheduling tables. For more information, see JOB5 - Convert Virtual Resource Management Components on page 61 and 25. Virtual Resource Management on page 115
CONTROL-M Calendars
In CA-7, Base calendar definitions must be assembled and link-edited into load modules. In CONTROL-M, calendar definitions are simply created online using the IOA Calendar facility (Screen 8). The CA-7 conversion tool automatically creates CONTROL-M calendars in several situations:
s
when you specify CA-7 Base calendars in JOB1, as discussed in Step 3 - Modify and Run the JOB0 Member on page 74 when a CA-7 job has the SCHDMOD CURRENT indicator set in its scheduling information when CA-7 job schedule parameters cannot be consistently converted to CONTROL-M basic scheduling parameters when non-standard, periodic, calendars are converted to standard calendars
Chapter 1
Conceptual Overview
25
Application Definition
manual modification of the JCL of the job, by changing the PARM of the U11RMS step or inserting a //*CA-11 comment statement, or issuance of online commands (PRE)
In contrast, CONTROL-M/Restart is a fully automated rerun and restart system that is tightly integrated with CONTROL-M. It normally requires no manual intervention, unless you specify manual confirmation. Definition of CONTROL-M/Restart processing is performed by means of parameters defined in the job scheduling definition for the job. This consolidates and simplifies the job scheduling and restart process. The following fields in the CONTROL-M Job Scheduling Definition screen determine the processing to be performed by CONTROL-M/Restart:
s s s s
In addition, it is possible to override the default CONTROL-M/Restart parameters by using control parameter members in the library allocated to the DACTRCTL DD statement of the CONTROLR step. For more information, see the CONTROL-M/Restart User Guide. One option that many CA-7 conversion sites specify is NORECAPTABEND, which prevents automatic abend code recapture. For more information on how CA-11 PARM parameters are converted to CONTROL-M/Restart parameters, see 31. CA-11 U11RMS Step on page 123
26
The CONTROL-M/Restart Simulation facility, which corresponds to the CA-11 PSEUDO=YES processing option, enables you to see what actions will be taken by CONTROL-M/Restart without actually performing a restart. CONTROL-M/Restart also has an interface with a Tape Management System similar to the CA-11/CA-1 or the CA-11/CA-DYNAM/CA-TLMS interface. For more information, see the CONTROL-M/Restart User Guide, and the CTRX001 sample Exit in the IOA SAMPEXIT library.
a job that is scheduled, that is, a job that contains scheduling information, or a job that is not scheduled or triggered by another job
If a head-of-tree job is scheduled, the tree of this job is called a scheduled tree. Otherwise, it is called an independent tree, usually defined in CA-7 for special purpose or on-demand execution. These trees can contain one or more jobs based on triggering information. All CA-7 job trees are converted to CONTROL-M Group scheduling tables with the head-of-tree job name assigned to the CONTROL-M scheduling table.
NOTE
The conversion tool does not necessarily place the converted jobs into the job scheduling table in alphabetical order. An on-line CONTROL-M SORT command can be used to sort jobs in scheduling tables if necessary.
Chapter 1
Conceptual Overview
27
Production Control
Production Control
In CA-7, numerous online transactions are required to achieve production control. These transactions access CA-7 queues in order to assist in tracking and controlling the daily production environment. Example transaction types include:
s
the LQ transaction and its subsets, used to track production jobs the XQ transaction, used to change production control parameters, such as posting a prerequisite condition the FSTRUC transaction, used to forecast job flow structures
Under CONTROL-M, production tracking and control is performed using one screen the Active Environment screen (Screen 3).
Production Management
CA-7 manages production jobs using a set of queue files. When a production job is to be executed, it is loaded into the Request Queue where its prerequisites are handled. After all prerequisite conditions are satisfied, the job is moved to the Ready Queue where it waits to be submitted for execution based on physical resource availability, such as initiator, tape drives, and priority. When job execution starts, the job is moved to the Active Queue where CA-7 monitors its execution. Additional CA-7 queues manage statistics, JCL decks, and so on. In CONTROL-M, production tracking and control is managed using a single file, the Active Jobs file (AJF). When a job is scheduled or FORCEd (demanded), CONTROL-M loads its definition to the AJF. The AJF is then used to track and control the life cycle of the job. Access to the AJF is provided using the Active Environment screen (Screen 3), which enables you to monitor, track, and control the entire life cycle of a job. Using this screen, you can see the status of the job, hold the job in order to modify its definition, free the job for execution, view the sysout of the job, browse the Log information relating to the job, display predecessor and successor job chains and network dependencies, perform deadline scheduling tasks, and carry on a variety of other activities.
Production Control
to define a logical workday that begins at a specified time. Other scheduling products, such as CA-7, begin every workday at the first moment of a new calendar day. The CA-7 schedule scan process scans the database looking for production jobs that require scheduling during the next interval. These jobs are then added to the Request Queue. CA-7 schedules the jobs based on the job scheduling definition and on the machine date, which changes at midnight. The CONTROL-M CA-7 conversion tool is designed to convert CA-7 scheduling data so it can be used in CONTROL-M scheduling. The following example illustrates how the CA-7 scheduling method is converted to the CONTROL-M scheduling method.
Figure 1 New Day Processing Example
The above example assumes that your logical business date changes at 8:00 A.M. You want to take a job scheduled in CA-7 to begin at 4:00 A.M. on March 15th, and convert it to be run as a CONTROL-M job. The conversion tool converts this CA-7 job to a CONTROL-M job that begins at 4:00 A.M. on the March 14th logical business day.
NOTE
CONTROL-M enables you to define logical workdays that begin at a time best suited to the scheduling requirements of your organization, without being subject to the limits that might be imposed by strict adherence to calendar days. The conversion tool handles this difference automatically. For more information, see Step 13 - Customize CONTROL-M and Install User Exits on page 85
Chapter 1
Conceptual Overview
29
Production Control
30
Production Control
Workload Balancing
In CA-7, the Workload Balancing facility dynamically balances CPU work based on user-defined processing objectives. The Workload Balancing facility analyzes jobs awaiting execution, and sets priorities for jobs submitted based on the following criteria:
s s s s s
job start times CPU usage tape drive usage initiators and job class structure threshold priorities
In CONTROL-M, maximizing throughput is achieved through the specification of Quantitative resources (using the RESOURCE job definition parameter and the CONTROL-M Resources file), job priority, and the CTMRELRS utility. In addition, you can implement the Dynamic Tape Drive Quantity Adjustment feature, using the AUTOTAPE parameter in the CTMPARM member in the IOA PARM library. The conversion tool converts the following CA-7 Workload Balancing entities to CONTROL-M RESOURCE and PRIORITY parameters:
s s s s s
initiators class barriers class and priority specified in the CA-7 JCL # RES override statement class and priority specified in the CA-7 DEMAND[H] command tape drives, class, and priority specified in the CA-7 Job Definition screen
Tape drives, class, and priority specifications coded in the CA-7 Job Definition screen serve as initial Workload Balancing values. These initial values can be overridden by values specified in
s s s
the RESCHNG command the # RES JCL override statement the DEMAND[H] command
Tape drives specified in CA-7 JCL batch RESCHNG commands and # RES override statements are converted to input parameters for the CTMRELRS utility, to change Quantitative resources. The RESCHNG command and the # RES JCL override statement are discussed in Command RESCHNG and # RES JCL Override Statement on page 32.
Chapter 1
Conceptual Overview
31
Production Control
Class Barriers
CA-7 Class Barriers establish the maximum number of jobs that can be submitted concurrently in an associated job class. For more information on how class barriers are converted to CONTROL-M Resources, see 12. CLASS, # RES and DEMAND[H] on page 104.
DEMAND[H] Commands
You can also use the DEMAND[H] command to change the high-water Workload Balancing resource requirements of a job. For more information, see Table 11 on page 94.
32
Production Control
WLBPDEF MODNAME=xxx TAPE1 NAME=TAPE1,MXTAL=25 TAPE2 NAME=TAPE2,MXTAL=15 INITR TOTAV=10 CLBARR BARA=5,BARB=1,BAR2=3 WLBEND
NOTE
You can use CONTROL-M Exit CTMX004 to assign weights to Quantitative resources, to fine-tune the scheduling algorithm.
All resources referenced by a CHANGE RESOURCE statement must already exist in the CONTROL-M Resources file. The CA-7 /WLB command can be similarly converted to a CHANGE RESOURCE statement. A summary of available CA-7 resources is provided by the CA-7 LWLB command.
JCL Considerations
CA-7 provides the capability to specify special scheduled JCL override statements. These override statements enable you to perform the following functions:
s s s s s s s
modify workload balancing resource requirements define step-level condition code checking criteria set various types of manual requirements make runs non-executable turn off job triggering send messages at job submission time dynamically tailor run-stream contents based on schedule ID, date, and time
Chapter 1
Conceptual Overview
33
Production Control
These functions are specified by the CA-7 JCL # statements and are converted to CONTROL-M AutoEdit statements, job scheduling definition parameters, or CONTROL-M batch utilities. For more information on how each of these statements is converted, see the component conversion summary in Chapter 4, Conversion Details. In addition, CA-7 commands can also be included in JCL Batch Terminal steps. For details of how they are converted, see DEMAND[H] and POST Commands on page 30, and Command RESCHNG and # RES JCL Override Statement on page 32. If you are also converting from CA-11, the CA-11 U11RMS JCL steps and comment statements are analyzed for restart and rerun information. These steps and statements are incorporated into CONTROL-M/Restart Job Scheduling parameters. For more information, see 31. CA-11 U11RMS Step on page 123. Standard JES JCL statements such as ROUTE PRINT are also processed by the conversion tool. For more information, see 42. JES ROUTE PRINT on page 130.
the discussion of the OVERLIB parameter in the CONTROL-M for OS/390 and z/OS User Guide the discussion of the DELOVRER parameter in the CONTROL-M chapter of the INCONTROL for OS/390 and z/OS Installation Guide the CTMIMACx source members in the IOA CLIST library.
34
Production Control
When these statements are encountered, the conversion tool searches the converted CA-DRIVER procedure library for a member name matching the procname (procedure name). If the member name is found in the converted procedure library, the EXEC card is replaced with CONTROL-M AutoEdit %%INCLIB and %%INCMEM control statements that copy the converted procedure member to the current job stream. If the member name is not found in the converted procedure library, the EXEC card remains unchanged. For more information, see Table 24 on page 103.
Chapter 1
Conceptual Overview
35
Production Control
In addition to the previously described standard and extended support provided by CONTROL-M, the conversion tool converts the CA-7 MAINID parameter. This parameter is used to specify a CPU from which JES can transmit a job to the proper remote node. The conversion tool provides a sample exit that inserts one of the following into the JCL stream of the job:
s s
For more information, see 40. MAINID on page 129 and Step 14(5) in Chapter 3, Conversion Steps.
Data set that causes the triggering event. Indication that all jobs and started tasks are to be monitored for the event. Any of the following dispositions of the data set trigger the event: CATLG, UNCATLG, KEEP, DELETE, RETAIN (SMS), SCRATCH (SMS). Upon the occurrence of the event, CONTROL-M adds a prerequisite condition. The condition name is in the form @dsn where dsn is the first 19 characters of the data set name. CONTROL-M working date associated with the added condition.
ACTION=DO COND
DATE=ODAT
36
Production Control
The action is performed at the end of the step in which the event occurs only if the step completes successfully. The conditions added by the CMEM facility correspond to IN conditions created by the conversion in jobs that require these data sets as prerequisites.
NOTE
For CMEM to monitor DATASET events for a job or started task, the JOB card in the JCL of the job or started task must contain the MSGLEVEL=(1,1) parameter, and the IEF403I or IEF125I message must appear in the Job log. For additional information regarding the CMEM facility, see the CONTROL-M for OS/390 and z/OS User Guide.
Customization
To customize the way in which the conversion process operates, consider using the following options:
s
the conversion parameters described in Appendix A, Conversion Parameters the CTMTBUPD CONTROL-M utility, which performs post-conversion mass updates on Job Scheduling Table parameters
Chapter 1
Conceptual Overview
37
Production Control
38
Chapter
Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 JOB8 - Convert CA-DRIVER Procedures and JCL Libraries (Optional). . . . . . . . . . . . 66 Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
40
Overview
Overview
This chapter describes in detail the components of the conversion process from the perspective of jobs, programs, and data sets. A familiarity with the conversion process will help you understand the conversion logic and the installation and operation steps discussed in Chapter 3, Conversion Steps. The process is comprised of the following primary jobs:
Table 2 Job Primary Jobs in the Conversion Process Description
Produces the CA-7 LJOB, LSCHD, Base Calendar, and Job-to-Resource Cross Reference reports Produces the updated CA-7 LJOB report Creates the Applications list, CONTROL-M Calendar library, and Calendar Names List files Creates intermediate CONTROL-M scheduling table library and CMEM rules Converts JCL members Converts resource management components Updates the CONTROL-M scheduling tables (optional) Converts the CONTROL-M scheduling tables created in JOB3 to Group Scheduling format Converts CA-DRIVER procedure and JCL libraries
41
JOB0 - Produce the CA-7 LJOB, LSCHD, Base Calendar and Job-to-Resource Reports
JOB0 - Produce the CA-7 LJOB, LSCHD, Base Calendar and Job-to-Resource Reports
Description
JOB0 produces the CA-7 LJOB, LSCHD, Base Calendar, and Job-to-Resource Cross Reference reports, and writes the reports to disk for subsequent use. JOB0 utilizes the CA-7 Batch Terminal mechanism. This job may require several hours for processing, due to the manner in which CA-7 communicates with Batch Terminals.
Input
The following commands are executed to obtain the information needed by the conversion tool: 1. The CA-7 command LJOB,JOB=*,LIST=NODD is used to retrieve job and scheduling information from the CA-7 database.
NOTE
For CA-7 Release 2.9 and earlier, specify LIST=ALL instead of LIST=NODD.
2. The CA-7 command LSCHD,JOB=*,LIST=BYSID is used to retrieve scheduling information from the CA-7 database. If you set the value of JOB to anything other than * (Asterisk), the value you choose must exactly match that used in the CA-7 LJOB command (immediately above). 3. The CA-7 PRINT commands are used to retrieve Base calendar information from the CA-7 database. Use one PRINT command for each CA-7 Base calendar identified in the CALBLK statement of the CA-7 Initialization file. The form of the command is PRINT,YEAR=yy,SCAL=xx
42
JOB0 - Produce the CA-7 LJOB, LSCHD, Base Calendar and Job-to-Resource Reports
where
s s
yy is the year of the calendar xx are the last two characters of the CA-7 calendar name
NOTE
Multiple PRINT statements can be specified for the same calendar, each for a different year. In addition, CA-7 Base calendars can be non-standard periodic calendars. 4. For CA-7 Release 3.0 or earlier, if the CA-7 Virtual Resource Management facility is installed, the LXRSC command must be used to produce the Job-to-Resource Cross Reference report. For CA-7 Release 3.1 and later, the commands RM.2 followed by LIST,RM.2,RSRC=* are used to produce this report.
Output
1. The LJOB report file Default file name: CTM.CA7.REPORT File characteristics: sequential; record length 133; block size 23408 2. The LSCHD report file Default file name: CTM.CA7.SCHED File characteristics: sequential; record length 133; block size 23408 3. The Base Calendar report file Default file name: CTM.CA7.BASECAL File characteristics: sequential; record length 133; block size 23408 4. The Job-to-Resource Cross Reference report file Default file name: CTM.CA7.RESOURCE File characteristics: sequential; record length 133; block size 23408
43
Parameters
The number of jobs contained in the LJOB report must be specified in the JCL PARM parameter of the EXEC statement of STEP5 in this job. This value must be equal to, or greater than, the number of jobs to be processed.
NOTE
The REGION parameter must be set to 0K in the EXEC statement. Because approximately 1.5 KB of virtual storage above-the-line is required by the program for each job in the LJOB report, the user must ensure that this job is not limited by the amount of above-the-line storage available to it (such as when using the IEFUSI SMF exit).
Input
1. The LJOB report file created by JOB0 2. The CA-7 Initdeck Initialization File statements The CA-7 Initdeck Initialization File is described on page 51.
NOTE
For performance reasons, any JCL libraries that do not contain DEMAND commands should be removed from this file for the duration of JOB1 only. For details of these commands, see 28. DEMAND[H] and POST on page 120.
44
Output
1. The updated LJOB report file. Default file name: CTM.CA7.LJOBO File characteristics: sequential; record length 80; block size 23440 2. List of the jobs that require auxiliary calendars. Default file name: CTM.CA7.JOBSCH File characteristics: sequential; record length 11; block size 27995
45
JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files
JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files
Description
JOB2 reads the LJOB report file created by JOB1 and produces a list of all defined head-of-tree job names that are used as a basis for CONTROL-M scheduling table names. JOB2 reads the LSCHD and Base Calendar reports created by JOB1, and produces the CONTROL-M Calendar library and the Calendar Names List file. For more information, see CONTROL-M Calendars on page 25. The Calendar Names List file is used in JOB3 to assign calendar names to the CONTROL-M DCAL scheduling parameter when any of the following events occur:
s s
SCHDMOD CURRENT processing is requested inconsistencies exist between CA-7 scheduling definitions and CONTROL-M basic scheduling parameters non-standard CA-7 calendars are converted to standard CONTROL-M calendars
Input
1. The LJOB report file created by JOB1 2. The LSCHD report file created by JOB0 3. The Base Calendar report file created by JOB0 4. List of jobs requiring an auxiliary calendar created by JOB1 5. The non-standard (Periodic) Base Calendar definitions This user-defined SYSIN file specifies the beginning and ending days of the non-standard (periodic) months for each periodic calendar produced in the Base Calendar report. The format of the control statements is shown in Table 3.
46
JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files
Table 3 Position
0148 5051
Twelve pairs of 2-digit beginning and ending days for each of the twelve non-standard months in the calendar. Calendar name (that is, the xx portion of SCALyyxx).
Example
For calendar AA, B01=25, E01=23, B02=26, E02=21, B03=23, E03=29, and so on.
Column: Code: ----1----2----3----4----5----6 //SYSIN DD * 252326212329...
AA
NOTE
For non-standard calendars, if the gap between the first day of two consecutive, non-standard calendar months exceeds a regular calendar month, the non-standard calendars must be manually converted. However, a dummy entry must still be made in the SYSIN file for this calendar.
Output
1. The Message Report file 2. The Applications List file This contains a list of CA-7 head-of-tree job names with corresponding CONTROL-M scheduling table names to be assigned. Default file name: CTM.CA7.APPLS File characteristics: sequential; record length 80; block size 3120
Record Layout
Table 4 Column JOB2 Scheduling Table Layout (Part 1 of 2) Description
CA-7 head-of-tree job name. CA-7 schedule ID. 000 indicates an independent or special purpose job. Intermediate CONTROL-M scheduling table name.
47
JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files
Table 4 Column
4148 5158 61
The CONTROL-M scheduling table name. By default, this is the head-of-tree job name. The CA-7 system name. Indicates whether the head-of-tree is scheduled. Valid values are:
s
' ' (Blank) the head-of-tree is scheduled X the head-of-tree is not scheduled.
65
Whether SCHDMOD CURRENT calendar processing is manual or automatic. The SCHDMOD CURRENT indicator is globally set by the &SCHDMOD conversion parameter. You can individually set the SCHDMOD CURRENT indicator for each scheduled application by editing column 65 of this file. Valid values are:
s
Y (Yes) processing is automatic Some job scheduling information is modified for all jobs in the application for which a SCHDMOD CURRENT calendar has been created, as described in 13. SCAL on page 105. N (No) processing is manual The original job scheduling information is retained in the job scheduling definition.
An editor can be used to modify only the scheduling table names (columns 41 through 48), and the SCHDMOD CURRENT indicator. When editing, it is important to ensure that the scheduling table names remain unique, valid PDS member names.
WARNING
Do not delete any records from this file.
48
JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files
3. The CONTROL-M Calendar library containing the Base calendars and Auxiliary CONTROL-M calendars, including SCHDMOD CURRENT calendars Default library name: CTM.V600.CALENDAR Library characteristics: PDS; record length 80; block size 3120 The format of Auxiliary calendar names is xynnnnnn, where
s s s
x is ,T,...,Z y is A-Z nnnnnn is CA-7 DSNBR, the database schedule member number that was assigned to the schedule when it was added to the CA-7 database
For more information on Auxiliary calendars, see 13. SCAL on page 105. 4. The Calendar Names List file containing a list of calendar names and related information, sorted by job name, schedule ID, and system name Default file name: CTM.V600.CALNAMES File characteristics: sequential; record length 30; block size 9030 This file is for internal system use only. Do not modify it. 5. The SCHDYONLY and Periodic Base Calendar Name List file This contains a list of all CA-7 calendar names that were created with OPTION set to SCHDYONLY, using the CA-7 CALENDAR macro, or that are defined as nonstandard in the SYSIN file. Default file name: CTM.V600.DACALS File characteristics: sequential; record length 10; block size 100 For more information, see Item 4 in Input on page 46.
Record Layout
Table 5 Column JOB2 Base Calendar Name List Record Layout Description
0108 09 10
CA-7 Base Calendar name. P if a non-standard (Periodic) calendar. Reserved for future use.
49
reads the LJOB report file created by JOB1 For every CA-7 job, JOB3 extracts all information relevant to the conversion. The JCL member for each job is read in order to process CA-7 or JCL override control statements that may affect the scheduling process, such as JCL job class, DEMAND[H], and # SCC.
creates intermediate CONTROL-M scheduling tables JOB3 also produces a cross-reference file that contains all converted CA-7 job names and associated CONTROL-M scheduling table names.
creates a CMEM rules table for jobs triggered by DATASET events JOB3 activates the CTMCA702 program. The source code for this program resides in the conversion SOURCE library, and can be tailored locally.
NOTE
The CTMCA706 program is called to scan the CA-7 JCL members. Local modification may be required if the DEMAND[H] statement is not used in the standard CA-7 manner.
Parameters
The number of jobs contained in the LJOB report must be specified in the JCL PARM parameter of the EXEC statement of STEP2 in this job. This value must be equal to, or greater than, the number of jobs to be processed.
50
NOTE
The REGION parameter in the EXEC statement must be set to 0K. Because approximately 1.5 KB of virtual storage above-the-line is required by the program for each job in the LJOB report, the user must ensure that this job is not limited by the amount of above-the-line storage available to it (such as when using SMF exit IEFUSI).
Input
1. The LJOB report file (created by JOB1) 2. The Applications List file (created by JOB2) 3. The SCHDYONLY and Periodic Base Calendar Name file (created by JOB2) 4. CA-7 Initdeck Initialization File statements These are used for several purposes: A. The conversion tool determines which JCL libraries to access using the following Initialization File statement:
JCL,DSN=dsname,INDEX=nnn[,ALT=mmm]
where dsname must reference the data set names of the copies of the JCL libraries. For more information, see Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck on page 73. If no JCL library names are found in the CA-7 Initdeck, JCL library processing is bypassed. The copied JCL libraries must be cataloged. CA-7 jobs are contained within specific JCL libraries. The library names are used in specifying the CONTROL-M MEMLIB parameter, as described in 2. JCLID on page 99. When converting job definitions of jobs in libraries with many members, you may be able to improve performance by avoiding mass allocations and deallocations. You can do so by programming the conversion tool to specify GENERAL as the value of the MEMLIB parameter, rather than the CA-7 JCL library name. To do this, you should change the Initialization File statement in relation to each of these JCL libraries, by doing the following, in order:
s
Instead of the statement set out at the beginning of this section, use the following statement:
JCL,DSN=dsname,INDEX=nnn[,ALT=mmm],GENERAL
Chapter 2 Conversion Process Flow 51
Code a DALIB DD statement in the CONTROL-M procedure. Concatenate all these JCL libraries in the DALIB DD statement.
For information about on-line considerations, see the description of the MEMLIB parameter in the parameters chapter of the CONTROL-M for OS/390 and z/OS User Guide. B. The conversion tool determines which job entry subsystem (JES) is in use at the site using the following Initialization File statement: CPU, HOST=JESn,... where n is 2 or 3 C. The conversion tool obtains information on CA-11 using the following Initialization File statement
RESTART,RMS=xxx,PROCRMS=procname,STEPRMS=stepname, PARMRMS=parm
31. CA-11 U11RMS Step on page 123 &PRVNCT2 on page 155 &CTR on page 144
5. Dynamically allocated CA-7 and CA-11 JCL libraries (derived from the CA-7 Initdeck Initialization File statements), used to process CA-7 and/or CA-11 control statements 6. Calendar Name List file (created by JOB2) 7. JCL Job Class Translation Table containing a list of all JCL job classes for which Quantitative resource statements are to be created This file is only needed if the JCL job classes in the JOB statement are to be converted into CONTROL-M Quantitative resources. For more information, see &JOBCLAS on page 152. The table must be a card-image (LRECL=80) or in-stream file. The layout of each record in the Job Class Translation Table is as set out in Table 6.
52
Table 6 Column
01 02
JCL job class. For more information, see Table 7JOB3 CPUID Translation Table Record Layout on page 53. Generic resource name indicator Valid values are:
s
For more information, see Table 7JOB3 CPUID Translation Table Record Layout on page 53. 03 11 User-specified text to be used as the CONTROL-M Quantitative resource name.
The first column of the Translation Table must be in ascending alphabetic order. An asterisk (*) in the first position of the first row indicates that the JCL job class must be used as the resource name for any JCL job class that is not listed in the table, or for which no user text is specified in the table. A dollar sign ($) in the second position, including after the asterisk in the first row if desired, indicates that a $ sign is appended to the resource name. For the significance of the $ mask character, see the description of the RESOURCE conversion parameter in the CONTROL-M for OS/390 and z/OS User Guide.
8. The CPUID translation table This contains a list of all the CA-7 MAINIDs and the corresponding system IDs. It is used by sample Exit 2 to add JES2 (JOBPARM) or JES3 (MAIN) statements into the converted CA-7 JCL job streams when necessary. This is accomplished using the SET VAR parameter and the AutoEdit variable %%SYSID in the job scheduling definition. For more information, see 40. MAINID on page 129. The layout of each record in the CPUID Translation Table is shown in Table 7.
Table 7 Column JOB3 CPUID Translation Table Record Layout Description
1 25
53
Output
1. The CONTROL-M Intermediate Scheduling Table library Default library name: CTM.V600.SCHEDULE Library characteristics: PDS; record length 80; block size 3120 2. The CONTROL-M Documentation library Default library name: CTM.V600.DOCUMENT Library characteristics: PDS; record length 80; block size 3120 3. A global cross-reference file for all jobs and intermediate scheduling tables, which can be used to determine the names of the scheduling tables in which a specific job resides Default file name: CTM.CA7.XREF File characteristics: sequential; record length 80; block size 3120
NOTE
The CONTROL-M CTMXRF utility can be used to create an updated cross-reference file on the final scheduling tables created in JOB7.
4. A file containing all conversion exception messages 5. A file containing JCL for the New Day procedure, which must be customized Default file name: CTM.V600.DAILY File characteristics: sequential; record length 80; block size 3120 6. An Include library, containing all job names for which the JCL member name differs from the job name Default file name: CTM.V600.INCLIB File characteristics: PDS; record length 80; block size 3120 7. The CONTROL-M CMEM rule table, containing data set triggering events Default file name: CTM.V600.CMEM File characteristics: sequential; record length 80; block size 9040
NOTE
This file must be specified as a member within a CONTROL-M CMEM rule table library. The member contains a CONTROL-M rule table specifying ON DSNEVENT rules. 8. The JCL Library DSN list This contains a list of all the modified JCL Library data set names extracted from the CA-7 Initdeck Initialization file. Default file name: CTM.V600.JCLIN File characteristics: sequential; record length 44; block size 8800
54 CONTROL-M for OS/390 and z/OS CA-7 Conversion Guide
9. The Demanded Job Names file Default file name: CTM.CA7.DMDJOBS File characteristics: sequential; record length 8; block size 9072 10. A file from which appended scheduling tags are added to job scheduling definitions when CA-7 basic scheduling criteria are too complex to correspond to a single CONTROL-M scheduling tag Default file name: CTM.CA7.DATAG File characteristics: sequential; record length 60; block size 23460 11. A file containing utility control statements for the CTMBLT utility These statements are used to create to create the CONTROL-M Intermediate Scheduling Table library (described earlier in this list of Output files) File characteristics: sequential; record length 80; block size 27920
55
NOTE
The CTMCA709 program is called to perform modifications to the JCL members containing CA-7 Batch Terminal Steps. Local modification may be required if the CA-7 Batch Terminal Step is not used in the standard CA-7 manner.
Input
1. Dynamically allocated copies of CA-7 and/or CA-11 JCL libraries 2. The JCL library DSN list, created by JOB3 3. A Batch Terminal Parameter file The Batch Terminal Parameter file provides information on how the conversion tool is to convert CA-7 Batch Terminal Steps. The format of the Batch Terminal Parameter control statements is:
BTERM=batch-terminal-name[,PARM=parm-parameters]
56
s s s
They must begin in column 1 and be separated by commas with no intervening blanks. They must be contained on one line. BTERM is a mandatory subparameter. PARM is an optional subparameter.
One Batch Terminal Parameter control statement is required for each Batch Terminal PROC used in the CA-7 JCL libraries. A maximum of 10 control statements is allowed. The value of the batch-terminal-name subparameter is the program or procedure (PROC) name of the CA-7 Batch Terminal Step, such as SASSTRLR or U7VSC. There is no default. The value of the parm-parameter subparameter can be set by one of the following methods:
s
Specify the JCL PARM parameter designation used in the CA-7 Batch Terminal procedure. The default is PARM=PARM Indicate that the CA-7 Batch Terminal procedure is issuing a CA-7 DEMAND or POST command, use the JCL PARM parameter, and display symbolic variables for various subparameters of the command.
The type of CA-7 command, and the symbolic variable names, are specified in the control statement, using the following syntax:
PARM=(command-type[,variable-1][,variable-2])
where
s
command-type is one of the following types of command: DE a DEMAND command PU a POST command with a user-defined requirement PJ a POST command with a predecessor job dependency requirement
variable-1 is the symbolic variable name of the JOB parameter value in the command. The default variable name is JOB.
57
Where the command-type specified is DE, variable-2 is the symbolic variable name of the SCHID parameter value. The default variable name is SCHID. If the SCHID variable is not found in the JCL, a symbolic schedule ID of 000 is assigned. When Batch Terminal Procedures are specified using DE as the value for command-type, you must incorporate the demanded jobs into a CONTROL-M scheduling table, and specify the appropriate IN conditions in their job scheduling definitions. Where the value of command-type is set to PU, variable-2 is the symbolic variable name of the USR parameter value. The default variable name is USR Where the value of command-type is set to PJ, variable-2 is the symbolic variable name of the DEPJOB parameter value. The default variable name is DEPJOB. The usage of the parm-parameter subparameter value is further clarified in the following example. Example Suppose a site has six types of Batch Terminal Procedures in the CA-7 JCL libraries. A. The BTERM1 procedure specifies all CA-7 Batch Terminal Commands using one of the following SYSIN DD statements:
//stepx EXEC BTERM1//SYSIN DD CA-7 commands /* //stepx EXEC BTERM1 //SYSIN DD DISP=SHR, // DSN=pdsmember_or_seq_file *
B. The BTERM2 procedure specifies a CA-7 Batch Terminal command using the JCL EXEC PARM parameter, as follows:
//stepx EXEC BTERM2,PARM='CA-7 command'
C. The BTERM3 procedure specifies a CA-7 Batch Terminal command using a symbolic PARM parameter P, as follows:
//stepx EXEC PGM=SASSTRLR,PARM='&P'
58 CONTROL-M for OS/390 and z/OS CA-7 Conversion Guide
D. The BTERM4 procedure specifies symbolic variables for the job name (JOB) and schedule ID (SCHID) parameters of the CA-7 DEMAND command, as follows:
//stepx EXEC BTERM4,JOBNM=jobname,SCH=schid
E. The BTERM5 procedure specifies symbolic variables for the job name (JOB) and user-defined requirement (USR) parameters of the CA-7 POST command, as follows:
//stepx EXEC BTERM5,JOBN=jobname,USREQ=usr
F. The BTERM6 procedure specifies CA-7 Batch Terminal commands using a SYSIN DD statement, and contains a symbolic parameter (ID) that specifies a relative batch terminal number, as follows:
//stepx EXEC BTERM6,ID=1 //SYSIN DD * CA-7 commands //
The symbolic parameter ID is irrelevant to the proper conversion of the CA-7 commands in the SYSIN file. However, the corresponding CONTROL-M procedure, CTMUTIL, which is explained in Chapter D, The CTMUTIL Conversion Utility, must take the ID into account to avoid a JCL error when resolving symbolic parameters. One method of accomplishing this is by having the CTMUTIL procedure use the symbolic parameter in a harmless way. For example, define the CTMUTIL procedure with the symbolic parameter ID as follows:
59
The contents of the DABTERM file for the above example must be coded as follows:
BTERM=BTERM1 BTERM=BTERM2 BTERM=BTERM3,PARM=P BTERM=BTERM4,PARM=(DE,JOBNM,SCH) BTERM=BTERM5,PARM=(PU,JOBN,USREQ) BTERM=BTERM6
NOTE
The conversion tool is delivered with two Batch Terminal programs or procedures named SASSTRLR and U7SVC. These names can be modified to conform to local naming conventions at the site. When the second form of the PARM parameter is specified, both variable-1 and variable-2 must appear on the same JCL line as the batch-terminal-name. 4. The Demanded Job Names file created by JOB3
Output
1. JCL libraries in CONTROL-M format 2. the JCL conversion report
60
For more information, see Table 17 on page 95 and 25. Virtual Resource Management on page 115.
NOTE
Users of CA-7 Release 3.0 and earlier should execute this job only if the CA-7 Resource Management facility and the LXRSC command are installed.
JOB5 activates the CTMCA710 program to convert the CA-7 virtual resources.
Input
1. The file containing the Job-to-Resource Cross Reference report that was created by JOB0 2. The global cross-reference file that was created by JOB3 3. The CONTROL-M scheduling table library that was created by JOB3
61
Output
1. Modified CONTROL-M scheduling tables containing Control and Quantitative resources and manual IN conditions 2. A message file
62
63
CTMNDMD
CTMDMD
demanded jobs (as head-of-tree) the jobs triggered by the demanded jobs
When the &DEMAND conversion parameter is set to CTM, STEP3 must be deleted from JOB7. JOB7 activates the CTMCA7V5 and CTMCA7DM programs to create the CONTROL-M Group scheduling tables.
Parameters
The expected maximum number of lines in any Group scheduling table must be specified in the JCL PARM parameter of the EXEC statements in STEP2 and STEP3 in this job. This number must be approximately 2 to 3 times the maximum number of lines of the largest scheduling table. The default is 40000. The REGION parameter must be set to 0K in the EXEC statement.
64 CONTROL-M for OS/390 and z/OS CA-7 Conversion Guide
Input
1. The Application List file created by JOB2 2. The CONTROL-M intermediate scheduling table library created by JOB3 3. The Appended Scheduling Tags file create by JOB3
Output
1. The CONTROL-M Group Scheduling Table library Default library name: CTM.V600.NEWSCHED Library characteristics: PDS; record length 80; block size 3120
NOTE
Review the members in this library carefully.
The conversion tool generally attempts to combine like-named jobs in a table with different scheduling IDs into the same job scheduling definition with multiple schedule tags. However, in some instances, minor differences in job scheduling parameters prevent this from being done. In this case, you may want to modify these job scheduling definitions and combine them using multiple schedule tags. In addition, a set of schedule tags with different names may have the same Basic Scheduling parameters. You may choose to retain only one of these tags in the Group Entity, delete the rest, and rename all occurrences of the deleted tags in the job scheduling definitions to the name of the retained tag. 2. The CONTROL-M Group scheduling table library without Demanded jobs Default library name: CTM.V600.SCHED.NDMD Library characteristics: PDS; record length 80; block size 3120 3. The CONTROL-M Demanded jobs scheduling table library Default library name: CTM.V600.SCHED.DMD Library characteristics: PDS; record length 80; block size 3120 The conversion of demanded jobs, referred to in the two preceding paragraphs, and in particular setting the &DEMAND conversion parameter to CA7, is discussed in &DEMAND on page 148.
65
Input
1. A list of all CA-DRIVER procedure library names 2. A list of all CA-7 JCL library names Each name is entered on a separate line, beginning at column 1
Output
1. The procedure library in CONTROL-M format Default name: CTM.CA7.PROCLIB Library characteristics: PDS; record length 80; block size 3120 2. JCL libraries in CONTROL-M format 3. The procedure default values library in CONTROL-M format This library contains in a JCL member the default values assigned to variables by the EXEC statement. Default name: CTM.CA7.PARMLIB Library characteristics: PDS; record length 80; block size 3120 4. The Input Statements library in CONTROL-M format Default name: CTM.CA7.DATALIB Library characteristics: PDS; record length 80; block size 3120 All conversion messages are written to the CTM.CA7.MSG message file.
66
For more information on the PROCLIB and PARMLIB output files, see 51. DPROC on page 133. For more information on the DATALIB output files, see 56. DATA, DEND on page 136.
67
68
Chapter
Conversion Steps
This chapter includes the following topics: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pre-Conversion Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 1 - Create the Conversion SOURCE and LOAD Libraries . . . . . . . . . . . . . . . . . . Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck . . . . . . Step 3 - Modify and Run the JOB0 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 4 - Modify Parameters in the DEFAULTS Member . . . . . . . . . . . . . . . . . . . . . . . . Step 5 - Modify and Run the ASMLINK Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 6 - Modify and Run the JOB1 Member. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 7 - Modify and Run the JOB2 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 8 - Modify and Run the JOB3 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 9 - Modify and Run the JOB4 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 10 - Modify and Run the JOB5 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 11 - Modify and Run the JOB7 Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 12 - Modify and Run the JOB8 Member (Optional) . . . . . . . . . . . . . . . . . . . . . . . Step 13 - Customize CONTROL-M and Install User Exits . . . . . . . . . . . . . . . . . . . . . . Step 14 - Final Adjustments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 15 - Check Conversion Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Step 16 - Customize the New Day Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 71 72 73 74 75 75 76 77 79 81 82 83 84 85 87 88 89
Chapter 3
Conversion Steps
69
Overview
Overview
Installation and operation of the conversion tool consists of a series of steps. BMC Software recommends that you first review the contents of Appendix C, Planning The Conversion then read through the remainder of this chapter before performing the steps. It is important to follow the outlined sequence of the steps to ensure a successful conversion. The following is a summary of the steps: Pre-conversion planning
1 Create the conversion SOURCE and LOAD libraries. 2 Copy CA-7 and/or CA-11 JCL and CA-DRIVER Libraries and Initdeck. 3 Modify and run the JOB0 member. 4 Modify parameters in the DEFAULTS member. 5 Modify and run the ASMLINK member. 6 Modify and run the JOB1 member. 7 Modify and run the JOB2 member. 8 Modify and run the JOB3 member. 9 Modify and run the JOB4 member. 10 Modify and run the JOB5 member. 11 Modify and run the JOB7 member. 12 Modify and run the JOB8 member (Optional). 13 Customize CONTROL-M and install user exits. 14 Final adjustments. 15 Check conversion results. 16 Customize the New Day Procedure.
70
Pre-Conversion Planning
NOTE
For all of the jobs which follow, the IEF283I NOT DELETED 8 message can be ignored for the first (or only) run of the job.
Pre-Conversion Planning
Before beginning the actual conversion process, the following list must be reviewed for tasks that may need to be performed in preparation for the conversion: 1. Verify the CA-7 database to ensure its integrity and accuracy. A. Run the UCC7DBVR program to verify that all logical pointers in the CA-7 database are properly set. B. Run the following Analyze commands to correct, if necessary, various database index entries and cross references.
s s s s
2. Simplify the JCL conversion process by running the CA-7 SASSJCLU utility against the CA-7 JCL Scheduled Override control statements and the scheduled JCL itself. 3. Ensure that all calendar-oriented schedules are RESOLVEd against the proper Base Calendar. Without schedule resolution, job schedules cannot be correctly defined in the LSCHD report. For more information, see JOB1 - Produce the updated CA-7 LJOB Report on page 44. 4. Review any system, CA-7, or CA-11 exits that perform functions that must be implemented in the CONTROL-M environment. 5. Ensure that all personnel involved in the conversion process have security access to all required functions, such as authorized CA-7 LOGON IDs, and that they have authorization to execute the necessary batch jobs.
Chapter 3
Conversion Steps
71
Job statement INLIB OUTLIB LOADLIB UNIT VOLSER PRODUCT IOA CONV library name CA-7 conversion SOURCE library name CA-7 conversion LOAD library name Unit name of DASD device Volser of DASD device CA7
3. Submit the job for execution. The job must finish with a completion code of 0.
NOTE
Do not APF-authorize the conversion LOAD library.
72
Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck
Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck
To prevent changes to the current production JCL environment, create a copy of the CA-7 and CA-11 JCL libraries named in the CA-7 Initdeck Initialization file. All CA-DRIVER libraries, if any, must also be copied. A sample job for copying the production JCL libraries is provided in the COPYLIBS member in the conversion SOURCE library. For CA-LIBRARIAN or CA-PANVALET libraries, use the utilities supplied by CA-LIBRARIAN or CA-PANVALET to create and copy the production JCL libraries into PDS libraries for use by the conversion tool. The new libraries must be sufficiently large to enable update of all the members. Additional libraries and sequential data sets may need to be copied. For more information, see &PNIBTSD on page 154. The original CA-7 Initdeck must be copied and the data set names of the JCL libraries must be modified to reflect the data set names of the copies of the JCL libraries referred to above.
Chapter 3
Conversion Steps
73
the job statement the name and location of the LJOB report, specified in the SYSPRINT DD statement in STEP1 the name and location of the LSCHD report, specified in the SYSPRINT DD statement in STEP2 the name and location of the Base Calendar report, specified in the SYSPRINT DD statement in STEP3 the name and location of the Job-to-Resource Cross Reference report, specified in the SYSPRINT DD statement in STEP4 the CA-7 SASSBTRM procedure name, if changed locally, as specified in STEP1, STEP2, STEP3, and STEP4 This procedure invokes the CA-7 SASSBSTR program. the CA-7 user ID of the /LOGON command, as referred to in STEP1, STEP2, STEP3, and STEP4
Submit the job and check the sysout for completion code and error messages. The job must finish with a condition code of 0.
NOTE
Producing the CA-7 LJOB report may take several hours, depending on the size of the CA-7 database.
74
the job statement the conversion SOURCE library name, set in the SRCLIB parameter, created in Step 1 the conversion LOAD library name, set in the LOADLIB parameter, allocated in Step 1 the IOA LOAD library name, set in the IOALOAD parameter the IOA SMP/E Distribution LOAD library name, set in the ALOAD parameter the IOA MAC library name, set in the IOAMAC parameter
Submit the job and check the sysout for completion code and error messages. In the link-edit of Steps M5 and M6, a condition code of 4, caused by unresolved external references, is acceptable. All other steps must complete with a condition code of 0.
NOTE
This step must be re-executed whenever changes are made to the parameters in the DEFAULTS member, or a source fix is applied to any module. If necessary, an LLA REFRESH must also be performed after changes are made.
Chapter 3
Conversion Steps
75
If the high-level assembler Release 2, HLASMR2, is used for assembly and link processing, use assembly option USING(WARN(2)) to obtain a clean assembly and suppress the ASMA303 warning message.
the job statement the IOA LOAD library name, specified in the IOALOAD DD statement in STEP0 the IOA PARM library name, specified in the IOAPARM DD statement in STEP0 the IOA IOAENV library name, specified in the IOAENV DD statement in STEP0 the conversion LOAD library name, specified in the CTMLOAD DD statement in STEP0 the CA-7 Initdeck-library and member name, specified in the DAINIT DD statement STEP0 Use the copy of CA-7 Initdeck made in Step 2 (on page 73). the name of the LJOB report file created by JOB0, specified in the DAREPORT DD statement in STEP0 Concatenated LJOB reports may be specified. However, verify that the record indicating the end of the CA-7 Batch Terminal (SLIA-00) is removed from all the LJOB reports except the last LJOB report in the concatenation. Do not concatenate different LJOB reports that may contain jobs of the same name. Each such LJOB must be converted in a separate conversion process. If you want to concatenate multiple LJOB reports, you must first arrange them in jobname order.
the name and location of the updated LJOB report, specified in the DALJOBO DD statement in STEP0 the name and location of the file containing the list of jobs that require Auxiliary Calendars, specified in the DAJOBSCH DD statement in STEP0
76
the name and location of a work library, specified in the WORK DD statement in STEP0 The same data set name must also be specified in the SYSINLIB DD statement in STEP5 (but do not delete the member name) the number of jobs that are contained in the LJOB report, specified in STEP5, the PARM parameter of the EXEC statement. You must also set the REGION parameter to 0K in the EXEC statement If you allocate files on SMS-managed volumes, you must pre-allocate files referenced by the DALJOBO and DAJOBSCH DD statements before executing JOB1 for the first time. This file must not be placed on volumes that have the SMS Management Class Partial Release attribute specified.
Submit the job and check the sysout for completion code and messages. Ignore any informational or warning messages. Errors with a return code of 12 must be corrected and the job rerun. Error (E) level messages with a return code of 8 must be investigated and corrected wherever possible. However, E level messages rarely prevent the creation of the updated LJOB report. Some E level messages are unavoidable, such as those referring to missing calendars, because the calendar library has not yet been created. These types of E level messages can be safely ignored, and you may continue with the conversion process. For explanations of each message, see Appendix B, Messages
the job statement the IOA LOAD library name, specified in the IOALOAD DD statement in STEP0 the conversion LOAD library name, specified in the CTMLOAD DD statement in STEP0 the IOA PARM library name, specified in the IOAPARM DD statement in STEP0 the IOA IOAENV library name, specified in the IOAENV statement in STEP0 the name of the LJOB report file created by JOB1, specified in the DAREPORT DD statement in STEP0
Chapter 3
Conversion Steps
77
the name of the LSCHD report file created by JOB1, specified in the DAREPRT2 DD statement in STEP0 the name of the Base Calendar report file created by JOB1, specified in the DABASCAL DD statement in STEP0 the name and location of the Applications List file, specified in the DAOUT1 DD statement in STEP0 the name and location of the CONTROL-M Calendar library, specified in the DACAL DD statement in STEP0 the name and location of the Calendar Names List file, specified in the DACALNM DD statement in STEP0 the name and location of the SCHDYONLY and Periodic Calendar Name file, specified in the DACALS DD statement in STEP0 the name of the job list report of the jobs requiring an Auxiliary Calendar created by JOB1, specified in the DAJOBSCH DD statement in STEP0 the work unit name, specified in the SORTIN DD statement in STEP0 the CA-7 Periodic Base Calendar Control statements, specified in the SYSIN DD statement in STEP3 For details of the record layout and content, see JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files on page 46. Specify this information only if there are nonstandard, periodic, CA-7 Base Calendars produced in JOB1 in the Base Calendar report.
NOTE
If you allocate files on SMS-managed volumes, you must preallocate files referenced by the DAOUT1, DACAL, DAJOBSCH, and DACALNM DD statements before executing the specified job the first time. These files, if they are PDSs, must not be placed on volumes that have the SMS Management Class Partial Release attribute specified. Submit the job and check the sysout for completion code and error messages. The job must finish with a condition code of 0. Error messages are explained in Appendix B, Messages An editor can be used to modify the Application List file. For more information, including details of the record layout, see JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files on page 46.
78
NOTE
Before performing this step, be sure to check, and if necessary modify, the Applications List file created in JOB2.
Edit the JOB3 member in the conversion SOURCE library. Adjust the following specifications in accordance with your local conventions:
s
the job statement the IOA LOAD library name, specified in the IOALOAD DD statement in STEP0 the conversion LOAD library name, specified in the CTMLOAD DD statement in STEP0 the IOA PARM library name, specified in the IOAPARM DD statement in STEP0 the IOA IOAENV library name, specified in the IOAENV DD statement in STEP0 the name of the LJOB report file created by JOB1 and used in JOB2, specified in the DAREPORT DD statement in STEP0 the name of the Applications List file created by JOB2, specified in the DASYSN DD statement in STEP0 the CA-7 Initdeck library and member name, specified in the DAINIT DD statement in STEP0 Use the copy of CA-7 Initdeck made in Step 2.
the name and location of the CONTROL-M Documentation library, specified in the DADOC DD statement in STEP0 the name and location of the intermediate table or jobname Cross-Reference file, specified in the DAXREF DD statement in STEP0 the name and location of the library for JCL INCLUDE members, specified in the DAINCLIB DD statement in STEP0 the name and location of the file containing the JCL for the New Day procedure, specified in the DADAILY DD statement in STEP0
Chapter 3
Conversion Steps
79
the name and location of the intermediate CONTROL-M scheduling table library, specified in the DASCHD DD statement in STEP0 the name of the SCHDYONLY and Periodic Calendar Name List file created by JOB2, specified in the DACALS DD statement in STEP0 the name of the Calendar Name List file created by JOB2, in the DACALNM DD statement in STEP0 the name and location of the CONTROL-M CMEM Rule Table definitions, specified in the DACMEM DD statement in STEP0 the name and location of the JCL library DSN list, specified in the DAJCLIN DD statement in STEP0 the name and location of the Demanded Job Names file, specified in the DADMDJNM DD statement in STEP0 the name and location of the control input statements for the CTMBLT utility, specified in the DABLT DD statement in STEP0 the number of jobs that are contained in the LJOB report, in STEP2, the PARM parameter of the EXEC statement in STEP2 The REGION parameter in the EXEC statement must also be set to 0K. the name of the CA-7 Job Class Translation Table, or the actual table contents, DD statement DAJOBCL in STEP2 For details of the record layout and content, see JOB3 - Create CONTROL-M Scheduling Tables and CMEM Rules on page 50. This information must only be specified if the JCL Job Classes (in the Job statement) are to be converted into CONTROL-M Quantitative resources. For more information, see &JOBCLAS on page 152.
the name of the CPUID translation table, or the actual table contents, in the DACPUID DD statement in STEP2 For details of the record layout and contents, see JOB3 - Create CONTROL-M Scheduling Tables and CMEM Rules on page 50. This table need only be specified if jobs require specific system affinity, which is specified using the CA-7 MAINID parameter.
the name and location of a WORK library, specified in the WORK DD statement in STEP0. The same data set name must also be specified in the SYSINLIB DD statement in Step 2, but do not delete the member name. the name and location of the file that causes the creation of additional scheduling tags in job scheduling definitions, specified in the DATAG DD statement in STEP0
80
NOTE
If you allocate files on SMS-managed volumes you must, before executing the specified job for the first time, pre-allocate files referenced by the DAXREF, DACMEM, DASCHD, DAINCLIB, DADOC, DADAILY, DABLT, and DATAG DD statements. If they are PDSs, these files must not be placed on volumes that have the SMS Management Class Partial Release attribute specified. Submit the job and check the sysout for completion code and error messages. A condition code of 12 or above causes the job to stop processing. Error messages are explained in Appendix B, Messages
the job statement the conversion LOAD library name, specified in the CTMLOAD DD statement in STEP0 the IOA LOAD library name, specified in the IOALOAD DD statement in STEP0 the IOA PARM library name, specified in the IOAPARM DD statement in STEP0 the IOA IOAENV library name, specified in the IOAENV DD statement in STEP0 the name of the JCL Library DSN list, created by JOB3, as specified in the DAJCLIN DD statement in STEP0 the name of the Demanded Job Names file, created in JOB3, as specified in the DADMDJNM DD statement in STEP0 the name and location of a WORK library, specified in the WORK DD statement in STEP0 The same data set name must also be specified in the SYSINLIB DD statement in STEP2, but do not delete the member name.
a list of the Batch Terminal parameters control statements, specified in the DABTERM DD statement in STEP2
Chapter 3
Conversion Steps
81
For details on how to specify these parameters, see JOB4 - Convert JCL Members on page 56.
WARNING
To prevent changes to the current production environment, use a copy of the CA-7 and/or CA-11 production JCL libraries, and not the actual libraries, as input to this job. For instructions, see Step 2. JOB4 issues the CTMCA707-00R message, which requires that the operator confirm that Step 2 has been performed. Submit the job and check the sysout for completion code and error messages. The job must finish with a condition code of 0. Error messages are explained in Appendix B, Messages
NOTE
For users of CA-7 Release 3.0 or earlier, perform this step only if your site has implemented the CA-7 Resource Management facility. Otherwise, skip to Step 11.
Edit the JOB5 member in the conversion SOURCE library. Adjust the following specifications in accordance with your local conventions:
s
the job statement the conversion LOAD library name, specified in the CTMLOAD DD statement in STEP0 the IOA LOAD library name, specified in the IOALOAD DD statement in STEP0 the name of the Job-to-Resource Cross Reference report file, specified in the DAREPIN DD statement in STEP0 the name of the table-jobname Cross Reference file created by JOB3, as specified in the DAXREF DD statement in STEP0 the name of the CONTROL-M scheduling table library created by JOB3, as specified in the DASCHD DD statement in STEP0
Submit the job and check the sysout for completion code and error messages. The job must finish with a condition code of 0. Error messages are explained in Appendix B, Messages
82 CONTROL-M for OS/390 and z/OS CA-7 Conversion Guide
If an Sx37 abend occurs during the execution of this job, compress and optionally enlarge the library, then rerun the job. The conversion program does not update scheduling tables that were updated in the previous run.
the job statement the conversion LOAD library name, specified in the CTMLOAD DD statement in STEP0 the IOA LOAD library name, specified in the IOALOAD DD statement in STEP0 the IOA PARM library name, specified in the IOAPARM DD statement in STEP0 the IOA IOAENV library name, specified in the IOAENV DD statement in STEP0 the name of the Applications List file created by JOB2, specified in the APPLIST DD statement in STEP0 the name of the intermediate CONTROL-M job scheduling table library in JOB3, specified in the DASCHD DD statement in STEP0 the name of the file that causes the creation of additional schedule tags, created by JOB3, specified in the DATAG DD statement in STEP0 the name and location of the CONTROL-M Group scheduling table library, specified in the CTMSV5 DD statement in STEP0 the maximum number of lines in any Group scheduling table, the PARM parameter of the EXEC statement in STEP2 and STEP3
When the &DEMAND conversion parameter, which is described in &DEMAND on page 148, is set to CTM, STEP3 in JOB7 must be deleted. The following specifications are required only if the &DEMAND conversion parameter is set to CA7:
Chapter 3
Conversion Steps
83
the name and location of the CONTROL-M Group scheduling table library excluding all demanded jobs, specified in the CTMNDMD DD statement in STEP0 the name and location of the CONTROL-M (non-Group) scheduling table library containing all demanded job streams, specified in the CTMDMD DD statement in STEP0
NOTE
If you allocate files on SMS-managed volumes, you must, before executing the specified job for the first time, pre-allocate files referenced by the DASCHD, CTMNDMD, and CTMDMD DD statements. If they are PDSs, these files must not be placed on volumes that have the SMS Management Class Partial Release attribute specified. Submit the job and check the sysout for completion code and error messages. The job must finish with a condition code of 0. Error messages are explained in Appendix B, Messages
the job statement the conversion LOAD library name, in the CTMLOAD DD statement in STEP0 the IOA LOAD library name, in the IOALOAD DD statement in STEP0 the name and placement of the Procedure library, in the DAPROC DD statement in STEP0 the name and placement of the Procedure Default Values library, in the DAPARAM DD statement in STEP0 the name and placement of the Input Statements library, in the DADATA DD statement in STEP0
84
a list of CA-DRIVER Procedure library names, in the DAPROCIN DD statement in STEP3 a list of CA-7 JCL library names, in the DAJCLIN DD statement in STEP4
WARNING
To prevent changes to the current production environment, use copies of the JCL libraries, not the CA-7 production JCL libraries, as input to this job. For more information, see Step 2. Submit the job for execution, then check the SYSOUT for completion code and error messages. A condition code of 12 or above causes the job to terminate. Error messages are explained in Appendix B, Messages If problems or errors are encountered, correct them manually in the CA-7 JCL libraries, and rerun this job.
Chapter 3
Conversion Steps
85
4. If the &CTR conversion parameter, which is described in &CTR on page 146, was set to Y or X, the following applies: It may be necessary to set the NFILVS99 parameter (to N). It may also be necessary to set the ADDPROC, PROCRC, and NCT2RC parameters. If your JCL contains any referbacks in the COND parameter of the type COND=(1,NE,UCC7RMS.U11STEP), do the following
s
Set the ADDPROC, PROCRC, and NCT2RC parameters. Change the U11STEP step name to IOATEST. This can be done by one of the following methods:
change the step name directly in the JCL members, by means of a utility that can make multiple updates use CONTROL-M User Exit 2 (CTMX002) to search the JCL member for EXEC statements containing the string COND=(1,NE,UCC7RMS.U11STEP), and, without physically changing the actual JCL member, change that string on submission to COND=(1,NE,UCC7RMS.IOATEST). All these parameters are in the CTRPARM member in the IOA PARM library. For more information on these parameters, see the section on optional wishes with data in the CONTROL-M/Restart Customization chapter of the INCONTROL for OS/390 and z/OS Installation Guide. 5. Install User Exit 2 (the Job Submission exit), which is supplied in the CTMX002R member in the SAMPEXIT library. The exit inserts JES2 and JES3 statements into the JCL member of a job in order to route jobs to the required CPU using the following job scheduling definition parameters
SET VAR=%%SYSID=xxx
where xxx is derived from the CA-7 MAINID parameter and the CPUID translation table supplied by you. For more information on the CA-7 MAINID parameter, see 40. MAINID on page 129. This exit can be tailored to local requirements. Read the comments in the CTMX002R member carefully to determine the desired method of implementation. For details regarding this user exit, see the CTMX002 member. If Exit 2 is currently being used, for example, as outlined in paragraph 2 of this Step, the supplied exit must be incorporated into the current exit.
86
13. SCAL on page 105 the description of the Calendar Names List file in the output of JOB2 on page 49
In order to minimize the work of maintaining auxiliary calendars, BMC Software recommends that, wherever possible, you replace them with basic scheduling parameters and base calendars. To do this, use the CONTROL-M CTMTBUPD utility. For more information on this utility, see the CONTROL-M chapter of the INCONTROL for OS/390 and z/OS Utilities Guide. Example Suppose the following:
s
The SJ123456 calendar is defined in the DCAL parameter of the TAG1 schedule tag in the XYZ group scheduling table. The SJ123456 calendar schedules the job every third working day of the month, which in the CA-7 Q1 base calendar is a Monday. The &CALPREF conversion parameter was set to CTMCAL. The &CALPREF conversion parameter is described in AConversion Parameters on page 143.
Chapter 3
Conversion Steps
87
Replace the auxiliary calendar by means of the following CTMTBUPD utility control statements:
SEL TBL XYZ,TAG=TAG1 DCAL=CTMCALQ1 DAYS=D3 RELATION=A WDAYS=1 ENDSEL
NOTE
Any auxiliary calendars that are not replaced must be extended to multi-year calendars as soon as possible.
4. If CA-LIBRARIAN or CA-PANVALET libraries were converted to partitioned data sets in Step 2 above, they may be reconverted back to CA-LIBRARIAN or CA-PANVALET format at this point. 5. Review all CA-7 and CA-11 system exits (if any), for example, the CA-11 JES2 or JES3 interfaces, such as the JES2 Exit 6, the JES3 IATUX03, and the CA-11 SMF IEFUJV exits. Remove or modify such exits as appropriate. 6. Copy the DAYMONTH AutoEdit member, which contains AutoEdit Global variable definitions. If you utilize CA-DRIVER, you must copy the DAYMONTH member from the conversion SOURCE library to the library specified in the DAGLOBAL DD statement, which is defined in the CONTROL-M monitor procedure.
88
Chapter 3
Conversion Steps
89
90
Chapter
Conversion Details
This chapter includes the following topics: Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Component Conversion Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Component Conversion Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 1. JOB and MEMBER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 2. JCLID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 3. SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 4. JCL-OVRD and # JCL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 5. VERIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 6. MAINT and # MNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 7. HOLD and DEMAND[H] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 8. EXEC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 9. PRTY, # RES and DEMAND[H] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 10. COND-CODE, RO and # SCC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 11. TYPE1 and TYPE2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 12. CLASS, # RES and DEMAND[H] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 13. SCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 14. ROLL, INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 15. SBTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 16. DOTM and LDTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 17. Scheduling Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 18. Job Triggering and # NTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 19. DEP-JOB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 20. DEP-JOB=/jobname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 21. DSN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 22. NWK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 23. USER REQUIREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 24. PROSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 25. Virtual Resource Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 26. # JI, # JO, and # JEND, # XI, # XO, and # XEND Statements . . . . . . . . . . . . . . . 117 27. JCL Job Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 28. DEMAND[H] and POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 29. CA-11 Non-Restartable Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 30. INSERT-RMS and //*CA-11 Comment Statements . . . . . . . . . . . . . . . . . . . . 123 31. CA-11 U11RMS Step . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Chapter 4 Conversion Details 91
32. NXTCYC SET-OFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 33. RESCHNG and # RES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 34. This item number is not currently in use.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 35. OWNER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 36. SCHID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 37. JCL Initialization Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 38. SHOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 39. CMEM Rule Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 40. MAINID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 41. INITR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 42. JES ROUTE PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 43. This item number is not currently in use.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 44. DEP-JOB=? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 45. DONT SCHEDULE BEFORE/AFTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 46. # HLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 47. # NOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 48. # MSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 49. # VER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 50. This item number is not currently in use.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 51. DPROC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 52. (D)STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 53. (D)GOTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 54. (D)SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 55. (D)IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 56. DATA, DEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 57. (D)NEST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 58. (D)ABORT/DFLUSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 59. Variable Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 60. Date Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 61. Attribute Functions (L, T) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 Unique CONTROL-M Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 CATEGORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 DO SYSOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 MAXWAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
92
Overview
Overview
This chapter details the conversion of relevant CA-7 and CA-11 components into corresponding CONTROL-M job scheduling definition parameters and AutoEdit parameters, and describes the unique CONTROL-M conversion parameters that may be specified.
NOTE
Item number (Item No.) in the following tables refers to the topic number in this chapter.
Table 10
Components of the CA-7 Job Definition Screen (JOB) (Part 1 of 2) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
JOB MEMBER JCLID SYSTEM JCL-OVRD VERIFY MAINT HOLD EXEC=N PRTY COND-CODE and RO TYPE1 and TYPE2 (tape) CLASS INSERT RMS UID
MEMNAME, OWNER, GROUP, TABLE name, Group Entity name %%INCLIB, %%INCMEM MEMLIB APPL IN condition (manual) IN condition (manual) Ignore DSN connections IN condition (manual) OVERLIB=DUMMY PRIORITY ON PGMST RESOURCE RESOURCE DO IFRERUN, CONTROL-M JCL steps OWNER
1, 3, 35 1 2 3 4 5 6 7 8 9 10 11 12 30, 31 35
93
Table 10
Components of the CA-7 Job Definition Screen (JOB) (Part 2 of 2) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
DEFINITION ACTIVE FROM, UNTIL SET VAR OWNER SHOUT WHEN LATESUB SHOUT WHEN EXECTIME
45 40 35 38 38
Components of the CA-7 Job Scheduling Screen (SCHD, JOB) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameters
SCAL SCHID ROLL, INDEX SBTM DOTM and LDTM SYMETRIC Scheduling Information
Table 12
CONFCAL, DCAL, WCAL Schedule Tag, SET VAR SHIFT FROM, SCHEDULE-PREV-DAY DUE OUT TASKTYPE=CYC, DATES, INTERVAL nnn D FROM TRGT Scheduling criteria
13 36 14 15 16 17 17
Components of the CA-7 Job Triggering Screen (SCHD, JTRG) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
Job Triggering
Table 13
18
Components of the CA-7 Dataset Triggering Screen (SCHD, DTRG) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
Dataset Triggering
Table 14
39
Components of the CA-7 Job Predecessor/Successor Screens (JOBCONN) (Part 1 of 2) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
DEP-JOB LEADTM=00
94
19 19
Table 14
Components of the CA-7 Job Predecessor/Successor Screens (JOBCONN) (Part 2 of 2) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
20 44 21 22 23
Components of the CA-7 Documentation Screens (PROSE) CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
PROSE data
Table 16
24
Components of the CA-7 Commands Screens CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Command
NXTCYC SET=OFF
Table 17
IN condition (manual)
32
Components of the CA-7 Virtual Resource Management Screen (RM/RSRC) CONTROL-M Job Scheduling Definition Parameter Item No.
25 25 25 25
Components of the CA-7 Modification to Resolved Schedule Dates Screen CONTROL-M Job Scheduling Definition Parameter Item No.
CA-7 Parameter
MODSTAT=CURRENT
DCAL
13
95
Table 19
Components of the CA-7 or CA-11 JCL Parameter, Statement, or Step CONTROL-M or CONTROL-M/Restart Job Scheduling Definition Parameter Item No. or AutoEdit Parameter
IOATEST utility IN condition (manual) Ignore DSN connections %%GOTO AutoEdit statement IOANOTE utility Suppress OUT Conditions PRIORITY, SHOUT WHEN EXECTIME, RESOURCE, CTMRELRS utility ONPGMST IOATEST utility RESOURCE OWNER OWNER OWNER CONTROL-M JCL step, IN condition, PRIORITY, RESOURCE, DESC CONTROL-M JCL step CONTROL-M JCL step
POST RESCHNG CA-11 non-restartable steps //*CA-11 comments statement CA-11 U11RMS steps JES ROUTE PRINT statement
Table 20
Components of the CA-7 or CA-11 Initialization File Statement (Part 1 of 2) CONTROL-M Job Scheduling Definition Parameter Item No.
JCL,...DSN=dsname JCL,...ALT=nnn
MEMLIB OVERLIB
2 37
96
Table 20
Components of the CA-7 or CA-11 Initialization File Statement (Part 2 of 2) CONTROL-M Job Scheduling Definition Parameter Item No.
40 31
Components of the CA-7 CALENDAR Macro CONTROL-M Job Scheduling Definition Parameter Item No.
17(2) 13
Components of CA-7 Workload Balancing Macros CONTROL-M Job Scheduling Definition Parameter Item No.
TAPE1 NAME=xxx, MXTAL=nnn TAPE2 NAME=xxx, MXTAL=nnn INITR TOTAV=nnn ... CLBARR BARx=nnn
11 11 41 12
Table 23
CA-DRIVER Command
DPROC (D)STEP (D)GOTO (D)SET (D)IF DATA, DEND (D)NEST (D)ABORT/DFLUSH Variable parameters Date functions Attribute (L',T') functions
%%SET %%LABEL %%GOTO %%SET %%IF %%INCLIB, %%INCMEM %%INCLIB, %%INCMEM %%ABORTED %% variables date-functions %%$LENGTH, %%$TYPE
51 52 53 54 55 56 57 58 59 60 61
97
98
2. JCLID
The CA-7 JCLID is a number from 000 through 253 that identifies the JCL library for a particular job. The library names are contained in the user-modified CA-7 Initdeck in the DSN parameter of the JCL Initialization statements. For more information on CA-7 Initdeck, see the discussion of the input to JOB3 in JOB3 - Create CONTROL-M Scheduling Tables and CMEM Rules on page 50. The conversion tool specifies the CA-7 JCL library name in the MEMLIB CONTROL-M job scheduling definition parameter. If the JCLID of a job does not correspond to any JCL initialization statements, the MEMLIB parameter is set to GENERAL. The JCLID parameter is not required for non-executable jobs, that is, when EXEC is set to N in the CA-7 JOB screen. The CA-7 JCLID value 254 indicates use of the CA-7 Special Override library. For more information on how to obtain the equivalent functionality in CONTROL-M, see Chapter 1, Conceptual Overview.
3. SYSTEM
The SYSTEM parameter in the CA-7 JOB screen is an optional parameter that associates the job with an application system name. The CONTROL-M APPL parameter is used to supply a common descriptive name to a set of related groups of jobs. The conversion tool creates the CONTROL-M APPL parameter from the CA-7 SYSTEM name.
5. VERIFY
The CA-7 VERIFY job definition parameter indicates whether the job requires manual verification before it can be submitted. The conversion tool adds a manual IN condition to the CONTROL-M job scheduling definition to prevent the automatic submission of the job. The format of the condition is: VERIFY_JCL_jobname where jobname is the CONTROL-M MEMNAME.
100
The conversion tool adds a manual IN condition to the CONTROL-M job scheduling definition to indicate that the job is held. The format of the condition is: HELD_jobname where jobname is the CONTROL-M MEMNAME. Setting the TYPE parameter to RES in the DEMAND command indicates that the job must be scheduled in restart or rerun status, and that the job is to be placed into the Request Queue with a restart requirement. The conversion tool adds a manual IN condition to the CONTROL-M job scheduling definition to indicate that the job has a restart requirement. The format of the condition is: RESTART_jobname
8. EXEC
The CA-7 EXEC job definition parameter indicates whether the job must be executed. If N is specified, the job does not execute, but CA-7 simulates a normal completion. In CONTROL-M, set the OVERLIB parameter to DUMMY to prevent the job being submitted. If EXEC is set to N in the CA-7 job definition, the conversion tool sets the OVERLIB parameter of the CONTROL-M job scheduling definition to DUMMY.
NOTE
The CONTROL-M OVERLIB parameter, not the MEMLIB parameter, is set to DUMMY, in order to preserve the original library specification (if any).
101
Similarly, job submission priority is determined by the values of the following parameters in the JCL member, which override the value in the CA-7 PRTY parameter:
s s
the PRT parameter in the CA-7 # RES override statement the PRTY parameter in the CA-7 DEMAND[H] command
If priority values appear in both the # RES and DEMAND[H] statements, that in the # RES statement takes precedence. The CONTROL-M PRIORITY job scheduling definition parameter uses two alphanumeric characters to set job priority. The conversion tool transforms the CA-7 numeric value to an alphanumeric value while maintaining priority order. This is achieved by converting the two high order digits of the CA-7 PRTY from 00-25 to A-Z, and not converting the low order digit. The conversion tool supports CA-7 express priority (when PRTY is set to 255), which is used to bypass Workload Balancing priority scheduling criteria, by defining the job as a critical path, that is, by specifying *5 in the CONTROL-M PRIORITY parameter. For more information, see the CONTROL-M for OS/390 and z/OS User Guide.
102
Table 24
COND=(nn,GE,...) COND=(nn,LE,...) COND=(nn,GT,...) COND=(nn,LT,...) COND=(nn,EQ,...) COND=(nn,NE,...) COND=(nn-mm,EQ,...) COND=(nn-mm,NE,...) COND=(,FL) COND=(n, oper, *)
CODES >Cnn CODES <Cnn CODES >C(nn-1) CODES <C(nn+1) CODES NCnn, >C0000 CODES Cnn CODES >Cnn CODES <Cnn OR >Cmm CODES <C(mm+1) >C(nn-1) CODES FLUSH PGMST +EVERY
In addition to permitting a step name operand following the Relational Operator, such as GE or LE, the conversion tool also allows specification of the procedure step name as follows: # SCC COND=(nn,ro,stephame.procstepname) where
s s s s
nn is the return code of the step ro is the Relational Operator value stepname is the name of the step which returned nn procstepname is the name of the procedure in the step which caused the step to return nn
This statement is converted to CONTROL-M as ON PGMST stepname PROCST procstepname CODES xxxx as shown in the above table. For processing step names in the form *-stepname, see &SCCGLBL on page 156. When the CA-7 job definition indicates default checking, unless you set the value of the MAXCCOK parameter in CTMPARM to 4095, the conversion tool sets the following CONTROL-M specification:
ON PGMST ANYSTEP DO OK PROCST CODES C****
103
104
The above resources must be added to the CONTROL-M Resources file with a quantity corresponding to the CA-7 class barrier specification, which is defined in the BARx parameter of the workload balancing CLBARR macro.
13. SCAL
CA-7 calendars are defined for one year only. A CA-7 Base calendar ID has the format SCALyyxx where:
s s
yy is the target year xx are two unique characters used during initial creation of the calendar
A CONTROL-M calendar definition can contain multiple years, and its name can be from 1 through 8 characters in length. The CONTROL-M job scheduling definition has several optional calendar parameters, namely DCAL, WCAL and CONFCAL. For more information on these parameters, see the CONTROL-M for OS/390 and z/OS User Guide. Calendars are automatically created as described in the following situations.
The first six characters are a constant value, as specified in the &CALPREF conversion parameter. For more information, see &CALPREF on page 143. The last two characters are the last two characters of the CA-7 calendar name, that is, the SCAL=xx that was specified by the PRINT command of JOB1.
105
Base calendars created with the CA-7 OPTION=SCHDYONLY are marked as SCHDYONLY. For more information, see Step 3 - Modify and Run the JOB0 Member on page 74.
When a CA-7 job has the SCHDMOD CURRENT indicator set in its scheduling information
The CA-7 Modification to Resolved Schedule Dates screen (D.B.2.7) enables a user to permanently modify a resolved schedule for a job or input network without having to redefine the schedule. This modification is indicated by a status of CURRENT. A list of all CA-7 job schedule members that have been modified using the SCHDMOD screen is available in CA7ER789, the CA-EARL CURRENT SCHDMOD report. For more information, see the CA-7 Management Reporting Guide. The user can, globally or on an individual application basis, determine whether SCHDMOD CURRENT processing is to be performed on jobs whose schedules are so marked. For more information, see &SCHDMOD on page 156, and the description of the Application List file in JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files on page 46. SCHDMOD CURRENT processing is the same as the processing described below.
When CA-7 job schedule parameters cannot be consistently converted to CONTROL-M Basic Scheduling parameters
The CA-7 job schedule parameters cannot be consistently converted to CONTROL-M Basic Scheduling parameters when
s
the conversion tool encounters a CA-7 SYMETRIC parameter, and the calendar used for the schedule was created with OPTION set to SCHDYONLY, or the CA-7 SPAN parameter is greater than 45 it is determined by the conversion tool that the CA-7 scheduling definition for a particular Schedule ID cannot automatically be converted to CONTROL-M Basic Scheduling parameters a CA-7 job schedule utilizes a nonstandard (periodic) calendar SCHDMOD CURRENT processing is requested (as described in the preceding section)
106
JOB2 builds an auxiliary calendar in the CONTROL-M Calendar library (DACAL) that is based on the CA-7 scheduling definition of the job in the LSCHD report. For more information on auxiliary calendar naming conventions, see the description of the CONTROL-M Calendars library among the Output Files under JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files on page 46. The auxiliary calendar is marked as SCHDMOD-CURRENT if the CA-7 schedule in the LSCHD report of the corresponding job indicates that at least one modification made to its schedule ID is still in effect, that is, the modification has a status of CURRENT. Otherwise, the calendar is marked as AUXILIARY CAL. For all jobs associated with the Schedule ID, the CONTROL-M job scheduling definitions in the scheduling table are modified as follows: the auxiliary calendar name is placed into the DCAL parameter the DAYS and MONTHS parameters are set to ALL the WDAYS, AND/OR, CONFCAL, WCAL, and SHIFT parameters are cleared
NOTE
Auxiliary calendars placed into the CONTROL-M Calendar library are 1-year calendars only, spanning January through December or July through June, depending on when the CA-7 schedules were RESOLVEd. You must extend these calendars to multiple years as soon as possible. You can use CONTROL-M utilities to
s
utilize user-defined calendars rather than the auxiliary calendars reduce the number of calendars defined to CONTROL-M by defining your own CONTROL-M Basic Scheduling parameters, such as DAYS or WDAYS.
For more information, see the discussion of the creation of auxiliary calendars in the description of the use of the CTMXREF CONTROL-M utility in Step 14 Final Adjustments on page 87.
107
where
s s
the value of x corresponds to the ROLL parameter value the value of yyy corresponds to the INDEX parameter value
Each of these conversions is described below. The CA-7 ROLL schedule definition parameter indicates the action CA-7 is to take when verifying (resolving) schedule parameters against the CA-7 Base calendar. CA-7 ROLL action values are converted to CONTROL-M as follows: 1. When ROLL is set to D, no action is to be performed and the requested schedule day is to be skipped. In such a case, the CONTROL-M SHIFT parameter in the CONTROL-M job scheduling definition is left blank. 2. When ROLL is set to B, the requested schedule day is to be rolled backward to the previous calendar working day. In such a case, SHIFT is set to < in the CONTROL-M job scheduling definition. 3. When ROLL is set to F, the requested schedule day is to be rolled forward to the next calendar working day. In such a case, SHIFT is set to > in the CONTROL-M job scheduling definition. 4. When ROLL is set to N, the requested schedule day must be kept regardless of the calendar definition (except for DAILY scheduling). In such a case, SHIFT is set to @ in the CONTROL-M job scheduling definition. When the CA-7 Base calendar is a non-standard (periodic) calendar, the CONTROL-M CONFCAL and SHIFT parameters are omitted, regardless of the CA-7 ROLL value. The CA-7 INDEX schedule definition parameter is used to specify an adjustment to schedule days. After exercising the ROLL option, the schedule is adjusted forward or backward by the number of working days specified in INDEX. This value (not exceeding 62), including sign, is copied to the CONTROL-M SHIFT parameter in the yyy portion of the value, as described earlier in this item.
15. SBTM
The CA-7 SBTM schedule definition parameter specifies a submission time prerequisite. CA-7 does not submit the job before this time. The CONTROL-M FROM job scheduling definition parameter specifies the earliest time the job can be submitted.
108
The conversion tool assigns the value of the CA-7 SBTM parameter to the CONTROL-M FROM parameter. If no value is set in the CA-7 SBTM parameter, the conversion tool can optionally use the deadline start time, the STARTM parameter on the LJOB report. For more information, see &STARTM on page 158
NOTE
The CONTROL-M SAC parameter is set when the converted FROM time is between midnight and the CONTROL-M New Day time, as explained in New Day Processing and Schedule Scan on page 28.
109
Table 25
CA-7
CONTROL-M
WDAYS
D4W1,D4W1,D4W5,D4W6
If xx is -00, the CONTROL-M DAYS parameter is set to L1, L2, ..., L7 or -L1, -L2, ..., -L7, depending on whether the week is to be included or excluded; the CONTROL-M WDAYS parameter is set to the value of the CA-7 DAY. 2. A CA-7 calendar definition can specify OPTION=SCHDYONLY. This calendar definition parameter changes the representation of the CA-7 MONTHLY RDAY schedule definition parameter from processing days to calendar (working) days. This is converted by specifying the calendar in the CONTROL-M DCAL parameter and the days of the month as working days, in Dn format. 3. SYMETRIC DAY=ddd, SPAN=nnn SYMETRIC schedules are converted to job definitions with the following attributes:
s
the SCHEDULE TAG corresponding to the CA-7 SCHEDULE-ID contains a DATES value of ddmm (or mmdd) derived from the julian date ddd specified in the CA-7 START parameter a MAXWAIT value of 99, so the job is never removed from the Active Jobs File
the INTERVAL parameter in the job definition is set to nnn D FROM TRGT, meaning the job must be recycled every nnn days from the date scheduled for the current job run
the calendar corresponding to the schedule-ID was not created with OPTION set to SCHDYONLY and
110
NOTE
When an online P (Plan) command in Screen 2 is issued for a converted SYMETRIC job, the calendar plan shows the job as being scheduled on only one date, that specified in the DATES parameter. In most cases, this does not match the CA-7 schedule (LSCHD) for the job. This is because the conversion tool converts the job as a cyclic job. Reruns of cyclic jobs are not displayed in response to the Plan command if the INTERVAL parameter is set to span more than one day.
111
19. DEP-JOB
The CA-7 DEP-JOB job connection parameter specifies a predecessor job on which the job specified in the JOB parameter is dependent. This causes the dependent job to wait until the job specified in the DEP-JOB parameter has completed OK. The conversion tool builds IN and OUT conditions in the form dep-jobname_OK ODAT where dep-jobname is the CONTROL-M MEMNAME of the job on which the job specified in the JOB parameter is dependent. For example, if the CA-7 job connection definition of JOBB states that JOBB is connected to JOBC using the specification DEP-JOB=JOBC, this means that JOBB is dependent on JOBC. The conversion tool converts this CA-7 job connection by specifying the IN condition JOBC_OK in the CONTROL-M job scheduling definition of JOBB, and specifying the OUT condition JOBC_OK in JOBC. For alternate naming convention considerations, incorporating both the predecessor and successor job names, see &DEPJCND on page 150. When incorporating demanded jobs, as well as jobs triggered by demanded jobs, into a CONTROL-M job scheduling table definition from a Batch Terminal step, such as SASSTRLR, in the CA-7 JCL, the IN or OUT condition is built in a modified format, as follows: jobname_dep-jobname_sched-id ODAT where
s
dep-jobname is the name of the JCL member containing the CA-7 DEMAND command jobname is the job name of the demanded job, that is, the name in the CA-7 JOB parameter sched-id is the SCHID value specified in the CA-7 DEMAND command
If SCHID is not specified in the DEMAND command, a value of 001 is assumed. When the &DEMAND conversion parameter, which is described in &DEMAND on page 148, is set to CA7, the demanded job itself is created without the above IN condition. The CONTROL-M CTMJOB batch utility can then force the job into the Active Jobs File, using the CTMUTIL procedure described in Appendix D, The CTMUTIL Conversion Utility
112
When the DEMAND command contains a DEPJOB parameter value, an IN condition is built in the same format as that described above, and is placed in a job that has the name defined in the CA-7 JOB parameter. All values of the CA-7 job connection LEADTM (the satisfaction lead time in hours), including 99, are ignored, except for the value 00. When a LEADTM of 00 is specified, the IN and OUT conditions created in the job scheduling definition specify **** instead of ODAT, to make the condition not dependent on the date. In addition, an OUT statement deletes the condition corresponding to its IN condition from the IOA Conditions file upon successful completion of the job. For information regarding the forced deletion of job connection conditions regardless of the value of the LEADTM parameter, see &DELCOND on page 147. For more information, see DEMAND[H] and POST Commands on page 30.
20. DEP-JOB=/jobname
The CA-7 DEP-JOB job connection parameter can specify a job name preceded by / (slash). This type of job connection is referred to as a negative job dependence, in that CA-7 prevents the connected job and the job specified in the DEP-JOB parameter from executing concurrently. The job specified in the DEP-JOB parameter runs only when the connected job ends (or abends), but it is not triggered by the connected job. The CONTROL-M CONTROL job scheduling definition parameter is used to control all job resource sharing, as well as preventing concurrent runs of jobs. The conversion tool converts this CA-7 job connection by specifying the CONTROL parameter in the format EXCLUSIVE_jobname where jobname is the connected CA-7 job name. This CONTROL resource is specified for the connected job with the Exclusive option, and for the DEP-JOB job with the Shared option.
21. DSN
The CA-7 DSN job connection parameter specifies an input data set name as a prerequisite for a job. This type of job connection instructs CA-7 to suspend the execution of a job until the input data set is created.
113
For example, if the CA-7 job connection definition states that JOBB has an input data set connection to DSN.OUTFILE, the job is dependent upon the creation of that data set. The conversion tool converts this CA-7 DSN job connection by changing it to a job connection of the CA-7 DEP-JOB type, which specifies in CONTROL-M IN and OUT conditions the job name that creates the data set in the DSN parameter. The valid syntax is: creating-job_DS where creating-job is the job that creates the data set. For other naming convention considerations relating to the names of both creating and successor jobs, see &DEPJCND on page 150. A DSN connection is ignored when a CA-7 job definition states any of the following:
s s s s s
Job is a MAINT job (maintenance job) DSN is marked as *PERM DSN* DSN is marked as PERM FOR JOB DSN is marked as CREATED BY **NONE** DSN is marked as CREATED BY nnn JOBS, where nnn is any number
22. NWK
The CA-7 NWK job connection parameter is used to specify the network prerequisites of a job. The conversion tool converts this CA-7 job connection to a manual IN condition of the form NW_jobname where jobname is the CONTROL-M MEMNAME.
114
In CONTROL-M, a manual prerequisite condition prevents the submission of a job until the condition is added manually to the IOA Conditions file. The conversion tool converts this CA-7 connection by specifying a long IN condition in the CONTROL-M job scheduling definition of the connected job. The format of the string is jobname_usertext The variable jobname is the CONTROL-M MEMNAME of the CA-7 connected job. The variable usertext is at least the first 30 characters of the USER REQUIREMENTS parameter
24. PROSE
In CA-7, job documentation (PROSE) optionally describes each job. The PROSE data is stored in the CA-7 database, and is maintained by means of the PROSE on-line screens. In CONTROL-M, documentation can be specified for each job. The documentation data of each job is contained in one library member. This documentation member can be maintained from the Job Scheduling Definition screen (Screen 2). The conversion tool converts the CA-7 PROSE data by creating a member in the CONTROL-M Documentation library for each job that has associated PROSE data.
Shared and Exclusive resources A Shared resource connection enables multiple jobs to execute at the same time, even though they may all use the same resource. An Exclusive resource is used to indicate that the job requires exclusive use of a resource, so that no other job requiring the resource can execute until the end of the exclusive use job.
115
In CONTROL-M, a CONTROL parameter is used to control resource sharing, and is defined with Exclusive or Shared options. For more information on the CONTROL parameter and its subparameters, see the CONTROL-M for OS/390 and z/OS User Guide.
s
Corequisite resources In the case of a Corequisite resource connection, whether a job executes depends on whether the status of the specified resource is active or inactive. In CONTROL-M, these resources are converted into manual IN conditions in the format status_res-name where: status is either A (Active) or I (Inactive) res-name is the name of the resource You must add or delete these manual conditions from the CONTROL-M Resource file when the resource becomes active or inactive.
Resource Count resources The availability to a job of a Resource Count resource depends on the count or number specified for this resource and job. When a job-to-resource connection is made to a Resource Count resource, the specified number identifies the total number of occurrences of this resource that are used by this job. In CONTROL-M, a RESOURCE parameter is used to specify Quantitative resources and the actual quantity of the resource that the job requires. For more information on the RESOURCE parameter, see the CONTROL-M for OS/390 and z/OS User Guide.
Address Space resources These resource types are not supported by the conversion tool.
All CA-7 virtual resources have a FREE option associated with them that determines the resource availability at job submission and job or step completion. If you want, you can reflect the FREE option in the format of the converted resource name, by specifying the &RESFREE conversion parameter, which is described in &RESFREE on page 156.
116
26. #JI, #JO, and #JEND, #XI, #XO, and #XEND Statements
The CA-7 override statements # JI, # JO, and # JEND, and similarly, # XI, # XO, and # XEND, indicate JCL statements that are to be included, or omitted, based on scheduling criteria. The CONTROL-M AutoEdit %%IF, %%ELSE, %%ENDIF, %%GOTO and %%LABEL control statements provide a Boolean IF logic capability. The conversion tool converts the # JI, # JO, # JEND, # XI, # XO, and # XEND) statements to corresponding CONTROL-M AutoEdit statements. Only the CA-7 RPT parameter is ignored. The CA-7 ID parameter is converted to the AutoEdit variable %%SCHID which, for scheduled jobs, is derived from the first 3 characters of the CONTROL-M %%$TAG system variable. The %%$TAG system variable is the Schedule Tag name of the Schedule Tag that causes the job to be submitted. All Schedule Tag names are of the form sched-ID_head-of-tree-jobname For non-scheduled, independent (single-purpose) jobs, sched-ID is set to 000. For demanded jobs and jobs triggered by demanded jobs, the CONTROL-M job scheduling definition contains a SET VAR %%SCHID AutoEdit variable, the value of which is set from the SCHID parameter in the CA-7 DEMAND statement for demanded jobs. The CA-7 BD, ED, OA, OB, BT, and ET parameters are converted to the system-defined date and time AutoEdit variables %%[O]YEAR, %%[O]JULDAY, and %%TIME, based on the setting of the CA-7 CV subparameter. %%OYEAR and %%OJULDAY are the conversion results when CV is set to DO or DL. %%YEAR and %%JULDAY are the conversion results when CV is set to CU.
NOTE
CA-7 JCL override statements (# NTR, # SCC, and so on) embedded within a # JI or # JO block are incorporated into the job scheduling definition with a schedule ID corresponding to the ID parameter of the # JI or # JO statement. The following examples illustrate how the # JI and # JO override statements are converted.
Example 1
#JI,ID=(1,5,10,15),BD=97010,ED=97250,OA=0100,OB=1530, BT=1010,ET=1212
117
is converted to:
%%IF X%%$TAG NE X %%SET %%SCHID = %%SUBSTR %%$TAG 1 3 %%ENDIF %%IF %%SCHID EQ 001 %%GOTO LABEL0001 %%ELSE %%IF %%SCHID EQ 005 %%GOTO LABEL0001 %%ELSE %%IF %%SCHID EQ 010 %%GOTO LABEL0001 %%ELSE %%IF %%SCHID EQ 015 %%GOTO LABEL0001 %%ELSE %%GOTO LABEL00XX %%ENDIF %%ENDIF %%ENDIF %%ENDIF %%LABEL0001 %%IF %%OYEAR.%%OJULDAY GE 97010 %%IF %%OYEAR.%%OJULDAY LE 97250 %%SET %%HHMM = %%SUBSTR %%TIME 1 4 %%IF %%HHMM GE 0100 %%IF %%HHMM LE 1530 %%GOTO LABEL0002 %%ELSE %%GOTO LABEL00XX %%ENDIF %%ELSE %%GOTO LABEL00XX %%ENDIF %%ELSE %%GOTO LABEL00XX %%ENDIF %%ELSE %%GOTO LABEL00XX %%ENDIF
%%LABEL LABEL0002 %%IF %%OYEAR.%%OJULDAY EQ 97010 %%SET %%HHMM = %%SUBSTR %%TIME 1 4 %%IF %%HHMM GE 1010 %%GOTO LABEL0003
118
%%ELSE %%GOTO LABEL00XX %%ENDIF %%LABEL LABEL0003 %%IF %%OYEAR.%%OJULDAY EQ 97250 %%SET %%HHMM = %%SUBSTR %%TIME 1 4 %%IF %%HHMM LE 1212 %%GOTO LABEL0004 %%ELSE %%GOTO LABEL00XX %%ENDIF %%LABEL LABEL0004 . . <JCL STATEMENTS> . . %%LABEL LABEL00XX
Example 2
Assume the following CA-7 JCL override statement is in the same JCL member as the statement in Example 1:
#JO,ID=205-250,BD=97010,ED=98010,CV=CU
It is converted to:
%%IF X%%$TAG NE X %%SET %%SCHID = %%SUBSTR %%$TAG 1 3 %%ENDIF %%IF %%SCHID GE 205 %%IF %%SCHID LE 250 %%GOTO LABEL01XX %%ELSE %%GOTO LABEL0101 %%ENDIF %%ELSE %%GOTO LABEL0101 %%ENDIF %%LABEL0101 %%IF %%YEAR.%%JULDAY GE 98010 %%GOTO LABEL01XX %%ELSE %%GOTO LABEL0102 %%ENDIF
119
resource-name is either the user text specified in the JCL Job Class Translation Table or the JCL job class $ is a mask character
The exact format of the quantitative resource depends on specifications in the Job Class Translation Table. For details, see Step 8 - Modify and Run the JOB3 Member on page 79.
120
The way the conversion tool operates depends on the mode set by the &DEMAND conversion parameter, which is described in &DEMAND on page 148. The conversion tool converts CA-7 DEMAND[H] JCL Batch Terminal step operations to one of the following:
s
CONTROL-M CTMJOB ORDER commands, to force a job into the Active Jobs file IOACND ADD COND commands that add conditions to the IOA Conditions file. The CA-7 JCL POST Batch Terminal step operation is converted to CONTROL-M IOACND JCL steps that add conditions to the IOA Conditions file.
For more information, see Appendix D, The CTMUTIL Conversion Utility, in which the utility that corresponds to the CA-7 Batch Terminal step is described. For an overview on DEMAND and POST processing, see DEMAND[H] and POST Commands on page 30. For the format of the converted conditions, see 19. DEP-JOB on page 112. The CONTROL-M DESC parameter of the demanded job scheduling definition is set to contain the string DEMANDED-JOB, and the DESC parameter in jobs triggered by the demanded job contains the string DEMANDED-JOB-BRANCH. DESC also contains the schedule-ID.
NOTE
The parameters supported in the DEMAND[H] command are: JOB, SCHID, DEPJOB, DOTM, PRTY, CLASS, and TYPE set to RES. The parameters supported in the POST command are: JOB, NW, USR, and DEPJOB. The only Batch Terminal commands converted are those specified as input to programs and procedures listed in the Batch Terminal input file. For more information, see JOB4 - Convert JCL Members on page 56. The only Batch Terminal commands converted are those in non-concatenated SYSIN, CA7DATA, and UCC7DATA DD statements, with or without a stepname qualification. Only one Batch Terminal command is recognized in each line, and the command must begin in column 1. It can appear in any one of the following positions:
s s s
in a PDS member in a sequential data set instream, for example, following the statements //SYSIN DD * or //SYSIN DD DATA, or no SYSIN statement at all
121
If Batch Terminal commands appear in the CA-7 PARM parameter on the EXEC statement, only one command is converted, and the whole of that command must be contained in one JCL line. Unsupported Batch Terminal commands in SYSIN and extraneous DD statements are deleted. PARM parameters that contain unsupported commands are nullified, and EXEC statement parameters that follow the PARM parameter are ignored. The CTMUTIL utility is the CONTROL-M equivalent of the CA-7 Batch Terminal procedure. CTMUTIL serves as the umbrella procedure for invoking IOACND, CTMJOB and CTMRELRS whenever their functionality is required. For more information on the CTMUTIL utility, see Appendix D, The CTMUTIL Conversion Utility,
NOTE
In rare cases, the non-restartable step feature may work differently in CONTROL-M/Restart from the way it works in CA-11. CONTROL-M/Restart first checks the condition codes, and determines whether a step will run. If CONTROL-M/Restart determines that the step will not run, it does not continue to check whether the step contains the CTRNORST DD statement. CA-11, however, first checks whether the UCC11NR or CA11NR DD statement exists in the step, and performs step adjustment accordingly. This can cause a job to restart at a different step when CTRNORST DD statements are utilized than it would if UCC11NR or CA11NR DD statements were in use.
122
a CA-11 comment statement in the JCL of a job, before the first EXEC statement, specifies
//*CA-11 INSERTRMS=YES
the AUTO-ARCHIVE, SYSDB, and PREVENT-NCT2 parameters are set to Y, and a DO IFRERUN statement is inserted into the CONTROL-M job scheduling definition. Specifying //*CA-11 PARM=value causes the conversion tool to process the statement exactly as if a U11RMS step had been encountered. For more information, see the following item.
When the value of PARM is set to P (production processing), R (rerun or restart processing), or F (format processing), the following occurs: The following CONTROL-M/Restart parameters are set to Y (Yes)
s s s
When the value of PARM is set to P or F, the DO IFRERUN restart step defaults to $ABEND or $EXERR, depending on whether the &CTR conversion parameter is set to Y or X. When the value of PARM is set to R, if startprocstep.startstep and endprocstep.endstep are included in the PARM parameter setting, these are used in the FROM and TO subparameters of DO IFRERUN. The CC=nnnn statement in the PARM parameter is ignored. The procedure name to identify the U11RMS step is determined from the PROCRMS parameter of the RESTART statement in the CA-7 Initialization file. If this parameter is not set, a default value of UCC11RMS is used. If this does not agree with the actual CA-11 usage, which is set out in Table 20 on page 96, you must insert the correct PROCRMS value in the RESTART statement before running the conversion.
Chapter 4 Conversion Details 123
When the value of PARM is set to N (null processing), DO IFRERUN is not inserted into the job scheduling definition and the PREVENT-NCT2 parameter is set to N (No) even if the job definition contains the statement INSERT-RMS=Y or a //*CA-11 comment statement is specified earlier in the JCL of the job. For more information, see 30. INSERT-RMS and //*CA-11 Comment Statements on page 122.
NOTE
The &CTRCONF conversion parameter determines whether manual confirmations of restarts, using DO IFRERUN, are required.
When the U11RMS step contains the statement PARM=R, PSEUDO=YES, you must set up a CONTROL-M/Restart simulation run. For more information, see the CONTROL-M/Restart User Guide.
124
RESOURCE quantities for a job, previously determined by the TYPE1 and TYPE2 parameters in the CA-7 job definition, are overridden by the CTMRELRS step. The same conversion restrictions that apply to the DEMAND and POST commands, which are described in 28. DEMAND[H] and POST on page 120, also apply to the RESCHNG command.
NOTE
Only RESCHNG commands with JOB subparameters that refer to the member in which the command resides are converted.
36. SCHID
The CA-7 SCHID parameter provides a method of varying scheduling requirements, job triggers, JCL overrides, and so on, for the same job. Within CONTROL-M, a job in a Group scheduling table can be assigned different sets of basic scheduling criteria by means of Schedule Tags. For each CA-7 SCHID assigned to a job, the conversion tool creates a Schedule Tag in the Group Entity of the Group Scheduling table. The name of the Schedule Tag is in the format schedule-ID_head-of-tree-jobname[_n] where n is an integer and indicates that a supplemental schedule tag had to be created for the same CA-7 scheduling criteria.
125
This occurs when the CA-7 scheduling criteria are so complex that a single CONTROL-M schedule tag is insufficient, for example, where the conversion of CA-7 scheduling criteria requires
s
both CONTROL-M DAYS and DATES parameters both CONTROL-M periodic and non-periodic parameters more than 12 CONTROL-M DATES parameters
Each Schedule Tag is then placed into the appropriate job scheduling definition.
NOTE
Schedule Tags are sometimes generated in CONTROL-M jobs even though there is no corresponding CA-7 SCHID with defined scheduling criteria. This can happen
s s
when a triggered job within a CA-7 job definition has a SCHID that is not defined in group scheduling tables containing DEMANDed jobs
The CA-7 hierarchical triggering structure must be retained during conversion to CONTROL-M, and such undefined SCHIDs may have an impact on it. To prevent unwanted effects, the conversion tool creates a Schedule Tag for each undefined SCHID when constructing the CONTROL-M scheduling tables. However, if not otherwise referred to, for example, in CA-7 # JI or # JO statements in JCL, these Schedule Tags with no scheduling criteria can be ignored and may be manually deleted. The CONTROL-M %%$TAG AutoEdit system variable contains the name of the Schedule Tag that causes the job to be scheduled. When the CA-7 JCL of a job contains CA-7 JCL override statements in the format # JI, ID=. . . the conversion tool converts these statements to CONTROL-M AutoEdit statements, transforming the ID subparameter into the %%SCHID AutoEdit variable as follows: %%SET %%SCHID = %%SUBSTR %%$TAG 1 3 This extracts the first three characters of the CA-7 SCHID Schedule Tag. For an example, see 26. # JI, # JO, and # JEND, # XI, # XO, and # XEND Statements on page 117. In the following instances, the %%$TAG variable is not used to derive a value for %%SCHID in the converted JCL:
126
For DEMANDed jobs, a SET VAR %%SCHID AutoEdit variable is used to create DEMANDed job definitions. The SET VAR %%SCHID AutoEdit variable value is set from the SCHID parameter contained on the DEMAND JCL Batch Terminal statement. If there is no CA-7 SCHID parameter, the %%SCHID value is taken from the schedule ID of the job that invokes the DEMANDed job. When the CA-7 SCHID of a job is changed from nnn to mmm by means of the statement SCHID=nnn/mmm in the TRIGGERED JOBS section of the LJOB report, the CONTROL-M SET VAR AutoEdit variable %%CHG_SCHID is set to the changed SCHID (mmm). In the JCL conversion of the corresponding JCL members, ensure the proper resolution of %%SCHID by using the following code:
%%RESOLVE NO %%IF %%CHG_SCHID GE 0 %%SET %%SCHID = %%CHG_SCHID
NOTE
Non-scheduled, single-purpose jobs are created with Schedule Tag names in the form 000_jobname.
38. SHOUT
Causes specific messages to be sent by CONTROL-M (shouted) to predetermined destinations on predefined occasions. The conversion tool supports the following situations:
127
Table 26 Item
Send a SHOUT message when a job fails. Send a SHOUT message when a job has not been submitted by a specified time and the CA-7 PROMPTS parameter of the Job Definition screen for the particular job is set to Y (Yes). The conversion tool uses the start time to set the SHOUT message to indicate that the job is late when the specified time has passed. For more details, see the STARTM parameter in the LJOB report. Note: If the SHOUT WHEN LATESUB time is equal to the TIME FROM parameter, which is discussed in 15. SBTM on page 108, one minute is added to the SHOUT WHEN LATESUB time to prevent a late SHOUT when the job is submitted.
WHEN LATE *
Send a SHOUT message when a job has not finished executing by its DUE OUT time, which is discussed in 16. DOTM and LDTM on page 109.
WHEN EXECTIME The CA-7 CLOCK-TIME, that is, the weighted average elapsed > nnn runtime of the job, is used to calculate if a SHOUT WHEN EXECTIME value, in minutes, has been exceeded. The CLOCK-TIME of the job is added to the quantity specified in the &SHOUTX conversion parameter and used in the CONTROL-M SHOUT WHEN EXECTIME > nnn parameter, which sends the message %%JOBNAME HAS EXCEEDED RUN TIME LIMIT. The CA-7 weighted average elapsed runtime can also be specified using the # RES override statement (value ELAPTM) in the JCL member. This overrides the value in the CLOCK-TIME parameter. Note: If the CA-7 CLOCK-TIME specifies an elapsed time greater than 999 minutes, nnn is set to 999. The &SHOUTT conversion parameter specifies the SHOUT message text for failed jobs. The default is %%JOBNAME J%%JOBID ENDED NOTOK! The &SHOUTL conversion parameter specifies the SHOUT message text for jobs submitted late. The default is MEMBER %%$MEMNAME IS LATE!
128
The &SHOUTE conversion parameter specifies the SHOUT message text for jobs that are still executing after their DUE OUT time. The default is %%JOBNAME J%%JOBID STILL EXECUTING AFTER DUE OUT! In these SHOUT messages
s
%%JOBNAME and %%JOBID are the Auto Edit variables in which the name of the submitted job and the JES job number are placed %%$MEMNAME is the AutoEdit variable in which the JCL member name of the job to be submitted is placed
When &SHOUTT or &SHOUTL or &SHOUTE are left blank, the corresponding SHOUT messages are suppressed. Various computer personnel can be specified as the CONTROL-M SHOUT destination. For more information, see the CONTROL-M for OS/390 and z/OS User Guide. The &SHOUTDT and &SHOUTDL conversion parameters specify the destination of the SHOUT message texts for failed and late jobs respectively. The conversion tool accesses the user ID from the &USEROPT conversion parameter, which is discussed in &USEROPT on page 160.
40. MAINID
The CA-7 MAINID parameter specifies on which CPU a job may or may not be scheduled. To display a list of all the CA-7 MAINID specifications that are assigned to the CA-7 SUBMIT data sets or internal reader, use the following CA-7 command: /DISPLAY,CPU=ALL The user must supply a CPUID translation table (the DACPUID DD statement) that associates a system ID with each MAINID. For more information, see JOB3 - Create CONTROL-M Scheduling Tables and CMEM Rules on page 50.
129
The conversion tool converts MAINID in the format SYn or /SYn by using the system ID associated with n (from the CPU Translation table) to create a %%SYSID AutoEdit variable in the CONTROL-M SET VAR parameter in the job scheduling definition. The JCL of jobs that require system affinity is then modified by Exit 2 (the Job Submission exit) by inserting one of the following JES statements before the first step:
/*JOBPARM SYSAFF=%%SYSID //*MAIN SYSTEM=%%SYSID (for JES2) (for JES3)
The %%SYSID AutoEdit variable is resolved from the value supplied by the SET VAR parameter. MAINID specifications of the form /SYn, meaning do not schedule on system n, are only supported for JES3 systems. The %%SYSID AutoEdit variable then takes the form /system-id. For additional information, see Network Communications Facility on page 35, and Step 11 - Modify and Run the JOB7 Member on page 83.
41. INITR
The total number of initiators available to CA-7 is indicated in the TOTAV parameter of the CA-7 INITR Workload Balancing macro. In CONTROL-M, the Initiator resource must be added to the CONTROL-M Resources file with a quantity corresponding to the CA-7 TOTAV parameter. The name of the CONTROL-M Initiator resource is specified in the &INIT conversion parameter, which is described in &INIT on page 152.
130
N specifies that the held output destination of the job is to be changed to new-dest new-dest is the first eight characters of the destination parameter specified on the JES ROUTE PRINT statement
The JES ROUTE PRINT statement is deleted from the JCL run stream.
131
The conversion tool converts DONT SCHEDULE BEFORE and DONT SCHEDULE AFTER parameters to CONTROL-M DEFINITION ACTIVE FROM and DEFINITION ACTIVE UNTIL values in the relevant job scheduling definitions. Dates are converted into the Gregorian format using a 2-digit year. The precise date format that is applied depends on the value specified for the IOA DATETYP installation parameter. Upon conversion, the values in CA-7 DONT SCHEDULE BEFORE and DONT SCHEDULE AFTER parameters are inserted into the DEFINITION ACTIVE FROM or DEFINITION ACTIVE UNTIL parameters respectively of both the job being converted and any of its dependent jobs which do not already have any values specified in those parameters.
46. #HLD
The CA-7 JCL # HLD override statement specifies that the job must be held. The conversion tool converts the # HLD override statement to the following JCL IOATEST utility step: // EXEC IOATEST,PARM=WTOR=JOB %%JOBNAME IS HELD This step causes the job to wait for an operator reply until the HOLD can be removed.
47. #NOX
The CA-7 # NOX override statement in the JCL member indicates that the job must not be executed. The conversion tool converts the # NOX override statement to the following JCL and AutoEdit statements:
//#NOX EXEC PGM=IEFBR14 //* %%GOTO END999
and at the end of the member adds the following AutoEdit statement:
//* %%LABEL END999
This has the effect of turning the job into a dummy job.
132
48. #MSG
The CA-7 # MSG override statement in the JCL member is used to send messages to the CA-7 Master Station at job submission time. The conversion tool converts the # MSG override statement to the following JCL IOANOTE utility step:
// EXEC IOANOTE,PARM=message-text
The first 48 bytes of the message text are placed into the PARM parameter.
49. #VER
The JCL CA-7 # VER override statement specifies that the job requires manual verification. The conversion tool converts the # VER override statement to the following JCL IOATEST utility step:
// EXEC IOATEST, // PARM=WTOR=JOB %%JOBNAME REQUIRES MANUAL VERIFICATION
This causes the job to wait for any operator reply after the manual verification has been satisfied.
133
The CONTROL-M %%SET AutoEdit control statement is used to set values for user-defined variables. The conversion tool converts each default value that is assigned to a variable in the DPROC statement into an appropriate CONTROL-M %%SET AutoEdit control statement.
s
All variable values are treated as character (non-numeric) data. In CA-DRIVER, a variable parameter can be assigned multiple values or array elements. The conversion tool converts each array element to a CONTROL-M AutoEdit variable name, consisting of the CA-DRIVER array name with the element number appended to it. In CA-DRIVER, default values can be specified in the EXEC statement, for the variables of the procedure. If values are specified in both the DPROC statement and the EXEC statement, the values on the EXEC statement override the DPROC default values.
In CONTROL-M, the current %%SET AutoEdit control statement overrides the previous value of the variable. The conversion tool creates a member in a special library called PARMLIB. The member contains a CONTROL-M %%SET AutoEdit statement for each default value assigned to a variable in the EXEC statement. The name assigned to this member is the job name with a suffix of an ascending number appended to it. If no default values are specified in the EXEC statement, an empty member is created in the PARMLIB library. In order to create a unique member name for every EXEC statement with default values, the conversion tool uses three CONTROL-M AutoEdit variables:
s s s
%%MEM# , which is a counter %%JOBNAMX, which is the job name %%MEMNAME, which is a member name consisting of the %%JOBNAMX AutoEdit variable with the %%MEM# AutoEdit variable appended to it.
The conversion tool establishes the connection between the default values member and the converted procedure by adding the CONTROL-M %%INCLIB and %%INCMEM AutoEdit control statements after all the CONTROL-M %%SET AutoEdit control statements that were created from the CA-DRIVER DPROC command.
s
The %%INCLIB and %%INCMEM control statements copy the PARMLIB default values member created from the EXEC statement. The %%INCLIB statement specifies the name of the PARMLIB library. The %%INCMEM statement specifies the %%MEMNAME AutoEdit variable.
134
52. (D)STEP
The CA-DRIVER procedure (D)STEP command is used to assign a name to a control statement. Naming a control statement enables branching to the statement from (D)IF or (D)GOTO commands. The CONTROL-M %%GOTO and %%LABEL AutoEdit control statements provide the AutoEdit facility with GO TO logic, enabling simple inclusion or exclusion of job steps, DD statements, input statements, and so on. The conversion tool converts the CA-DRIVER (D)STEP command to a CONTROL-M %%LABEL AutoEdit control statement.
53. (D)GOTO
The CA-DRIVER procedure (D)GOTO command is used to stop procedure expansion, branch forward and backward to another control statement, and continue expansion from that point. The CONTROL-M %%GOTO AutoEdit control statement provides the AutoEdit facility with GO TO logic, enabling simple inclusion or exclusion of job steps, DD statements, input statements, and so on. The conversion tool converts the CA-DRIVER (D)GOTO command to a CONTROL-M %%GOTO AutoEdit control statement.
54. (D)SET
The CA-DRIVER procedure (D)SET commands are used to change the value of a variable during conditional expansion. The CONTROL-M %%SET AutoEdit control statement is used to set values to user-defined variables. The conversion tool converts the CA-DRIVER (D)SET command to a CONTROL-M %%SET AutoEdit control statement.
s
Arithmetic operators + and are converted to CONTROL-M %%PLUS and %%MINUS operators respectively. Blank characters included in a string are converted to a CONTROL-M %%BLANKn AutoEdit control statement.
135
55. (D)IF
The CA-DRIVER (D)IF procedure command is used for conditional forward and backward branching. The CONTROL-M %%IF, %%ELSE, and %%ENDIF AutoEdit control statements provide the AutoEdit facility with a powerful Boolean IF logic capability. These statements, as well as the %%GOTO and %%LABEL control statements, facilitate branching based on different runtime criteria. The conversion tool converts the CA-DRIVER (D)IF command to CONTROL-M %%IF and %%ENDIF AutoEdit control statements.
57. (D)NEST
The CA-DRIVER (D)NEST procedure commands are used to call another CA-DRIVER procedure, which can, in turn, call another procedure. The CONTROL-M %%INCLIB and %%INCMEM AutoEdit control statements define a library and a member that are to be included in the job stream.
136
The conversion tool converts the CA-DRIVER (D)NEST statement to CONTROL-M %%INCLIB and %%INCMEM AutoEdit control statements that copy the called procedure into the job stream.
58. (D)ABORT/DFLUSH
The CA-DRIVER (D)ABORT/DFLUSH procedure commands are used to completely terminate the procedure expansion. The conversion tool converts CA-DRIVER (D)ABORT/DFLUSH commands to invalid CONTROL-M AutoEdit control statements. As a result, the job is not submitted by CONTROL-M, and a warning message is issued. The format of the invalid control statement is: //* %%ABORTED - DELIBERATE SYNTAX ERROR !
CA-DRIVER Parameter
&C_DATE or &DATE &C_JDATE or &JDATE &C_TIME or &TIME &C_DAY or &DAY &C_MONTH or &MONTH &C_L2SID &C_L2JN &C_L27# &C_L2xxx
%%OUTDATE %%YEAR.%%JULDAY %%TIME %%OUTDAY%%WDAY %%OUTMON%%MONTH %%SUBSTR %%$TAG 1 3 %%JOBNAME %%JOBID %%C_Lxxx
a b b b b b b b c
137
The variable date definitions shown in Table 28 depend on the site date format standard.
Table 28 Format Site Date Format Standards AutoEdit Variable Definition
NOTE
These variables are defined in the DAYMONTH AutoEdit Global Definition member. You must edit this member to choose the proper format. For more information, see item 6 under Step 14 - Final Adjustments on page 3-87. For more information regarding the support of the remaining &C_L2xxx CA-DRIVER parameters, see &L2VARS on page 153.
138
Table 29
M3DY YM3D DM3YR M3DYR YRM3D DAY MONTH MON MON# DOW DOW# WOY DTADD DTSUB JDOM JWDM JADM JRWD JRAD
%%$GREG %%$GREG %%$GREG %%$GREG %%$GREG %%$WEEKDAY %%$GREG %%$GREG %%$GREG %%$WEEKDAY %%$WEEKDAY %%$YEARWK# %%$GREG, %%$CALCDTE %%$GREG, %%$CALCDTE %%$GREG,%%$WCALC,%%$JULIAN %%$GREG,%%$WCALC,%%$JULIAN %%$GREG,%%$WCALC,%%$JULIAN %%$GREG,%%$WCALC,%%$JULIAN %%$GREG,%%$WCALC,%%$JULIAN
L var_name T var_name
139
CATEGORY
This CONTROL-M parameter specifies the CONTROL-D report decollating mission category that must be scheduled under CONTROL-D when the job is scheduled under CONTROL-M. This option is only available if CONTROL-D is installed at your site. For more information, see the description of the D-CAT parameter in the CONTROL-M for OS/390 and z/OS User Guide. If you use the &DCTGRY conversion parameter, which is described in &DCTGRY on page 147, the conversion tool specifies the CATEGORY parameter in the job scheduling definition of relevant jobs. This specifies the unique character string in the CA-7 JCL that precedes, and so identifies the existence of, the Mission Category. When the conversion tool finds this character string in the JCL, the characters following the string (up to 20) are entered in a CATEGORY basic scheduling parameter. For example, if the character string is //*CTDMC=, the following statements in the CA-7 JCL
//*CTDMC=XYZ //*CTDMC=DAILY
respectively specify mission categories XYZ and DAILY. The conversion tool can optionally define an OUT condition, to be used in CONTROL-D processing, in the job scheduling definition of any job for which a CATEGORY scheduling parameter is specified. For more information, see &CTDCOND on page 144. The format of the condition is jobname-usertext ODAT+
140
The variable jobname is the CONTROL-M MEMNAME of the job, and the variable usertext is specified in the &CTDCOND conversion parameter. For example, if the value specified in &CTDCOND is '-ENDED-OK' and the job scheduling definition of the ABC job has a CATEGORY parameter, then the OUT condition ABC-ENDED-OK ODAT+
DO SYSOUT
This CONTROL-M parameter specifies how the job output is to be handled. At job completion, CONTROL-M analyzes the job output. To enable CONTROL-M to locate the job output on the system spool, CONTROL-M modifies the MSGCLASS JCL parameter of the job at time of submission to the automatically held output class defined during installation, the CONTROL-M HLDCLAS parameter. After analyzing the sysout, CONTROL-M can be ordered to requeue the sysout. For more information on DO SYSOUT options, see the CONTROL-M for OS/390 and z/OS User Guide. The conversion tool can be instructed to specify various actions using the CONTROL-M DO SYSOUT facility. The &TOCLASS conversion parameter specifies the output class to which CONTROL-M requeues the job output. For more information on this parameter, see &TOCLASS on page 159. The &RELEASE conversion parameter controls whether CONTROL-M releases the job output for printing on the system spool. The default is Y (Yes). For more information on this parameter, see &RELEASE on page 155 The &FROMC conversion parameter specifies which of the held sysout classes must be requeued. For more information on this parameter, see &FROMC on page 151.
MAXWAIT
This CONTROL-M parameter specifies the number of extra days a job must wait to be executed in the Active Jobs file until it is disregarded. This 2-digit parameter accepts values in the range from 00 through 98, or 99, and is specified in the &MAXWAIT conversion parameter, which is described in &MAXWAIT on page 154. The default value is 03.
141
However, this does not apply when CA-7 SYMETRIC schedules are being converted. For more information, see 17. Scheduling Information on page 109.
142
Appendix
Conversion Parameters
CONTROL-M conversion parameters are defined in the DEFAULTS member in the conversion source library. These conversion options must be modified to fit your local site requirements, and are described in Table 31 in alphabetical order.
Table 31 Parameter Conversion Parameters (Part 1 of 18) Description
&ALLMSG
Specifies whether all messages in the JCL conversion (JOB4) are to be printed. Valid values are:
s
Y (Yes) All CA-7 batch terminal commands that are not supported or are not relevant in a CONTROL-M environment, such as /LOGON, are printed. N (No) An error message is issued only when the conversion encounters problems with the CA-7 Batch Terminal commands that it attempts to convert, such as DEMAND, POST, RESCHNG. Default.
&CALPREF
Calendar prefix for CONTROL-M calendar names. Must be 6 characters in length. Names in certain forms must not be used, and these are discussed in JOB3 - Create CONTROL-M Scheduling Tables and CMEM Rules on page 50. Default: CTMCAL Specifies whether CA-7 CLASS Barrier support is to be implemented. For more information, see 12. CLASS, # RES and DEMAND[H] on page 104. Valid values are:
s
&CLASBAR
Y (Yes) CA-7 CLASS Barrier support is implemented. The conversion tool creates CLASS Barrier resources in the CONTROL-M job scheduling definition. N (No) CA-7 CLASS Barrier support is not implemented. Default
Appendix A
Conversion Parameters
143
Table 31 Parameter
&CTDCOND
Only applicable at sites where CONTROL-D is installed. The user-text parts of the OUT conditions are added to job scheduling definitions when the DCAT basic scheduling parameter is specified in a job scheduling definition. Default: Blank, which indicates that no OUT conditions are to be added to the job scheduling definitions. For more information, see CATEGORY on page 140.
&CTR
Y (Yes) CONTROL-M/Restart is implemented with CONTROL-M. Default. N (No) CONTROL-M/Restart is not implemented. Instructs the conversion tool not to set any CONTROL-M/Restart statements. X Same as Y, except that $EXERR is used instead of $ABEND in the DO IFRERUN statement. For information about the difference between $ABEND and $EXERR, see the discussion of the DO IFRERUN post-processing parameter in the CONTROL-M for OS/390 and z/OS User Guide.
the CA-7 job definition indicates INSERT-RMS is set to Y INSERT-RMS is set to YES in the CA-11 JCL comment statement (//*CA-11) the CA-11 U11RMS step (specifying processing options P, R, or F) is present in the JCL of the job
a DO IFRERUN statement is inserted in the job scheduling definition. For more information, see 30. INSERT-RMS and //*CA-11 Comment Statements on page 122, and 31. CA-11 U11RMS Step on page 123.
144
Table 31 Parameter
&CTR (continued)
In addition, when &CTR is set to Y or X, the following CONTROL-M/Restart job scheduling parameters are also set:
s
AUTO-ARCHIVE is set to Y, to indicate that the three SYSDATA files of a job are archived for CONTROL-M/Restart use and for Online Viewing. Archive parameters, such as retention period or archive data set types, are determined by CONTROL-M/Restart installation parameters. SYSDB is set to Y, to indicate that the three SYSDATA files are to be archived to a common data set (as opposed to a unique data set). PREVENT-NCT2 is set. The CA-11 U11RMS Run Handler program, in production processing mode (with PARM set to 'P') ensures that all output (DISP=NEW) simple data sets in the job stream are uncataloged and scratched for the current production run. The CONTROL-M/Restart PREVENT-NCT2 parameter performs this function. PREVENT-NCT2 is set by the &PRVNCT2 conversion parameter, which is described later in this table. When set to Y, this job scheduling definition specification automatically prevents NOT CATLGD 2 situations from occurring in non-restarted jobs, by causing the deletion of problematic data sets prior to job execution.
Note: The CONTROL-M/Restart PREVENT-NCT2 processing encompasses data sets with any DISP setting (not just DISP=NEW). Therefore, CONTROL-M/Restart EXCLUDE DSN statements may be necessary for some data sets, such as data sets specifying DISP=(OLD,CATLG), for proper CA-11 emulation.
Appendix A
Conversion Parameters
145
Table 31 Parameter
&CTR (continued)
In CA-11, the user option module is generated by the U11OPTBL macro, which codes the default return code value issued by CA-11 during rerun (R) processing. If this value is not 0, you must specify the ADDPROC, PROCRC, and NCT2RC parameters in the CTRPARM member of the IOA PARM library. These parameters simulate the action of CA-11 in passing the desired return code to subsequent job steps, and are described in the INCONTROL for OS/390 and z/OS Installation Guide. Specify these parameters as follows:
s
Set the ADDPROC parameter to the step name specified in the STEPRMS parameter of the RESTART statement in the CA-7 Initialization file, or the default value of CA07RMS. Take PROCRC from the U11OPTBL CA-11 macro. If you want the CONTROL-M/Restart step to simulate a non-zero return code during the the original run of the job for NCT2 processing, specify NCT2RC.
If you use the CA-11 U11VOLCX macro (Volume INCLUDE/EXCLUDE list) or the U11UCSEX exit (Uncatalog/Scratch exit), you must either specify corresponding CONTROL-M/Restart EXCLUDE DSN statements, or Exit 1 (CTRX001) to perform the equivalent function. &CTRCONF CONTROL-M/Restart confirmation parameter. If the &CTR conversion parameter is set to Y, this parameter specifies whether manual confirmation is required before the job is scheduled for restart using the DO IFRERUN statement. Valid values are:
s s
Y (Yes) Manual confirmation is required. Default. N (No) Manual confirmation is not required.
146
Table 31 Parameter
&DCTGRY
Only applicable at sites where CONTROL-D is installed. A character string to be searched for, starting in column 1, in the JCL of the job that precedes the CONTROL-D Report Decollating Mission Category specification and identifies its position. Default: Blank, which indicates that no D-CAT basic scheduling parameters are to be specified in the job scheduling definitions being set up by the conversion tool. For more information, see CATEGORY on page 140.
&DELCOND
Specifies whether any, and if so what type of, conditions must be deleted from the IOA Conditions file when the job ends successfully, regardless of the LEADTM. Valid values are:
s
A (All) delete all IN conditions, including job-triggering and manual conditions The job-triggering conditions are deleted as OUT conditions in the group entity definition. Y (Yes) delete job connection conditions only N (No) do not delete conditions Default.
When many jobs run more than once each day, this parameter is useful for cleaning used conditions from the IOA Conditions file, so that a condition that triggered a successful job run does not trigger subsequent job runs. Warning! Do not set &DELCOND to A or Y if different jobs wait for the same IN conditions, or these jobs will be prevented from executing.
Appendix A
Conversion Parameters
147
Table 31 Parameter
&DEMAND
The conversion tool converts CA-7 DEMAND[H] commands differently, depending on the value of the &DEMAND conversion parameter. Valid values are:
s s
When &DEMAND is set to CTM (CONTROL-M mode), the conversion tool converts DEMAND[H] commands by incorporating the demanded job into a CONTROL-M scheduling table and specifying a demanded job IN condition in its job scheduling definition. The DEMAND[H] command step in the demanding job is converted to a CONTROL-M IOACND step with an ADD COND command to add the IN condition. This method provides increased control over your application jobs, since the demanded jobs become part of the application job tree by means of scheduling criteria as well as job connections. Nested demanded jobs are also incorporated into the application job tree structure. This enables all relevant CONTROL-M facilities to treat these jobs as one application. For example, the CONTROL-M Simulation and Forecasting facility handles all scheduled jobs, including demanded jobs, that would otherwise have been ignored, as they are in the CA-7 forecasting utility. When &DEMAND is set to CA7 (CA-7 mode), the conversion tool converts DEMAND[H] commands by creating a new (non-group) scheduling library in which the job scheduling members consist of the demanded jobs as head-of-tree jobs. The remainder of the jobs in each scheduling member are the jobs that are triggered from the demanded head-of-tree job. The DEMAND[H] command step in the demanding job is converted to a CTMUTIL step (which invokes the CONTROL-M CTMJOB utility) with an ORDER command to FORCE the job and all its successor jobs into the daily schedule. For more information on the CTMUTIL utility, see Appendix D, The CTMUTIL Conversion Utility.
148
Table 31 Parameter
&DEMAND (continued)
This method more closely resembles the way demanded jobs are processed by CA-7. The jobs are not incorporated into the application job tree, as in the CONTROL-M mode. The advantage to this method is that demanded jobs are ordered into the Active Jobs file only when they are actually to be executed. Demanded branches that are only executed in specific circumstances, such as demanded branches dependent on a specific prior step condition code, are not ordered into the Active Jobs file when not needed. This reduces clutter in the Active Jobs file and possible confusion as to which jobs must run. Note: The only demanded jobs that are incorporated into CONTROL-M scheduling definitions by the conversion tool are the jobs with JCL members that are referenced by jobs defined in the CA-7 LJOB report using a DEMAND[H] statement in the JCL member. These demanded jobs are then subject to being divided during JOB7, which is discussed in JOB7 Create CONTROL-M Group Scheduling Tables on page 64. If a job which issues a DEMAND is not defined in the LJOB report, the job which it demands is not processed by JOB7 as a demanded job, but as an unscheduled job.
Appendix A
Conversion Parameters
149
Table 31 Parameter
&DEPJCND
Specifies the format of the CA-7 job and DSN connection dependency IN and OUT condition names. Valid values are:
s
N (No) The condition names are formatted as specified in 19. DEP-JOB on page 112 and 21. DSN on page 113. Default. J (Job) The condition names for job connection dependencies are formatted as follows: jobname_dep-jobname_OK ODAT The variable jobname is the CONTROL-M MEMNAME of the predecessor job, on which dep-jobname is dependent; this is also referred to as the predecessor job name. The variable dep-jobname is the CONTROL-M MEMNAME of the successor job, which is dependent on jobname; this is also referred to as the successor job name. D (DSN) The condition names for DSN connection dependencies are formatted as follows: creating-jobname_dep-jobname_DS ODAT The variable creating-job is the CONTROL-M MEMNAME of the job that creates the data set that defines the DSN connection dependency. The variable dep-jobname is the CONTROL-M MEMNAME of the dependent job. Y (Yes) The condition names for job dependencies are formatted as if J was specified, and the condition names for DSN connection dependencies are formatted as if D was specified
Notes:
s
When J, D, or Y are specified for &DEPJCND, a separate OUT condition is created for each job for which a job or DSN connection exists. This may lead to a much larger number of OUT conditions being created. If you specify &DEPJCND=N, only one job connection OUT condition is created for each job.
150
Table 31 Parameter
Specifying J, D, or Y for &DEPJCND provides a considerable degree of close control for manipulating OUT conditions. For example, if Job A has three dependent jobs (B, C, and D), three IN/OUT conditions are created, B_A_OK, C_A_OK, and D_A_OK, each in the respective job scheduling definition. If Job A abends, you can selectively trigger Job B without affecting Jobs C and D by adding the condition B_A_OK to the IOA Conditions file. If the value of the CA-7 job connection LEADTM parameter (the satisfaction lead time in hours) is 00, the conversion tool automatically creates OUT conditions that delete condition names which have an ODAT of ****. For more information, see Item 19 in 19. DEP-JOB on page 112. If you often use this feature, specifying J, D, or Y for &DEPJCND will give you close control over the deletion of job and DSN connections. When you set &DEPJCND to J or Y, conditional job connections create IN and OUT conditions in the following format: ?jobname_dep-jobname_OK
&DIRMAX
Maximum number of members in a CA-7 JCL library. The value you set for &DIRMAX must be as small as possible without going below the actual maximum. Default: 10000
&FROMC
Which of the held sysout classes must be requeued. Specify (blank) if all held sysouts must be requeued. Default: (Blank) When TOCLASS is this parameter is ignored.
&HISTORY
Dnnn The retention period (nnn), measured in days. Gnn The retention period (nn), measured in generations. (Blank) Do not use the History Active Jobs file feature. Default.
&INCLIB
Appendix A
Conversion Parameters
151
Table 31 Parameter
&INIT
CONTROL-M Quantitative resource name for controlling initiators that is added, with a quantity of 1, to the job scheduling definition of each executable job. To suppress creation of an initiator resource, set &INIT to ' ' (Blank). Default: INITIATOR
&JESRPRT
Specifies whether JES ROUTE PRINT JCL statements are to be converted to CONTROL-M SYSOUT post-processing parameters. Valid values are:
s
Y (Yes) JES ROUTE PRINT JCL statements are converted. For more information, see 42. JES ROUTE PRINT on page 130. Default. N (No) JES ROUTE PRINT JCL statements are not converted.
&JOBCLAS
CA-7 JCL Job Class conversion. This parameter specifies whether JCL job classes are converted to CONTROL-M Quantitative resources. For more information, see 27. JCL Job Class on page 120. Valid values are:
s
' ' (Blank) suppress the creation of Quantitative resources. Default. in cases where the JCL job statement contains no CLASS parameter, the default job class to be used to create the resource name.
&JOBMXOC
Maximum number of occurrences of a job within a scheduling table. This parameter enables the control of application creation by the conversion tool when CA-7 DEMANDs are encountered in the JCL, or for recursively-defined jobs. Valid values are from 1 through 35. Default: 5
&LINMAX
Maximum number of lines in a JCL member. Default: 5000. Ensure that this number is large enough to accommodate the growth of JCL members due to the insertion of CONTROL-M AutoEdit statements by the conversion tool.
152
Table 31 Parameter
&L2VARS
For users who are running CA-7 release 3.1 or later, and have implemented CA-DRIVER only. CA-DRIVER provides various reserved-name variable parameters specifically for CA-7. These variables can be referenced in CA-DRIVER procedures, and values are automatically assigned when the variable is referenced during procedure expansion. Many of these variables can be automatically converted by the conversion tool, as follows. The CA-DRIVER variable is converted to a CONTROL-M AutoEdit variable, and a CONTROL-M SET VAR statement for the newly created AutoEdit variable is placed into the job scheduling definition of the invoking job to provide an initial value. The initial value is derived from the corresponding CA-7 job definition. The conversion supports the CA-DRIVER variables listed in Table 32, CA-DRIVER Variables, on page A-161. For the definition of CA-DRIVER system variable and other CA-7 specific variables, such as &C_MONTH, &C_DAY, &C_DATE, &C_JDATE, &C_TIME, &C_L2SID, &C_L27# , and &C_L2JN, see the DAYMONTH member in the conversion source library. Since not all users utilize all the above variables in their CA-DRIVER procedures, this conversion parameter enables you to choose whether to create the corresponding SET VAR parameters in the job scheduling definitions, thereby preventing clutter in the job scheduling definitions. The choice is indicated by coding a positional Y (Yes) or N (No) value in the &L2VARS parameter. The position of the Y or N corresponds to the position of the relevant variable in the list in Table 32, CA-DRIVER Variables, on page A-161. For example, &L2VARS=NNYYNNNNYN indicates that the only variables that will be automatically processed by the conversion tool are &C_L2RO, &C_L2CC, &C_L2DOT. Default: &L2VARS=NNNNNNNNNN
Appendix A
Conversion Parameters
153
Table 31 Parameter
&MAXGENT
The maximum number of lines in a group scheduling entity. Default: 5000. In general, the default value of this parameter should not be changed unless the CTMCA7V5-12S error message is displayed. In that event, the value of &MAXGENT should be increased to approximately 5% of the value in the PARM parameter on the EXEC statement in STEP2 of JOB7.
Maximum number of calendars contained in the AUXCAL file. Default: 5000 Maximum number of data set triggers that create CMEM events. Default: 1000 Number of extra days a job must wait in the Active Jobs file to be executed, after which the job is deleted. Format: 2 digits. Leading zeroes are required. Default: 03
&PNIBTSD
Process Non-Instream Batch Terminal SYSIN Data indicator. Whether to convert CA-7 Batch Terminal commands, such as DEMAND, POST, and RESCHNG, that are not contained instream in the SYSIN DD statement of a CA-7 Batch Terminal Step (that is, are pointed to by a sequential file or a member of a PDS). Valid values are:
s s
Y (Yes) Convert the commands. N (No) Do not convert the commands. Default.
For sites where references to Batch Terminal commands are made from within JCL procedures, that is, the SYSIN DD statement does not appear in the JCL member being converted, you can run the JCL conversion (JOB4) against the affected procedure library. Note: If &PNIBTSD is set to Y, in addition to the JCL libraries defined in the CA-7 Initdeck, you should copy all PDSs and sequential data sets containing CA-7 Batch Terminal command members, to preserve the original PDSs and sequential data sets. For more information, see Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck on page 73. In case of fallback to CA-7, simply delete the original PDSs and sequential data sets and rename the copies to the original production names.
154
Table 31 Parameter
&PRVNCT2
Y (Yes) Sets PREVENT-NCT2 to Y on all jobs. N (No) Sets PREVENT-NCT2 to N on all jobs. CA7 Sets PREVENT-NCT2 to either Y or N, based on the INSERT-RMS definition of CA-7, and whether the JCL of the job contains the CA-11 U11RMS step, specifying processing options F, P, R, or N. If the JCL contains the CA-11 U11RMS step, or the CA-11 JCL comment statement is coded with a PARM parameter, PREVENT-NCT2 is set to Y, regardless of how the CA-7 INSERT-RMS parameter is set, except when the PARM parameter is coded as N (null processing), or P,PSEUDO=YES (pseudo production processing). If the JCL does not contain the CA-11 U11RMS step, and the INSERT-RMS parameter is set to Y, or the CA-11 JCL comment statement is coded as INSERTRMS=YES, PREVENT-NCT2 is set to Y, except when the PARMRMS parameter of the RESTART statement in the CA-7 Initialization file is set to PSEUDO. Default.
This parameter is ignored when &CTR is set to N. For more information, see PREVENT-NCT2 under the &CTR conversion parameter in this table. &REL &RELEASE The release of CA-7 from which you are converting, in the format x.y (for example, 3.1). Default: 3.0 Sysout release specifies whether the job sysouts are released for printing after they are analyzed by CONTROL-M, or are deleted. Valid values are:
s s
R Release sysouts for print. Default. D Delete the sysouts. This parameter may be useful at sites that have sysout archival products. (Blank) Ignore the &RELEASE parameter.
Appendix A
Conversion Parameters
155
Table 31 Parameter
&RESFREE
Whether to include the CA-7 FREE status (A, F, N, or Y) of resources in the Virtual Resource Management facility as a prefix to the converted CONTROL-M Resource name.
s s s s
N Do not include the FREE status. Default. C Include FREE status for Control resources. Q Include FREE status for Quantitative Resources. B Include FREE status for both Control and Quantitative resources.
&SCCGLBL
Provides the ability to treat *-stepname in the stepname parameter of the # SCC JCL override statement as if * alone had been specified.
s
N (No) The CTMCA706-01E message is displayed when *-stepname is encountered. Default. Y (Yes) *-stepname is treated like *, that is, the CONTROL-M ON PGMST parameter is set to +EVERY when converting the # SCC statement. For more information, see 10. COND-CODE, RO and # SCC on page 102. F Only the first occurrence of a # SCC JCL statement in the member containing *-stepname is converted as above. The CTMCA706-01E message is displayed for all other occurrences.
The CTMCA706-01E message is described in CTMCA70601E on page 172. &SCHDMOD SCHDMOD CURRENT calendar indicator. Enables you to specify globally whether SCHDMOD CURRENT calendars are automatically placed into the job scheduling definitions for all applications. Valid values are:
s
N (No) SCHDMOD CURRENT calendars are not automatically placed into the job scheduling definitions for all applications. Default. Y (Yes) SCHDMOD CURRENT calendars are automatically placed into the job scheduling definitions for all applications.
For more information, see 13. SCAL on page 105, and JOB2 - Create the Applications List, Calendar Libraries, and Calendar Names List Files on page 46.
156
Table 31 Parameter
&SHOUTDL
Destination for SHOUT WHEN LATE and SHOUT WHEN EXECTIME messages. For more information on valid values and the default, see &SHOUTDT in this table. Destination for SHOUT messages when a job failed. Valid values are:
s
&SHOUTDT
SYSUSER Use the user ID associated with the specific job or scheduling table. For more information, see &USEROPT in this table. Default. OPER Issue the SHOUT message to the console. OPER2 Issue the SHOUT message to the console, as highlighted and unrollable. TSO-uid Issue the SHOUT message to a specific TSO user ID. The variable uid is a specific user ID of up to 7 characters
For information about additional options, see SHOUT in the parameter descriptions chapter of the CONTROL-M for OS/390 and z/OS User Guide. &SHOUTE The text (up to 50 characters) of the SHOUT WHEN LATE * message that is sent when the job is still executing after its DUE TIME time has passed. Specify ' ' (blank) to suppress the message. The default is: %%JOBNAME J%%JOBID STILL EXECUTING AFTER DUE OUT! The text (up to 50 characters) for the SHOUT WHEN LATESUB message that is sent when the submission time for the job has elapsed. Specify ' ' (blank) to suppress the message. The default is MEMBER %%$MEMNAME IS LATE! The text (up to 50 characters) for the SHOUT WHEN NOTOK message that is sent when a job fails. Specify ' ' (blank) to suppress the message. The default is: %%JOBNAME J%%JOBID ENDED NOTOK! 2-digit value added to the weighted average elapsed runtime of the job and used to determine the CONTROL-M SHOUT WHEN EXECTIME parameter. Specify ' ' (blank) to suppress this message. Default: 05. For more information, see 38. SHOUT on page 127.
&SHOUTL
&SHOUTT
&SHOUTX
Appendix A
Conversion Parameters
157
Table 31 Parameter
&STARTM
When an SBTM CA-7 submit time is specified, it is always used as the CONTROL-M FROM TIME. When the SBTM is not specified, the value of the &STARTM parameter determines the FROM TIME, as follows:
s
Y (Yes) The CA-7 deadline start time (STARTM parameter on the LJOB report) is always used. N (No) The deadline start time is used only when the job has no prerequisite IN conditions, accompanied by a warning message, CTMCA705-06W; otherwise, the CONTROL-M FROM TIME is left blank. Default.
&SUPMSG
' ' (Blank) Do not suppress any messages. I Suppress information messages. W Suppress warning and information messages.
&SWLPROP
Whether to propagate the SHOUT WHEN LATESUB message to all successor jobs of the head-of-tree job. Valid values are:
s
Y (Yes) Propagate the SHOUT WHEN LATESUB message to all successor jobs of the head-of-tree job. Default. N (No) Do not propagate the SHOUT WHEN LATESUB message to all successor jobs of the head-of-tree job.
&TAPE1
CONTROL-M Quantitative resource name for the CA-7 TAPE1 resource, corresponding to the value of the NAME parameter of the CA-7 workload balancing TAPE1 macro. Default: TAPE1 CONTROL-M Quantitative resource name for the CA-7 TAPE2 resource, corresponding to the value of the NAME parameter of the CA-7 workload balancing TAPE2 macro. Default: TAPE2
&TAPE2
158
Table 31 Parameter
&TOCLASS
New output class to which CONTROL-M is to requeue the JCL MSGCLASS sysouts of the job. Valid values are:
s s
' ' (Blank) Reroute is not required. * (Asterisk) The MSGCLASS sysouts of the job must be requeued to the original MSGCLASS after they are analyzed by CONTROL-M. Default. In this case, the &FROMC conversion parameter, which is described in this table, is ignored, and the SYSOUT HELD class is taken from the HLDCLS parameter in the CTMPARM member in the IOA PARM library.
&UNTIL
Time Until Indicator. The conversion tool does not set the CONTROL-M TIME UNTIL scheduling parameter unless you set the &UNTIL conversion parameter to >. Valid values are:
s
> (Greater) The TIME UNTIL parameter is set to > in every job definition. Default. ' ' (Blank) The TIME UNTIL parameter is not set.
For more information, see the TIME parameter in the CONTROL-M for OS/390 and z/OS User Guide. &USERLEN When the &USEROPT conversion parameter is specified as OWNER, JOB, APPL, JCLUSER, JCLGRP, or NOTIFY, this parameter specifies how many characters of the specified parameter are used for the CONTROL-M OWNER parameter. Default: 8
Appendix A
Conversion Parameters
159
Table 31 Parameter
&USEROPT
Source for the CONTROL-M OWNER job scheduling parameter. The OWNER parameter is useful for implementing security checking by various CONTROL-M components. In the following description of values, n is set by the &USERLEN parameter, which is described elsewhere in this table. Valid values for &USEROPT are:
s
JOB The first n characters of the job name in the scheduling table. Default. OWNER/xxxxx The first n characters of the CA-7 OWNER parameter. xxxxxxxx is a fixed default value for the OWNER parameter when OWNER=*NONE* is specified. APPL The first n characters of the CONTROL-M application name (APPL). =xxxxxxxx A fixed value of xxxxxxxx (1 through 8 characters) for every CONTROL-M job scheduling definition. CA7USERID/xxxxx A fixed value of xxxxx (1 through 5 characters) followed by the CA-7 USR ID parameter of the job.
The following options create an OWNER parameter derived from the JCL JOB statement of the job.
s
JCLUSER The first n characters of the JCL USER=JOB statement parameter. JCLGRP The first n characters of the JCL GROUP=JOB statement parameter. NOTIFY The first n characters of the JCL NOTIFY=JOB statement parameter.
For these options, an OWNER ID of NOUSER, NOGROUP, or NONOTIFY is specified for jobs whose JCL member cannot be found and for jobs whose JOB statement does not contain a USER, GROUP, or NOTIFY parameter, respectively.
160
Table 32 No.
Variable
1 2 3 4 5 6 7 8 9 10
&C_L2UID &C_L2SN &C_L2RO &C_L2CC &C_L2PRY &C_L2CLS &C_L2# T1 &C_L2# T2 &C_L2DOT &C_L2MID
CA-7 user security identification. Application system name. Relational operator of the condition code (OR if step level # SCC statements are being used). Job level condition codes, used to determine whether a job executes successfully. CA-7 workload-balancing job priority. CA-7 workload-balancing job class. TYPE1 tape drives needed for the job. TYPE2 tape drives needed for the job. Job due-out time of day, for a particular schedule ID. Indicates on which CPU a job may or may not be scheduled.
Appendix A
Conversion Parameters
161
162
Appendix
Messages
This list contains only messages produced by the components of the conversion tool. Messages issued by other CONTROL-M components are described in the INCONTROL for OS/390 and z/OS Messages Manual. A message code usually consists of the following parts:
CTMyyyaa-nnx
CTM indicates that the message pertains to CONTROL-M. The variables in the message are: Item Explanation
yyy
3-character identifier of the conversion tool component that produced the message. Examples:
s s
CA7CTMCA7aa-nnx CA-DRIVERCTMDRyaa-nnx
aa nn x
2-character identifier for the component that produced the message. 2-character numeric identifier for the message. 1-character alphabetic identifier for the severity of the message. Valid values are:
s s s s s
Appendix B
Messages
163
Message descriptions contain any or all of the following: Explanation: A description of the cause of the message, and other related information. System Action: System action when this message is issued. User Response: Recommended actions to correct the problem.
CTMCA701-01S
Explanation: Beginning at the jobname job, the CA-7 LJOB report is not sorted in job name order. System Action: The step terminates with a return code of 12. The rest of the job is flushed. User Response: Do the following: 1. Ensure that all CA-7 LJOB reports are concatenated in sorted job name order, or that all multiple CA-7 LJOB commands in the CA-7 Batch Terminal program are in sorted job name order and do not overlap. 2. Recreate the CA-7 LJOB report. 3. Rerun the conversion from JOB1.
CTMCA702-00W
Explanation: No CA-7 JCL control statements were found in the CA-7 Initdeck file. System Action: JOB3 bypasses all JCL checking and processing.
CTMCA702-01W
Explanation: The jobname CA-7 job name differs from its JCL member name. In CONTROL-M, jobs are identified by their JCL member names, and the conversion tool uses the JCL member name as the job identifier. When the CA-7 job name differs from its JCL member name, the conversion tool creates an INCLUDE member in the library referenced by the DAINCLIB DD statement. User Response: Consider installing CONTROL-M Exit 2. For more information, see Step 12 - Modify and Run the JOB8 Member (Optional) on page 84.
164
CTMCA702-03E
Explanation: The Applications List file (the DASYN DD statement) contains duplicate occurrences of the tablename CONTROL-M scheduling table name. Since scheduling table names are also PDS member names, they must be unique. User Response: Do the following: 1. Replace duplicate occurrences of tablename in the Applications List file with unique scheduling table names 2. Rerun JOB3.
CTMCA702-04E
CONTROL-M SCHEDULING TABLE NAME tablename NOT A VALID PDS MEMBER NAME
Explanation: The Applications List file (the DASYN DD statement) contains an invalid CONTROL-M scheduling table name, identified by the variable tablename. User Response: Do the following: 1. Replace tablename in the Applications List file with a valid PDS member name. 2. Rerun JOB3.
CTMCA702-05W
Explanation: The CA-7 job definition for the jobname job states that the JCL member of the Override library must be used for the next run of jobname. However, the conversion uses the JCL member from the original library (identified by the CA-7 JCL ID). User Response: Check modifications of the JCL in the Override library. The CONTROL-M AutoEdit facility can be used to perform JCL modifications.
CTMCA702-06W
Explanation: Triggering networks are not supported and are not converted.
Appendix B
Messages
165
CTMCA702-07W
Explanation: The Application List file contains no data. The error may be due to one of the following:
s s s
The DASYSN DD statement in JOB3 does not point to the correct file. An error occurred when JOB2 was creating the Application List file. You may have modified the LJOB command in JOB1 (LJOB,JOB=*) to produce only a subset of all the CA-7 jobs, which may have been insufficient to produce an Application List file in JOB2.
User Response: Do the following: 1. Check that DASYSN points to the correct file, correct the JCL, and rerun JOB3. 2. Correct any error in JOB2, and rerun JOB2 and JOB3. 3. Specify a more generic JOB parameter in the LJOB command of JOB1 so as to generate sufficient jobs to produce an Application List file, then rerun JOB1, JOB2, and JOB3.
CTMCA702-08W
Explanation: The jobname job contains a DSN-type job connection. The dsn data set that creates the connection can be created by more than one job. User Response: You must manually define IN prerequisite conditions, OUT prerequisite conditions, or both, to connect the creating jobs to the jobname job in the respective CONTROL-M job scheduling definitions. System Action: The dsn connection is ignored.
CTMCA702-09E
Explanation: The CA-7 job definition for the jobname job contains a job-level condition code that uses an unknown relational operator. System Action: The condition code is ignored by the conversion tool. User Response: Do either of the following:
s
Correct the relation operator in the RO parameter of the CA-7 database, and rerun JOB1 and JOB3.
166
CTMCA702-10E
Explanation: A problem occurred while the conversion tool was analyzing relevant lines in the CA-7 Initdeck member. The conversion tool uses the CA-7 Initdeck in order to extract the CA-7 JCL library names, determine the job entry subsystem to which JCL is submitted (JES2 or JES3), and so on. User Response: Correct the specification of the DAINIT DD statement in the JCL of JOB3 and rerun the job.
CTMCA702-11S
Explanation: The conversion tool found the jobname job twice in the LJOB report. Since job names are unique in the CA-7 database, the error is probably due to a problem in the DAREPORT DD statement in the JOB3 JCL member. System Action: The program terminates. User Response: Do the following: 1. Correct the specification of the DAREPORT DD statement in the JCL of JOB3, and rerun JOB3. 2. Make sure that you have not concatenated multiple LJOB reports that contain jobs of the same name. If this is the case, each LJOB must be separately converted.
CTMCA702-17S
Explanation: JOB1 and JOB3 contain a parameter that specifies the maximum number of jobs that can be handled. In the case of JOB1, this parameter is in the PARM parameter in the EXEC statement of STEP5. In the case of JOB3, it is in the PARM parameter in the EXEC statement of STEP2. The CA-7 LJOB report contains more jobs than the value specified in that parameter. User Response: Increase the relevant PARM value or values, and rerun JOB1, JOB3, or both JOB1 and JOB3, as appropriate.
Appendix B
Messages
167
CTMCA702-20W
JOB jobname SCHEDULE ID schid CONTAINS DOTM/STARTM BEFORE NEWDAY TIME, AND SUBTM IS AFTER
Explanation: The jobname CA-7 job definition for schedule ID schid specifies either DOTM or STARTM between midnight and the CONTROL-M New Day Start time (that is, the start of the new logical workday), but the SUBTM time is after the New Day Start time. Generally, SHOUT WHEN LATE messages are issued at the start time of the job. However, when the submission time is after the New Day Start time, the SHOUT WHEN LATE message is only issued after the New Day Start time.
CTMCA705-01W
JCL MEMBER memname NOT FOUND IN lib WILL NOT BE EXECUTED, RC=nn
Explanation: During the conversion process the JCL member of each job is read in order to extract additional information. The specified JCL member could not be found in the lib library, or in its alternate JCL library, if one was specified using the ALT parameter of the JCL Initialization Statement. For an explanation of the return code nn, see the CTMCA799-03S message. System Action: The CONTROL-M job scheduling definition is created, but the job cannot run if the JCL member cannot be found. User Response: Determine whether the job is needed. If it is needed, create a JCL member for the job.
CTMCA705-02S
SYSTEM sysname SCHID schid NOT FOUND IN APPLS TABLE PROCESSING STOPS
Explanation: While trying to assign the CONTROL-M scheduling table name to a job, its CA-7 system name and schedule ID could not be located in the Applications List file. This error indicates that the Applications List file was probably incorrectly modified manually. System Action: The job stops processing. User Response: Correct the Applications List file and rerun JOB3.
CTMCA705-03E
Explanation: The conversion tool could not find the jobname job in the LJOB report. This message may be due to one of the following:
168 CONTROL-M for OS/390 and z/OS CA-7 Conversion Guide
The jobname job, which is triggered by the trigjob job that appears in the LJOB report, does not itself appear in the LJOB report. The jobname job, as specified in a DEMAND command in a CA-7 Batch Terminal step in the trigjob job, does not appear in the LJOB report. The jobname job, which appears as a dependent (successor) job of the trigjob job in the LJOB report, does not itself appear in the LJOB report.
System Action: The conversion tool cannot define the jobname job. User Response: Determine whether the jobname job is needed. If it is needed, do one of the following:
s
Check and correct the CA-7 database (for the jobname job) and rerun JOB1 and JOB3. Modify the CONTROL-M scheduling table.
CTMCA705-04I
Explanation: Informational message indicating that a CONTROL-M scheduling table memname is to be written to the scheduling library pointed to by ddname.
CTMCA705-05E
TOO MANY LEVELS FOR JOB TREE STARTING WITH JOB jobname SCHEDULE ID schid
Explanation: As supplied, the conversion tool can handle job trees of up to 255 levels. The specified job tree contained too many levels. This usually means that a recursive job tree has been defined in the CA-7 database for the CA-7 jobs. The recursive job can be defined by triggering, or by a DEMAND from the JCL. User Response: Verify that there is no recursive job tree in the CA-7 database.
CTMCA705-06W
Explanation: The jobname CA-7 job definition for the schid schedule ID contains no prerequisite conditions. Since CONTROL-M submits jobs at the earliest possible time, this job is submitted immediately after the New Day procedure.
Appendix B
Messages
169
User Response: Verify the CONTROL-M job scheduling definition. If required, a FROM parameter can be added to the job scheduling definition.
CTMCA705-07S
Explanation: When the CA-7 job name differs from its JCL member name, the conversion tool creates an INCLUDE member in the library referenced by the DAINCLIB DD statement. This message indicates that an error occurred when the program tried to obtain the name of the library. System Action: The program terminates. User Response: Verify that the DAINCLIB DD statement is pointing to a correctly allocated PDS.
CTMCA705-08I
Explanation: This information message indicates that a JCL INCLUDE member has been written to the INCLIB library pointed to by the DAINCLIB DD name.
CTMCA705-09E
NUMBER OF OCCURRENCES OF JOB jobname IN SCHEDULING TABLE tbl EXCEEDS THE MAXIMUM VALUE
Explanation: As a result of CA-7 JCL DEMANDs or recursive TRIGGERED JOBS definitions (in LJOB), the jobname job has exceeded the maximum number of occurrences defined by &JOBMXOC in the DEFAULTS member in the tbl scheduling table. System Action: The job continues processing, but ignores any further occurrences of the specified job. User Response: Do the following: 1. Check the JCL DEMANDs or the TRIGGERED JOBS definition within the application structure. If jobname is a non-recursive JCL DEMAND job, consider increasing the value of &JOBMXOC. 2. Either manually restructure the application by means of CONTROL-M features such as ON PGMST or DO FORCEJOB, or increase the value of &JOBMXOC. 3. Rerun the ASMLINK and JOB3 jobs.
170
CTMCA705-10E
Explanation: The conversion tool could not find a calendar in the Calendar Names List file (created by JOB2) to supply the proper calendar name in the DCAL parameter of the CONTROL-M job scheduling definition. Most likely, the CA-7 job schedule was not RESOLVEd. Therefore, no schedule day calendar was available for display in the LSCHD report, produced in JOB0, to be used in the CONTROL-M DCAL parameter. This leads to improper Basic Scheduling parameters being created in the job scheduling definition. System Action: JOB3 continues processing. User Response: Do the following: 1. Ensure that all CA-7 scheduling members are RESOLVEd. 2. Rerun STEP2 of JOB0 to recreate the LSCHD report. 3. Rerun JOB2 and JOB3. Alternatively, you can manually update the CONTROL-M job scheduling definition to conform to the CA-7 scheduling definition parameters.
CTMCA705-11W
Explanation: The conversion tool found that the jobname job of the schid schedule ID is either triggering or demanding itself. To prevent such looping, the conversion tool ignores this recursive definition. User Response: Use the CONTROL-M TASKTYPE cyclic job scheduling definition to accomplish this task. To prevent the job from being continually resubmitted, it is recommended that the cyclic job either delete the prerequisite conditions that triggered its operation, or set a TIME UNTIL parameter.
CTMCA705-12W
Explanation: In a CA-7 # SCC JCL override statement in the jobname job, the conversion tool encountered a relational operator, ro, that is not supported by CONTROL-M. System Action: The job continues processing, but the # SCC statement is ignored.
Appendix B
Messages
171
CTMCA705-14I
PHASE 2
Explanation: The CA-7 conversion tool is entering a second phase, converting any CA-7 jobs that were not processed during the main conversion phase. Normally, if the CA-7 database (the LJOB report) was maintained as required, you do not see any further messages after this message. If there are any further messages, the probable reason is that the CA-7 database contains orphan job definitions or broken triggering structures. Conditions of those types are normally indicated by occurrences of the CTMCA705-O3E message during the main conversion phase. System Action: Normal processing continues. User Response: Do the following: 1. Examine any scheduling tables written during the second phase. 2. Try to eliminate all occurrences of the CTMCA705-03E message. This will minimize the number of messages following the CTMCA705-14I message.
CTMCA705-24S
Explanation: The number of calendars produced in JOB2 exceeds the value specified in the &MAXCALS conversion parameter. System Action: The job stops processing. User Response: Do the following: 1. Increase the value of the &MAXCALS conversion parameter in the DEFAULTS member. 2. Rerun the ASMLINK and JOB3 jobs.
CTMCA706-01E
Explanation: The conversion tool encountered an invalid or unsupported parameter when converting a # SCC CA-7 JCL override statement for the jobname job. System Action: The conversion tool may create a partial ON PGMST post-processing parameter and continue processing. If the step name is of the format *-stepname, the # SCC statement is not processed. User Response: Modify the CONTROL-M ON PGMST parameter in the job scheduling definition of the jobname job.
172
CTMCA706-02E
Explanation: While processing the jobname job in a CA-7 or CA-11 JCL library, the conversion tool encountered an invalid PARM parameter in a CA-11 U11RMS step. System Action: The PARM parameter is not converted, but the job continues processing. User Response: Do the following: 1. Correct the PARM parameter. For more information, refer to the CA-11 User Guide. 2. Rerun JOB3.
CTMCA706-03E
Explanation: While processing the jobname job in a CA-7 or CA-11 JCL library, the conversion tool encountered an invalid JOB or SCHID or DEPJOB parameter in a CA-7 DEMAND[H] statement. The JOB or DEPJOB parameter may contain a jobname exceeding eight characters, or the SCHID may contain a non-numeric schedule-id, or a schedule-id exceeding eight digits. System Action: The DEMAND statement is not processed, but the job continues processing. User Response: Correct the DEMAND statement and rerun JOB3.
CTMCA707-00R
HAVE YOU ENSURED THAT PROD JCL LIBRARIES WILL NOT BE MODIFIED (SECT3/STEP2) (Y/N)?
Explanation: This query is always issued by JOB4 to force verification that Step 2 (described in Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck on page 73) has been carefully followed, so that copies of the Production JCL libraries are converted to CONTROL-M format and not the actual Production JCL libraries. For more information, see &PNIBTSD on page 154. System Action: If the reply is N, the program terminates without processing the JCL libraries. If the reply is Y, normal JCL library conversion is performed. User Response: Reply Y (Yes) or N (No) as appropriate.
Appendix B
Messages
173
CTMCA707-01S
Explanation: The number of Batch Terminal Parameter Control Statements (the DABTERM DD statement) may not exceed 10. System Action: Processing terminates. User Response: Contact your local INCONTROL representative.
CTMCA709-01E
Explanation: A Batch Terminal in-stream command, a Batch Terminal JCL PARM parameter, or the Batch Terminal SYSIN DD statement could not be processed. Possible reasons include the following:
s
An in-stream DEMAND command did not specify the JOB parameter. An in-stream POST command did not specify one or more of the following parameters: the JOB parameter the DEPJOB parameter the USR parameter
In trying to convert a DEMAND, POST or RESCHNG command in a JCL PARM parameter, the equivalent CTMUTIL command overflowed column 71, and could not be contained on one JCL line. The Batch Terminal SYSIN DD statement does not specify in-stream data, and the JCL DSN parameter could not be found in the SYSIN DD statement. In a DEMAND or POST command, the JOB or DEPJOB parameters can contain a job name that exceeds 8 characters, or the SCHID parameter can contain a schd-id that exceeds 3 digits. An in-stream RQVER command specified UPDATE=YES, which is not supported. An in-stream ADDRQ or D=dsn command was specified, but these are not supported. For errors involving SYSIN (only), the explanation is contained in the message immediately preceding this message.
System Action: The cmd command is not converted, or is only partially converted.
174
User Response: Inspect the indicated JCL member, and manually convert the cmd command (or commands).
CTMCA709-02W
Explanation: While processing the jobname job in a CA-7 or CA-11 JCL library, the conversion tool encountered an unsupported PARM parameter in a CA-7 Batch Terminal step. User Response: Examine the PARM parameter to determine if any manual actions are necessary to incorporate the unsupported feature in CONTROL-M. System Action: The PARM parameter is nullified by placing a blank at the end of the PARM statement.
CTMCA710-01E
Explanation: According to the CA-7 Job-to-Resource Cross Reference report, the jobname job uses certain resources. However, this job either does not appear in the Cross Reference file created by JOB3, or is not contained within any CONTROL-M scheduling table. User Response: Check if this job appears in the LJOB report that was used by JOB3.
CTMCA710-03I
Explanation: Informational message indicating that the tbl scheduling table in the scheduling table library has been updated with new resources or conditions.
CTMCA710-04E
Explanation: The tbl scheduling table, which requires a resource or condition update, could not be found in the scheduling libraries pointed to by the DASCHD DD statement. The Job-to-Resource Cross Reference report may not agree with the LJOB report. User Response: Ensure that the Resource Cross Reference report and the LJOB report are synchronized, and rerun JOB5.
Appendix B
Messages
175
CTMCA710-10S
Explanation: The Cross Reference file contains no data. The error may be due to one of the following: The DAXREF DD statement in JOB5 does not point to the correct file. s An error occurred when JOB3 was creating the Cross Reference file. System Action: The job stops processing.
s
User Response: Check if the DAXREF DD statement points to the correct file. If it does not, correct the JCL, and rerun JOB5. If it does, do the following: 1. Check the Cross Reference file created by JOB3 and make any necessary corrections. 2. Rerun JOB3. 3. Rerun JOB5.
CTMCA710-12E
Explanation: The CA-7 Resource Management report contains no processable data. The error may be due to one of the following: The DAREPIN DD statement in JOB5 does not point to the correct file. s The &REL conversion parameter in the DEFAULTS member was incorrectly specified. s there are no processable resources contained in the DAREPIN file. Only the following types of resource are supported: exclusive shared corequisite resource count resources. System Action: The job stops processing.
s
Check if the DAREPIN DD statement points to the correct file. If it does not, correct the JCL, and rerun JOB5.
176
If it does, check that the proper CA-7 release number was specified in the &REL conversion parameter, then correct and rerun ASMLINK and JOB5.
s
If the DAREPIN file contains no processable resources, no further action is required, unless you want to convert the non-supported resources manually.
CTMCA799-02E
Explanation: The func MVS memory acquisition or freeing function (GETMAIN or FREEMAIN) failed for the blockname block. The JCL REGION parameter specification is not large enough. If the message is issued by JOB1 or JOB3, it is possible that the PARM value on the EXEC statement is too high. In some cases, the name of the member (memname) and DD name (ddname) for which the function failed are displayed in the message. User Response: Increase the value of the REGION parameter.
CTMCA799-03S
CTMMEM FUNCTION func FAILED WITH RC rc [MEMBER memname] [DDNAME ddn|DSNAME dsn]
Explanation: An error occurred in the func CTMMEM function. The CONTROL-M CTMMEM routine is used to perform operations on PDS libraries and members. Return codes that indicate the cause of failure are explained in the list below.
s s s s s s s s
s s
04 end of file (in GETLINE operation) 08 insufficient memory to continue 12 member not found in library 16 data set not a library 20 data set not fixed format 24 LRECL not 80 28 data set in use 32 internal error; for example, there were insufficient directory blocks, or the file was not allocated 36 data set not found in catalog 40 dynamic allocation failed; for example, there were insufficient directory blocks, or the file was already in use. 44 invalid request to CTMMEM
Appendix B
Messages
177
s s
s s s
48 maximum number of lines or directory entries exceeded 52 error opening or processing (or both opening and processing directory; for example, there were insufficient directory blocks 56 STAE has intercepted an abend; examples are: insufficient REGION out-of-space condition security violation invalid PDS structure RLSE coded in the JCL SPACE parameter third party vendor product, such as VAM, STOPX37, HIPER-CACHE, or ULTIMIZER 60 member does not exist during save 64 member already exists 68 format parameter does not match library type
CTMCA799-04E
Explanation: JCL Library lib contains more members than are specified in the &DIRMAX DEFAULTS member parameter. System Action: The library is not processed. User Response: Do the following: 1. Increase the value of the &DIRMAX parameter. 2. Rerun the ASMLINK job. 3. Rerun the affected job.
CTMCA799-06E
MEMBER memname CONTAINS TOO MANY LINES AND IS SKIPPED. PROCESSING CONTINUES
Explanation: The memname JCL member contains more lines than are specified in the &LINMAX DEFAULTS member parameter. As a result of modifications to the JCL member by the conversion tool, such as insertion of AutoEdit statements, the number of lines in the member may exceed &LINMAX. System Action: The job continues processing, but the specified member is skipped.
178
User Response: Do the following: 1. Increase the value of the &LINMAX parameter. 2. Rerun the ASMLINK job. 3. Rerun the affected job.
CTMCA799-08I
Explanation: This information message indicates the completion of the conversion from CA-7 format to CONTROL-M format of all members of JCL Library library.
CTMCA799-09I
Explanation: This information message indicates that the memname JCL member, or a member (memname) pointed to by the SYSIN statement in a JCL member, has been modified. Note that lines may have been deleted without conversion from the memname member because their function was not supported by the converted CONTROL-M utility.
CTMCA799-13S
Explanation: The input list (the DAJCLIN DD statement) may contain up to 256 library names. This maximum has been exceeded. User Response: Split the input list into different runs of the job.
CTMCA799-18S
Explanation: The job could not find the CTMMEM CONTROL-M installation parameters load module. System Action: The program terminates. User Response: Check that the IOA LOAD library is specified in the STEPLIB DD statement, then rerun the job.
Appendix B
Messages
179
CTMCA7V5-01S
Explanation: JOB7 contains a parameter in the PARM parameter of the EXEC statement of STEP2 that specifies the maximum number of lines it can handle in a job scheduling table. The job attempted to build a Group Scheduling table (tblname) with more lines than that value. User Response: Increase the PARM value, then rerun JOB7.
CTMCA7V5-11E
Explanation: When the &DELCOND option in the DEFAULTS member is set to A, the conversion can create a maximum of 600 OUT conditions in a group entity to delete conditions. This message indicates that this group scheduling table already contains 600 defined OUT conditions and no additional conditions will be added to the table. System Action: The program continues executing. User Response: Manually split the group scheduling table into multiple tables, thereby reducing the number of OUT conditions in each table.
CTMCA7V5-12S
Explanation: The maximum number of lines in a group entity has been exceeded. System Action: The program terminates with a return code of 12. User Response: Increase the value of the &MAXGENT parameter in the DEFAULTS source member, then rerun the ASMLINK and JOB7 jobs. The value of the &MAXGENT parameter should be approximately 5% of the number specified in the PARM of the EXEC statement in STEP2 of JOB7.
CTMDRPRC-05E
Explanation: Either the conversion tool does not support the CA-DRIVER feature specified (statement), or an error was encountered while attempting to convert a JCL or CA-DRIVER procedure statement in the memname member in a JCL or CA-DRIVER procedures library. The variables in this message are:
s s
text a description of the error stmt the JCL or CA-DRIVER procedure statement
180
User Response: Determine whether the procedure is needed. If it is needed, correct the error and rerun JOB8. If it is an unsupported option, you can manually complete the JCL member conversion, if required.
CTMDRPRC-06E
Explanation: The conversion tool does not support the CA-7 CAJUTIL0 or CAICHERL report utilities specified in a JCL or CA-DRIVER procedure member. System Action: The JCL or CA-DRIVER procedure member (memname) containing the unsupported option is not converted. User Response: You can manually complete the procedure member conversion, if required. For CONTROL-M reporting options, see the discussion of reporting facilities in the INCONTROL for OS/390 and z/OS Utilities Guide.
CTMDRPRC-07S
Explanation: An MVS GETMAIN function failed. User Response: Do the following: 1. Increase the value of the AREASIZE parameter, which specifies the maximum number of bytes for GETMAIN, in the CTMDRPRC program. 2. Rerun the ASMLINK job. 3. Rerun JOB8.
CTMDRV01-09I
Explanation: This information message indicates that the conversion of the CA-DRIVER procedure libraries has ended.
CTMDRV02-08I
Explanation: This information message indicates that the conversion of the JCL procedure libraries has ended.
Appendix B
Messages
181
CTMDRV02-11S
Explanation: The CA-DRIVER procedure library (the DAPROC DD statement) has no members. User Response: Do the following: 1. Check previous messages of JOB8 in the Conversion messages file (the DAMSG DD statement). 2. Correct any errors accordingly. 3. Rerun JOB8.
CTMDRV02-12E
Explanation: While trying to convert the jobname job to CONTROL-M format, a member name length was exceeded. In CA-DRIVER, default values can be specified for the procedure variables in the EXEC statement. The conversion tool creates a member that contains a CONTROL-M Auto-Edit %%SET control statement for each default value. The name assigned to this member is the job name with a suffix of an ascending number appended to it. For more information, see Chapter 4, Conversion Details. The member name length exceeded the maximum allowed, which is 8 characters. System Action: The jobname job is not processed. User Response: Determine whether the jobname job is needed. If it is needed, a manual modification is required.
CTMDRV02-13E
182
Appendix
your existing scheduling information and its operation procedures your site rules on data set organization, naming conventions, and so on your expectations from the conversion project
Appendix C Planning The Conversion 183
3. Identify the exact release or version number of CA-7 that you are currently using. 4. Identify the operating system and platforms to be supported by CONTROL-M in the target environment. In relation to each platform, identify the release level, number of systems, and physical location.
184
What resources, such as tape drives, initiators, and so on, do you use at your site? What MVS images, that is, CPUs, LPARs, and Sysplexes, will be available to CONTROL-M when running production jobs? How are your MVS images connected? Is the connection by coupling facility shared spool NJE some other method Are the systems managed separately or collectively? Is there job flow between systems?
Do you currently have multi-system dependencies, either on the same platform type, or using different platforms? If so, how many? how are they managed?
Appendix C
185
Is there a single production department or are there several? Who are the end users of the system?
3. Consider the typical application flows at your site. The following are useful questions to ask:
s
Which are the three key applications, in terms of size, complexity, or value to your business? How are those applications scheduled? How are their internal dependencies managed? Are there currently any performance bottlenecks or constraints in scheduling implementation?
4. List any products you use to support production scheduling, such as console automation, job restart products, and so on.
s s
What function does each such product perform? Will CONTROL-M replace that function?
If you think that CONTROL-M will not make some product redundant, obtain as much information as possible about that product, to enable you to decide how the product will interface with CONTROL-M. 5. List all your applications, interfaces, user or system exits, reports, and similar material, that operators, system programmers, and other third parties have customized, and form part of the implementation of your current production scheduling
186
Include interfaces used to submit jobs from an internal front-end process, as well as any interface used to issue commands and/or perform tasks using batch utility programs. Consider whether you can use CONTROL-M to implement these functions and/or features. 6. Do you manually schedule any jobs or their logical successors on demand, instead of allowing the system to schedule jobs? If you do,
s s
list each job and record the way you deal with it consider whether CONTROL-M can be used to schedule these jobs automatically
7. Do your jobs run automatically, on rigid scheduling, or do you frequently modify job schedules and/or dependencies to meet needs as they arise? 8. Consider your job concurrency requirements, and the way you meet those requirements. Examples of questions to ask are the following:
s
Do you use job triggering, so that the completion of one job causes another job to be submitted or ordered? Do you use job dependencies, meaning that one job (the waiting job) does not start until another has finished, even though the waiting job is submitted or ordered in some other way? Do you use negative job dependencies, meaning that if a job fails, another job starts?
9. How do you manage such resources as tape drives, initiators, and so on? 10. Consider the following questions about the jobs your systems currently perform:
s s s s s s s
s s
How many jobs do you currently have defined? How many jobs are run on a daily, weekly, or monthly basis? How many jobs run on peak days, for example, end of year processing? How many jobs run on request, that is, demand jobs (see Question 6)? Are your existing job definitions satisfactory in every respect? Do you use all your existing job definitions, or are many now obsolete? How many jobs use JCL automation features? Identify the type of automation used. How many jobs are scheduled using data set triggering? How many jobs require manual intervention prior to submission?
Appendix C
187
11. How many jobs use JCL automation features? Identify the type of automation used. 12. How many jobs are scheduled using data set triggering? 13. How many jobs require manual intervention prior to submission?
188
the conversion will not be performed automatically your existing system is otherwise incompatible with CONTROL-M, for example, where calendar generation may serve as a substitute for some scheduling parameters
Are the proposed solutions acceptable in all cases? If not, identify alternative solutions, such as the use of the supplied user exits. 2. Is there any aspect of the way you use CA-7 that may not be reflected in the reports and parameter files used by the conversion program? 3. Prepare the names to be used for libraries, table names, job names, conditions, resources, and so on, in the output of the conversion, in order to reflect the way you want the CONTROL-M environment to appear to users. 4. Consider whether at this stage you are converting the entire production environment, or just one application? If you are only converting one application, determine
s s
how typical it is of the work done at your site what are the principal differences between this application and other applications
Consider whether you can yet identify any other pitfalls ahead, and if so, how to avoid the problems they appear to present.
Appendix C
189
190
Appendix
The CTMUTIL utility invokes the IOACND utility to do the following: to add conditions to the IOA Conditions file, using the command ADD COND condition_name ODAT to replace CA-7 POST commands when the &DEMAND conversion parameter is set to CTM, to replace CA-7 DEMAND[H] commands. The &DEMAND conversion parameter is described in &DEMAND on page 148.
The CTMUTIL utility invokes the CTMJOB utility to do the following: to force jobs into the CONTROL-M Active Jobs file, using the command ORDER DD=DMD MEM=demanded_job FORCE to replace CA-7 DEMAND[H] commands when the &DEMAND conversion parameter is set to CA-7. The CTMUTIL utility does not support the SELECT/ IGNORE TAG feature of CTMJOB. The &DEMAND conversion parameter is described in &DEMAND on page 148.
Appendix D
191
The CTMUTIL utility invokes the CTMRELRS utility to change the quantity of Quantitative resources required by a job to replace CA-7 RESCHNG commands. The command format is CHANGE RESOURCE resource_name quantity.
You must set up a JCL procedure with the procedure name CTMUTIL for invoking the CTMUTIL utility program. The procedure must include the following DD statements:
s s s s s s s s s s
STEPLIB (IOA LOAD library) DAPARM (IOA PARM library) SYSPRINT DAPRINT PRTDBG (dummy) DALOG DACNDF DACKPT DMD SYSIN (optional)
The files to which these DD statements refer can be determined directly from the existing CONTROL-M IOACND, CTMJOBPR and CTMRELRS procedures, which can be found in the IOA PROCLIB library. The DMD DD statement must point to the library containing the tables consisting of demanded jobs, as head-of-tree, and the jobs triggered by the demanded jobs produced in JOB7, STEP3. SYSIN is the file containing the ADD COND, ORDER and CHANGE RESOURCE commands. It can be coded as DDNAME=SYSIN, or it can be omitted from the procedure.
192
Appendix
Product
Conversion
CA-7/NCF
CA-7/NCF is totally replaced by native CONTROL-M support. For more information, see Network Communications Facility on page 35. An automatic conversion tool to convert CA-7/RPT to CONTROL-D is available. Contact your BMC Software representative for additional information. For details of the support the conversion tool provides in interfacing existing CONTROL-D (Output Management System) installations to CONTROL-M, see CATEGORY on page 140, &DCTGRY on page 147, and &CTDCOND on page 144. CONTROL-M supports JCL libraries in CA-LIBRARIAN or CA-PANVALET format. However, during the conversion process, these libraries must be in partitioned data set format. For more information, see Step 2 - Copy CA-7 and CA-11 JCL and CA-DRIVER Libraries and Initdeck on page 73, and Step 13 - Customize CONTROL-M and Install User Exits on page 85.
CA-7/RPT
CONTROL-D
With the CA-7 and/or CA-11 and CA-7/RPT conversion tools, a complete migration from all CA-7 related products to INCONTROL products can be accomplished automatically.
Appendix E
193
194
Appendix
Problem Reporting
Please supply all the information requested below when reporting a problem related to the conversion tool.
s
Version number of CONTROL-M (for example, 6.1.00) and the OS/390 or z/OS operating system (for example OS/390 2.10) Release number of CA-7 (for example, 3.1) from which you are converting The latest PTF applied to the conversion tool Copy of the DEFAULTS member The full text of all Job Log messages, in addition to all error messages in the error files (DAMSG, SYSPRINT, and so on) All changes made to the Application List file (from JOB2) Any source fixes or zaps applied to the conversion tool Also, check if REFRESH LLA was done after changes were applied.
If an abend has occurred, send the symptom dump to BMC Software Customer Support, and have a full dump (SYSUDUMP) available for use by BMC Software Customer Support staff. Ensure that whenever a change is made to the DEFAULTS member or a source fix is applied, all the programs are reassembled and relinked.
Appendix F
Problem Reporting
195
196
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Index
Symbols
# HLD JCL Override Statement 100 # JCL Override Statement 99 # JEND JCL Override Statement 117 #JI Block 117 #JI Override Statement 117 # JO Block 117 # JO JCL Override Statement 117 # MNT JCL Override Statement 100 # NOX 127 # NOX JCL Override Statement 117, 132, 133 #NTR JCL Override Statement 111, 117 #RES JCL Override Statement 31, 101, 104, 128 CLASS Field 104 PRTY Field 101 Workload Balancing 32 #S, RO Value 102 # SCC JCL Override Statement 102, 156 #VER JCL Override Statement 133 # XEND JCL Override Statement 117 #XI JCL Override Statement 117 # XO JCL Override Statement 117 $ Mask Character 53 $ABEND Value DO IFRERUN Parameter 123, 144 $EXERR Value DO IFRERUN Parameter 123, 144 %%$TAG AutoEdit System Variable 126 %%$TAG AutoEdit Variable 117 %%BLANK Control Statement SET/DSET Commands 135 %%ELSE AutoEdit Control Statement 117 %%ELSE Control Statement IF/DIF Commands 136 %%ENDIF AutoEdit Control Statement 117 %%ENDIF Control Statement IF/DIF Commands 136 %%FROM Variable DONT SCHEDULE BEFORE/AFTER Fields 131 %%GOTO AutoEdit Control Statement 117 %%GOTO Control Statement GOTO/DGOTO Commands 135 IF/DIF Commands 136 STEP/DSTEP Commands 135 %%GROUP AutoEdit Variable 137, 139 %%IF AutoEdit Control Statement 117 %%IF Control Statement IF/DIF Commands 136 %%INCLIB AutoEdit Command 98 CA-DRIVER Procedure 35 CADRIVER Procedure 136 %%INCMEM AutoEdit Command CA-DRIVER Procedure 35 CADRIVER Procedure 136 %%JOBID AutoEdit Variable 129, 157 %%JOBNAME 157 %%JOBNAME AutoEdit Variable 129, 157 %%JOBNAMX AutoEdit Variable CADRIVER EXEC Statement 134 %%JULDAY AutoEdit Variable 117 %%LABEL AutoEdit Control Statement 117 %%LABEL Control Statement IF/DIF Commands 136 STEP Command 135 %%MEM# AutoEdit Variable CADRIVER EXEC Statement 134 %%MEMNAME AutoEdit Variable CADRIVER EXEC Statement 134 CADRIVER Procedure 136 %%MINUS Function SET/DSET Commands 135 %%MONTH AutoEdit Variable 137, 138 %%OJULDAY AutoEdit Variable 117 %%OUTDATE AutoEdit Variable 137, 138 %%OUTDAY AutoEdit Variable 137, 138 %%OUTMON AutoEdit Variable 137, 138 %%OYEAR AutoEdit Variable 117 %%PLUS Function SET/DSET Commands 135 %%SCHID AutoEdit Variable 117, 126 %%SET Control Statement CADRIVER Procedure 134 SET/DSET Command 135 %%SYSID AutoEdit Variable 53, 86, 130 %%TIME AutoEdit Variable 117 %%TO Variable DONT SCHEDULE BEFORE/AFTER Fields 131 %%WDAY AutoEdit Variable 137, 138 %%YEAR AutoEdit Variable 117 &ALLMSG Conversion Parameter 143 &C_DATE CADRIVER Parameter 137, 138 &C_DAY CADRIVER Parameter 137, 138
Index
197
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
&C_JDATE CADRIVER Parameter 137, 138 &C_MONTH CADRIVER Parameter 137, 138 &C_SNAME CADRIVER Parameter 137, 139 &C_TIME CADRIVER Parameter 137, 138 &CALPREF Conversion Parameter 105, 143 &CLASBAR Conversion Parameter 104, 143 &CTDCOND Conversion Parameter 140, 141, 144 &CTR Conversion Parameter 52, 56, 86, 122, 123, 144, 146, 155 &CTRCONF Conversion Parameter 124, 146 &DATE CADRIVER Parameter 137, 138 &DAY CADRIVER Parameter 137, 138 &DCTGRY Conversion Parameter 140, 147 &DELCOND Conversion Parameter 113, 147 &DEMAND Conversion Parameter 30, 64, 65, 83, 112, 121, 191 &DEPJCND Conversion Parameter 112, 114 &DIRMAX Conversion Parameter 151 &FROMC Conversion Parameter 141, 151 &INIT Conversion Parameter 130, 152 &JDATE CADRIVER Parameter 137, 138 &JESRPRT Conversion Parameter 130, 152 &JOBCLAS Conversion Parameter 52, 80, 120, 152 &JOBMXOC Conversion Parameter 152 &L2VARS Conversion Parameter 138 &LINMAX Conversion Parameter 152 &MAXCALS Conversion Parameter 154 &MAXDSN Conversion Parameter 154 &MAXGENT CTMCA7V5-12S 154 &MAXWAIT Conversion Parameter 141, 154 &MONTH CADRIVER Parameter 137, 138 &PNIBTSD Conversion Parameter 73, 121, 154 &PRVNCT2 Conversion Parameter 145, 155 &REL Conversion Parameter 155 &RELEASE Conversion Parameter 141, 155 &RESFREE Conversion Parameter 116, 156 &SCCGLBL Conversion Parameter 103, 156 &SCHDMOD Conversion Parameter 48, 106, 156 &SHOUTDL Conversion Parameter 129, 157 &SHOUTDT Conversion Parameter 129, 157 &SHOUTE Conversion Parameter 129, 157 &SHOUTL Conversion Parameter 128, 129, 157 &SHOUTT Conversion Parameter 128, 129, 157 &SHOUTX Conversion Parameter 128, 157 &STARTM Conversion Parameter 109, 158 &SUPMSG Conversion Parameter 158 &SWLPROP Conversion Parameter 158 &TAPE1 Conversion Parameter 32, 104, 158 &TAPE2 Conversion Parameter 32, 104, 158 &TIME CADRIVER Parameter 137, 138 &TOCLASS Conversion Parameter 141, 159 &UNTIL Conversion Parameter 159 &USERLEN Conversion Parameter 125, 159, 160 &USEROPT Conversion Parameter 125, 129, 157, 160 * Mask Character 53 *-stepname 156 *stepname 103 /* JOBPARM SYSAFF Statement (JES2) 36 //*CA11 Comment Statement Conversion Details 122 //*MAIN SYSTEM Statements (JES3) 36 /LOGON Command 74 /WLB Command 33 Quantitative Resource JOBCLASS_resourcename 120
A
Abend Code Recapture Prevention 26 ABORT Command CADRIVER Procedure 137 ACTION= 36 Active Jobs File 28 Active Queue 28 ADD COND Command 30 ADDMNCND KSL Script Maybe Jobs 131 ADDPROC Parameter 86 Ad-Hoc Jobs 30 Execution 27 ALL Value DAYS, MONTHS Parameters 107 ALT Subparameter CA 7 JCL Initialization Statement 127 Alternate Libraries 127 Analyze Commands 71 AND/OR Parameter 107 ANNUAL Field 109 ANYSTEP Value ON PGMST Parameter 156 APF Authorization 72 APPL &USEROPT Parameter 159 Field (CA7) 125 Parameter 160 Parameter (CONTROL-M) 99 Value in &USEROPT Parameter 160 Application Definition Overview 21 Job Grouping 98 List File 46, 51, 65, 76, 77, 79, 83, 156 Name 160 Names List 46 System Name 99 Tree Structure 24 APPLIST DD Statement 83 Archive Parameters 145 ASMLINK Member Modify and Run using Conversion Step 5 75 ASMMCL Procedure 75 Associated Job Class Maximum Number of Jobs Submitted 104
198
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Authorization 71 AUTO-ARCHIVE Parameter 26, 145 AutoEdit Facility 99 Parameters 93 Statements 117 AutoEdit Facility CA-DRIVER Procedure 35 AUTOARCHIVE Parameter 123 AUXCAL DD Statement 80 File 154 AUXILIARY CAL 107 auxiliary calendars creation 87 replacement 87, 88 Average Elapsed Runtime 128 CA11NR DD Statements 122 CA-7 JCL Library 151 JCL Library - Copy Using Conversion Step 2 73 Production JCL Libraries 82 Queues 28 Release Number 155 System Exits 88 User ID 74 CA-7 ID Field 117 CA-7/NCF Product Interface 193 CA-7/RPT Product Interface 193 CA7DATA DD Statement 121 CA7ER789 106 CA7USERID Value &USEROPT Conversion Parameter 160 CA7USRID Field 125 CA-DRIVER Procedure Conversion Overview 35 Modifying and Running the JOB8 Member 84 CA-DRIVER Variables 161 CALBLK Statement 42 Calendars 156 Auxiliary Calendar Library 80, 107 Base Calendar Definitions 25 Base Calendar ID 105 Base Calendar Report File 42, 44, 74, 78 Base Calendars 21, 71, 108 CA-7 Calendars 105 Calendar Library File 46, 76, 77 CALENDAR Macro (CA-7) 21, 49 Calendar Name Change List File 55 Calendar Name List File 46, 52, 76, 77, 80, 107, 143 Calendar Name Prefix 143 CONFCAL Calendar 105 CONTROL-M Calendar Definition 105 CONTROL-M Calendar Library 78, 107 CONTROL-M Calendar Overview 25 DSB Calendar Name Prefix 143 IOA Calendar Facility 22, 25 Non-Standard Periodic Calendars 105, 108 Overview 25 Periodic Base Calendar Control Statements 78 Periodic Base Calendar Name List File 49 Periodic Calendar Name List File 78, 80 Periodic Calendars 25, 105, 108 SCAL Base Calendar ID 105 Standard Calendars 105 CA-LIBRARIAN Libraries 73, 88 CA-Librarian Product Interface 193 CA-PANVALET Libraries 73, 88 CA-Panvalet
B
BARx Field CLBARR Macro 105 Basic Scheduling Parameters 106, 125 Batch Terminal Commands 154 DEMAND Command 120 JCL Batch Terminal Step Operations 121 JCL Batch Terminal Steps 56 Mechanism 42 Parameter Control Statement 82 Parameter File 56, 60 SLIA-00 End Record 76 Steps 30, 34, 112, 154 SYSIN Non-Instream 154 BD Field 117 BMC Software, contacting 2 BT Field 117 BTERM 57
C
CA 11 Non-Restartable Step Conversion Details 122 CA-11 CA-1 Interface 27 CA-DYNAM Interface 27 CA-TLMS Interface 27 Copy JCL Library Using Conversion Step 2 73 JCL Steps 26 PARM Parameters 26 Production JCL Libraries 82 Rerun/Restart Processing 26 System Exits 88 U11RMS Step 52, 56, 144
Index
199
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Product Interface 193 CATEGORY Parameter 144 Conversion Details 140 CATLG Disposition 36 CA7 Job Name 98 Job Triggers 98 MEMBER Name 98 Simulation 101 CADRIVER Procedure %%SUBSTR AutoEdit Function 137 ABORT/DABORT Commands 137 DATA/DEND Commands 136 DPROC Parameter 133 EXEC Statement 134 GOTO/DGOTO Commands 135 IF/DIF Commands 136 NEST/DNEST Commands 136 SET/DSET Commands 135 STEP/DSTEP Commands 135 Variable Parameters 137 CAEARL CURRENT SCHDMOD Report 106 CHANGE RESOURCE Statement 32 checking conversion results 88 CLASS Conversion Details 104 Field 143 Field (JCL) 120 Parameter (JCL) 152 Class Barriers 31, 104 Resources 143 Support 143 Workload Balancing 32 CLASS CA-7 parameter 104 CLBARR Macro 105 CLOCKTIME Field 128 CMEM Conversion 129 Events 154 File 87 Overview 36 Rule Creation by Conversion Job3 50 Rule Definition 22, 80 Rule Table 80, 87 Codes (Messages) Descriptions 163 CODES Parameter 102 Command Type 57 Concatenating LJOB Reports 76 Concurrent Job Runs 104, 113 COND= JCL Statement 102 Condition Code Checking Job Level 102 Step Level 102 Conditional Job Dependency DEPJOB=? Field 131 Conditions/Resources File 23, 31, 111, 113, 115, 120, 130, 147 Conditions/Resources Screen 23 CONDCODE Field Conversion Details 102 CONFCAL Calendar 108 Connected Job 113, 114 Connection DSN 113 Job 112, 113 JOB REQUIREMENTS 114 Control Resources 62 Overview 25 CONTROL-D 144, 147 Product Interface 193 Report Decollating Mission 140 CONTROL-M/Restart &CTR Conversion Parameter 144 CA-11 Conversion 122 Confirmation 146 EXCLUDE DSN Statements 146 Implementation 56 Installation Parameters 145 Job Scheduling Parameters 34 Parameter 123 PREVENT NCT2 Processing 145 Rerun/Restart Processing Overview 26 Simulation Facility 27 Simulation Run 124 Statements 144 Step 26 CONTROL-Parameter EXCLUSIVE_jobname 113 Conventions Used in This Guide 13 Conversion CA-DRIVER 66 Check Results Using Conversion Step 15 88 Component Summary 93 Components 91 Conceptual Overview 19 Detail Summary 93 Details 91 Job1 42, 44 Job2 46 Job3 50 Job4 56 Job5 61 Job6 63 Job7 64 LOAD Library 76, 77 LOAD Library Name 75, 79, 81, 82, 83 Parameters 93, 143 Pre-Conversion Planning 71 Process Flow 39 Source Library 140 SRC Source Library Name 75
200
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Step 1 - Create Conversion SOURCE and LOAD Libraries 72 Step 10 - Modify and Run the JOB5 Member 82 Step 11 - Modify and Run the JOB7 Member 83 Step 13 - Customize CONTROL-M and Install User Exits 85 Step 14 - Final Adjustments 87 Step 15 - Check Conversion Results 88 Step 16 - Customize New Day Procedure 89 Step 2 - Copy CA 7 and CA 11 JCL Libraries, Initdeck 73 Step 3 - Modify and Run the JOB0 Member 74 Step 5 - Modify and Run the ASMLINK Member 75 Step 7 - Modify and Run the JOB2 Member 77 Step 8 - Modify and Run the JOB3 Member 79 Step 9 - Modify and Run the JOB4 Member 81 Steps - General 69 Unique Parameters 140 Utilities 191 Conversion Parameters &ALLMSG 143 &CALPREF 105, 143 &CLASBAR 104, 143 &CTDCOND 140, 141, 144 &CTR 52, 56, 86, 122, 123, 144, 146 &CTRCONF 124, 146 &DCTGRY 140, 147 &DELCOND 113, 147 &DEMAND 30, 64, 65, 83, 112, 121, 148, 191 &DEPJCND 112, 114, 150 &DIRMAX 151 &FROMC 141, 151 &HISTORY 151 &INCLIB 151 &INIT 130, 152 &JESPRT 152 &JESRPRT 130 &JOBCLAS 52, 80, 120, 152 &JOBMXOC 152 &L2VARS 138, 153 &LINMAX 152 &MAXCALS 154 &MAXDSN 154 &MAXGENT 154 &MAXWAIT 141, 154 &PNIBTSD 73, 121, 154 &PRVNCT2 155 &REL 155 &RELEASE 141, 155 &RESFREE 116, 156 &SCCGLBL 103, 156 &SCHDMOD 48, 106, 156 &SHOUTDL 129 &SHOUTDT 129 &SHOUTE 129 &SHOUTL 128, 129, 157 &SHOUTT 128, 129, 157 &SHOUTX 128, 157 &STARTM 109, 158 &SUPMSG 158 &SWLPROP 158 &TAPE1 32, 104, 158 &TAPE2 32, 104, 158 &TOCLASS 141, 159 &UNTIL 159 &USERLEN 125, 159 &USEROPT 125, 129, 160 conversion results checking 88 Conversion source library 143 CPU Usage 31 CPUID Translation Table 53, 80, 86, 129 CREATED BY **NONE* 114 nnn JOBS 114 Critical Path 102 Critical Resources 25 Cross Reference File 79, 82 CTM.CA7.APPLS File Name 47 CTM.CA7.BASECAL File Name 43 CTM.CA7.REPORT File Name 43, 45 CTM.CA7.RESOURCE File Name 43 CTM.CA7.SCHED File Name 43 CTM.CAS.PARMLIB JOB5 Output 66 CTM.CAS.PROCLIB JOB5 Output 66 CTM.CA7.XREF Library Name 54 CTM.V500.Calendar File Name 49 CTM.V500.CALNAMES File Name 49 CTM.V500.CMEM File Name 54 CTM.V500.DACALS File Name 49 CTM.V500.Daily Name 54 CTM.V500.DOCUMENT Library Name 54 CTM.V500.INCLIB Library Name 54, 55, 56 CTM.V500.JCLIN File Name 54 CTM.V500.NEWSCHED Library Name 65 CTM.V500.SCHEDULE Library Name 54 CTMCA702 Program 50 CTMCA706 Program 50 CTMCA706-01E Message 156 CTMCA707 Program 56 CTMCA707-00R Message 82 CTMCA709 Program 56 CTMCA711 Program 46 CTMCA7RL Procedure 124 Utility 32 CTMCA7V5 Program 64 CTMCAS51 Program CA-DRIVER Conversion 66, 71 CTMIMAC1 REXX Procedure JCL Repository Functionality 34 CTMJOB Utility 112
Index
201
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
CTMJTXRF Utility 54 CTMLOAD DD Statement 76, 77, 79, 81, 82, 83 JOB8 84 CTMMEM Function 177 CTMRFLW Utility 88 CTMROGR Utility 88 CTMRPLN Utility 88 CTMSRTJB Utility 27 CTMSV5 DD Statement 83, 84 CTMTBUPD Utility Customization 37 CTMTBUPD utility 87 CTMUTIL Procedure 112 CTMX001 Exit Date Range for Job Execution 140 CTMX002 Exit 85 CTMX002Q Member IOA SAMPEXIT Library 85 CTMX004 Exit 33 CTMX015O Exit 34 CTMXRF Utility 87, 88 CTMXRF utility 87 CTR Conversion Parameter 123 CTRNORST DD Statements 122 CTRPARM Member IOA PARM Library 86 CTRX001 Exit 27, 146 CURRENT Status 106 Customer Support 195 customer support 3 Customization Overview 37 CV= Subparameter 117 DAJOBCL DD Statement 80 DAOUT1 DD Statement 76, 78 DAPARM DD Statement JOB8 84 DAPROC DD Statement JOB8 84 DAPROCIN DD Statement JOB5 85 DAREPIN DD Statement 82 DAREPORT DD Statement 76, 77, 79 DAREPRT2 DD Statement 78 DASCHD DD Statement 64, 80 DASCHD2 DD Statement 80 DASCHDxx DD Statement 82 DASYSN DD Statement 79 DATA Command CADRIVER Procedure 136 Data Set Archiving 145 Deletion 145 Event 36, 50 Scratched 145 Triggering 36, 129, 154 Uncataloged 145 Database Verification 71 DATALIB Library 136 Date Format 138 Date Range for Job Execution Exit 1 140 DATE= 36 DATES Parameter 109 DATETYP Parameter %%FROM/%%TO Variables 132 DAXREF DD Statement 79, 82 DAYMONTH Member AutoEdit Variables 138 DAYS Parameter 109 DCAL Parameter 46, 110 DE Command Type 57 Default Job Class 152 DEFAULTS Member 75, 104 Conversion Source Library 140 Conversion source Library 143 Modify Using Step 4 75 DELETE Disposition 36 DELOVRER Parameter 34 DEMAND Command 31, 112, 125, 154 CLASS/#RES 104 Conversion Details 120 HOLD/# HLD 100 Overview 30 PRTY/# RES 101 Workload Balancing 32 DEMAND Field 152
D
DABASCAL DD Statement 78 DABORT Command CADRIVER Procedure 137 DABTERM DD Statement 82 DACAL DD Statement 78, 107 DACALNM DD Statement 78, 80 DACALS DD Statement 78, 80 DACMEM DD Statement 80 DACPUID DD Statement 80, 129 DACTRCTL DD Statement 26 DADAILY DD Statement 79, 89 DADATA DD Statement JOB5 84 DADOC DD Statement 79 DAILY Scheduling 108 DAINCLIB DD Statement 79, 98 DAINIT DD Statement 79 DAJCLIN DD Statement 80, 81 JOB8 85 DAJOB DD Statement 89
202
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Demanded Job Execution 27, 148 DEND Command CADRIVER Procedure 136 DEPJOB Value 30 DEPJOB Field Conversion Details 112, 113 Job Connection 114 DEPJOB=? Field Conditional Job Dependency 131 DGOTO Command CADRIVER Procedure 135 STEP Command 135 DIF Command CADRIVER Procedure 136 STEP/DSTEP Commands 135 DISP= 36 NEW 145 DNEST Command CADRIVER Procedure 136 DO IFRERUN Parameter 26, 123, 144 DO NOTOK Parameter 102 DO OK Parameter 102 DO RERUN Parameter 26 DO SYSOUT Parameter 141 Conversion Details 141 Documentation Library (CONTROL-M) 79, 115 Documentation Requirements 24 DONT SCHEDULE BEFORE/AFTER Fields %%FROM/%%TO Variables 131 DOTM Field Conversion Details 109 DPROC Parameter CADRIVER Procedure 133 DSB Calendar Name Prefix 143 DSET Command CADRIVER Procedure 135 DSN 36 Connection Dependency Condition Names 150 Connection for MAINT Jobs 100 Conversion Details 113 CREATED BY **NONE* 114 CREATED BY nnn JOBS 114 JCL Initialization Statement 99, 127 PERM 114 PERM FOR JOB 114 DSTEP Command CADRIVER Procedure 135 DTRG Screen 21 Due Out DUE OUT Parameter 109 Shout Message 157 Time 109, 128 DUMMY Value in OVERLIB Parameter 101, 127 Dynamically allocated CA-7/CA-11 JCL Libraries 52
E
ED Field 117 Editing JCL 34 ELAPTM Value # RES Override Statement 128 ENDEDOK Status 102 Error Messages Descriptions 163 ET Field 117 EXCLUDE DSN Statements 146 Exclusive Resource Control 116 EXEC Field Conversion Details 132, 133 EXEC Statement CA-DRIVER Procedure 35 CADRIVER Procedure 134 EXEC=N 127 CA7 Job Definition 101 JOB Screen 99 Execution Time 109 Exit 1 Date Range for Job Execution 140 Exits 71 Exit 1 146 Exit 2 53, 85, 86, 130 exits Exit 2 98 Extended NJE Job Tracking 35
F
Failed Job SHOUT Destination 157 Final Adjustments Conversion Step 14 87 FORCE Option 30 Forecast Job Flow Structures 28 Format Processing U11RMS Step 123 FROM Parameter 108, 128 FSTRUC Transaction 28
G
General Daily 54 Global Cross Reference File 54, 61 GOTO Command CADRIVER Procedure 135 STEP/DSTEP Commands 135 Group Entity 23, 125 Scheduling Table 23, 98, 125 Scheduling Table Creation by Conversion Job7 64 Scheduling Table Library 83 Grouping Application Jobs 98
Index
203
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
H
Head-Of-Tree Job 22 Definition 27 Head-of-Tree Job 24, 158 Held Sysout Classes 151 High-Water 32 HLDCLASS Parameter 141 HOLD Field Conversion Details 100
Step 148 Utility 32, 87 IOAENV Library Name 76 IOALOAD DD Statement JOB8 84
J
Japanese Date Format 138 JCL Automation 35 CA-DRIVER Procedure 35 Considerations Overview 33 CONTROL-M JCL Steps 56, 124 Conversion 154 Conversion of JCL Libraries 66 GROUP= JOB Statement 160 INCLUDE Member 98 Include Members 79 Initialization Statements 99, 127 JCL Conversion Report 60 JCL Library DSN List 56, 80, 81 Job Class 52, 80 Job Class Conversion Details 120 Job Class Parameter 152 Job Class Translation Table 52, 120 JOB Statement 160 Job Stream 53 Libraries (CONTROL-M) 60 Library 127 Library Copy 73 Library Name 99 Max Lines in Member 152 Member Conversion 56, 81 Member Name 98 NOTIFY= JOB Statement 160 Override Statement # JI,ID=... 126 Override Statements 33, 50 PARM= Field 44, 50 USER= JOB Statement 160 JCL Repository Facility 34 JCLGRP &USEROPT Conversion Parameter 160 Field 125 JCLID Field Conversion Details 99 JCLUGRP &USEROPT Conversion Parameter 159 JCLUSER &USEROPT Conversion Parameter 159, 160 Field 125 JCLOVRD Field Conversion Details 99 JDEP Connection 24
I
ID= Subparameter 126 IEF125I Message 37 IEF403I Message 37 IF Command CADRIVER Procedure 136 STEP/DSTEP Commands 135 IF Logic Capability 117 IN Conditions 23, 37, 98, 111, 120, 147, 148 creating job data set 114 depjobname_OK 112 jobname_depjobname_schedid 112 INCLIB Library 85, 98 Include Library 54 INCLUDE Members 85 Independent Tree 27 Initdeck Copy Using Conversion Step 2 73 File (CA-7) 154 File (CA7) 99 Initialization File (CA-7) 51 Library Name (CA-7) 79 Member Name (CA-7) 79 Initialization File (CA-7) 21 Initiator Control 152 Initiators 31, 130 INITR Macro Conversion Details 130 Input Data Set Creation 113 Name 113 INSERT-RMS Field 155 INSERTRMS Conversion Details 122 Interfacing Other Products 193 Intermediate Scheduling Table Library 80 IOA LOAD IOALOAD DD Statement 76, 79, 81, 82, 83 IOALOAD Parameter 75 Library Name 75, 76, 79, 81, 82, 83 IOACND Procedure 120
204
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
JES Definitions 35 JCL Statements 34 JES ROUTE PRINT Statement Conversion Details 130 Job Number 129 ROUTE PRINT JCL Statement 152 Statement 130 JES2 and JES3 Statements 86 JES2 JOBPARM Statement 53 JES3 MAIN Statement 53 Job Completion 111 Connection 98, 113, 114 Connection Conditions 147 Connection Dependency Condition Names 150 Connection Overview 24 Definition Overview 22 Dependency Overview 24 Documentation 115 Documentation Overview 24 Execution Flow 23 Grouping 120 JOB Field 98, 112, 125 JOB Parameter Value 57 JOB Value / &USEROPT Conversion Parameter 159, 160 Name 160 Occurrences 111, 152 Output Handling 141 Owner 160 Priority 31 Scheduling Overview 22 Start Times 31 Statement 80 Submission Time Limit 108 Tracking 28 Triggering 22, 36 Overview 23 Triggering Conversion Details 111 Job Class Conversion 152 Conversion Details 120 Structure 31 Translation Table 80 Job Scheduling Definition 22, 26 Parameters 34, 93 Screen 22, 24, 25, 115 JOB Screen 22, 98, 99 Application Definition Overview 21 job submission exit (Exit 2) 98 JOB=* 42 JOB1 25, 74 Modify and Run Using Conversion Step 6 76 Job1 Conversion Process 42, 44 JOB2 106, 156 Job2 Conversion Process 46 JOB3 99, 107, 129, 143 Modify and Run Using Conversion Step 8 79 Job3 Conversion Process 50 JOB4 120, 154 Modify and Run Using Conversion Step 9 81 Job4 Conversion Process 56 JOB5 CA-DRIVER Conversion 66 Modify and Run Using Conversion Step 10 82 Job5 Conversion Process 61 Job6 Conversion Process 63 JOB7 Modify and Run Using Conversion Step 11 83 Job7 Conversion Process 64 JOB8 Modifying and running 84 JOBCONN Screen 21, 24 JOBNAME= 36 JOBPARM Statement 53 JTRG Screen 21, 23 Modify and Run Using Conversion Step 7 77
K
KEEP Disposition 36
L
LDTM Field Conversion Details 109 Lead Time 109 LEADTM Field 113, 147 LIST= ALL 42 NODD 42 LJOB Command 42 LJOB,JOB=*,LIST=ALL Command 42 Report File 27, 42, 44, 50, 74, 76, 77, 79, 128 LJOB Reports, Concatenating 76 LKED Procedure 75 LLA REFRESH 75 LOADLIB Parameter 75 Logical Device Type 104 LOGON ID 71 LQ Transaction 28 LSCHD Command 42
Index
205
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
LSCHD,JOB=*,LIST=BYSID Command 42 Report File 71, 74, 78, 107 LSCHED Report File 42, 44 LWLB Command 33 MEMNAME parameter 98 Message Destination 129 File 47, 62 Shouting 127 Suppression 129 Messages and Codes Descriptions 163 Mission Category 140 Modification To Resolved Schedule Dates Screen 21, 106 MONTHLY Field 109 MONTHLY RDAY Field 110 MONTHS Parameter 107 MSGCLASS Parameter 141 Sysouts 159 MSGLEVEL=(1,1) Parameter 37 MXTAL Parameter Workload Balancing TAPE1 / TAPE2 Macros 104
M
M3 Step 75 M4 Step 75 M5 Step 75 M6 Step 75 Machine Date 29 Macro CALENDAR 21 User Option Table 21 Workload Balancing 21 MAIN Statement 53 MAINID Conversion Details 129 CPUID Translation Table 53, 86 Field 36, 80 MAINT Conversion Details 100 Job 100, 114 Manual Confirmation 146 Verification 100 Manual Conditions 24 Screen 24 Manual IN Condition HELD_jobname 101 JCL_OVERIDE_jobname 99 jobname_NW 114 RESTART_jobname 101 SUSPEND_jobname 124 VERIFY_JCL_jobname 100 Mask Character $ 53 * 53 MAXDAYS Parameter 26 Maximum Number Calendars in AUXCAL File 154 Dataset Triggers For CMEM Events 154 Job Occurrences In Scheduling Table 152 Lines in JCL Member 152 Members in CA-7 JCL Library 151 MAXRUNS Parameter 26 MAXWAIT Parameter Conversion Details 141 Maybe Jobs DEPJOB=? Field 131 MEMBER Field Conversion Details 98 MEMLIB Parameter 99, 101 MEMNAME Parameter 22, 98, 100, 101, 111, 112, 114, 115, 141
N
NAME Parameter TAPE1 Macro 158 TAPE2 Macro 158 NCT2RC Parameter 86 NDAY Value 109 Negative Job Dependence 113 NEST Command CADRIVER Procedure 136 Network Communications Facility Overview 35 Prerequisites 114 New Day Processing Overview 28 Schedule Scan and 28 New Day Time 85 New Output Class 159 NFILVS99 Parameter 86 NJE Jobs 35 Support 86 NOGROUP Value OWNER ID 160 Non-Instream SYSIN 154 NONOTIFY Value OWNER ID 160 Non-Restartable Steps (CA 11) Conversion Details 122 Non-Restarted Jobs 145 Non-Standard Periodic Calendars 105, 108 NORECAPTABEND Option 26 NOT CATLGD 2 Situations 145 NOTIFY Field 125 Value in &USEROPT Conversion Parameter 159, 160
206
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
NOUSER Value OWNER ID 160 NW 30 NWK Field Conversion Details 114 NXT CYC SETOFF Command Conversion Details 124 PJ Command Type 57 POST Command 125, 154 Conversion Details 120 Overview 30 PRE Online Commands 26 Pre-Conversion Planning Conversion Steps 71 Predecessor Job 112 Prerequisite Conditions 23, 24, 111, 120 Overview 23 Prevent Automatic Abend Code Recapture 26 PREVENT-NCT2 Parameter 26, 52, 145, 155 PREVENTNCT2 Parameter 123 Primary JCL Library 127 PRINT Command 42 JOB1 105 Priority PRIORITY Parameter 31, 102 Problem Reporting 183, 195 Procedure Library Conversion to CTM Format 66 PROCLIB Library CADRIVER Procedure 133 PROCRC Parameter 86 PROCRMS Field RESTART Statement 123 Product Interfaces 193 product support 3 Production Control - Overview 28 Control Parameters 28 Data Sets 100 Management - Overview 28 Parameters 22 Processing 123 PROMPTS Field 128 PROSE Data Conversion 115 Screen 21, 24 Prose Information Overview 24 PRTY Field Conversion Details 101 Pseudo Production Processing 155 PSEUDO Option 27 PSEUDO=YES 155 PU Command Type 57
O
OA Field 117 OB Field 117 ON DATASET Rules 54 ON PGMST Parameter 102, 123, 156 ON STEP/CODES Parameters 102 On-Line Viewing Archive Parameters 145 OPER Value Shout Destination 157 OPER2 Value Shout Destination 157 OPTION=SCHDYONLY 106, 110 OPTION=SHCDYONLY 106 Original MSGCLASS 159 OUT Condition 23, 98, 111, 144 creating job data set 114 depjobname_OK 112 jobname_depjobname_schedid 112 jobnameusertext 140 scheduletable_jobname_OK 111 Output Class 159 OVERLIB Library Deleting Members from 34 Editing JCL 34 OVERLIB Parameter 127 DUMMY value 101 OWNER Conversion Details 125 Parameter 125, 159, 160 Value in &USEROPT Conversion Parameter 159, 160 OWNER ID 160
P
PARM Field 77, 80, 83, 122 Parameter 155 Value 123 Value F 123 Value P 123, 145 Value R,PSEUDO=YES 124 PARMLIB Library CADRIVER EXEC Statement 134 PDS Libraries 73 PERM DSN 114 PERM FOR JOB 114
Q
Quantitative Resource 31, 52, 80, 104, 120, 124, 152 Resource Name 152, 158
Index
207
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
R
Ready Queue 28 REGION=0K 44, 50, 77, 80 Relational Operator 102 Release Sysouts 155 Report Decollating Mission 140 Category 147 Request Queue 28, 29, 100, 109 Requeue Held Sysout Classes 151 MSGCLASS Sysouts 159 Sysout 141 Reroute MSGCLASS Sysouts 159 Rerun Processing 26, 123 RESANL Analyze Command 71 RESCHNG Command 31 Conversion Details 124 Workload Balancing 32 Resource Availability 28 CLASS 104 Management 25 Management Components - Conversion 61, 82 Management Facility 82, 115 Management Overview 25 Quantity 125 RESOURCE Parameter 31, 53, 104 Sharing 104, 113, 115 Restart Confirmation 146 Parameters 56 Processing 26, 123 Requirement 101 RETAIN (SMS) Disposition 36 RO Field Conversion Details 102 ROLL Field 105 ROUTE PRINT Statement 34 RQMT Analyze Command 71 RSRC Screen 21, 25 RUN HANDLER 123
S
SAC Parameter 85 Sample Exit 2 53 SASSBTRM Procedure Name 74 SASSJCLU Utility (CA-7) 71 SASSTRLR Procedure Name 60 Satisfaction Lead Time 113 SBTM Field Conversion Details 108 SCAL 156 Conversion Details 105
SCALyyxx 47 SCHD Screen 21, 22, 23 SCHDMOD CURRENT 106 Indicator 25, 156 Processing 46 SCHDMOD Screen 106 SCHDYONLY 49, 106, 110 Periodic Calendar Name File 78, 80 Schedule ID 23, 47, 106 Schedule Scan New Day Processing and 28 Overview 28 SCHEDULE TAG Field 23 SCHEDULE TAG Parameter 117, 125 scheduleIDheadoftreejobname 117, 125 Scheduled Tree 27 Scheduling Conversion Details 109 Date 24 Definition 106 Indicator 124 Overview 22 Scheduling Table 24, 25, 79, 98, 111, 125 Creation by Conversion Job3 50 Creation Overview 27 Customize New Day Procedure Using Conversion Step 16 89 Libraries 61, 82, 83 List File 79 Name 46 Scheduling Tables Update Using Conversion Job6 63 SCHID =000 Value 23 DEMAND Command Value 112 Field 23, 125 SCHPREVD parameter 85 SCRATCH (SMS) Disposition 36 Security Access 71 SET Command CADRIVER Procedure 135 SET VAR Parameter 53, 130 SET=%%SYSID 86 Setup Time 109 Shared Option 113 Shared Resource Control 116 SHIFT Parameter 107, 108 SHOUT Conversion Details 127 Destination For Failed Jobs 157 Facility 157 WHEN EXECTIME 157 WHEN LATE 157 WHEN LATESUB 157, 158 WHEN NOTOK 157 Simulate Job Execution 101 Simulation and Forecasting Facility 148
208
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
SLIA-00 End Record 76 SMF Feedback Data 35 SMS-Managed Volumes 77, 78, 81, 84 SORTIN DD Statement 78 SPAN Field 106 SRCLIB Parameter 75 Standard Calendars 105 Start Time 109 STARTM Field 128 Status Screen 28 Step 1 72 Step 10 82 Step 11 83 Step 13 85 Step 14 87 Step 15 88 Step 16 89 Step 2 73 Step 3 74 Step 4 75 Step 5 75 Step 6 76 Step 7 77 Step 8 79 Step 9 81 STEP Command CADRIVER Procedure 135 Stepname Field # SCC JCL Override Statement 156 Submission Exit (Exit 2) 85, 130 Successor Jobs 158 support, customer 3 Suspend Job Execution 113 Sx37 Abend 83 SYMETRIC Parameter 106 SYSDATA Files 145 SYSDB Files 145 Parameter 26, 123 SYSIN DD Statement 78, 121, 154 Non-Instream 154 SYSINLIB DD Statement 77, 80, 81 Sysout Handling 141 Release 155 SYSOUT Parameter 130, 152 System Affinity 80, 130 ID 53, 130 Spool 141 SYSTEM Field 99 SYSUSER Value Shout Destination 157
T
Tape Drive 104 Usage 31 Tape Management System 27 TAPE1 Macro 104, 158 Resource 158 TAPE2 Macro 104, 158 Resource 158 technical support 3 Threshold Priorities 31 Time Limit Job Submission 108 Time Until Indicator 159 TIME UNTIL Parameter 159 TOCLASS 151 TOTAV Parameter INITR Macro 130 TP1 Value # RES Override Statement 124 TP2 Value # RES Override Statement 124 Track Production Jobs 28 Trailer Step 32 TRGID Field 23 TRIG Analyze Command 71 Triggering 22 TSO-uid Value Shout Destination 157 TYPE=RES Parameter DEMAND Command 101 TYPE1 Fields 125 TYPE2 Fields 125 TYPRUN Value 123
U
U11RMS Step 26, 34, 122, 144, 155 Conversion Details 123 U11UCSEX Exit 146 U11VOLCX Macro (CA-11) 146 U7SVC Procedure Name 60 UCC11NR DD Statements 122 UCC7DATA DD Statement 121 UCC7DBVR Program 71 Uncalalog/Scratch Exit 146 UNCATLG Disposition 36 Unique CONTROL-M Parameters Conversion Details 140 User Exit 2 (CONTROL-M) 85 User Exits Install Using Conversion Step 13 85
Index
209
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
User ID 125 User Option Table Macro 21 USER REQUIREMENTS Field Conversion Details 114 USERID Parameter 125 USEROPT Conversion Parameter 159 UserDefined Prerequisites 114 USR 30 Connection 24 USR ID Field 160 Utilities CTMRFLW 88 CTMROGR 88 CTMRPLN 88 CTMXRF 87, 88 General 191 IOACND 87
V
Variable Parameters CADRIVER Procedure 137 Variable-1 57 VERIFY Field Conversion Details 133 Volume INCLUDE/EXCLUDE List 146 VTAM Node Definitions 35
W
WDAYS Parameter 109 WEEKLY Field 109 WLB Command 33 WORK DD Statement 77, 80, 81 Work Library 77, 80, 81 Work Unit Name 78 Workload Balancing Macro INITR 130 Macro TAPE1 158 Macro TAPE2 158 Macros 21 MXTAL Parameter 104 Overview 31 Priority Scheduling Criteria 102
X
XEQ Statement 34 XQ Transaction 28 XREF Analyze Command 71
210
License for that Software. BMC's obligations in this section are conditioned upon Your providing BMC prompt access to the affected Software and full cooperation in resolving the claim. DISCLAIMER. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE, THE PRODUCT IS PROVIDED AS IS. BMC, ITS AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. BMC DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT ALL DEFECTS CAN BE CORRECTED. DISCLAIMER OF DAMAGES. IN NO EVENT IS BMC, ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT, SUPPORT, AND/OR THE PRODUCT (INCLUDING, WITHOUT LIMITATION, LOST PROFITS, LOST COMPUTER USAGE TIME, AND DAMAGE OR LOSS OF USE OF DATA), EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IRRESPECTIVE OF ANY NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT LAW. LIMITS ON LIABILITY. BMCS AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE LICENSE TO THE PRODUCT. SUPPORT. If Your order includes support for the Software, then BMC agrees to provide support (24 hours a day/7 days a week) (Support). You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You as provided below. There is a free support period during the one year warranty period. A. Support Terms. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of supported versions of the Software, BMC provides bug fixes, patches or workarounds in order to cause that copy of the Software to operate in substantial conformity with its thencurrent operating specifications; and (ii) BMC provides new releases or versions, so long as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. BMC may refuse to provide Support for any versions or releases of the Software other than the most recent version or release of such Software made available by BMC. Either party may terminate Your enrollment in Support upon providing notice to the other at least 30 days prior to the next applicable Support anniversary date. If You re-enroll in Support, BMC may charge You a reinstatement fee of 1.5 times what You would have paid if You were enrolled in Support during that time period. B. Fees. The annual fee for Support is 20% of the Softwares list price less the applicable discount or a flat capacity based annual fee. BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date. VERIFICATION. If requested by BMC, You agree to deliver to BMC periodic written reports, whether generated manually or electronically, detailing Your use of the Software in accordance with this Agreement, including, without limitation, the License Capacity. BMC may, at its expense, perform an audit, at your facilities, of Your use of the Software to confirm Your compliance with the Agreement. If an audit reveals that You have underpaid fees, You agree to pay such underpaid fees. If the underpaid fees exceed 5% of the fees paid, then You agree to also pay BMCs reasonable costs of conducting the audit. EXPORT CONTROLS. You agree not to import, export, re-export, or transfer, directly or indirectly, any part of the Product or any underlying information or technology except in full compliance with all United States, foreign and other applicable laws and regulations. GOVERNING LAW. This Agreement is governed by the substantive laws in force, without regard to conflict of laws principles: (a) in the State of New York, if you acquired the License in the United States, Puerto Rico, or any country in Central or South America; (b) in the Province of Ontario, if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the Americas Region); (c) in Singapore, if you acquired the License in Japan, South Korea, Peoples Republic of China, Special Administrative Region of Hong Kong, Republic of China, Philippines, Indonesia, Malaysia, Singapore, India, Australia, New Zealand, or Thailand (collectively, Asia Pacific Region); or (d) in the Netherlands, if you acquired the License in any other country not described above. The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety. ARBITRATION. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR ALLEGED BREACH, SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. IF THE DISPUTE IS INITIATED IN THE AMERICAS REGION, THE ARBITRATION SHALL BE HELD IN NEW YORK, U.S.A., UNDER THE CURRENT COMMERCIAL OR INTERNATIONAL, AS APPLICABLE, RULES OF THE AMERICAN ARBITRATION ASSOCIATION. IF THE DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN SINGAPORE, SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES. IF THE DISPUTE IS INITIATED IN A COUNTRY OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION, THE ARBITRATION SHALL BE HELD IN AMSTERDAM, NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. THE COSTS OF THE ARBITRATION SHALL BE BORNE EQUALLY PENDING THE ARBITRATORS AWARD. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT, AND MAY BE ENFORCED IN ANY COURT OF COMPETENT JURISDICTION. NOTHING IN THIS AGREEMENT SHALL BE DEEMED AS PREVENTING EITHER PARTY FROM SEEKING INJUNCTIVE RELIEF FROM ANY COURT HAVING JURISDICTION OVER THE PARTIES AND THE SUBJECT MATTER OF THE DISPUTE AS NECESSARY TO PROTECT EITHER PARTYS CONFIDENTIAL INFORMATION, OWNERSHIP, OR ANY OTHER PROPRIETARY RIGHTS. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE, AND THE PARTY PREVAILING IN ARBITRATION SHALL BE ENTITLED TO RECOVER ITS REASONABLE ATTORNEYS FEES AND NECESSARY COSTS INCURRED RELATED THERETO FROM THE OTHER PARTY. U.S. GOVERNMENT RESTRICTED RIGHTS. The Software under this Agreement is commercial computer software as that term is described in 48 C.F.R. 252.227-7014(a)(1). If acquired by or on behalf of a civilian agency, the U.S. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition Regulations (FAR) and its successors. If acquired by or on behalf of any agency within the Department of Defense (DOD), the U.S. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C.F.R. 227.7202 of the DOD FAR Supplement and its successors. MISCELLANEOUS TERMS. You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice, unless otherwise provided on the order for the License to the Products. You will pay, or reimburse BMC, for taxes of any kind, including sales, use, duty, tariffs, customs, withholding, property, value-added (VAT), and other similar federal, state or local taxes (other than taxes based on BMCs net income) imposed in connection with the Product and/or the Support. This Agreement constitutes the entire agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements, whether oral, written or displayed electronically, concerning the Product and related subject matter. No modification or waiver of any provision hereof will be effective unless made in a writing signed by both BMC and You. You may not assign or transfer this Agreement or a License to a third party without BMCs prior written consent. Should any provision of this Agreement be invalid or unenforceable, the remainder of the provisions will remain in effect. The parties have agreed that this Agreement and the documents related thereto be drawn up in the English language. Les parties exigent que la prsente convention ainsi que les documents qui sy rattachent soient rdigs en anglais.
Notes