You are on page 1of 320

CONTROL-M®/Desktop User Guide

Version 6.1.01

June 20, 2002

Copyright 2002 BMC Software, Inc., as an unpublished work. 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. Oracle is a registered trademark, and the Oracle product names are registered trademarks or trademarks of Oracle Corp. All other registered trademarks or trademarks belong to their respective companies.

THE USE AND CONTENTS OF THIS DOCUMENTATION ARE GOVERNED BY THE SOFTWARE LICENSE AGREEMENT ENCLOSED AT THE BACK OF THIS DOCUMENTATION.

Restricted Rights Legend
U.S. GOVERNMENT RESTRICTED RIGHTS. UNPUBLISHED–RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in FAR Section 52.227-14 Alt. III (g)(3), FAR Section 52.227-19, DFARS 252.227-7014 (b), or DFARS 227.7202, as amended from time to time. Contractor/Manufacturer is BMC Software, Inc., 2101 CityWest Blvd., Houston, TX 77042-2827, USA. Any contract notices should be sent to this address.

Contacting BMC Software
You can access the BMC Software Web site at http://www.bmc.com. From this Web site, you can obtain information about the company, its products, corporate offices, special events, and career opportunities.

United States and Canada
Address BMC Software, Inc. 2101 CityWest Blvd. Houston TX 77042-2827 713 918 8800 or 800 841 2031 713 918 8000

Outside United States and Canada
Telephone Fax (01) 713 918 8800 (01) 713 918 8000

Telephone Fax

Customer Support
You can obtain technical support by using the Support page on the BMC Software Web site or by contacting Customer Support by telephone or e-mail. To expedite your inquiry, please see “Before Contacting BMC Software.”

Support Web Site
You can obtain technical support from BMC Software 24 hours a day, 7 days a week at http://www.bmc.com/support.html. From this Web site, you can • • • • • • • 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

Support by Telephone or E-mail
In the United States and Canada, if you need technical support and do not have access to the Web, call 800 537 1813. Outside the United States and Canada, please contact your local support center for assistance. To find telephone and e-mail contact information for the BMC Software support center that services your location, refer to the Contact Customer Support section of the Support page on the BMC Software Web site at www.bmc.com/support.html.

Before Contacting BMC Software
Before you contact BMC Software, have the following information available so that Customer Support can begin working on your problem immediately: • 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

BMC Software, Inc., Confidential and Proprietary Information

iii

• • •

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

BMC Software, Inc., Confidential and Proprietary Information

iv

CONTROL-M/Desktop User Guide

Contents

Contents
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Chapter 1 Overview

CONTROL-M/Desktop Components . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Drafts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Read/Write Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5 CONTROL-M/Desktop Window . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Collections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12 CONTROL-M/Server and CONTROL-M for OS/390 . . . . . . . . 1-13
Chapter 2 CONTROL-M/Desktop Wizard

Step 1: Introduction Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Step 2: Connect Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Step 3: CONTROL-M Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Step 4: Skeleton Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Step 5: Job Definition Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Step 6: Write Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9 Step 7: Upload Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10 Step 8: Order/Force Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12 Step 9: Finish Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
Chapter 3 Communicating with CONTROL-M/EM

Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Managing Connections with CONTROL-M/EM . . . . . . . . . . . . . . . 3-3 Connection Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3 Manual Communication Management . . . . . . . . . . . . . . . . . . . . 3-4

BMC Software, Inc., Confidential and Proprietary Information

Contents

v

Chapter 4

CONTROL-M/Desktop Window

CONTROL-M/Desktop Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-9 CONTROL-M/Desktop Window Options . . . . . . . . . . . . . . . . . . . . .4-13 Selecting a Draft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-13 Saving a Draft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-14 Connecting to CONTROL-M/EM . . . . . . . . . . . . . . . . . . . . . . . .4-14 Reading a Scheduling Table . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-15 Exiting CONTROL-M/Desktop . . . . . . . . . . . . . . . . . . . . . . . . .4-15 Working with the Navigation Tree . . . . . . . . . . . . . . . . . . . . . . . . . . .4-16 Displaying/Hiding Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-18 Moving Jobs in the Navigation Tree . . . . . . . . . . . . . . . . . . . . . .4-19 Deleting Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-21 List and Flow Diagram Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22 Switching Between Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22 Arranging the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22 Working in List Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-23 Editing Jobs in List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-25 Deleting Jobs in List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-25 Flow Diagram Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-27 Expanding/Collapsing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-28 Stepping In and Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-29 Zooming In/Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-31 Working with Jobs in the Flow Diagram . . . . . . . . . . . . . . . . . . . . . .4-33 Accessing the Job Editing Form . . . . . . . . . . . . . . . . . . . . . . . . .4-33 Mouse Pointer Drag Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34 Selecting Nodes in the Flow Diagram . . . . . . . . . . . . . . . . . . . . .4-35 Adding Jobs in the Flow Diagram . . . . . . . . . . . . . . . . . . . . . . . .4-37 Copying Jobs in the Flow Diagram . . . . . . . . . . . . . . . . . . . . . . .4-37 Deleting Jobs from the Flow Diagram . . . . . . . . . . . . . . . . . . . .4-38 Find a Job Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-39 Identify Predecessor and Dependent Jobs . . . . . . . . . . . . . . . . . .4-42 Group Scheduling Tables in the Flow Diagram . . . . . . . . . . . . . . . . .4-46 Creating Group Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . .4-46 Deleting Group Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . .4-47 Managing Conditions in the Flow Diagram . . . . . . . . . . . . . . . . . . . .4-48 Creating/Modifying Conditions and Dependencies . . . . . . . . . .4-48 Displaying Conditions Created by Do Statements . . . . . . . . . . .4-50 Delete Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-51 Condition Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-55 Net Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-57
BMC Software, Inc., Confidential and Proprietary Information

vi

CONTROL-M/Desktop User Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7 Defining a New Tag . . . . . 5-13 Execution Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-51 Exiting the Job Editing Form . . 6-8 Modifying an Existing Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3 Job Skeletons . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28 Set Panel . . . . . . . . . . . . . . . . . . . . . . . . .Chapter 5 Working with the Job Editing Form Job Editing Form Layout . . . . . . . . . . 5-3 Undo and Redo in the Job Editing Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-22 Exiting the Group Editing Form . . . . . . . . . . . . . 5-10 General Panel for Application-Specific Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25 Resources Panel . . . . . 6-17 Shouts Panel . . . . . . . . . 5-32 Steps Panel (OS/390) . . . . . . . . . 5-7 General Panel (OS/390) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8 Conditions Panel . . . . . . 7-4 Specifying and Modifying Skeleton Fields . . . . . . 5-12 Scheduling Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26 Chapter 7 Creating and Updating Multiple Jobs Mass Creation of Job Processing Definitions . . . . . . 5-54 Chapter 6 Working with the Group Editing Form Layout . . . . . . . . . . . . . . . . . . 6-2 General Panel . . . . . . . . . . . . . . . . . . 6-18 PostProc Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21 Conditions Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13 BMC Software. . . . . . . . . . . . . . . . . . . 6-12 Resources Panel (OS/390) . . . . . . . . . . . . . . . . . . . . Inc. . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . 5-53 Running CONTROL-M/Server Utilities as Scheduled Jobs . . . . . . . 5-5 General Panel . . . . . . . . 6-8 Scheduling Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-39 PostProc Panel . . . . . . . . . . . 7-11 In Conditions and Out Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2 Helpful Hints . . . . . . . . . . 5-30 Steps Panel . . . . . . . . . . . . . . . Confidential and Proprietary Information Contents vii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-47 Tags Selection Panel . . 6-5 Schedule Tags Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15 Set Panel . . . . . . 6-26 Copy Tags Window . .

. . . . . . . . . . .9-13 Managing Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-9 Writing Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-22 Jobs List Window . . . . . . . . . . . . . .10-8 Defining Calendar Criteria . . . . . . . . . . . . . . . . . . . . . . . . .9-4 Reading Scheduling Tables . .. . . . . . . . . . . . . . . . . . . . . . . .9-24 Chapter 10 Working with Calendars Managing Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-8 Lock/Unlock . . . . . . . . . . . . .9-10 Using Scheduling Tables in the Draft Window . . . . . . . . . . . . . . . . . . . . . .12-2 Flow Diagram Panel . . . . . . . .11-6 Chapter 12 Customization Options Dialog Box . . . . . . . . .10-10 Chapter 11 CONTROL-M Definitions and Validity Checks CONTROL-M Definitions . . . . . . . . . . . . . . . .9-13 Selecting Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-4 Checking Validity by Default . . . . . . . . .7-22 Chapter 8 Filtering Data Using Collections Defining Selection Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12-1 General Panel . . . . .7-18 Mass Updating In Conditions and Out Conditions . . . Confidential and Proprietary Information viii CONTROL-M/Desktop User Guide . . . . . . . . . . . . . . . . . .8-2 Specifying the Selection Action . . . . . . . . . . . . . . . . . . . . . . .8-5 Chapter 9 Working with Scheduling Tables Data Transfer From CONTROL-M/EM . . . . . .12-5 Viewing Toolbars . . . . . . . . . . .10-3 Defining Calendars . . . . . . . . . . . . . . . . . . . . . . . .Specifying In Conditions and Out Conditions in a Skeleton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-5 Select Jobs Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-15 Updating Multiple Jobs and Group Scheduling Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-3 Logging in to CONTROL-M/EM . . . . . . . . . . . .11-1 Validity Checking . . . .13-1 Printing the Flow Diagram . . . . . . . . . . . . . . . . . . . . . .12-9 Chapter 13 Printing Facility Previewing a Flow Diagram . . . . . . . . . . . . . . . . . . . . . . . .13-3 BMC Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-16 Scheduling Table Details Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Confidential and Proprietary Information Contents ix .Index BMC Software. Inc..

Confidential and Proprietary Information x CONTROL-M/Desktop User Guide . Inc..BMC Software.

. . . . . . . . . . . . . . Sample Step In Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Net Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Figures Figures Figure 1-1 Figure 1-2 Figure 1-3 Figure 1-4 Figure 1-5 Figure 1-6 Figure 1-7 Figure 1-8 Figure 1-9 Figure 3-1 Figure 3-2 Figure 4-1 Figure 4-2 Figure 4-3 Figure 4-4 Figure 4-5 Figure 4-6 Figure 4-7 Figure 4-8 Figure 4-9 Figure 4-10 Figure 4-11 Figure 4-12 Figure 4-13 Figure 4-14 Figure 4-15 Figure 5-1 Figure 5-2 Read/Write Facility . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . Job Editing Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application Hierarchy . . Communication Login Window. . . . . . . . . . . . . . . . . . . . . . . . . Moving Jobs between Scheduling Tables . . . . . List View . . . . . . Connection Properties Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M/Desktop Draft Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Flow Diagram View . . . . . . . Find a Job Dialog Box . . . . . . . . . CONTROL-M/Desktop Draft Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . In Conditions Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Confidential and Proprietary Information Figures xi . . 1-5 1-6 1-7 1-8 1-8 1-9 1-10 1-11 1-12 3-5 3-8 4-2 4-3 4-4 4-5 4-6 4-7 4-8 4-20 4-23 4-27 4-30 4-40 4-50 4-55 4-57 5-3 5-6 BMC Software. . . . . . . . . . . . . . Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONTROL-M Hierarchy . . Job Editing Form . . . . .General Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Editing Mode Pop-up Menu. . . . . . . List View . . . . . . . . . . Job Editing Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multiple Windows in CONTROL-M/Desktop . . . . . . . . . . . . . . .General Panel . . . . . . . . . . . . . . . . . . . . . . . Condition Nodes . . . . . . . . . . . . . . . . . Draft Window. . . . . . . . . . . . flow diagram View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options Dialog Box . Group Editing Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Editing Form – General Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Net Overview . . CONTROL-M/Desktop Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5 Group Editing Form – Schedule Tags Panel. . . . . . . . . . . . . . . 5-32 Steps Panel – On Statement Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10 Scheduling Panel of the Job Editing Form . . . . . . 6-22 Skeleton Editor Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21 Conditions Panel of the Job Editing Form . . . . . . 5-25 Resources Panel of the Job Editing Form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5 Select Jobs Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5 Expanded Skeleton Editor Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12 Group Editing Form – Set Panel. . . . . . . . . . . . . . Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13 Execution Panel Fields . . . . . 5-47 Tags Selection Panel of the Job Editing Form . . . . 5-43 PostProc Panel of the Job Editing Form. . . . . . . . . . . 9-8 Write Scheduling Tables results Window. . . . . . . . . . . 7-9 Collection Criteria Dialog Box. . . . . . . . . . . . . . 13-2 BMC Software. . . . . . . . . . 6-17 Group Editing Form – Shouts Panel. . . . . . . . . . . . 8-3 Collection Criteria – Operators List Box . . . . . . . . . . . .. . . . . . . . 12-5 Flow Diagram Print Preview Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34 Steps Panel – Do Statement Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11 Scheduling Tables Window . . . . . . . . . . 5-7 General Panel (OS/390) . . . . . . . 5-42 Do Statement Definition Line . . . . . . . . . . 6-3 Group Editing Form – General Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30 Steps Panel of the Job Editing Form . . . . 11-5 Options Dialog Box – General Panel . . . . . 6-19 Group Editing Form – Postproc Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4 Sample Collection Criteria . . . . . . . . . . . . 5-51 Group Editing Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2 Collection Criteria – Fields . . . . . . 5-39 Step Range Fields . . . . . . . . . 10-4 Calendar Definition Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7 Group Editing Form – Conditions Panel . . . . . . . . . . . . . . . . . . . . 5-40 ON Statement Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35 Steps Panel of the Job Editing Form (OS/390). . . . . . . 9-25 Calendars Manager Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2 Options Dialog Box – Flowdiagram Panel. . . . .Figure 5-3 Figure 5-4 Figure 5-5 Figure 5-6 Figure 5-7 Figure 5-8 Figure 5-9 Figure 5-10 Figure 5-11 Figure 5-12 Figure 5-13 Figure 5-14 Figure 5-15 Figure 5-16 Figure 5-17 Figure 5-18 Figure 6-1 Figure 6-2 Figure 6-3 Figure 6-4 Figure 6-5 Figure 6-6 Figure 6-7 Figure 7-1 Figure 7-2 Figure 8-1 Figure 8-2 Figure 8-3 Figure 8-4 Figure 9-1 Figure 9-2 Figure 9-3 Figure 9-4 Figure 9-5 Figure 10-1 Figure 10-2 Figure 11-1 Figure 12-1 Figure 12-2 Figure 13-1 General Panel of the Job Editing Form . . Confidential and Proprietary Information xii CONTROL-M/Desktop User Guide . . . . . . . . . 5-28 Set Panel of the Job Editing Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22 Jobs List Window . . . . . 9-17 Scheduling Table Details Window . . . . . 10-8 Validity Check – Messages Window . . . . .

. . . . . . . . . . . . . . . .Parameters . . . . . . . . . . . . . . . . . . . . . . . 5-10 Conditional Sections of the Scheduling Panel . . . . . 4-41 Neighborhood Dialog Box Elements . . . . . . 5-22 Conditions Panel – Buttons . . . . Microsoft Windows. . . . 5-20 Execution Panel Field Descriptions . . . and VAX/VMS . . . . . . 4-16 Icons in the Application Hierarchy . . . . . . . . . . . . . 4-9 CONTROL-M/Desktop Edit Menu Options . . . . 4-11 CONTROL-M/Desktop Communication Menu Options. 5-26 In Condition Fields . . . . 5-13 Scheduling Panel Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27 Resources Panel – Function Buttons . . . . . . Confidential and Proprietary Information Tables xiii . . . . . . . . . . 4-24 Find/Select a Job Window Field and Button Descriptions . . . . . . 4-12 Icons in the CONTROL-M Hierarchy . . . . Inc. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . . . . . . . . . . 5-14 Shift Values . . . 5-19 Shift Num Values . . . . 5-8 General Panel Parameter Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17 Display According to Node Selected in the Navigation Tree . iSeries (AS/400). . . . . . . . . . . . . . . . . . . . . . . . 4-12 CONTROL-M/Desktop Help Menu Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44 Panels of the Job Editing Form . . . . . 5-4 General Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 Task Types for OS/390. . . . . . 4-9 CONTROL-M/Desktop View Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Tables Tables Table 2-1 Table 2-2 Table 4-1 Table 4-2 Table 4-3 Table 4-4 Table 4-5 Table 4-6 Table 4-7 Table 4-8 Table 4-9 Table 4-10 Table 4-11 Table 4-12 Table 5-1 Table 5-2 Table 5-3 Table 5-4 Table 5-5 Table 5-6 Table 5-7 Table 5-8 Table 5-9 Table 5-10 Table 5-11 Table 5-12 Table 5-13 Task Types for Unix. . . . . . 5-26 Out Condition Fields . . . . . . . . . 4-10 CONTROL-M/Desktop Tools Menu Options . . 2-8 Editing Mode Pop-up Menu. . . . . . . . . . . . . . . . . . . 5-31 BMC Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7 CONTROL-M/Desktop File Menu Options . . . . . . 5-29 Set Panel – Function Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . 6-20 Shout Statement Parameters . . . . . . . . . . . . . . . 5-50 CONTROL-M/Server Utility Jobs . . . . . . 6-6 Schedule Tags Panel – Field Descriptions . . . . . . . 9-18 Command Buttons – Scheduling Table Manager . . . . . . . . . . . . . . . . . . . 5-34 DO Statement Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-55 Group Editing Form – Panels . . . . . . . . . . . . . . 5-33 On Statement Code Criteria . . . . . . . . 6-3 Group Editing Form – General Parameters . . . . . . . . . . . . . . . . . . . . . . 5-43 DO Statement Parameters. . . . . . . . . . . . . .. . 7-10 Valid Functions for Values in the Skeleton Editor . . 10-2 Column Descriptions – Calendars Manager Window . . . . . 6-24 Fields of the Mass Create Form Dialog Box . . . . . . . . . . . . . . . . . . 5-42 On Statement Parameters . . . . . . . . 6-13 In Condition Fields . . . . . . . . 8-4 Filter Fields – Scheduling Table Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-25 Calendar Types . . . . . . . . 6-16 Set Panel – Function Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19 Field Descriptions – Scheduling Table Details Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3 Skeleton Editor Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inc. . . . . . . . . . . . . . . . . . . . . . . . . 6-13 Out Condition Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36 Step Range – Fields . . 10-5 BMC Software. 6-14 Resources Panel – Function Buttons . . . . . . . . 7-14 Fields of the Mass Update Form . . . . . . . . . . . . . . . . . . . . . . . 5-43 Shout Statements – Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20 Postproc Panel – Buttons . . . 6-9 Conditions Panel – Buttons . . . . . 5-40 Step Range – Buttons . . . . . . . . . . . 5-48 Shout Statement Parameters . . . . . . . . . .Table 5-14 Table 5-15 Table 5-16 Table 5-17 Table 5-18 Table 5-19 Table 5-20 Table 5-21 Table 5-22 Table 5-23 Table 5-24 Table 5-25 Table 6-1 Table 6-2 Table 6-3 Table 6-4 Table 6-5 Table 6-6 Table 6-7 Table 6-8 Table 6-9 Table 6-10 Table 6-11 Table 6-12 Table 7-1 Table 7-2 Table 7-3 Table 7-4 Table 7-5 Table 7-6 Table 7-7 Table 8-1 Table 8-2 Table 9-1 Table 9-2 Table 9-3 Table 9-4 Table 9-5 Table 10-1 Table 10-2 Steps Panel – Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22 Jobs List Window Elements . . . 7-13 Valid Functions for the Condition Format Field. . . . . . . . . . . . . . . . . . . . . 8-2 Collection Criteria – Operators . . . . . . . . Confidential and Proprietary Information xiv CONTROL-M/Desktop User Guide . . . . . . . . 7-20 Valid Functions for To Values . . . . . . . . . . . . . . . . . . . . 6-18 Shout Statements – Buttons . . . . . . 6-23 Postproc Panel (Groups) – Valid DO statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18 Column Descriptions – Scheduling Table Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-40 Step Codes – Buttons . . . . . . 7-6 Application Support Fields in the Skeleton Editor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-49 Sysout Handling Parameters. . . 7-21 Collection Criteria Dialog Box Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . General Panel – Options Dialog Box.. . . . . . . . . . . . . Dates and Colors . . . . . . . . . . . . . . . . . . . . . . . . . 10-6 10-13 11-3 12-3 12-6 12-9 13-2 BMC Software. . . . . . Confidential and Proprietary Information Tables xv . . . . Fields in the CONTROL-M Dialog Box . . . . . . . . . . . . . . . . . . . . . . . Inc. . . . . . Flowdiagram Panel – Options Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Print Preview – Buttons . . . . . . . . . .Table 10-3 Table 10-4 Table 11-1 Table 12-1 Table 12-2 Table 12-3 Table 13-1 Command Buttons – Command Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Toolbar Contents . . . . .

.BMC Software. Inc. Confidential and Proprietary Information xvi CONTROL-M/Desktop User Guide .

Inc.1. CONTROL-M/Desktop Window Describes how to use the CONTROL-M/Desktop window and the various methods available for viewing data.01).. About This Book This book is a guide to using CONTROL-M/Desktop on a Microsoft Windows computer. the CONTROL-M® Job Parameter and Variable Reference Guide. Confidential and Proprietary Information About This Book xvii . and the CONTROL-M Installation Guide (version 6. the CONTROL-M®/Enterprise Manager Utilities Reference Guide. capabilities. which introduces you to the CONTROL-M Business Integrated Scheduling environment.1. This guide is divided into the following chapters: Chapter Chapter 1 Description Overview Provides an overview of CONTROL-M/Desktop including its advantages.1. . Communicating with CONTROL-M/EM Describes how to establish communication between CONTROL-M/Desktop and CONTROL-M/EM. Use this book with the CONTROL-M/Enterprise Manager User Guide (version 6.01). CONTROL-M/Desktop Wizard Describes how to use the CONTROL-M Job Definition Wizard.01). Chapter 2 Chapter 3 Chapter 4 BMC Software. the CONTROL-M/Enterprise Manager Administrator Guide (version 6.About . and components. .

and upload/download Scheduling tables. It also describes how to use the Scheduling Table Manager to create. Filtering Data Using Collections Describes how to create a subset of job processing definitions for filtered viewing. Inc. Chapter 6 Chapter 7 Chapter 8 Chapter 9 Chapter 10 Chapter 11 Chapter 12 Chapter 13 Various CONTROL-M platforms sometimes use different terminology for CONTROL-M components and parameters. Customization Describes how to set CONTROL-M/Desktop defaults. CONTROL-M Definitions and Validity Checks Describes the means for defining CONTROL-M installations and checking the validity of job processing parameters. Confidential and Proprietary Information xviii CONTROL-M/Desktop User Guide . force/order. but each component or parameter referenced is easily recognized. Working with Calendars Describes how to use the Calendar Manager to create and update Calendar definitions and how to transfer them to the CONTROL-M/EM database. Printing Facility Describes how to print the Flow Diagram View of the Command window. Working with Scheduling Tables Describes the means for transferring job processing definitions between CONTROL-M/Desktop and the CONTROL-M/EM database and CONTROL-M platforms. modify. Creating and Updating Multiple Jobs Describes how to create and update multiple job processing definitions at one time. BMC Software. The terminology used in this book may be different than the terminology used for your platform.. search and replace techniques and mass updates. Working with the Group Editing Form Describes how to use the Group Editing form to create and update Group Scheduling table definitions.Chapter Chapter 5 Description Working with the Job Editing Form Describes how to use the Job Editing form to create and update job processing definitions.

These guides describe installation. customization. CONTROL-M/Enterprise Manager Administrator Guide describes administrator responsibilities. Inc. CONTROL-M Administrator Guides are supplied based on the type of computer(s) in each site’s CONTROL-M installation(s). CONTROL-M/Server Administrator Guide describes installation and maintenance of CONTROL-M/Server on the various types of supported platforms. CONTROL-M® Job Parameter and Variable Reference Guide describes the parameters used for creating job processing definitions. setup. and iSeries (AS/400) platforms.Related Publications • CONTROL-M User Manual (OS/390) describes all CONTROL-M concepts. facilities and operating instructions in detail. features. facilities and operating instructions in detail. • • • • • • • BMC Software.. features. CONTROL-M/Enterprise Manager User Guide describes all CONTROL-M/EM concepts. Confidential and Proprietary Information About This Book xix . security and utilities that apply to CONTROL-M for OpenVMS. It can be used as a learning guide as well as a reference guide. CONTROL-M/Agent Administrator Guide describes installation and maintenance of CONTROL-M/Agent on the various types of supported platforms. maintenance and security of CONTROL-M/EM. It can be used as a learning guide as well as a reference guide. CONTROL-M Installation Guide describes the installation processes for implementing CONTROL-M/EM and CONTROL-M/Server environments on Microsoft Windows and Unix platforms.

CONTROL-M®/Enterprise Manager API Developers Guide describes how to enable your applications to submit requests to CONTROL-M/EM. Users and Groups => Groups => Add means that you first select Users and Groups from the menu bar. Menu => Option BMC Software. <F1>). Select the Groups option from the submenu.. Finally. Inc. When two keys are joined with “+” as in <Shift>+<F1>. This represents an option selection sequence. hold down <Shift> while pressing <F1>.• CONTROL-M®/Enterprise Manager Utilities Reference Guide describes the utilities used for creating and managing objects in the job production environment and maintaining various aspects of CONTROL-M®/Enterprise Manager. • Conventions The following abbreviations are used in this guide: Abbreviation CONTROL-M/EM Net <home-directory> Description CONTROL-M/Enterprise Manager CONTROL-M/EM Network Directory in which CONTROL-M/EM is installed The following conventions are used in this guide: <key> When describing keystrokes. For example. angle brackets are used to enclose the name of a key (for example. select the Add option from the Groups submenu. Confidential and Proprietary Information xx CONTROL-M/Desktop User Guide .

and Web addresses also appear in boldface type. b.. directory names and paths. . In instructions. you would choose a. The titles of BMC Software product documentation are also displayed in italic type. [Option] JCL Script Square brackets are used to enclose parameters that are optional. Confidential and Proprietary Information About This Book xxi . ) indicates that you can repeat the preceding item or items as many times as necessary. » denotes one-step An ellipsis ( . For example: {AND|OR} means that you specify either AND or OR. Boldface Italics One-Step Procedures Ellipsis The symbol instructions. and literal examples are presented in this typeface.{Option A|Option B} The vertical bar is used to separate choices. In the following example. File names. Inc. All syntax. boldface type highlights information that you enter. A vertical bar ( | ) separating items indicates that you must choose one item. or c: a|b|c Option Symbol BMC Software. window names. Italic type is used to emphasize important terms. operating system terms. .

BMC Software. Confidential and Proprietary Information xxii CONTROL-M/Desktop User Guide .. Inc.

View and modify parameters in job processing definitions. It provides you with an intuitive and easy-to-use tool for creating and maintaining job processing definitions and calendars. CONTROL-M/Desktop is a component of CONTROL-M/Enterprise Manager (CONTROL-M/EM). Move job processing definitions between CONTROL-M installations/scheduling tables or between applications/groups using “drag-and-drop” techniques. Perform global search-and-replace of job processing parameters. CONTROL-M/Desktop runs under all supported Windows platforms. For more information see the CONTROL-M Installation Guide. Inc.. • • • BMC Software. For more information on supported Windows platforms. calendars and Scheduling tables. CONTROL-M/Desktop can help you: • Display job hierarchy based on a CONTROL-M scheduling table or application/group parameters. see the CONTROL-M Installation Guide.1 Overview 1 CONTROL-M/Desktop is a production design and definition system for users of CONTROL-M. CONTROL-M/Desktop uses online forms to simplify definition of job processing parameters. Confidential and Proprietary Information Overview 1-1 . It is installed as a client component during CONTROL-M/EM installation.

Confidential and Proprietary Information 1-2 CONTROL-M/Desktop User Guide . • • • • • CONTROL-M/Desktop generates Scheduling table files from the CONTROL-M/EM database and reads them using a communication link. View specific parameters in a list of job processing definitions.. View and modify Calendars.00 or later. Define “collections” of job processing definitions for both viewing and performing mass updates.• Create multiple job processing definitions automatically with predefined parameters and functions. New or modified tables are written back into the CONTROL-M/EM database. View two or more job processing definitions simultaneously. Note Direct transfer of Scheduling tables to and from CONTROL-M for OS/390 (using SCH files) is not supported for CONTROL-M/Desktop version 6. Inc. according to job dependencies.0. View job production flow graphically. making modifications as you progress through the list. BMC Software. Both Scheduling tables and Calendars can be uploaded or downloaded from the CONTROL-M/EM database to their respective CONTROL-M/Server database directly in CONTROL-M/Desktop.

— Group Editing Form View – Editing window containing parameters of a selected Group Scheduling table. — Job Editing Form View – Editing window containing Job Production parameters of a selected job processing definition. Skeletons – Templates for creating job processing definitions based on default parameters and predefined functions. used for filtered viewing and mass parameter modifications.. • Collections – Specified subsets of job processing definitions in a Draft.CONTROL-M/Desktop Components CONTROL-M/Desktop consists of the following components: • Drafts – The repository for storing and working on CONTROL-M job processing definitions. Read/Write Facility – Means of transferring scheduling tables between CONTROL-M/EM and CONTROL-M/Desktop online. — Flow Diagram View – Graphic representation of job production flow based on various job dependencies. CONTROL-M/Desktop Window – The online user interface that displays Draft data in various formats (views): — Tree View – Hierarchical list of job processing definitions displayed according to CONTROL-M/scheduling table or application/group hierarchy. — List View – Contents of the next level of detail of an item selected from Tree View. CONTROL-M – Means of identifying scheduling tables and specific job processing parameters for different platforms or applications. Confidential and Proprietary Information Overview 1-3 . • • • • BMC Software. Inc.

create. Users do not require direct access to CONTROL-M. force. modify. modify. Scheduling Table Manager – Enables the user to list. order. Working in CONTROL-M/Desktop does not negatively impact performance of the CONTROL-M platform. Drafts can contain job processing definitions from either a single scheduling table or from multiple scheduling tables. At sites where only the CONTROL-M administrator has direct access to CONTROL-M. CONTROL-M does not have to be operational for job processing definitions to be created using CONTROL-M/Desktop.. upload or download Calendars. • • BMC Software. Inc. delete. to be able to work in CONTROL-M/Desktop. delete. personnel from other departments can still work in CONTROL-M/Desktop. upload or download scheduling tables. Drafts are totally independent of CONTROL-M and the CONTROL-M production environment. Confidential and Proprietary Information 1-4 CONTROL-M/Desktop User Guide . or the CONTROL-M platform.• Mass Job Creation/Update Facility – Creates and updates multiple job processing definitions in a Draft. Drafts The repository for storing and working on job processing definitions in CONTROL-M/Desktop is called a Draft. Because of this independence: • • Work can be saved without undergoing validity checks. create. • • Each of these components is described in detail below. Calendar Manager – Enables the user to view.

all definitions for a single Scheduling table are Written back to the CONTROL-M/EM database.. After creating or modifying job processing definitions in a Draft. Figure 1-1 Read/Write Facility Communication with the CONTROL-M/EM database is initiated using the Read/Write facility. updates them. To prevent multiple users from updating the same Scheduling table concurrently. The Read option copies the job processing definitions from the requested Scheduling table in the CONTROL-M/EM database and reads them into the current CONTROL-M/Desktop Draft. Inc. BMC Software.Read/Write Facility CONTROL-M/Desktop reads Scheduling tables from the CONTROL-M/EM database. CONTROL-M/Desktop automatically Locks a Scheduling table when it is read by a specific user. CONTROL-M/Desktop automatically Unlocks a Scheduling table when it is written back by the user or when the user quits the CONTROL-M/Desktop session. Confidential and Proprietary Information Overview 1-5 . and then transfers the Scheduling Tables back to the CONTROL-M/EM database.

Confidential and Proprietary Information 1-6 CONTROL-M/Desktop User Guide . CONTROL-M/Desktop contains the following Draft views: • Tree View BMC Software. Inc. Each Draft window contains either two or three panes. Each of these displays is called a view. each of which displays one view at a time. Actions performed on an item in one pane affect the view of items displayed in another pane.. Draft views usually include a combination of graphic and text representation of Draft items.CONTROL-M/Desktop Window Figure 1-2 CONTROL-M/Desktop Window Multiple windows can be opened at the same time to displaying different views of the same Draft. Data in a CONTROL-M/Desktop Draft can be organized in different ways when it is displayed in a Draft window.

Group and Mem Name. Scheduling Table and Mem Name. This “tree” is based on parameters in each job processing definition and can be displayed using either of two parameter hierarchies: — CONTROL-M Hierarchy CONTROL-M hierarchy is based on job processing parameters: CONTROL-M. — Application Hierarchy Application hierarchy is based on job processing parameters: Application..The left pane of the Draft window displays a tree of job processing definitions in the Draft. Figure 1-3 CONTROL-M Hierarchy BMC Software. Confidential and Proprietary Information Overview 1-7 . Inc.

Inc.. Confidential and Proprietary Information 1-8 CONTROL-M/Desktop User Guide . Figure 1-5 List View BMC Software.Figure 1-4 Application Hierarchy • List View List view displays the details of a selected item in the Tree pane.

• Flow Diagram View Flow Diagram view displays a graphic representation of job production flow.. based on job dependencies established through prerequisite IN and OUT conditions. Inc. Figure 1-6 Flow Diagram View BMC Software. Confidential and Proprietary Information Overview 1-9 .

A miniature overview (Net Overview) of the flow diagram is displayed in the lower right pane of the window. When you double-click on a job in Tree. You can click on items in this pane to navigate more easily in the Flow Diagram.. or click on a job in Tree view under List/Job Editing Form view. BMC Software. the Job Editing form for that job is displayed. Flow Diagram or List view. Inc. Figure 1-7 Net Overview • Job Editing Form View The Job Editing form in CONTROL-M/Desktop displays all parameters in a job processing definition. Confidential and Proprietary Information 1-10 CONTROL-M/Desktop User Guide .

Figure 1-8 Job Editing Form – General Panel • Group Editing Form View The Group Editing form displays processing parameters for a Group Scheduling table. It is used to create new Group Scheduling tables. When you double-click a Group Scheduling table node in Flow Diagram view. Confidential and Proprietary Information Overview 1-11 .. BMC Software. Inc. and to modify processing parameters in existing Group Scheduling tables. the Group Editing form for the table is displayed.

CONTROL-M/Desktop allows you define a collection of the jobs upon which to work. You can adjust the collection as often as needed.General Panel Collections A collection is a selection of jobs in a Draft. By default. BMC Software. You can also add and delete specific jobs from a collection without having to define a new collection that would omit those jobs. This is especially useful for applying mass updates to all job processing definitions in a collection. the collection on which you work includes all jobs in the Draft.. Confidential and Proprietary Information 1-12 CONTROL-M/Desktop User Guide .Figure 1-9 Group Editing Form . Inc.

. In order create these associations.CONTROL-M/Server and CONTROL-M for OS/390 Each job processing definition handled by CONTROL-M/Desktop must be associated with one or more CONTROL-M/Server or CONTROL-M for OS/390 installations at your site. The parameters in the displayed Job Editing form vary depending on these specifications. You can also create multiple job processing definitions automatically. Each skeleton is associated with a CONTROL-M definition and an application type. based on Skeletons. that allow you to create job processing definitions with default parameters and predefined functions. These definitions can then be modified as necessary using the Job Editing form and the Group Editing form. this global search and replace can be limited to jobs that satisfy specified criteria. Confidential and Proprietary Information Overview 1-13 . BMC Software. Inc. Together with Collections. These Skeletons can be used to automatically create individual job processing or Group definitions. each relevant CONTROL-M installation must be defined in CONTROL-M/Desktop. Possible variations are: • • • Default (appropriate for most jobs) OS/390 job parameters Job parameters for a specific application (for example. Skeletons CONTROL-M/Desktop provides templates. Oracle Applications or SAP) Mass Job Creation and Update CONTROL-M/Desktop allows you to globally search and replace values in job processing definitions in the current Draft. and multiple job processing definitions. called Skeletons.

BMC Software. delete..The advantage of both of these features is to eliminate the need for individually defining and modifying job processing definitions with similar parameters. and upload or download Scheduling tables to the CONTROL-M/Server database in the indicated CONTROL-M installation. create a new scheduling table. After using the mass job creation facility. Confidential and Proprietary Information 1-14 CONTROL-M/Desktop User Guide . Inc. It is used to modify. Scheduling Table Manager The Scheduling Table Manager lists all Scheduling tables in the CONTROL-M/EM database. you can define collections to filter the new definitions and use the mass update facility to further modify the definitions. force or order an existing scheduling table.

usually spanning a number of months or years.Calendar Manager A CONTROL-M Calendar contains a list of dates. The Calendar Manager is used to define and edit calendars. Inc. which can be used as a basis for scheduling jobs. The dates on which a job can be ordered are limited by the calendars named in the Scheduling parameters of the job processing definition. Confidential and Proprietary Information Overview 1-15 . BMC Software. and upload and download calendars from the CONTROL-M/EM database to the indicated CONTROL-M/Server database. If no calendar is specified.. the job is ordered solely on the basis of the other Scheduling parameters.

Confidential and Proprietary Information 1-16 CONTROL-M/Desktop User Guide .. Inc.BMC Software.

2 CONTROL-M/Desktop Wizard 2 The CONTROL-M/Desktop Wizard is the easy way to create. BMC Software. It enables you to define and run jobs while becoming familiar with the key elements of CONTROL-M. modify. you will need: • • • • A CONTROL-M/EM user account and valid password A running CONTROL-M/EM GUI Server Definitions in CONTROL-M/Desktop for each of your CONTROL-M installations A running gateway between CONTROL-M/EM and your CONTROL-M installation The CONTROL-M/Desktop Wizard is intended for new users. press Ctrl-w to display the Toolbar menu. To run the CONTROL-M/Desktop Wizard. If the toolbar is not displayed. Confidential and Proprietary Information CONTROL-M/Desktop Wizard 2-1 .. Inc. and schedule CONTROL-M job processing definitions. Opening the CONTROL-M/Desktop Wizard » Click in the CONTROL-M/EM Desktop tool bar and the Introduction window is displayed.

Note The Finish button completes the job definition and opens the CONTROL-M/EM GUI. Confidential and Proprietary Information 2-2 CONTROL-M/Desktop User Guide . You can return to the CONTROL-M/Desktop Wizard and continue the job definition. All data is retained in the database. The window you are in is highlighted. The left side lists all the windows of this wizard. The Close button closes the CONTROL-M/Desktop Wizard. BMC Software. Inc.Step 1: Introduction Window The Introduction window (Step 1) describes the CONTROL-M/Desktop Wizard functions and prerequisites..

Step 2: Connect Window If you are offline or want to connect to a different CONTROL-M/EM GUI Server. The CONTROL-M/EM GUI Server is the ‘heart’ of CONTROL-M/EM. Confidential and Proprietary Information CONTROL-M/Desktop Wizard 2-3 .» Ensure that the prerequisites have been met and click Next to continue.. in which all job scheduling information is stored before being inserted in to the CONTROL-M Active Jobs file. enter the data in this window. The CONTROL-M/EM GUI Server also maintains a database. This component controls communication between the various CONTROL-M components and the CONTROL-M/Server database. Specify the following information: • • Username – Your CONTROL-M/EM username Password – Your CONTROL-M/EM password BMC Software. Inc. 1.

• Server – Hostname of the computer that is running the CONTROL-M/EM GUI Server to which you will connect. If you are logged on to a CONTROL-M/EM GUI server and you choose to change servers. Step 3: CONTROL-M Window In this window you select the CONTROL-M installation on which to run your jobs. BMC Software. Inc.. Confidential and Proprietary Information 2-4 CONTROL-M/Desktop User Guide . Click Next to continue. 2. the first server is automatically disconnected. You can connect to only one CONTROL-M/EM GUI server at a time.

The drop-down list includes all CONTROL-M configurations that have been defined in CONTROL-M/Desktop. “CONTROL-M Definitions and Validity Checks. 2. you select the skeleton (job template). Step 4: Skeleton Window In this window. The skeleton determines the default values of the job. Confidential and Proprietary Information CONTROL-M/Desktop Wizard 2-5 . If you want to add. For more information on defining a CONTROL-M in CONTROL-M/Desktop.” 3. see Chapter 11. click the CONTROL-M Definitions button. Select the CONTROL-M installation from the drop-down list. Click Next to continue. BMC Software.1.. or delete a CONTROL-M definition. modify. Inc.

The Skeleton Editor form is displayed. Inc. click on the Skeleton Editor button. Click Next to continue. 3.” Any changes to an existing skeleton are permanent and will affect the present job. or delete a skeleton definition. Confidential and Proprietary Information 2-6 CONTROL-M/Desktop User Guide . The changes are not retroactive. 2. see Chapter 7. Step 5: Job Definition Window BMC Software. Select the skeleton from the drop-down list. “Creating and Updating Multiple Jobs. If you want to add. modify.Job skeletons are job parameter templates that are used as the basis from which job processing definitions are created. 1. For more information about job skeletons..

If you use Job(Counter). Microsoft Windows. Inc. “Working with Scheduling Tables. The displayed parameters change with the selected Task Type. iSeries (AS/400). the job names will be Job0. Tasktype—Of the job (task) to be performed by CONTROL-M Table Name —Name of the Scheduling table to which the job belongs. Job2 . the task types and required parameters are: Table 2-1 Task Types for Unix. Specify the following information in the New Job section (all task types require the following parameters: • Job Name— Specify a job name or use Job(Counter). Confidential and Proprietary Information CONTROL-M/Desktop Wizard 2-7 . Microsoft Windows. Each job is added to a specified Scheduling table. For a complete description of parameters see the CONTROL-M Job Parameter and Variable Reference Guide.” 1. Job1. and VAX/VMS • • Task Type Command Job Description and Parameters The only parameter is Command. iSeries (AS/400).The Job Definition window (Step 5) enables specification of the minimum mandatory parameters for your job. Normal job.. see Chapter 9. Together with parameter CONTROL-M.. For Unix. and VAX/VMS. For more information on Scheduling tables. this determines the position of the job in the CONTROL-M/Scheduling Table hierarchy.. Parameters: • File • Path BMC Software.

iSeries (AS/400). see Chapter 5.. “Working with the Job Editing Form.Table 2-1 Task Types for Unix. For more information. Dummy Table 2-2 Task Types for OS/390 Task Type Job Description and Parameters Normal job. Parameters: • Mem Name • Mem Lib • Table Lib Parameters: • Mem Name • Mem Lib • Table Library Started Task 2. Click Add to add the job the Scheduling table. Parameters: • File • Path A normal job that submits the file specified in File Name to the operating system. BMC Software. If you define jobs with different Table Names.” 4. In the Existing Jobs field. 3. or delete a job processing definition on the specified Scheduling Table: • Select the job name and click Job Details. Microsoft Windows. You can continue to define jobs. if you want to add. Inc. Confidential and Proprietary Information 2-8 CONTROL-M/Desktop User Guide . The Job Editing form is displayed. and VAX/VMS Task Type Detached Description and Parameters The job does not run but does its preprocessing and post processing. modify. Click Next to continue. the Upload Table window will display the Table Name of the last defined job. Used to check job flow.

2. Inc. you will be prompted to confirm the Write operation and the existing table will be overwritten. This is the last table specified in “Step 5: Job Definition Window” on page 2-6. Click Write to write the Scheduling table to the CONTROL-M/EM database. 1. To see all Scheduling tables that can be written to the CONTROL-M/EM database. If this Scheduling table has the same name as an existing table. click the Draft Scheduling Tables button. For more information. Confidential and Proprietary Information CONTROL-M/Desktop Wizard 2-9 .Step 6: Write Table Write Table (Step 6) writes the Scheduling table (with the new job) to the CONTROL-M/EM database. see Chapter 9.” BMC Software. “Working with Scheduling Tables..

Step 7: Upload Table The Upload Table window (Step 7) copies the Scheduling table uploaded to the CONTROL-M/EM database in “Step 6: Write Table” on page 2-9. see Chapter 9. Inc. you will have to open the Draft Table Manager to write these tables to the CONTROL-M/EM database. Confidential and Proprietary Information 2-10 CONTROL-M/Desktop User Guide .If you have defined more than one Scheduling table and want to select which table to write or want to write more than one table at one time. Click Next to continue..” 3. For more information. BMC Software. “Working with Scheduling Tables. to the CONTROL-M database for that table.

2. see Chapter 9.1.” 4. BMC Software. including the following: • • • • Check an existing Scheduling table Modify an existing Scheduling table Upload more than one Scheduling table Delete an existing Scheduling table For more information. Confidential and Proprietary Information CONTROL-M/Desktop Wizard 2-11 . Click Next to continue. 3. If the table cannot be uploaded.. “Working with Scheduling Tables. Click Table Manager in the Scheduling Table Manager field if you want to perform various Scheduling table operations. Click Upload to copy the Scheduling table from the CONTROL-M/EM database to the CONTROL-M database on the specified computer. you can click Force Upload to upload the Scheduling table. Inc. Uploading a table with same name as an existing table will fail unless the table that you are uploading has been modified to have content different from that of the table already in the database.

the order will fail. 2. Click Order to submit the job. If the job data does not fall within existing scheduling parameters. Confidential and Proprietary Information 2-12 CONTROL-M/Desktop User Guide . For more information.Step 8: Order/Force Window The Order/Force window (Step 8) submits your job in the Scheduling table to CONTROL-M. Clicking Force will submit the job regardless of its scheduling criteria. BMC Software.. Inc. 1. see Chapter 9. “Working with Scheduling Tables. 3. If you want to check or modify existing tables.” Click Next to continue. click Table Manager in the Scheduling Table Manager field.

1.. If you click Close. To launch the CONTROL-M/EM GUI upon completion of the process. BMC Software. click the Launch CONTROL-M/EM GUI to view the production environment checkbox. The CONTROL-M CONTROL-M/Desktop Wizard closes and the CONTROL-M/EM GUI is displayed with the All Jobs default ViewPoint loaded. 2. the CONTROL-M CONTROL-M/Desktop Wizard closes without displaying the CONTROL-M/EM GUI. Inc.Step 9: Finish Window The Finish window (Step 9) completes the job processing definition. Click Finish. A summary is displayed in the Summary window. Confidential and Proprietary Information CONTROL-M/Desktop Wizard 2-13 . 3.

BMC Software. Inc. Confidential and Proprietary Information 2-14 CONTROL-M/Desktop User Guide ..

Confidential and Proprietary Information Communicating with CONTROL-M/EM 3-1 . This chapter explains the following topics: • • Logging In Managing Connections with CONTROL-M/EM Logging In The first time you initiate communication with CONTROL-M/Enterprise Manager (CONTROL-M/EM) during a CONTROL-M/Desktop session. the Communication Login window is displayed. you initiate communication with the CONTROL-M/EM GUI Server. BMC Software.. Inc. When you upload a Scheduling table. These Scheduling tables are uploaded to CONTROL-M/EM so that they can be scheduled to run.3 Communicating with CONTROL-M/EM 3 Job processing definitions and Group Scheduling table definitions are organized into logical groupings called Scheduling tables.

Inc.1. 2. However. The name of the default CONTROL-M/EM GUI Server is automatically displayed in the Server text box. Note The default GUI Server is the GUI Server that was specified during installation. using the Connect feature described in “Managing Connections with CONTROL-M/EM” on page 3-3. Confidential and Proprietary Information 3-2 CONTROL-M/Desktop User Guide . Communication is established Note Usually the connection with CONTROL-M/EM is broken when you close the Scheduling Table Manager window. you can establish a connection that remains open until you close it manually. Specify your Username and Password. Click Login.. BMC Software.

see “Manual Communication Management” on page 3-4.. Confidential and Proprietary Information Communicating with CONTROL-M/EM 3-3 . see “Connecting with Different Connection Properties” on page 3-6. the table is finished uploading). Manual Connection You manage your connection with the GUI server. Inc. To learn how to establish a connection with different properties. you are prompted for your username and password and the name of the GUI server to which you are connecting. Every time you perform an action requiring communication with the GUI server (such as uploading a Scheduling table). • BMC Software. • Automatic Connection CONTROL-M/Desktop manages your connection with the GUI server. When the action is complete (for example.Managing Connections with CONTROL-M/EM Each time you upload or download Scheduling tables or Calendars. you are informed that the requested action requires a connection. and no connection is active. the connection is terminated by CONTROL-M/Desktop. close the connection following the transfer. or initiate communication each time data is transferred. Connection Modes There are two connection modes that you can choose from. you use a communication channel with CONTROL-M/EM. You can maintain an open connection all the time. These settings remain in effect until you close CONTROL-M/Desktop or you establish a connection with different properties. it remains on until you log off of CONTROL-M/Desktop or terminate the connection manually. CONTROL-M/Desktop establishes a connection with the GUI server you specified when you logged on. Automatic and Manual. When you start CONTROL-M/Desktop. For more information. You can manually reestablish a terminated connection. Once a connection is established. If an action requiring communication is requested.

The General panel of the Options dialog box is displayed. This connection remains up until you either click or until you choose Communication => Disconnect from GUI Server. you can freely upload and download Scheduling tables and Calendars without having to reestablish communication. and communication is not currently established with the GUI server. BMC Software. Click OK. see “Options Dialog Box” on page 12-1. Confidential and Proprietary Information 3-4 CONTROL-M/Desktop User Guide . you are informed of the situation. Manual Communication Management A connection is established only after you specifically request it. For a more detailed description of the Options dialog box. As long as the connection remains.To choose a communication mode: 1. 3. Choose Tools => Options. If you request an action that requires a connection. Inc. This enables you to perform multiple actions that require communication with CONTROL-M/EM without having to reconnect to the GUI server for each action. Select the required connection mode.. Establish a connection and the retry the request. 2.

Click Login. your password. Figure 3-1 . BMC Software..The Connect and Disconnect functions are available only when the Manual Connection mode is chosen in the General panel of the Options dialog box. Inc. 3. Confidential and Proprietary Information Communicating with CONTROL-M/EM 3-5 . Note You can obtain information about the current connection status at any time using the Connection Properties feature described in “Displaying Connection Properties” on page 3-8. Enter your username. Communication Login Window 2. Click . and the name of the server to which you are connecting. The Communication Login window is displayed. To Connect to CONTROL-M/EM: 1. The Connect button toggles to . or choose Communication => Connect to GUI Server.

3. go to Step 3. you may wish to log on to a different GUI server or to log on as a different user. Are changing GUI Servers. It is not necessary to close and restart CONTROL-M/Desktop to do so. Inc. Enter your username and your password. If you: • Are changing to a GUI Server that uses the same Orbix Server as GUI Server that was previously specified. Click . or choose Communication => Connect with Different Properties. The Communication Login window is displayed. Instead. -or- . you can establish communication with properties different from those with which you initially logged on using Connect with Different Properties. If you: • • Are not changing GUI Servers. The connection is Choose Communication => Disconnect from GUI Server. go to Step 5. BMC Software. The Disconnect icon is replaced by . Enter a different GUI Server into the Server text box. Connecting with Different Connection Properties After you have started CONTROL-M/Desktop. 2.To Disconnect from CONTROL-M/EM: » Click broken. go to Step 5. To establish a new connection with different connection properties: 1. if required. The name of the default GUI Server is displayed in the Server text box. Confidential and Proprietary Information 3-6 CONTROL-M/Desktop User Guide ..

BMC Software. Inc. you must change the Orbix connection properties. Confidential and Proprietary Information Communicating with CONTROL-M/EM 3-7 ..• Are changing to a different GUI Server and the following two conditions apply. Go to Step 4. — This GUI Server uses a different Orbix installation than the GUI Server to which CONTROL-M/Desktop was previously connected. 4. — You want to log on to a different GUI Server. Change Orbix connection properties: A. Click Advanced. Enter the hostname of the Orbix Locator process host computer in the Host Name text box. The Communication Login dialog box is displayed with additional controls: B.

Click Apply Settings. D. BMC Software. Communication is established using the new properties. Enter the port number on the Orbix Locator process host computer in the Port Number text box. 5. 2. To Display Connection Properties: 1.C. Inc. Click OK to close the window. Displaying Connection Properties The Connection Properties window displays the name of the user who is currently connected and the name of the server to which that user is connected. The bottom portion of the window is hidden and Login becomes available.. Figure 3-2 Connection Properties Window . Click Login. Confidential and Proprietary Information 3-8 CONTROL-M/Desktop User Guide . Choose Communication => Connection Properties or click The Connection Properties window is displayed. Note Click Restore Default Settings to enter the Orbix hostname and port values that were specified when CONTROL-M/Desktop was installed.

.4 CONTROL-M/Desktop Window 4 CONTROL-M/Desktop runs under all supported Windows platforms using the standard GUI features of these environments. Tool Bar. Inc. This window is set to display the Application/Group hierarchy in the navigation tree and in the flow diagram. The CONTROL-M/Desktop window contains the same features common to other windows: Title Bar. When entering CONTROL-M/Desktop. BMC Software. The CONTROL-M/Desktop repository for storing and working on job processing definitions is called a Draft. Drafts can contain job processing definitions from either a single scheduling table or from multiple scheduling tables. Menu Bar. Status Bar and Display Area. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-1 . The CONTROL-M/Desktop window is used to display Draft data in various formats. an empty CONTROL-M/Desktop Draft window is displayed.

Confidential and Proprietary Information 4-2 CONTROL-M/Desktop User Guide .. A net overview of the flow diagram is displayed below the flow diagram. Inc. BMC Software. the highest level of items are displayed in navigation tree on the left side of the Draft window. The corresponding flow diagram is displayed in the upper right side of the Draft window.Figure 4-1 CONTROL-M/Desktop Draft Window When you open an existing Draft or read scheduling tables into a Draft.

listing all the groups in that application. the navigation tree expands to the next level of detail. When you click on one of the jobs in either the navigation tree or flow diagram. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-3 . the Job Editing form for that job is displayed.Figure 4-2 Draft Window When you double-click on an application name or icon (see below) or single click on the preceding the application in the left pane.. BMC Software. Inc. the navigation tree expands to list all the job processing definitions in that group. When you double-click on one of the groups. the job is highlighted on the flow diagram and that section of the diagram is highlighted in the net overview. When you double-click on the job.

. BMC Software. the Job Editing form is displayed in place of the flow diagram.Figure 4-3 Job Editing Form When you change the view to List/Job Editing (View => List/Job Editing Form). Inc. Confidential and Proprietary Information 4-4 CONTROL-M/Desktop User Guide .

Figure 4-4 Job Editing Form When you click on a group item in the navigation tree. Inc. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-5 . the Job Editing form is replaced with a list of the jobs in the group. BMC Software..

Figure 4-5 CONTROL-M/Desktop Draft Window To decrease the level of detail for an item in the navigation tree. Multiple windows can be open at one time. Each window contains two or three panes. each pane displays a different view of the data. Options for the Editing View of the Desktop Window Right-click on the CONTROL-M/Desktop window when in List/Job Editing mode to display the following pop-up menu: BMC Software. the CONTROL-M/Desktop window can be minimized and maximized. double-click on the item or click on the preceding the item name. Like all Windows applications. Inc.. Confidential and Proprietary Information 4-6 CONTROL-M/Desktop User Guide . Each pane can be sized by adjusting the frame around it.

• Group icon: displays the number of jobs in the group. For more information. Displays the icon and the name of the Job group. the name of the icon. Displays the icon.. and job description. Edit Job Options BMC Software. see “Options Dialog Box” on page 12-1. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-7 . selecting this item opens the Job Editing form. Displays large icons and a name for each icon. MemLib. • Job icon: displays the Owner. Inc. and relevant details. Opens the Options dialog box.Figure 4-6 Editing Mode Pop-up Menu Table 4-1 Editing Mode Pop-up Menu Menu Items Flowdiagram View Name Big Icon Partial Details Description Changes the window to display the flow diagram. When a job is selected in the display.

Figure 4-7 Multiple Windows in CONTROL-M/Desktop Note Only one Draft can be used (opened) at one time. Inc. Confidential and Proprietary Information 4-8 CONTROL-M/Desktop User Guide .. BMC Software. This means that all panes in all Draft windows display views of the same Draft.

New Delete Edit Copy Tag Creates a new Group Scheduling table Deletes the selected Group Scheduling table Opens the Group Editing form. Deletes the selected job. Inc. Saves the current Draft with a filename that you specify. CONTROL-M/Desktop Window 4-9 . Scheduling Group Submenu containing the options for managing Group Scheduling tables. Creates a copy of the selected Schedule tag.CONTROL-M/Desktop Menus All CONTROL-M/Desktop options can be chosen from the toolbar. Creates a copy of the selected job. Confidential and Proprietary Information Opens the Find a Job window. Closes the current Draft. Opens an existing Draft.. Saves the current Draft. Table 4-2 CONTROL-M/Desktop File Menu Options Options New Open Close Save Save As Table 4-3 Description Creates a new Draft. Use the Find a Job window to locate one or more jobs in the current Draft. The menu options are described in the following tables. Submenu containing the options for managing jobs. from which you can register the CONTROL-M installations in your network. New Job Copy Job Delete Job Creates a job using the current skeleton. Find/Select Jobs BMC Software. CONTROL-M/Desktop Edit Menu Options Option CONTROL-M definitions Job Description Opens the CONTROL-M definitions window.

Confidential and Proprietary Information 4-10 CONTROL-M/Desktop User Guide . reading. Exports Scheduling tables from the current Draft to the CONTROL-M/EM database.Table 4-3 CONTROL-M/Desktop Edit Menu Options Option Scheduling Tables Description Submenu containing the options for managing. Displays the Validity Checks Error Messages window. from which you can create. Note: You can export new Scheduling tables when the target CONTROL-M is active or disabled. Name Big Icon Partial Details Select All Messages Window BMC Software. and manage the contents of Scheduling tables in the CONTROL-M/EM database and the CONTROL-M/Server database. Changes the order of displayed information between Application => Group => Job and Data Center => Scheduling table => Job.. Scheduling Table Manager Opens the Scheduling Table Manager. and writing Scheduling tables. Arranges the nodes in the Draft window according to name. Imports Scheduling tables from the CONTROL-M/EM database to the current Draft. Selects all displayed nodes in the Draft window. Displays the List view in the Draft window. Displays large nodes. Displays information about each displayed node. CONTROL-M/Desktop View Menu Options Option Flow Diagram List/Job Editing Form Hierarchy Description Displays the flow diagram in the Draft window. Inc. delete. Read from CONTROL-M/EM Write to CONTROL-M/EM Calendars Manager Table 4-4 Opens the Calendar Manager window. from which you can trouble shoot problems with your job and table definitions.

Table 4-4 CONTROL-M/Desktop View Menu Options Option Table Actions Report Calendar Actions Report Toolbar Description Displays the Table Actions Report window. Displays the Options dialog box. Displays the Toolbars dialog box. Inc. from which you can create and modify job skeletons (templates). based on the same skeleton (template). The results are displayed in the Validity Checks Error Messages window. Import the forms once on each CONTROL-M/Desktop installation in your network from which you want to create jobs to run on the specific application. Using this panel. Use this option only if you have installed an application Control Module. which you can use to identify jobs according to their dependent relationships. from which you can select which toolbars to display. from which multiple jobs. from which modifications can be applied to multiple jobs. Imports a Job Editing form panel for the Job Editing form. Performs validity checks on the jobs in the current Draft. you can create jobs for supported external applications (such as SAP and Microsoft Windows 2000). Opens the Neighborhood dialog box.. Displays the Collection window. Displays the Skeleton Editor window. Displays the Calendar Actions Report window. This window can be hidden when it is waiting for pending information. are created. Displays the Mass Update dialog box. Mass Update Validity Checks Import Forms Skeleton Collection Neighborhood Options BMC Software. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-11 . CONTROL-M/Desktop Tools Menu Options \ Table 4-5 Option Mass Create Description Displays the Mass Create dialog box. This window can be hidden when it is waiting for pending information. from which you can modify the contents of the current collection.

Inc.. Establishes communication with the GUI Server. Confidential and Proprietary Information 4-12 CONTROL-M/Desktop User Guide . CONTROL-M/Desktop Help Menu Options Option Tutorial Description Displays the CONTROL-M/Enterprise Manager tutorial. Displays CONTROL-M/Desktop Help. this tutorial explains the steps necessary for getting started with CONTROL-M/Desktop. Ends communication with the GUI Server.Table 4-6 CONTROL-M/Desktop Communication Menu Options Option Connection Properties Connect to GUI Server Disconnect from GUI Server Connect with Different Properties Table 4-7 Description Displays the current connection properties. Help Index Wizard About CONTROL-M/Desktop BMC Software. Starts the CONTROL-M Job Definition Wizard. Enables you to change your connection properties and reconnect to a GUI Server. Displays identifying information about your version of CONTROL-M/Desktop.

directory. on the toolbar. To open an existing Draft: 1. “Filtering Data Using Collections..CONTROL-M/Desktop Window Options On the following pages some general tasks relevant to the CONTROL-M/Desktop window are described. Choose the drive. BMC Software. “Customization”. “Working with the Job Editing Form. Described in Chapter 5. Described in Chapter 8. “Working with the Group Editing Form. “Creating and Updating Multiple Jobs. Inc. Described in Chapter 7.” Mass Create or Mass Update Form. or open an existing Draft. In addition to these tasks. Described in Chapter 7. see Chapter 12.” Skeleton Form.” Collection Criteria Form.” Selecting a Draft When you first start CONTROL-M/Desktop.” Group Editing Form. Described in Chapter 6. “Creating and Updating Multiple Jobs. Choose File => Open or click Open 2. the Draft window contains an empty Draft. certain more specific actions can be performed using the following forms: • • • • • Job Editing Form. and Draft. You can either work in this Draft. For more information. 3. Click Open. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-13 . A default directory for Drafts can be specified using the Tools => Options => General => Directory option.

Connecting to CONTROL-M/EM Each time you upload or download Scheduling tables or Calendars. • To create a new Draft: » Choose File => New or click New Saving a Draft on the toolbar. see “Managing Connections with CONTROL-M/EM” on page 3-3. you use a communication channel to CONTROL-M/EM. Work can be saved at any stage of completion without validity checks. Connection properties are managed using the Connection Properties function and the Connect with Different Properties function. Choose File => Save or click . If changes have been made. Confidential and Proprietary Information 4-14 CONTROL-M/Desktop User Guide .Only one Draft can be open at a time. You can either keep this connection open all the time. a dialog box is displayed requesting the name and path for the Draft. BMC Software. when you open a Draft. 2. To save the current Draft: 1. The previous Draft will then be closed accordingly. If the current Draft has not been saved previously. Therefore. CONTROL-M/Desktop will automatically close the previously opened Draft (if it is still open): • If no changes have been made to the previous Draft. you will be prompted to save the changes. it will be closed automatically. For more information. Establish and end communication using the Connect and Disconnect functions. or have it open each time data is transferred and closed following the transfer.. Inc.

. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-15 . » Choose File => Exit. you will be prompted to save your work. » Choose Edit => Scheduling Tables => Write.Reading a Scheduling Table Drafts can contain job processing definitions from a single Scheduling table or from multiple Scheduling tables. Scheduling tables are Read directly from the CONTROL-M/EM database. or click To Write a Scheduling table to CONTROL-M/EM: . Inc. If necessary. or click Exiting CONTROL-M/Desktop To exit CONTROL-M/Desktop: . To Read a Scheduling table from CONTROL-M/EM: » Choose Edit => Scheduling Tables => Read. BMC Software.

The icons in the Application hierarchy are described in Table 4-9. • CONTROL-M/Desktop uses various icons next to each item name to indicate the level in the hierarchy. Each hierarchy is sorted according to parameters in each job processing definition: • CONTROL-M Hierarchy CONTROL-M hierarchy is sorted according to the CONTROL-M. These sort-orders are called hierarchies. Confidential and Proprietary Information 4-16 CONTROL-M/Desktop User Guide . Scheduling Table and Mem Name parameters. Icons in the CONTROL-M Hierarchy Table 4-8 Icon Description Indicates a CONTROL-M installation Indicates a Scheduling Table Indicates a Job Indicates a Job in a Group Scheduling table BMC Software.Working with the Navigation Tree A navigation tree of the current draft is displayed on the left side of the CONTROL-M/Desktop Draft window. Group and Mem Name parameters. The navigation tree is sorted either according to CONTROL-M installation or according to application.. Application Hierarchy Application hierarchy is sorted according to the Application. • • v The icons in the CONTROL-M hierarchy are described in Table 4-8. Inc.

. Inc. Choose View => Hierarchy => Application/Group/Job. To select the CONTROL-M hierarchy either: Click on the CONTROL-M Tree -or- button in the toolbar.Table 4-9 Icons in the Application Hierarchy Icon Description Indicates an Application Indicates a Group Indicates a Job Indicates a Job in a Group Scheduling table To select the Application hierarchy: Click on the Application Tree -or- button in the toolbar. Choose View => Hierarchy => CONTROL-M/Sched. Note Scheduling table library names are indicated with scheduling table names in the navigation tree only if there is more than one table with the same name in the relevant CONTROL-M installation. Table/Job. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-17 . BMC Software.

This greatly simplifies definition of applications.Other Options in the Navigation Tree The following options are discussed in detail in the following pages: • Sets of items in the navigation tree (for example.. Items in the navigation tree can be moved to other locations in the navigation tree. the navigation tree is displayed with only the highest level branches visible (i. and Group Scheduling tables can be deleted from a Draft. the next level of entries is displayed in the right pane of the window. You can expand (show more levels of detail) or collapse (show fewer levels of detail) the navigation tree as required. Jobs. If the selected item is a job. click the next to the branch you wish to expand (or double-click the item). see “Moving Jobs in the Navigation Tree” on page 4-19. If entry is selected. For more information. a job can be moved from one group to another. • To expand a branch in the navigation tree. You can click on an item in the navigation tree under List/Job Editing format (View => List/Job Editing Form). Scheduling tables. For more information. or from one scheduling table to another. see “Working in List Mode” on page 4-23.. This makes viewing selected items easier. Inc. groups and jobs. For more information. BMC Software. Confidential and Proprietary Information 4-18 CONTROL-M/Desktop User Guide . to view the contents of that item in the right-hand pane. applications or CONTROL-M installations). see “Displaying/Hiding Entries” on page 4-18. jobs in a group or scheduling table) can be alternately displayed or hidden. see “Deleting Jobs” on page 4-21.e. • • • Displaying/Hiding Entries Initially. The plus sign (+) Next to each item in the navigation tree indicates that one or more levels below the item are not currently displayed. For more information. the Job Editing form is opened in the right-hand pane.

BMC Software. click the minus sign next to the branch you wish to collapse (or double-click the item). The CONTROL-M and Scheduling Table parameters are automatically modified to reflect the new location of the job.• To collapse a branch in the navigation tree. CONTROL-M. You can change the values of these parameters using either the navigation tree or the Job Editing form: • If you change the location of a job in the navigation tree. drag a job from one scheduling table to another in the same or a different CONTROL-M. To move a job in the navigation tree: Use the mouse to drag the job from one location in the navigation tree and drop it in a different location: — With the Application hierarchy displayed.. Moving Jobs in the Navigation Tree The location of a job in the navigation tree corresponds directly to the values of certain parameters in the job processing definition (Application. Group. drag a job from one group to another. the corresponding values in the job processing definitions are automatically changed accordingly. and Scheduling Table). Confidential and Proprietary Information CONTROL-M/Desktop Window 4-19 . Inc. — With the CONTROL-M hierarchy displayed. Note that the destination group does not need to be in the same application. Parameters Application and Group are automatically modified to reflect the new location of the job.

Note • You cannot move jobs in a Group Scheduling table to another Group Scheduling table or to an ordinary Scheduling table. CONTROL-M and Scheduling Table are not regarded as modifiable parameters. Confidential and Proprietary Information 4-20 CONTROL-M/Desktop User Guide . the job moves to the appropriate location in the Application hierarchy. If you drag a job from one table to another. Moving a Job Using the Job Editing Form If you change the value of any of the relevant parameters in the Job Editing form. Inc.. the location of the job in the navigation tree is automatically updated: • When parameters Application or Group are modified. CONTROL-M/Desktop allows you to modify these attributes in the same manner as any other parameter.Figure 4-8 Moving Jobs between Scheduling Tables Note In CONTROL-M for OS/390. the library name is also updated. However. BMC Software. the job moves to the appropriate location in the CONTROL-M hierarchy. You cannot move jobs in an ordinary Scheduling table to a Group Scheduling table. When parameters CONTROL-M or Scheduling Table (or Library) are modified.

. or a Group Scheduling table and all its jobs. Press the Delete key on the keyboard or click the Delete Job button on the toolbar. Inc. BMC Software. you are actually deleting it from the Draft. You can also delete an ordinary scheduling table and all its jobs. It will therefore be automatically deleted from all other views in any other panes in which it appears. select the item to be deleted. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-21 . Confirm the deletion in the Confirmation window that is displayed.Deleting Jobs When you delete a job in the navigation tree. » To delete an item in the navigation tree.

When selected. or choose View => List/Job Editing Form. Confidential and Proprietary Information 4-22 CONTROL-M/Desktop User Guide . -orClick the Arrange all items in flow diagram button on the toolbar.List and Flow Diagram Modes The right side of the CONTROL-M/Desktop window can be displayed in either List mode or in flow diagram mode. To rearrange the flow diagram: Right-click anywhere in flow diagram (except on a job node). Inc. Arranging the Display After adding or modifying job dependencies. Switching Between Views To switch to List/Job Editing Form mode from the flow diagram mode: Right-click in the background of the flow diagram. and select Arrange All from the pop-up menu. the window is adjusted to display the items that are selected in the navigation tree.. Dependency line crossed as little as possible. the Arrange All option reformats the flow diagram according to the following rules: • • Dependencies are displayed from top to bottom (predecessor jobs appear above successor jobs). For each of these views. it may be necessary to rearrange the flow diagram to display a more direct representation of the job production flow. BMC Software. and select List/Edit Job View from the pop-up menu.

the groups in that application are displayed in List mode.. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-23 . BMC Software. To activate List mode. For example.Working in List Mode The List mode displays details (the next level of items) of the item currently selected in the Tree (the left pane of the CONTROL-M/Desktop window). Inc. Figure 4-9 List View Table 4-10 describes the nodes that can be displayed in the CONTROL-M/Desktop Draft window when in List mode. select View => List/Job Editing Form. if you select an application in the Tree.

Inc.) For example. Member library and Description parameters. (the navigation tree lists only the node names. jobs displayed in List mode. Member name. Only one node can be selected at a time in the navigation tree. Combining two views allows you to simultaneously see items at one level in the navigation tree and the contents of another item in List mode. Confidential and Proprietary Information 4-24 CONTROL-M/Desktop User Guide . Multiple items can be selected in List mode. you can delete only one job at a time in the navigation tree. • • BMC Software.Table 4-10 Display According to Node Selected in the Navigation Tree Icon Navigation Tree Node CONTROL-M Scheduling Table Displayed Item in List View List of scheduling tables in the CONTROL-M List of jobs in the scheduling table Application List of groups in the application Group List of jobs in the group Job Job Editing form for the job List mode provides the following advantages: • List mode provides additional information about the nodes displayed.. For example. are displayed with the values of the Owner. You can delete multiple jobs in List mode.

Click on the job to be deleted. the Job Editing form is displayed. Choose View => List/Job Editing Form.Editing Jobs in List View You can use the List mode for selecting jobs for editing. If you make any changes to the parameters. Deleting Jobs in List View You can delete one or more jobs in List mode. Click on the job in the navigation tree. The Job Editing form is displayed in the right pane. 2. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-25 . select Apply or Cancel at the top of the form before selecting the next job from the navigation tree. Press the Delete key. You can move between various job definitions without closing and opening the form for each job.” To open the Job Editing form from List mode: 1. You must close the Job Editing form using OK or Cancel at the bottom of the form. -orDouble-click on the job in the List mode. For more information. 2. “Working with the Job Editing Form. BMC Software. Inc. -orClick . The Job Editing form is displayed. To delete a job: 1. When you double-click a job in List mode. see Chapter 5.. in order to return to the original display.

-orClick -orRight-click one of the selected items and select Delete from the pop-up menu.-orRight-click the selected item and select Delete from the pop-up menu. Confidential and Proprietary Information 4-26 CONTROL-M/Desktop User Guide . click on the last job to be deleted. Confirm the deletion. 3. Inc. Hold down the Ctrl key and click the jobs.. Use one of the following methods for selecting the items: • Select the jobs by clicking on the first job to be delete and while depressing the Shift key. • • 2. Confirm the deletion. To delete multiple jobs: 1. Press the Delete key. 3. Click and drag a rectangle over the jobs. BMC Software. .

Inc. select View => Flowdiagram. Figure 4-10 flow diagram View Each entity in the flow diagram (application. or Group Scheduling table) is represented by a node. The job flow reflects job dependencies indicated by prerequisite In and Out conditions in job processing definitions.Flow Diagram Mode Flow diagram mode displays job production flow in a graphic format. » To display the flow diagram. job. scheduling table. The top part of the job node contains the Job Title. CONTROL-M. BMC Software. group. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-27 . The smallest entity is the job node..

Job dependencies can be created using this graphical representation. see “Flow Diagram Panel” on page 12-5. applications. Job dependencies are indicated by dependency lines from the Out Connector of the predecessor to the In Connector of the successor.The area inside the job node is called the Job Area. For more information. see “Creating/Modifying Conditions and Dependencies” on page 4-48. Note Elements of the flow diagram (for example. For more information. “Customization”). node color) can be modified in the Flowdiagram panel of the Options dialog box. Triangular symbols the job nodes: • • called Connectors appear at the top and bottom of The In Connector at the top represents the job’s IN conditions. You can expand it further to show all the jobs in a group or scheduling table. The Job Title and the two fields to be displayed in the Job Area can be customized using Tools => Options => Flowdiagram (see Chapter 12. The Out Connector at the bottom represents the job’s OUT conditions. Expanding/Collapsing Initially. and symbols next to each branch in BMC Software. You can Expand each entity displayed to show all the groups in an application or scheduling tables in a CONTROL-M. scheduling tables or CONTROL-M installations. Inc. This is similar to clicking on the the navigation tree. You can later Collapse each part of the diagram to show only the groups. Confidential and Proprietary Information 4-28 CONTROL-M/Desktop User Guide .. the flow diagram is displayed showing only the applications or CONTROL-M installations. Two fields from the job processing definition are displayed in the lower part of the Job Area. depending upon the hierarchy selected.

-orRight-click a node and select Collapse or Expand from the pop-up menu. • When you Expand a part of the flow diagram. Stepping In and Out of the flow diagram is not the same as Expanding and Collapsing. and select Collapse or Expand from the pop-up menu. the window returns to the previous display. Stepping In and Out You can focus the flow diagram on jobs in only selected applications. This option limits the flow diagram to only jobs in the selected entities. • BMC Software. groups. CONTROL-M installations or scheduling tables.To collapse/expand the display: Right-click a node. When you Step In to a part of a flow diagram. only the nodes in the selected entities are displayed. When you Step Out. Inc.. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-29 . -orDouble-click the node to toggle the Collapse/Expand function. To collapse or expand multiple nodes in the flow diagram: Hold down the Ctrl key and select the desired nodes. the groups and applications or scheduling tables and CONTROL-M installations are still displayed in the window.

Multiple entities can be selected for Stepping In. -orSelect the node for the entity and click . BMC Software.Figure 4-11 Sample Step In Display Note You can Step In and Step Out to or from any level of the flow diagram. Inc. Confidential and Proprietary Information 4-30 CONTROL-M/Desktop User Guide . To Step In to an entity in the flow diagram: Right-click the node for the entity and select Step In from the pop-up menu..

and select Step Out from the pop-up menu. Right-click anywhere in the background of the flow diagram. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-31 . Hold down the Ctrl key and click the desired entity nodes. and more easily create multiple job dependencies. Zooming in makes the nodes larger so that you can focus on a smaller area of the flow. • To decrease the size of the flow diagram: Use any of the following methods: • Click . Zooming In/Out By zooming in and out of the flow diagram. • Zooming out makes the nodes smaller so that you can view a larger portion of the job production flow.. 2. -orClick To Step Out from the display: . Right-click one of the selected entities and select Step In from the pop-up menu. you can change the size of the nodes in the flow diagram. -orClick anywhere in the background of the flow diagram. and then click . Repeat as needed. Inc.To Step In to multiple entities in the display: 1. BMC Software.

. To increase the size of the flow diagram: Use any of the following methods: • • Click . Confidential and Proprietary Information 4-32 CONTROL-M/Desktop User Guide . “Filtering Data Using Collections”) to view a specific part of the job production flow in a single window. • Right-click anywhere in the background of the flow diagram. BMC Software. Repeat as necessary. Inc. Repeat as needed. box on the Select the size in the Flowdiagram Zoom toolbar. box on the • Right-click anywhere in the background of the flow diagram.• Select the size in the Flowdiagram Zoom toolbar. and select Zoom Out from the pop-up menu. Tip Use the Zoom In/Out feature together with a Collection of jobs in the Draft (see Chapter 8. Repeat as needed. and select Zoom In from the pop-up menu.

Inc. In CONTROL-M/Desktop. job processing definitions are edited using the Job Editing form. -or• Right-click a job node in the flow diagram. Only one job can be edited at one time.” To open an existing Job Editing form in the flow diagram: • Double-click the job in the navigation tree or the job node in the flow diagram. You can modify or delete existing job nodes or create new definitions that are represented by nodes. see Chapter 5. The Job Editing form is displayed. You must close the Job Editing form using the OK or Cancel button at the bottom of the form. before you can return to the original display. The most common node is the job node. “Working with the Job Editing Form.. BMC Software. Each CONTROL-M/EM element is represented by a node that is displayed in the flow diagram. Each job node represents a job processing definition. For more information about this form.Working with Jobs in the Flow Diagram The flow diagram provides you with a graphical representation of the current Draft. This form can be opened in a number of different ways. and select Edit Job from the pop-up menu. Accessing the Job Editing Form You can view or modify job processing definitions from the flow diagram using the Job Editing form. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-33 .

Dragging does not select multiple nodes. dependencies are created when dragging between nodes. “Creating and Updating Multiple Jobs.To open a Job Editing form for a new job: Choose Edit => Job => New Job. For more information. For more information about creating dependencies. “Working with the Job Editing Form. see Chapter 5.You must close the Job Editing form using OK or Cancel before you can return to the original window. or click Note . see “Creating/Modifying Conditions and Dependencies” on page 4-48.” Mouse Pointer Drag Behavior Dragging the cursor across the flow diagram while holding down the left mouse button enables you to perform various actions on the nodes that are displayed: • • Create dependencies (prerequisite conditions) between nodes. Inc.” The Job Editing form is displayed on top of the flow diagram. The action that dragging performs is determined by whether CONTROL-M/Desktop is in Selection mode or Definition mode: • In Definition mode. Confidential and Proprietary Information 4-34 CONTROL-M/Desktop User Guide . changes are immediately applied to the Draft views in the CONTROL-M/Desktop window. The Job Editing form for the new job is displayed with default values from the current skeleton. Select multiple nodes. see Chapter 7. If you close the Job Editing form.. You can then perform single actions on all selected nodes. BMC Software. For more information about job skeletons.

Confidential and Proprietary Information CONTROL-M/Desktop Window 4-35 . To choose Selection mode: Click . creating dependencies (prerequisite conditions) by dragging between nodes is disabled. Note Definition mode is selected by default when CONTROL-M/Desktop is started. Inc. indicating that it is selected. However. For more information about selecting multiple nodes and performing action on them. This enables you to perform a single action that affects multiple nodes. To select a single node: Click on the required node. BMC Software.• In Selection mode. dragging the mouse enables you to select multiple nodes. To choose Definition mode: » Click . Selecting Nodes in the Flow Diagram You can select multiple nodes in the flow diagram.. see “Selecting Nodes in the Flow Diagram” on page 4-35. Node color will change.

Note This option does not select condition nodes. Choose View => Select All. Note Select All can select nodes of any type other than condition nodes. Select an option from the Action menu. To perform an action on all nodes in the flow diagram: This option selects those nodes currently displayed in the flow diagram. Select an option from the Action menu. Place the cursor in the flow diagram window.. 2. Release the mouse button to complete the select action. 2. 3. Hold down the left mouse button and drag the cursor over the required nodes. All nodes in the displayed in the flow diagram are selected. 1. Inc. or right-click one of the nodes. Click to enter selection mode. and select an option from the pop-up menu. Confidential and Proprietary Information 4-36 CONTROL-M/Desktop User Guide . Note Select All works in both Definition mode and Selection mode. A dotted rectangle is displayed as you drag the cursor. All nodes within the rectangle are selected. and select an option from the pop-up menu. this option does not select all nodes in the current ViewPoint.To perform an action on multiple nodes using selection mode: 1. BMC Software. or right-click one of the nodes.

Copying Jobs in the Flow Diagram You can copy a job processing definition from a source job and create a new. so that it can be differentiated from the source job. a scheduling table. Tip You can double-click the new job processing definition to modified it using the Job Editing form.. resources. Use one of the following methods to copy a job: • • Click . The Application and Group or CONTROL-M and Scheduling Table fields of the added jobs are set to reflect the correct location of the job in the flow diagram. or a Group Scheduling table in the flow diagram. The new job is created in the same group or table as the source job. Right-click the job node of the source job in the flow diagram. To add a job: » Right-click the appropriate group or table node. etc. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-37 . and select Copy from the pop-up menu. and select New job in this group/New job in this table from the pop-up menu. “Creating and Updating Multiple Jobs”).Adding Jobs in the Flow Diagram You can add new jobs to a group.). The new job is assigned a unique identification number. The new jobs will contain most of the default values in the current skeleton (see Chapter 7. and it is added in the appropriate place in the flow diagram. Inc. BMC Software. The new job is given the same name as the source job. identical job processing definition. and identical properties (conditions.

Press the Delete key. Select the jobs to be deleted by holding down the Ctrl key and clicking on each of the job nodes.. 3. the Copy Job process must be repeated or an identical job processing definition must be created with the Mass Create feature.• In the flow diagram. click . For more information about Mass Job Creation.” Deleting Jobs from the Flow Diagram To delete a job: 1. see Chapter 7. Confirm the deletion. 3. and choose Edit => Job => Copy. 2. click . Click on the job to be deleted. Press the Delete key. Confidential and Proprietary Information 4-38 CONTROL-M/Desktop User Guide . select the job node of the source job. or right-click the selected item and select Delete from the pop-up menu. To create more than one job. BMC Software. To delete multiple jobs: 1. or right-click the selected item and select Delete from the pop-up menu. “Creating and Updating Multiple Jobs. Note Copy Job creates only one job at a time. 2. Confirm the deletion. Inc.

To delete all jobs in an application, group, CONTROL-M, or scheduling table:

1. Click one the appropriate application, group, CONTROL-M or scheduling table node. 2. Press the Delete key, click , or right-click the selected item and select Delete from the pop-up menu. 3. Confirm the deletion. When an upper level node is deleted, all the lower level nodes (for example, groups, tables, or jobs) are deleted.

Find a Job Window
You can find nodes in the flow diagram using the Find a Job window. The Find a Job window is used to specify job processing definition parameters as criteria for finding and selecting nodes in the current displayed draft. Each node is highlighted in the flow diagram in the Draft window.
Note

The Find a Job feature does not work when Display Condition Nodes is selected in the Flowdiagram panel of the Options window. The Find a Job feature can be used to find any job in a Draft or when a Collection within a Draft is displayed. However, when a Collection is displayed, only jobs in the Collection are searched. Jobs that satisfy selection criteria that are in the Draft but are not part of the collection are ignored.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/Desktop Window

4-39

To open the Find a Job window:

1. Choose Edit => Find/Select Jobs.
Figure 4-12 Find a Job Dialog Box

The Find a Job window contains an empty table in which combinations of fields and values can be specified. These combinations act as selection criteria for defining which jobs are to be highlighted in the Draft window. The field values are compared against the parameters in job processing definitions (for example, Application, Group, Cyclic, etc.) to determine if the job should be selected. For a description of these parameters, see the CONTROL-M Job Parameter and Variable Reference Guide.

BMC Software, Inc., Confidential and Proprietary Information

4-40

CONTROL-M/Desktop User Guide

They must be entered exactly as they appear in the CONTROL-M Job Parameter and Variable Reference Guide. The values of the parameters are case-sensitive.
Note

The relationship between the fields in the Find a Job window is AND. The window columns are described in Table 4-11
Table 4-11 Find/Select a Job Window Field and Button Descriptions

Column
Field

Description
Field to be checked in the job processing definition. This field is a list box. All job processing parameters are displayed in the list. Value that determines whether or not the criteria are satisfied. Values are entered as case-sensitive strings. Note: Binary values (such as check boxes) are specified as TRUE (selected) and FALSE (cleared). These values are case-sensitive. Name of a Quantitative resource. Values are entered as case-sensitive strings. Name of a Control resource. Values are entered as case-sensitive strings. Name of an In Condition. Values are entered as case-sensitive strings. Note: A condition can be specified without specifying a value for Date. Name of an Out Condition. Values are entered as case-sensitive strings. Note: A condition can be specified without specifying a value for Date. A date reference (four characters long) associated with the condition. A value for this field can be specified only when a value was supplied for In Condition or Out Condition. Note: The Find a Job function does not support the **** date value. Closes the Find a Job window.

Value

Quantitative Resource Control Resource In Condition

Out Condition

Date

Close

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/Desktop Window

4-41

Table 4-11

Find/Select a Job Window Field and Button Descriptions

Column
Find Prev Find Next

Description
Displays the last job node that satisfies the criteria that was displayed. Displays the next node that satisfies the criteria

2. Specify fields and values as required.
Note

Only one value can be specified for each parameter. However, pattern-matching strings can be used to enhance search capabilities. A question mark (?) can be inserted in place of a single character. An asterisk (*) can be inserted in place of a string. 3. Click Find Next to display the first or next node that fits the criteria. 4. Click Find Prev to display the previous node. 5. Click Cancel to close the Find a Job window.

Identify Predecessor and Dependent Jobs
The Neighborhood option identifies jobs that are predecessors or dependents of a selected job or Group Scheduling table and highlights the nodes of those jobs in the flow diagram. The Neighborhood option is not available in any of the following instances: • • When condition nodes are displayed. When more than one node is selected in the flow diagram or navigation tree.

BMC Software, Inc., Confidential and Proprietary Information

4-42

CONTROL-M/Desktop User Guide

To identify applicable jobs with Neighborhood Step 1

Select a job or Group Scheduling table node in the flow diagram or the tree. Choose Tools => Neighborhood. The Neighborhood dialog box is displayed:

Step 2

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M/Desktop Window

4-43

Table 4-12

Neighborhood Dialog Box Elements

Element
Data Center Mem Name Scheduling Table Direction

Description
CONTROL-M installation in which the selected job was run. Entered automatically by CONTROL-M/EM. Mem Name of the selected job. Entered automatically by CONTROL-M/EM. Scheduling Table of the selected job. Entered automatically by CONTROL-M/EM. Indicates which types of nodes to select. Radial Direct Relationship s Identifies relevant job nodes branching in all directions. Identifies the predecessor and the dependent nodes that are directly above and below the selected node. The identified above and below is determined by the Radius parameter. Identifies the predecessor nodes of the selected job. The number of levels that are surveyed is determined by the Radius parameter. Identifies the nodes dependent on the selected job. The number of levels that are surveyed is determined by the Radius parameter.

Predecessor

Dependent

Radius

Number of nested levels that are selected branching out from the selected node. Valid values: 1-99999. Displays the number of nodes that are selected when Find is clicked. Identifies and selects applicable job nodes. Closes the Neighborhood dialog box.

Number of Nodes Found Find Close

Step 3

Select a value from the Direction list box to indicate the direction in which to extend the search for applicable nodes. Direction values are described in Table 4-12. I Specify a numerical value in the Radius text box.

Step 4

BMC Software, Inc., Confidential and Proprietary Information

4-44

CONTROL-M/Desktop User Guide

. The applicable job nodes in the flow diagram are selected. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-45 . Note The Neighborhood dialog box is displayed until you click Close. Inc. BMC Software.Step 5 Click Find.

and deleted in the flow diagram graphical environment. “Working with the Group Editing Form. Inc. To edit an existing Group Scheduling table: » Double-click the Group Scheduling table node or choose Scheduling Group=>Edit.” BMC Software. see Chapter 6.Group Scheduling Tables in the Flow Diagram Group Scheduling tables can be created. specified changes are immediately applied to the Draft views in the CONTROL-M/Desktop Draft window. If you close the Group Editing form. Creating Group Scheduling Tables You can create new Group Scheduling tables in the flow diagram. close the Group Editing form using OK or Cancel. For more information.. Processing parameters from the current skeleton are copied to the new Group Scheduling table (see “Skeletons” on page 1-13). or click Note . The Group Editing form for a new Group Scheduling table is displayed with the default values taken in the current skeleton (see “Skeletons” on page 1-13). modified. so you must define at least one Schedule Tag for a new Group Scheduling table. To create a new Group Scheduling table: Choose Edit => Scheduling Group => New. Confidential and Proprietary Information 4-46 CONTROL-M/Desktop User Guide . After making changes. The Group Editing form is displayed over the flow diagram. Skeletons do not contain Schedule Tag definitions.

. and select Delete from the pop-up menu. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-47 .Deleting Group Scheduling Tables Use one of the following methods to delete a Group Scheduling table: • Select the Group Scheduling table node. BMC Software. and click . • • Right-click the Group Scheduling table node. and choose Edit => Scheduling Group => Delete. Inc. Select the Group Scheduling table node.

CONTROL-M/Desktop creates the In/Out Connectors and Dependency line. Note • • Job dependencies can also be determined by conditions created using Do Condition statements. and deleted from within he flow diagram graphical environment. For more information. To create a job dependency: » Click on the predecessor job node and drag the mouse to the successor job node. These dependencies are determined by IN and OUT statements defined in job processing definitions.Managing Conditions in the Flow Diagram Prerequisite conditions (In conditions and Out conditions) can be created. see “Displaying Conditions Created by Do Statements” on page 4-50.. The following symbols are used to indicate job dependencies in the flow diagram: • Out Connectors at the bottom of predecessor job nodes or group nodes represent the OUT conditions. modified. BMC Software. Inc. Confidential and Proprietary Information 4-48 CONTROL-M/Desktop User Guide . These conditions are displayed using the same conventions as In and Out conditions. In Connectors at the top of the successor job nodes or group nodes represent the job’s IN conditions. and Group Scheduling tables. Creating/Modifying Conditions and Dependencies You can view and create job dependencies in the flow diagram. Dependency lines drawn from the Out Connectors to the In Connectors represent the dependencies between the various jobs and groups.

To display a predecessor job or successor job: 1.. Select Goto In Connector or Goto Out Connector from the pop-up menu. BMC Software.When you create a dependency. CONTROL-M/Desktop automatically adds the required IN conditions and OUT conditions to the job processing definitions. Right-click the connector line. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-49 . 2. Note Depending on the resolution (zoom value) of your display and the number of jobs in the flow diagram. This feature enables you to quickly jump to a predecessor or successor job. Note The name and format of new conditions conform to the value specified in the Condition Format field in the current Skeleton. certain predecessor or successor jobs may not be displayed near their related jobs or groups. Inc.

see Chapter 5.” BMC Software. For more information. For more information.” Displaying Conditions Created by Do Statements Display of conditions that are created using a Do Condition parameter is handled separately from conditions created using an Out statement.. Confidential and Proprietary Information 4-50 CONTROL-M/Desktop User Guide . To display job dependencies that rely on Do Condition statements. » Click and hold the left mouse button on the job’s Out Connector to display the job’s OUT conditions. 2. Figure 4-13 In Conditions Window To modify or delete job dependencies: 1. select the Display Do Conditions as links between jobs option in Tools => Options => Flowdiagram. Select the Conditions panel and edit the IN conditions or OUT conditions. see Chapter 12. “Working with the Job Editing Form. Double-click the job node to display the Job Editing form for the job. Inc. “Customization.To display a job’s prerequisite conditions: » Click and hold the left mouse button on the job’s In Connector to display the job’s IN conditions.

Confidential and Proprietary Information CONTROL-M/Desktop Window 4-51 . Right-click the dependency line of the condition that you want to delete. the appropriate In condition and Out condition can be removed from each connected job processing definition. Inc. The Delete Dependency dialog box is displayed: BMC Software. Click Delete Dependency.Delete Dependency You can delete conditions (dependencies) between jobs by deleting the job node lines that connect dependent jobs from the CONTROL-M/Desktop flow diagram. When a condition is deleted in the flow diagram.. The following popup is displayed: 2. To delete a dependency between jobs: 1.

BMC Software.Note The Delete Dependency dialog box is displayed by default. 3. Inc. Confidential and Proprietary Information 4-52 CONTROL-M/Desktop User Guide . Select the jobs from which the selected condition is to be deleted from the Job Name list.. 4. Select the name of the condition that you want to delete from the Condition list. The names of the jobs in which the selected condition is specified as an Out condition or an In condition are displayed. To change the behavior of the Delete Dependency feature. see page 4-53.

5.. Example: Multiple In conditions sharing the same Out condition Condition C1 is an Out Condition for Job_A and an In condition for jobs Job_B. Click the Flowdiagram tab to display the Flowdiagram panel: BMC Software. In this case. You must remove C1 only from Job_D. 2. you should not remove the C1 Out condition from Job_A. other jobs (Job_B and Job_C) will also be affected. Click OK. and Job_D. and the dependency line is deleted from the flow diagram. If the Out condition was not deleted. If you do this. Job_C. Choose Tools => Options to display the Options dialog box. Note After deleting a condition. You no longer want C1 to be an In condition for Job_D. Inc. a dependency line will still be displayed between the two nodes if the nodes are still linked by other conditions (which were not deleted). To modify Delete Dependency behavior: 1. the jobs for which it is an In condition will not run. the condition connector remains on the underside of the job node that supplied the Out condition: Note If you remove an Out condition from a job. The Delete Dependency dialog box closes. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-53 .

. The Out condition in the predecessor job is not affected. Displays the Delete Dependency dialog box. Inc.3. Select the required Delete Dependency action from among the three options in the Delete Dependency field: Option Delete only IN cond Description Deletes only the In condition. BMC Software. Click OK. Delete IN. when Delete Dependency is selected from a dependency line popup menu. Deletes both the In condition and the Out condition. Confidential and Proprietary Information 4-54 CONTROL-M/Desktop User Guide . OUT cond Ask what to delete 4. Default. when Delete Dependency is selected from a dependency line popup menu.

Condition nodes describe dependencies between jobs. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-55 . Figure 4-14 Condition Nodes Note The Expand function is not available when condition nodes are displayed. Display the flow diagram window. BMC Software. For example. a condition node is displayed between two Scheduling table nodes when one or more jobs in one Scheduling table are dependent on one or more jobs in the other Scheduling table. you can use only the Step In and Step Out functions to move up and down the node hierarchy. conditions appear as elliptical icons (condition nodes) linked to the various types of nodes in the flow diagram. Select Tools => Options.Condition Nodes Prerequisite conditions can be displayed as separate nodes in the flow diagram. In this case. Inc. When displayed. 2.. They are most useful when viewing a small number of jobs. To display Condition Nodes: 1.

Confidential and Proprietary Information 4-56 CONTROL-M/Desktop User Guide . BMC Software. If a dependency is created by dragging a connecting line from one job node to another while condition nodes are displayed. 5. 4. a new condition node is displayed automatically on the connecting line. Select the Display Condition nodes checkbox. the Expand-Item and the StepInto-Item options are not available. Click OK.. Select the Flowdiagram tab on the Options dialog box. Note When the Display Condition nodes check box is selected. Inc.3. Condition nodes can also be created using the drag and drop function.

If there are too many nodes in the current level to be displayed in the Net Overview. When you can click on a node in the Net Overview. Figure 4-15 Net Overview To select an area in the Net Overview: » Click and drag the rectangle in the Net Overview pane until the it include the job flow that you want to display in the flow diagram. The Net Overview can be scrolled to view other parts of the flow diagram. BMC Software. This is the Net Overview. is enclosed in a rectangle in the Net Overview. only part of the current level is displayed. the flow diagram is adjusted to view the selected part of the job flow..Net Overview The portion of the flow diagram contains a miniature version of the current flow diagram. Inc. The part of the flow diagram that is currently displayed above. Confidential and Proprietary Information CONTROL-M/Desktop Window 4-57 .

Confidential and Proprietary Information 4-58 CONTROL-M/Desktop User Guide .BMC Software.. Inc.

If modifications are made to the form in this format. If modifications are made to the form. BMC Software. it is displayed as a separate dialog box. you can move between job processing definitions by clicking on jobs in the tree without closing and opening the form for each job. Select Cancel to undo the changes.. the Job Editing form is displayed. the Job Editing form must be closed before any other processing can be performed. click Save to Draft on the bottom of the form. the editing of job processing definitions is performed using the Job Editing form. Confidential and Proprietary Information Working with the Job Editing Form 5-1 .5 Working with the Job Editing Form 5 In CONTROL-M/Desktop. When displayed in this format. There are two different formats of the Job Editing form: • Window Format When you choose View => List/Job Editing Form and click on the job in Tree view in the left pane. select Apply at the top of the form to save the changes before selecting the next job from the tree or changing views. • Dialog Box Format If the Job Editing form is opened by any of the other methods (listed below). Inc. When using this format.

see Chapter 12. If you want CONTROL-M/Desktop to perform validity checks each time you select the Apply or Save to Draft button on the Job Editing form. choose Tools => Options and select the Always check the validity of jobs check box on the General panel. “Customization. Right-click on the job node in Flow Diagram view. Double-click on the job in List view. and select Edit Job from the pop-up menu.To open a Job Editing form for an existing job: Use any of the following methods to open the Job Editing form: • Double-click on the job name or icon in Tree view under Flow Diagram format (View => Flowdiagram).” BMC Software. Confidential and Proprietary Information 5-2 CONTROL-M/Desktop User Guide . For more information. Inc. Double-click on the job node in Flow Diagram view.. • • • To open a Job Editing form for a new job: Choose Edit => Job => New Job from the menu bar or click Note .

A detailed description of each parameter can be found in the CONTROL-M Job Parameter and Variable Reference Guide and in the CONTROL-M for OS/390 User Manual. Each panel is used to define a certain type of parameters.Job Editing Form Layout The Job Editing form contains a series panels.. BMC Software. Inc. Table 5-1 describes the panels of the Job Editing form. Do not include apostrophes in any values entered in the Job Editing form. Note Apostrophes are not supported in the Job Editing form. Figure 5-1 Job Editing Form Note The parameters that are available in the Job Editing form may vary depending on the CONTROL-M platform for which the job is being defined. Confidential and Proprietary Information Working with the Job Editing Form 5-3 .

BMC Software. Prerequisite conditions which must be satisfied before job submission. Inc. Conditional post-processing instructions. Parameters related to the execution of the job and processes that accompany the job's execution.. AutoEdit variables to be set when the job is submitted. Confidential and Proprietary Information 5-4 CONTROL-M/Desktop User Guide . Note Additional panels may be displayed in the Job Editing form for jobs whose skeleton indicates a specific application type (such as SAP). and conditions to be added/deleted when the job is successfully completed. When and/or how often the job should be scheduled for submission. “Shout When” and Sysout-handling post-processing instructions. Quantitative and Control resources required for job submission. Schedule tags to be applied to the job (relevant only for jobs in Group Scheduling tables).Table 5-1 Panels of the Job Editing Form Panel Name General Scheduling Execution Conditions Description What the job does and where it’s script is located.) Resources Set Steps PostProc Tags Selection Each of these panels is described below in detail.

you can no longer redo the undone actions.Undo and Redo in the Job Editing Form During the job editing process. Inc. and the number of undo levels can be configured manually (the default is 100).. These functions are located in the General panel of the Options dialog box. actions in the Job Editing form can be undone (using Ctrl-z) or redone (using Ctrl-y). The General panel is displayed by default. Tip The Undo/Redo feature can be toggled on and off. Confidential and Proprietary Information Working with the Job Editing Form 5-5 . To access the Options: Choose Tools => Options. BMC Software. If a number of actions have been undone and a new action is performed.

Inc. The undo and redo features automatically move among panels in the Job Editing form. Confidential and Proprietary Information 5-6 CONTROL-M/Desktop User Guide . BMC Software.General Panel Note Undo and redo are not confined to the panel of the Job Editing form that is currently displayed.Figure 5-2 Options Dialog Box ..

(described below). Confidential and Proprietary Information Working with the Job Editing Form 5-7 . Table 5-2 describes the parameters in the General panel of the Job Editing form. The General Panel for application-specific jobs (see page 5-12). Inc. Figure 5-3 General Panel of the Job Editing Form BMC Software..General Panel The General panel indicates what the job does and where it is located. There are three possible versions of the General Panel: • • • The regular General Panel. The General Panel for OS/390 jobs (see page 5-10).

Confidential and Proprietary Information 5-8 CONTROL-M/Desktop User Guide . Together with parameter CONTROL-M. (Text) Original author of the job. Inc. this determines the position of the job in the CONTROL-M/Scheduling Table hierarchy. and Command. (Text) Note: This parameter is called Memlib when specified in utilities of CONTROL-M/EM or CONTROL-M. (Text) Name of the file that contains the job Script. such as SAP or Oracle Applications. Detached job in VMS The job does not run but does its preprocessing and post processing. It is used to check job flow. This option is displayed under Task Type only on the Group Editing form.. (Text) Type of the job (task) to be performed by CONTROL-M. A Group Scheduling table. Path Full path for the file that contains the job script.Table 5-2 General Panel . (Text) BMC Software. This parameter is used by the CONTROL-M security mechanism. Job External Group Table Name of the Scheduling table to which the job belongs. (Text) Owner (user ID) of the job. Valid values are: Job. A job that runs on an external application. A normal job that submits the file specified in File Name to the operating system. (Text) Note: This parameter is called Memname when specified in utilities of CONTROL-M/EM or CONTROL-M. Over Lib Owner Author Task Type Name of the library/directory to use instead of the library/directory specified in the Path field. (List) Command Detached Dummy The job runs the command in the Command parameter.Parameters (Part 1 of 2) Parameter Job Name File Name Description Name of the job. Detached Job.

Table 5-2 General Panel . Together with parameter Group. Inc. Text of the command line to be submitted for the job when the Task Type parameter is Command. Together with parameter Scheduling Table Name. this determines the position of the job in the CONTROL-M/ Scheduling Table hierarchy. (Text) Description of the job. (Text) Name of the CONTROL-M to which the job belongs. (Text) Name of a library/directory containing the documentation file.Parameters (Part 2 of 2) Parameter Application Description Name of the application to which the job’s group belongs.. (Text) Name of the group to which the job belongs. (Text) Name of the file/member in which the documentation resides. This can be viewed using the Documentation option from the Job menu. (Text) Indicates the time zone used to calculate when the job should run. this determines the position of the job in the Application/Group hierarchy. Confidential and Proprietary Information Working with the Job Editing Form 5-9 . (Text) Group CONTROL-M Doc Mem Doc Lib Time Zone Command Description BMC Software. this determines the position of the job in the Application/Group hierarchy. Together with parameter Application.

. (Text) Owner BMC Software. (Text) Name of an alternate JCL library. This parameter is used by the CONTROL-M security mechanism. CONTROL-M searches for the file specified in parameter Mem Name in the Over Lib library before searching the Mem Lib library. Confidential and Proprietary Information 5-10 CONTROL-M/Desktop User Guide . Figure 5-4 General Panel (OS/390) Table 5-3 General Panel Parameter Descriptions (Part 1 of 2) Parameter Mem Name Mem Lib Over Lib Description Name of the member that contains the job JCL. (Text) Name of the library that contains the job JCL member. (Text) Owner (user ID) of the job.General Panel (OS/390) The General panel indicates what the job does and where it is located. Inc.

(Text) Name of the library that contains the scheduling table. this determines the position of the job in the CONTROL-M/ Scheduling Table hierarchy. Together with parameter Group. (Text) Short job description that appears in the Job List screen. Together with parameter Scheduling Table Name. Valid task types are: Batch Job and Started Task. this determines the position of the job in the CONTROL-M/Scheduling Table hierarchy.Table 5-3 General Panel Parameter Descriptions (Part 2 of 2) Parameter Task Type Description Type of the job (task) to be performed by CONTROL-M. and Emergency check boxes in the Execution panel in order to determine the desired tasktype. see “Execution Panel” on page 5-21. (Text) Name of the application to which the job’s group belongs. (Text) Indicates the global time zone used to calculate when the job should run. Inc. Name of a file in which job documentation resides. For more information. this determines the position of the job in the Application/Group hierarchy. (Text) Scheduling Table Name Scheduling Table Lib Application Group CONTROL-M Time Zone Doc Mem Doc Lib Description BMC Software. see Chapter 3 of the CONTROL-M for OS/390 User Manual. For more information about valid Task types. Name of the table that contains the CONTROL-M job processing definition. (Text) Name of a library/directory containing the documentation file. Together with parameter Application. (Text) Name of the group to which the job belongs. Confidential and Proprietary Information Working with the Job Editing Form 5-11 . Note: The value specified in this field is combined with the Cyclic. this determines the position of the job in the Application/Group hierarchy.. Together with parameter CONTROL-M. (Text) Name of the CONTROL-M to which the job belongs.

1.01. Most parameters in the application-specific General panel are the same as those described in “General Panel” on page 5-7. BMC Software. Note Before you can create a job for a specific application. you must configure CONTROL-M to support specific application jobs. Inc. For information on configuring CONTROL-M. Confidential and Proprietary Information 5-12 CONTROL-M/Desktop User Guide . CONTROL-M/Desktop can be used to define jobs for specific applications (for example. The application type is specified in the Application Type field of the Skeleton Editor form (described on page 7-4). Oracle Applications or SAP)..General Panel for Application-Specific Jobs As of version 6. see the Administrator Guide for the CONTROL-M/Control Module for the relevant application.

Confidential and Proprietary Information Working with the Job Editing Form 5-13 . Data can be specified for only one of these sections for each job processing definition. This section contains only the Dates parameter. Inc. Figure 5-5 Scheduling Panel of the Job Editing Form Three sections of this panel are controlled by option buttons. Table 5-4 Conditional Sections of the Scheduling Panel Field Month Days/Week Days Dates PDS Minimum Description Parameters for days-of-the-month and days-of-the-week scheduling. These panel sections are described in Table 5-4.. This section contains only the PDS and Minimum parameters [OS/390 only]. BMC Software.Scheduling Panel The Scheduling panel indicates when and how often a job should be scheduled for submission.

2. see Chapter 10. or specify a new calendar name. using the numeric codes according to the site standard. Name of a user-defined calendar for use with the Month Days parameter to indicate a set of working days. Table 5-5 Scheduling Panel Field Descriptions (Part 1 of 3) Field Month Days Description A calendar and text box used to indicate the days of each month on which the job should be scheduled.. Specify the desired days. Logical connector establishing the relationship between Month Day values and Week Day values. Weekday Check boxes Text box Each day (Sunday through Saturday) is indicated by a separate check box. BMC Software. and a text box. More detailed information for certain parameters is provided in “Month Days: A detailed explanation” on page 5-16 and “Confcal: A detailed explanation” on page 5-18. Values can be specified using the check boxes or the text box. (Text) Month Days Calendar and / or Week Days Example 1. 6=Saturday). For a more detailed description of this parameter. Confidential and Proprietary Information 5-14 CONTROL-M/Desktop User Guide . Note: Regardless of which method is used. For more information.The fields of the Scheduling panel are described in Table 5-5.” In various CONTROL-M and CONTROL-M/EM utilities.5 would schedule the job on Monday through Friday (assuming the site standard is 0=Sunday. Inc.4. Specify the name of an existing calendar. the specified values are displayed both in the text box and the check boxes above it.. 1=Monday. . see “Month Days: A detailed explanation” on page 5-16. “Working with Calendars. Day(s) of the week on which to schedule the job. This parameter consists of a series of check boxes for the days of the week (Sunday through Saturday). Specified codes should be separated by comma.3.. and then define it at a later time. this parameter is also known as DCAL and DAYCAL.

Select from the current list. Dates are inserted into the list separately. Additional shifting may or may not be performed.Table 5-5 Scheduling Panel Field Descriptions (Part 2 of 3) Field Weekdays Calendar Description Name of a user-defined. See “Confcal: A detailed explanation” on page 5-18 for a detailed explanation of Confcal and the Shift functions. If more dates are required. This function is also called Extended Shift. [OS/390 only] Dates on which to order the job. • Next Day. • Prev Day. or specify a different name (this will add the specified name to the list). • No Confcal. Months in which to order the job. Confidential and Proprietary Information Working with the Job Editing Form 5-15 . Inc. Shift to the previous working date. week-based calendar (WCAL calendar) used together with parameter Week Days to specify a set of working days. followed by the Enter key. A maximum of twelve dates can be specified. Indicates whether the job should be scheduled for possible execution after its original scheduled date has passed.. Shift to the next working date. depending on the value indicated in the Shift Num box. or specify a different name (this will add the name of the new calendar to the list). Values from -62 to 62 can be entered. Do not shift the job to a different date. Dates Retro BMC Software. The job is not scheduled. Months Confcal shift Shift Num The number of working days that a job can be shifted. Select from the current list. This parameter consists of the following subparameters: name Name of the calendar. use a calendar. Calendar used to confirm job scheduling dates. Valid values are 4-character dates. in mmdd or ddmm format (depending on the site standard). Tentatively schedule the job for the current day (even if not a working day). (List) When to schedule the job if the date is not confirmed. (Option) Valid values are: • Ignore Job.

[For OS/390 jobs and Group Scheduling tables. only] Month Days: A detailed explanation Month days are specified using either a graphic calendar. A narrow row of buttons appears above and to the left of the calendar.. This parameter corresponds to the CONTROL-M DAYS parameter. all dates directly below (that is. If you click on a button to the left of the calendar. [For OS/390 jobs and Group Scheduling tables. The fields for the Month Days parameter are described below: Calendar Each box (1. • BMC Software. Selected values are displayed in both fields regardless of which field was used to enter the specifications. deselects that date. only] Indicates the end of a period of time during which the job or Group Scheduling table can be ordered. or a text box.. Inc.2.31) in the calendar can be toggled on and off: • • Click a date once to select it for scheduling. Click on an already selected date. • If you click on a button above the calendar.Table 5-5 Scheduling Panel Field Descriptions (Part 3 of 3) Field Active from Date Active To Date Description Indicates the start of a period of time during which the job or Group Scheduling table can be ordered. . all days in the week to the right of the button become scheduling dates.. Confidential and Proprietary Information 5-16 CONTROL-M/Desktop User Guide . that day of the week) become scheduling dates.

Dates must be separated by commas.. Note As mentioned earlier. see Days parameter in the CONTROL-M Job Parameter and Variable Reference Guide. Example Click on date box 6 and then click on the +n button. then click the appropriate usage button. These buttons can be used to indicate additional scheduling information for jobs that are scheduled for a specific date. This symbol indicates that the job will be scheduled on the 6th of the month. Note To deselect (unschedule) all dates in a column or row of the calendar. click the button for that row or column a second time.• If you click on the button in the corner (first row and first column). A + symbol appears in the calendar box for the 6th of the month. -. Working with the Job Editing Form 5-17 • BMC Software. +.g. -n) is provided to the right of the calendar. For an explanation of the various usage symbols. select the appropriate date and then click the usage button. >) must be specified before the relevant dates.g. in addition to any scheduling dates in the DCAL calendar. Text Line Dates can be specified in the text box below the calendar: • Usage symbols (e. all dates defined using the calendar appear in the Text line below the calendar. +n. The selected usage symbol will appear in the selected date box of the calendar. To remove a usage symbol. Inc.. Confidential and Proprietary Information . all dates become scheduling dates.. A column of usage buttons (e. Click a calendar date.

and this field has no effect on job scheduling. all dates defined using the Text line will appear in the chart above the line. the job is tentatively scheduled on that day. or it may be cancelled. BMC Software. Confidential and Proprietary Information 5-18 CONTROL-M/Desktop User Guide . the Shift parameter is checked. on the original scheduling day. Confcal: A detailed explanation The Confcal field of the Schedule panel specifies a valid calendar name of 1-8 characters.) Actual scheduling of the job is then determined by the values specified for the Shift and Shift Num parameters. If the day is not a working day in the Confcal calendar.. (This day is referred to below as the original scheduling date.As mentioned earlier. Inc. Note • If no Confcal calendar is specified. Jobs to be scheduled on a given day are checked against the Confcal calendar: • If the day is a working day in the Confcal calendar. a later day. the job may be scheduled on an earlier day. Depending on the Shift value. no value can be specified for subparameter Shift. This calendar is used for: • • Validating scheduling dates Determining the scheduled work day.

. Valid values for the Shift parameters are described in Table 5-6. Additional shifting may or may not be performed. Table 5-6 Shift Values Value Ignore Job Next day Description No shifting occurs. In the CONTROL-M for OS/390 documentation. Optional. Shift Num is referred to as “extended shift”. Valid Values for the Shift Num parameter are described in Table 5-7. Default. Prev Day No Confcal Shift Num shifts scheduling of the job forward or backward the specified number of working days (as defined in the Confcal calendar). Confidential and Proprietary Information Working with the Job Editing Form 5-19 . Note Shift Num is available on the Job Editing Form only when an OS/390 CONTROL-M platform is selected. depending on the Shiftnum value (described below). Job scheduling is shifted to the next working day in the Confcal calendar. Shift indicates how to shift scheduling of the job if the original scheduling day of the job is not a working day in the Confcal calendar. depending on the Shiftnum value (described below). BMC Software. Job scheduling is shifted to the previous working day in the Confcal calendar. The job is not scheduled. Inc. Additional shifting may or may not be performed. Additional shifting may or may not be performed.Shift and Shift Num The Shift and Shift Num fields determine when and if a job should be scheduled. depending on the Shiftnum value (described below). Tentatively schedule the job for the current day (even if not a working day).

occurs. If the original scheduling day of the job is not a working day in the CONFCAL calendar. The interaction between the Shift value and the Shift Num value is as follows: • If the original scheduling day of the job is a working day in the CONFCAL calendar. Shift job scheduling backward to the previous nth working day. Note If the result of shifting by the number of days specified in Shift Num is a day which is not allowed (i. the Shift value is ignored and the Shift Num value determines when the job is scheduled. If the original scheduling day is not a working day. the job is not scheduled (regardless of whether or not a Shift Num value is specified).e. If the original scheduling day is a working day. Note • If the original scheduling day is not a working day and the x value is blank. –n was specified for that day in the DAYS parameter of the job processing definition). no shifting occurs.. no shifting. BMC Software. job scheduling is shifted according to the Shift value and then shifted again according to the Shift Num value (if specified) to determine when the job is scheduled. the job is shifted again to the next allowed working day (for a forward shift) or to the previous allowed working day (for a backward shift). beyond that indicated by the x value. +nn -nn Shift job scheduling forward to next nth working day. Inc.Table 5-7 Shift Num Values Value Blank Description Do not reshift job scheduling.. Confidential and Proprietary Information 5-20 CONTROL-M/Desktop User Guide . Default.

Confidential and Proprietary Information Working with the Job Editing Form 5-21 . Figure 5-6 Execution Panel Fields BMC Software. Inc.Execution Panel The Execution panel of the Job Editing form is used to define parameters that are related to the execution of a job and processes that accompany the job’s execution..

but generate the messages that would be required for GDG adjustment during restart. Inc. the job is executed. Note: This field is relevant only for OS/390 jobs. • Y – (Yes) – Perform dataset cleanup before the original job run.Table 5-8 Execution Panel Field Descriptions (Part 1 of 3) Parameter Prevent-NCT2 Description Indicates if NOT CATLGD 2 errors should be prevented by CONTROL-R (if installed) during started executions of a job. see “General Panel (OS/390)” on page 5-10. if it is not a restart. see “General Panel (OS/390)” on page 5-10. For more information. This value is not valid for started tasks. If selected.. (Text) Confirm Priority Critical Cyclic Emergency Rerun Interval BMC Software. Resources for a critical job are reserved exclusively for that job. If selected. Note for OS/390: The value specified in this field is combined with the Emergency check box. • F – (Flush) – Halt processing of the job if any dataset cleanup error is detected (even if OS/390 would not have stopped processing the job). Confidential and Proprietary Information 5-22 CONTROL-M/Desktop User Guide . When all necessary resources are available. The value specified in this field is combined with the Cyclic check box. indicates that the current job is cyclic. indicates that the job will not be run until the administrator confirms that the should be submitted. Default setting is 0. and the Tasktype value specified in the General panel in order to determine the desired tasktype. Indicates that a job will be rerun at an interval specified by the Interval and Max Rerun parameters. Amount of time (minutes) to wait between reruns. CONTROL-M job priority. • L – (List) – Do not perform dataset cleanup before the original job run. For more information. Note: this parameter is not relevant for OS/390 jobs. [OS/390 only] Valid values: • N – (No) – Do not perform dataset cleanup before the original job run. or between cycles of a cyclic job. Checking the checkbox a critical-path job in CONTROL-M. and the Tasktype value specified in the General panel in order to determine the desired tasktype.

this parameter must contain the host name of the CONTROL-M/Agent that will trigger the specified application.Table 5-8 Execution Panel Field Descriptions (Part 2 of 3) Parameter Description Units Specifies a unit of time for the numerical value indicated by the Interval parameter. Valid values: • Minutes (1-64800) • Hours(1-1080) • Days(1-45) Determines whether the interval until the subsequent rerun of the job is calculated from the beginning or the end of the current run of the job. Note: Not relevant for OS/390 jobs. Name of a CONTROL-D Report Decollating Mission category. and each such job has a unique Order ID. If specified. For application-specific jobs. From Maximum Member Max Wait Category Name of member to be submitted in the case of a rerun.. Inc. Time Node ID/Group Host name of the Agent platform on which the job is running. From Until Earliest submission time. the Report Decollating Mission is scheduled whenever the job is scheduled under CONTROL-M. Valid values are Start and End. All available Agents in the Node Group run an identical job. BMC Software. Note: Not relevant for OS/390 jobs. Confidential and Proprietary Information Working with the Job Editing Form 5-23 . Note: This field is relevant only for OS/390 jobs. Time limits for job submission. Note: The values for both time fields must be specified in hh:mm format. Maximum number od reruns of the job. Latest submission time. Multi Agent Specifies that job submission details be broadcast to all Agents within a defined Node Group. Maximum number of days that the job can wait to be executed after its original scheduling date has passed.

Confidential and Proprietary Information 5-24 CONTROL-M/Desktop User Guide . [OS/390 only] Request NJE Node BMC Software. [OS/390 only] Specifies the node in the JES network on which the job is to execute. [OS/390 only] Indicates the identity of the system in which the job must be initiated and executed (in JES2). Inc.. [OS/390 only] Indicates the JES2 workload management scheduling environment that is to be associated with the job. Indicates the identity of the processor on which the job must execute (in JES3).Table 5-8 Execution Panel Field Descriptions (Part 3 of 3) Parameter Due Out Scheduling Environment System Affinity Description Time by which the job should finish executing.

Inc. When you select a condition in the list. and a text box. In conditions are defined in the left side of this panel. The text box is used for editing existing conditions or defining new conditions. its contents are displayed in the Text line. click the check button next to the Text box to save the changes or to add the condition to the list. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. Confidential and Proprietary Information Working with the Job Editing Form 5-25 . Figure 5-7 Conditions Panel of the Job Editing Form Each half of the conditions panel consists of a list of already-defined conditions. Note Even after a condition has been added or changed.. see “Undo and Redo in the Job Editing Form” on page 5-5.Conditions Panel Conditions panel is used to define prerequisite In and Out conditions. After editing or creating a condition. and Out conditions are defined in the right side of this panel. For more information. BMC Software.

Table 5-10 In Condition Fields Field Name Date Description Name of the prerequisite condition.Table 5-9 describes the buttons that are available for each section of the Conditions panel. Any scheduling date. Defining IN Conditions Table 5-10 describes the fields used to define In conditions for a job. (Option buttons) Parentheses Box. The value for this field can be either a valid 4-character date reference in mmdd or ddmm format (depending on the site standard) or one of the following keywords: ODAT PREV NEXT STAT Original scheduling date of the job. Previous scheduling date of the job. (Text) Date reference for the condition. BMC Software. Note: This value is valid only for CONTROL-M/Server version 6. Used to indicate And/Or relationships. Next scheduling date of the job. and for CONTROL-M for OS/390. Delete the selected condition.. The condition is not date-dependent. Confidential and Proprietary Information 5-26 CONTROL-M/Desktop User Guide . Copy data. Paste data.0. Table 5-9 Conditions Panel – Buttons Button Description Enter a new condition. Note: This field is relevant only for OS/390 jobs. Inc. **** or $$$$ And/Or Logical relationship between multiple conditions.01 and above. and Change the order of the list.

Defining OUT Conditions Table 5-11 describes the fields used for defining OUT conditions. **** or $$$$ +/- Indicates whether to add (+) or delete (–) the condition. Previous scheduling date of the job.0. The value for this field can be either a valid 4-character date reference in mmdd or ddmm format (depending on the site standard) or one of the following keywords: ODAT PREV NEXT STAT Original scheduling date of the job. The condition is not date-dependent.01 and above. (Option buttons) BMC Software. Confidential and Proprietary Information Working with the Job Editing Form 5-27 . Next scheduling date of the job. Any scheduling date.. (Text) Date reference for the condition. Note: This value is valid only for CONTROL-M/Server version 6. Inc. and for CONTROL-M for OS/390. Table 5-11 Out Condition Fields Field Name Date Description Name of the prerequisite condition.

When you select a resource in the list. The text box is used for editing existing resources or defining new resources. and a text box. click the check button next to the Text box to save the changes or to add the resource to the list. Control resources are defined in the right side. its contents are displayed in the Text line. Quantitative resources are defined in the left side of this panel. Figure 5-8 Resources Panel of the Job Editing Form Each half of the resources panel consists of a list of already-defined resources. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. see “Undo and Redo in the Job Editing Form” on page 5-5.Resources Panel The Resources panel is used to define Quantitative and Control resources. Confidential and Proprietary Information 5-28 CONTROL-M/Desktop User Guide . BMC Software. Note Even after data has been added or changed. Inc. For more information.. After editing or creating a resource.

Delete the selected resource. and Change the order of the list. Copy data. Confidential and Proprietary Information Working with the Job Editing Form 5-29 . (Option buttons) Defining Quantitative Resources for a Job The following fields must be specified for each Quantitative resource: Name Quantity Name of the resource required by the job. (Text) Type of control that the job must have over the resource. Inc.Table 5-12 describes the buttons that are available for each section of the Resources panel. Quantity of the resource required by the job. Paste data. Table 5-12 Resources Panel – Function Buttons Button Description Enter a new resource. Defining Control Resources for a Job The following fields must be specified for each Control resource: Name Shared/Exclusive Name of the resource required by the job. BMC Software..

Figure 5-9 Set Panel of the Job Editing Form AutoEdit variables that have already been defined for the job are displayed in the central window of this panel.Set Panel The Set panel is used to specify AutoEdit variables to be resolved in the job’s JCL/Script before job submission. for updating existing variables. To edit a variable definition. see Do AutoEdit in the CONTROL-M Job Parameter and Variable Reference Guide. For more information about definition of AutoEdit variables. Below this window. and edit its contents the Text boxes below. Confidential and Proprietary Information 5-30 CONTROL-M/Desktop User Guide . After editing or creating a variable. click the check button next to the Text line to save the changes and/or add the variable to the list. select it in the list of existing variables. BMC Software. Inc. is a pair of text boxes that are used for adding new variables..

see the CONTROL-M Job Parameter and Variable Reference Guide. Inc. and Change the order of the list. Note Even after data has been added or changed. Confidential and Proprietary Information Working with the Job Editing Form 5-31 . Table 5-13 Set Panel – Function Buttons Button Description Enter a new variable.For general information about the AutoEdit facility. For more information. Table 5-13 describes the buttons that are available for the Set panel. BMC Software. Paste data. Copy data.. Delete the selected variable. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. see “Undo and Redo in the Job Editing Form” on page 5-5.

For more information. Note The steps panel works differently for OS/390 jobs. DO statements indicate actions to be performed when the preceding ON statements are satisfied. Inc.. • Table 5-14 describes the buttons that are available for use with Step Codes. The definition line below the list of statements can be toggled between fields for ON statements and fields for DO statements. see “Steps Panel (OS/390)” on page 5-39. BMC Software.Steps Panel The Steps panel indicates conditional post processing actions to be performed. Figure 5-10 Steps Panel of the Job Editing Form Each item in this panel indicates either an ON statement. depending on the outcome of specified statements. or a DO statement. ON statements indicate conditions under which specified actions should be performed. Confidential and Proprietary Information 5-32 CONTROL-M/Desktop User Guide .

For more information.• • Table 5-15 describes the fields that are used for definition of ON statements. click the check button at the corner of the Step Codes section to save the changes and/or add the statements to the list. Copy data. Table 5-16 describes the fields that are used for definition of DO statements. see the CONTROL-M Job Parameter and Variable Reference Guide. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. Table 5-14 Steps Panel – Buttons Button Description Displays the DO statement definition line. After editing or creating an ON statement. see “Undo and Redo in the Job Editing Form” on page 5-5. Confidential and Proprietary Information Working with the Job Editing Form 5-33 . Delete the selected statement. and Change the order of the list. BMC Software.. On Statement Definition Line Figure 5-11 shows a blank set of ON statement fields. Inc. For more detailed information about these fields. These fields are described briefly in Table 5-15. Displays the ON statement definition line. Paste data. Note Even after data has been added or changed.

Figure 5-12 displays a sample Do Statement definition line. Character string that is compared with the job’s log error codes. Do Statement Definition Line The DO statement definition line is displayed by clicking the DO button . BMC Software.. Inc.Figure 5-11 Steps Panel – On Statement Fields Table 5-15 On Statement Code Criteria Box Statement Code Description Character string that is compared with the job’s log statement records. Confidential and Proprietary Information 5-34 CONTROL-M/Desktop User Guide .

Figure 5-12 Steps Panel – Do Statement Fields The fields displayed in this line vary depending on the selected DO action. For more information about these fields. Inc. click the check button at the corner of the Step Codes section to save the changes and/or add the statements to the list. BMC Software. Confidential and Proprietary Information Working with the Job Editing Form 5-35 . After editing or creating a DO statement. A brief description of each DO action and its fields is supplied in Table 5-16. see the CONTROL-M Job Parameter and Variable Reference Guide..

or a resolvable AutoEdit Expression. see the CONTROL-M Job Parameter and Variable Reference Guide. Causes the job to be rerun according to the parameters specified in the Rerun parameter. Regular.. Inc.Table 5-16 DO Statement Parameters Parameter DO OK DO NOTOK DO Rerun DO Set-Var Description Sets the job’s completion status to OK regardless of the job’s completion status. This value can be either a constant value. Select the option button the reflects the level of urgency for the specified message. DO Shout Specifies messages to be sent (“shouted”) to various destinations on various occasions. No subparameters. Note: This parameter is called DO AutoEdit in CONTROL-M/EM. or Very Urgent. Confidential and Proprietary Information 5-36 CONTROL-M/Desktop User Guide . Priority for the shout message. MSG BMC Software. Value for the specified variable. No subparameters. Assigns a value to an AutoEdit variable. The following subparameter fields are displayed for this DO statement: Destination Urgency Destination to which the message should be sent. No subparameters. Text of the message to be sent. Sets the job’s completion status to NOTOK regardless of the job’s completion status. Urgent. The following subparameter fields are displayed for this DO statement: Name Value Name of variable to be set to the specified value. For more information about AutoEdit Expressions.

F Copy output. D Delete output. specify the New class (one character) or * to indicate the jobs original MSGCLASS. PRM FROM BMC Software. Relevant sysout data. R Release for Printer. The following subparameter fields are displayed for this DO statement: SCD Table Job Name Date Library Name of the scheduling table containing the job to be forced. The following subparameter fields are displayed for this DO statement: option Sysout option code (list box). • For option C. (Text) • For option F. Inc. The appropriate value depends on the option code above. Scheduling date of the job to be forced.Table 5-16 DO Statement Parameters Parameter DO Force-job Description Forces a job or a complete scheduling table to be ordered under CONTROL-M regardless of the scheduling criteria. Name of the job to be forced. • For option N. The following options are available: C Change job class. specify the new destination (up to 8 characters). Limits the sysout handling operation to sysouts originating in the specified class. Confidential and Proprietary Information Working with the Job Editing Form 5-37 . N Move output. From class. specify the file name. DO Sysout Specifies how the job’s output should be handled. Name of the library containing the specified scheduling table. C or N.. For use with codes F.

To Regular or Urgent Subject CC text box The e-mail address of the recipient of the DO Mail message. or Urgent. These option buttons indicate whether the specified condition should be added (+) or deleted (-).Table 5-16 DO Statement Parameters Parameter DO Condition Description Specifies prerequisite conditions to be added or deleted. Optional.. Date reference for the prerequisite condition. Inc. A brief message that can describe the contents of a longer message. Select the option button the reflects the level of urgency for the specified message. The following subparameter fields are displayed for this DO statement: Name Date + or – Name of the prerequisite condition. The text of the message to be sent. BMC Software. Priority for the shout message. Regular. DO Mail Sends a brief message when the specified On condition is fulfilled. Confidential and Proprietary Information 5-38 CONTROL-M/Desktop User Guide . The e-mail address of an additional recipient of the DO Mail message.

. Figure 5-13 Steps Panel of the Job Editing Form (OS/390) Two types of information are specified in this panel: • Step Range indicates which steps should be monitored for the specified codes. Postprocessing for all other jobs is specified using the Steps panel described on page 5-32.Steps Panel (OS/390) The Steps panel indicates conditional post processing actions to be performed. Confidential and Proprietary Information Working with the Job Editing Form 5-39 . Inc. depending on the outcome of specified steps. Note This panel is relevant only for OS/390 jobs. • BMC Software. Step Codes indicates what steps codes should be handled and what actions should be performed when the specified step completion codes are detected.

Delete the selected step. Confidential and Proprietary Information 5-40 CONTROL-M/Desktop User Guide . Inc. This field consists of two text boxes: • In the left box. This field consists of two text boxes: • In the left box. Figure 5-14 Step Range Fields • Table 5-17 describes the fields that are used for definition of each step range. specify the program (PGM) step name. (Text) • In the right box.Each of these types of information is described in detail in the following pages. (Text) Last step in the range. BMC Software. optionally specify the procedure (PROC) step name. (Text) Step Range – Buttons To Table 5-18 Button Description Enter a new step. optionally specify the procedure (PROC) step name. Step Range – Fields • Table 5-17 Field Name From Description Logical name for the specified step range.. Table 5-18 describes the buttons that are available for use with Step ranges panel. (Text) First step in the range. specify the program (PGM) step name. (Text) • In the right box. Specifying a step range eliminates the need to define separate postprocessing actions for each step in the range. Step Range Each item in the step range list indicates a range of steps to be checked for specified completion codes.

or a DO statement. Table 5-20 describes the fields that are used for definition of ON statements. Copy data. see “Undo and Redo in the Job Editing Form” on page 5-5. Step Codes Each item in the step codes list indicates either an ON statement. The definition line below the list of statements can be toggled between fields for ON statements and fields for DO statements.. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. Click the check button next to the new or updated step range. ON statements indicate conditions under which specified actions should be performed. Note Even after data has been added or changed. DO statements indicate actions to be performed when the preceding ON statements are satisfied.Table 5-18 Step Range – Buttons Button and Description Change the order of the list. For more information. • • • Table 5-19 describes the buttons that are available for use with Step Codes. to save the changes or the new step range to the list. Paste data. Inc. Confidential and Proprietary Information Working with the Job Editing Form 5-41 . Table 5-21 describes the fields that are used for definition of DO statements. BMC Software.

the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. Figure 5-15 ON Statement Fields BMC Software. Inc. Note Even after data has been added or changed. and Change the order of the list. Confidential and Proprietary Information 5-42 CONTROL-M/Desktop User Guide . Displays the ON statement definition line. For more detailed information about these fields. click the check button at the corner of the Step Codes section to save the changes and/or add the statements to the list. Delete the selected change.After editing or creating an On/Do Action statement. Copy data. Table 5-19 Step Codes – Buttons Button Description Displays the DO statement definition line. These fields are described briefly in Table 5-20.. see “Undo and Redo in the Job Editing Form” on page 5-5. see the CONTROL-M Job Parameter and Variable Reference Guide. For more information. ON statements Figure 5-15 shows a blank set of ON statement fields. Paste data.

in which the program step is found. Confidential and Proprietary Information Working with the Job Editing Form 5-43 . For more information about these fields. (Option buttons) DO Statements The DO statement definition line is displayed by clicking the DO button . Type in each codes separately. BMC Software. Name of the procedure step. see the CONTROL-M Job Parameter and Variable Reference Guide. Sets the job’s completion status to NOTOK regardless of the job’s completion status. click the check button at the corner of the Step Codes section to save the changes and/or add the statements to the list.. Figure 5-16 displays a sample Do Statement definition line. The fields displayed in this line vary depending on the selected DO action. Logical relationship between multiple On statements. No subparameters. A brief description of each DO action and its fields is supplied in Table 5-21.Table 5-20 On Statement Parameters Parameter PGMST PROCST Codes And/Or Description Name of the program step to be checked for the specified code criteria. and press < Enter> after each code. Figure 5-16 Do Statement Definition Line Table 5-21 DO Statement Parameters Parameter DO OK DO NOTOK Description Sets the job’s completion status to OK regardless of the job’s completion status. Codes for the indicated step which will satisfy the criteria. No subparameters. Inc. After editing or creating a DO statement.

DO Shout Specifies messages to be sent (“shouted”) to various destinations on various occasions. Note: This parameter is called DO AutoEdit in CONTROL-M/EM. Text of the message to be sent. Inc. or a resolvable AutoEdit Expression. The following subparameter fields are displayed for this DO statement: Name Value Name of variable to be set to the specified value. Scheduling date of the job to be forced.Table 5-21 DO Statement Parameters Parameter DO Rerun DO Set-Var Description Causes the job to be rerun according to the parameters specified in the Rerun parameter. or Very Urgent. BMC Software. MSG DO Force-job Forces a job or a complete scheduling table to be ordered under CONTROL-M regardless of the scheduling criteria. Urgent. The following subparameter fields are displayed for this DO statement: Destination Urgency Destination to which the message should be sent. Priority for the shout message.. This value can be either a constant value. see the CONTROL-M Job Parameter and Variable Reference Guide. Assigns a value to an AutoEdit variable. Name of the library containing the specified scheduling table. The following subparameter fields are displayed for this DO statement: SCD Table Job Name Date Library Name of the scheduling table containing the job to be forced. Select the option button the reflects the level of urgency for the specified message. No subparameters. Confidential and Proprietary Information 5-44 CONTROL-M/Desktop User Guide . Value for the specified variable. Regular. Name of the job to be forced. For more information about AutoEdit Expressions.

C or N. F Copy output. BMC Software. For use with codes F. Confidential and Proprietary Information Working with the Job Editing Form 5-45 . Arguments to be passed to the rule.. specify the New class (one character) or * to indicate the jobs original MSGCLASS. Relevant sysout data. • For option C. The following subparameter fields are displayed for this DO statement: option Sysout option code (list box). The following options are available: C Change job class. Limits the sysout handling operation to sysouts originating in the specified class. PRM FROM DO CTBRule Invokes a CONTROL-M/Analyzer rule to be executed at the processing of a specific program step. From class. Available only if CONTROL-M/Analyzer is installed. (Text) • For option F. specify the file name. The appropriate value depends on the option code above. Multiple arguments must be separated by commas. Inc.Table 5-21 DO Statement Parameters Parameter DO Sysout Description Specifies how the job’s log should be handled. • For option N. D Delete output. specify the new destination (up to 8 characters). R Release for Printer. N Move output. The following subparameter fields are displayed for this DO statement: Name Arg Name of the CONTROL-M/Analyzer rule.

BMC Software. Confidential and Proprietary Information 5-46 CONTROL-M/Desktop User Guide . These option buttons indicate whether the specified condition should be added (+) or deleted (-). If selected. The following subparameter fields are displayed for this DO statement: From Step from which to begin the job restart. Valid only if CONTROL-M/Restart is installed. • procstep — Called procedure in which the program step is found. Date reference for the prerequisite condition.Table 5-21 DO Statement Parameters Parameter Do IFRerun Description Indicates restart steps for the job if it is rerun.. Step at which to end the job restart. The following values can be specified for this subparameter: • pgmstep — Program step. The following subparameter fields are displayed for this DO statement: Name Date + or – Name of the prerequisite condition. The following values can be specified for this subparameter: • pgmstep — Program step. To Confirm DO Condition Specifies prerequisite conditions to be added or deleted. indicates that manual confirmation is required before the job will be submitted for restart. Inc. • procstep — Called procedure in which the program step is found.

Sysout handling.. • Each of these sections is described in detail on the following pages. Confidential and Proprietary Information Working with the Job Editing Form 5-47 . BMC Software. Figure 5-17 PostProc Panel of the Job Editing Form This panel is used for specifying the following types of information: • Shout information.PostProc Panel The PostProc panel is used to specify actions to be performed upon job completion. Inc. Describes messages that should be sent to specified destinations depending on how the job ended. Describes how the output of the job should be handled.

Paste data. For more information. BMC Software. Inc. Note Even after shout data has been added or changed. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. Delete the selected message. Table 5-23 describes the fields that are used for definition of Shout statements. see “Undo and Redo in the Job Editing Form” on page 5-5.Shout This section of the PostProc panel describes messages to be sent (shouted) to various destinations. and Change the order of the list. Confidential and Proprietary Information 5-48 CONTROL-M/Desktop User Guide . to After editing or creating a Shout message. Copy data. • • Table 5-22 describes the buttons that are available for use with Shout statements.. Below this list is series of fields for specifying additional Shout statements. Table 5-22 Shout Statements – Buttons Button Description Enter a new message. click the check button save the changes and/or add the message to the list. This section includes a list of previously defined Shout statements for the job.

Valid values for these fields are: OK NOTOK RERUN Late Sub Job ended OK. These option buttons indicate the urgency level of the shout. or >n where n is 1-999 minutes Late Time EXECTIME To Very Urgent Urgent Regular message area Destination to which the message should be sent. where HH is 00-23 and MM is 00-59. <n. Sysout Handling This section of the PostProc panel specifies handling for the sysout when the job ends OK.900 percent -n% where n is 1. The time must be specified in HH:MM format. Confidential and Proprietary Information Working with the Job Editing Form 5-49 . This text box to the right of the other fields is used to specify the contents of the message. Job’s elapsed runtime is outside of specified limits. BMC Software. Job requires rerun. Valid values are: +n% where is n is 1 . The time must be specified in HH:MM format.Table 5-23 Shout Statement Parameters Parameter When Description Indicates the conditions under which the messages should be issued.99 percent +n. Job not submitted by the specified time. –n. Inc. Job ended NOTOK. describes the fields that are used to specify sysout handling. Job not finished running by the specified time.. where HH is 00-23 and MM is 00-59.

Confidential and Proprietary Information 5-50 CONTROL-M/Desktop User Guide .. BMC Software. For OS/390 jobs only: When selected. Must be a three-digit number in the range 000 – 999. Limits the sysout handling operation to sysouts originating in the specified class. Maximum number of days to retain archived SYSDATA. The New Destination text box is displayed for the location to which the log file should be moved. The File Name text box is displayed for the location to which the log file should be copied. Change job class. Copy output. Available options are: None The output of the job is placed in a default location (specified using a CONTROL-M system parameter) until deleted by the next run of the New Day procedure. Release for Printer. Must be a two-digit number in the range 00 – 99. Note: This field is described as parameter Option in the CONTROL-M Job Parameter and Variable Reference Guide.. When selected. Inc. Max Run .. This is specified in the list box directly below the title Sysout Handling. this option indicates that the sysout of the job should be archived. indicates that the SYSDATA of the job should be archived to a common dataset. (for OS/390 jobs only) The New Class Name text box is displayed for the new class designation. Maximum number of runs for which archived SYSDATA should be retained. Move output. C F D N R From Class AutoArchive SYS DB Max Days ...Table 5-24 Sysout Handling Parameters Field Sysout Handling Option Description Sysout option code. Delete output.

. Figure 5-18 Tags Selection Panel of the Job Editing Form The Tag Selection panel includes two lists: • The Group Tag list (on the left) is a list of Schedule tags that are in the Group Scheduling table definition and not used by the job processing definition. Note • The name of the current Group Scheduling table is displayed in the upper-righthand corner of the Tag Selection panel. This panel is not relevant for jobs that are not in a Group Scheduling table. Confidential and Proprietary Information Working with the Job Editing Form 5-51 . The Job Tag list (on the right) is a list of Schedule tags that are used by the job processing definition. Inc. BMC Software.Tags Selection Panel The Tags Selection panel indicates which Schedule tags in a Group Scheduling table should be used by the current job.

Inc. all tags in the Group Tag list are selected. For example. BMC Software. and added to the list of Job Tags. Either click a tag in the Group Tag list. Click on the tag in the Job Tag list.To add a tag to the job definition: 1. The tag is removed from the list of Job Tags and added to the list of Group Tags. if you type A*. Click the left-facing arrow. Click the right-facing arrow. all the tags in the Group Tag list that begin with an A are selected. 2. If you type * or ALL. either on its own or as a suffix. or enter its name in the text box. 2. The tag is removed from the list of Group Tags.. Confidential and Proprietary Information 5-52 CONTROL-M/Desktop User Guide . To remove a tag from the job definition: 1. You can use an asterisk “*” as a wildcard in the tag name.

. or from the Job New menu option. Click Cancel. Additional processing can be performed in the Draft when using this format. • If the Job Editing form was opened in List/Job Editing View by selecting the job from the tree in the left pane. to apply the changes you have made in the Job Editing form. • BMC Software. • Click OK. from the New Job button. If the Job Editing form was opened in Flow Diagram view. the Job Editing form appeared as a dialog box. to apply the changes you have made in the Job Editing form. This dialog box must be closed before any other processing can be performed. in List view.Exiting the Job Editing Form The method for exiting the Job Editing form depends on how the form was originally opened. Click Cancel. to cancel the changes you have made in the Job Editing form. to cancel the changes you have made in the Job Editing form. Confidential and Proprietary Information Working with the Job Editing Form 5-53 . the Job Editing form appeared in the right pane. • Click Apply. Inc.

Click Save to Draft. Modify the command line to change the utility’s behavior.Running CONTROL-M/Server Utilities as Scheduled Jobs CONTROL-M/Server utilities can be invoked using the Command parameter of any job definition where Command has be specified for the Task Type parameter. to open the Draft browse 2. click window. Optional. Double-click on the job that you want to schedule. Modify any other job parameters. “CONTROL-M/Server Utility Jobs.DRF file. Navigate to <INSTALLATION_DIR>\ControlM-EM\CTMDsktp and double-click the Control-M Server Utilities. 8. Confidential and Proprietary Information 5-54 CONTROL-M/Desktop User Guide . In CONTROL-M/Desktop. 6. BMC Software. specify values for the following parameters: • • • • Author CONTROL-M Node ID/Group Owner 5. 7. To use a predefined utility job: 1. The Job Editing form is displayed. A special Draft of predefined jobs is supplied with CONTROL-M/EM with sample job definitions for certain CONTROL-M/Server utilities Table 5-25. 4.. Inc. Update the command line with the values you specified in Step 4 (for ctmcreate and ctmdefine only). the jobs in the Draft are displayed in the flow diagram. Optional.” on page 5-55. On the General panel of the Job Editing form. 3.

ctmloadset ctmloadset Updates a resource in the Quantitative Resources table with regard to usage on an Agent platform. ctmvar_delete Delete variable specification ecactltb ecactltb Lists the status of each resource in the Control Resources table. ecaqrtab_list Delete resource For more information about CONTROL-M/Server utilities. Confidential and Proprietary Information Working with the Job Editing Form 5-55 . ecaqrtab_add Add resource ecaqrtab Performs operations on the Quantitative Resources table. Write the job to the CONTROL-M/EM database. ctmvar Manipulates Global AutoEdit variables for data centers. ctmdefine Defines a job in the CONTROL-M/Server database. or jobs in Group Scheduling tables.. ctmorder ctmorder Orders one or more jobs from a Scheduling table contained in the CONTROL-M/Server database.9. ctmkilljob Terminates a CONTROL-M job and its associated processes. Group Scheduling tables. see the Utilities chapter of the CONTROL-M/Server for Unix Administrator Guide. Inc. ctmcreate ctmdefine ctmkilljob ctmcreate Creates a job in the Active Jobs file. Table 5-25 CONTROL-M/Server Utility Jobs Job Name Utility ctmcontb ctmcontb Performs operations on the Prerequisite Conditions table. ctmudly ctmvar_set Set variable ctmudly Orders jobs for a specific User Daily name. BMC Software.

Confidential and Proprietary Information 5-56 CONTROL-M/Desktop User Guide .BMC Software.. Inc.

see the copydefjob utility description in the CONTROL-M/Enterprise Manager Utilities Reference Guide. This change enables you to take advantage of group processing of jobs. For more information. Which conditions must be satisfied before jobs in the group are submitted for execution. Inc. These parameters are used by CONTROL-M to determine: • • When jobs in the group should be ordered. specify and modify processing definitions that apply to jobs in a Group Scheduling table. BMC Software.6 Working with the Group Editing Form 6 The Group Editing form is used to view. What action follows successful completion of all jobs in the group or unsuccessful completion of a job in the group. Note • You can convert an existing Scheduling table to a Group Scheduling table using the copydefjob utility.. Confidential and Proprietary Information Working with the Group Editing Form 6-1 .

You can only open the Group Editing form in Flow Diagram view. 2. To open a Group Editing form for a new Group Scheduling Table: • Choose Edit => Scheduling Group=>New.To open the Group Editing form for an existing Group Scheduling table: 1.. Confidential and Proprietary Information 6-2 CONTROL-M/Desktop User Guide . Choose View => Flowdiagram. and choose Edit from the pop-up menu. Some parameters differ for the different CONTROL-M platforms. Each panel is described in detail in the following pages. Layout The Group Editing form is divided into different panels in a similar way to the Job Editing form. Table 6-1 describes the panels of the Group Editing form. or click Note . Right-click the Group Scheduling table node. Each panel contains a group of parameters. Inc. BMC Software.

Inc.. Prerequisite IN conditions that must be satisfied for job submission for each job in the group. Tagged sets of scheduling criteria that are used by CONTROL-M to determine: When jobs in the group should be ordered. AutoEdit variables to be set when each job in the group is submitted. Conditions Set BMC Software. What action follows successful completion of all jobs in the group or unsuccessful completion of a job in the group. application and CONTROL-M installation. Confidential and Proprietary Information Working with the Group Editing Form 6-3 . OUT conditions to be added or deleted on completion of the last job in the group.Figure 6-1 Group Editing Form Table 6-1 Group Editing Form – Panels Field General Schedule Tags Description Parameters identifying the group. Which conditions must be satisfied before the jobs in the group are submitted for execution.

Confidential and Proprietary Information 6-4 CONTROL-M/Desktop User Guide .. depending on the completion status of the group (OK or NOTOK).Table 6-1 Group Editing Form – Panels Field Shouts Description Messages to be sent to various destinations. Inc. PostProc BMC Software. after all the jobs in the group complete their processing. depending on certain situations. Actions to be performed after all jobs in the group complete their processing.

General Panel The General panel for the Group Editing form identifies the group.. This field does not appear on the General panel for jobs defined for other platforms. Figure 6-2 Group Editing Form – General Panel Table 6-2 describes the parameters in this panel. application and CONTROL-M installation as well as other miscellaneous parameters. Confidential and Proprietary Information Working with the Group Editing Form 6-5 . Inc. Note The General panel for an OS/390 group has a field called Scheduling Table Lib. BMC Software.

Latest time (in hhmm format) that the last job in the Group Scheduling table can end. Latest time (in hhmm format) that a job in the Group Scheduling table can be scheduled. Name of the Group Scheduling table. manual confirmation is required before the Group Scheduling table is submitted for execution. Internal job priority under CONTROL-M for the group relative to other groups. This parameter is checked by CONTROL-M security mechanisms to determine if the owner has the necessary authority for the requested actions. When selected.. When selected. Name of the library/directory containing the documentation file. Free-text description of the group. (For OS/390 groups only) Name of the application to which the Group Scheduling table belongs. This value is always Scheduling Group for Group Scheduling tables. Earliest time (in hhmm format) that a job in the Group Scheduling table can be scheduled. Logical Name of the Group Scheduling table.Table 6-2 Group Editing Form – General Parameters Parameter Mem Name Owner Description Name of the file or member containing the Group definition (sometimes referred to as the Group entity). [OS/390 only] Name of the file in which group documentation resides. jobs in the Group Scheduling table should ignore conditions usually set by jobs in the Group Scheduling table that are not scheduled. Inc. Task type Confirm Adjust Condition Priority Name Lib Application Group CONTROL-M From Until Due Out Doc Mem Doc Lib Description BMC Software. Confidential and Proprietary Information 6-6 CONTROL-M/Desktop User Guide . Name of the CONTROL-M to which the Group Scheduling table belongs. Task type of the group. Name of the library that contains the Group Scheduling table. Owner (user ID) for the group.

BMC Software. The top left-hand section of the panel. When a tag in the list is selected. Inc. The following buttons are available in the Tag Name section: Inserts a new tag above the selected tag.Schedule Tags Panel Figure 6-3 Group Editing Form – Schedule Tags Panel This panel is used to define Schedule Tags for a Group Scheduling table.. click the check button next to the text box under the list of Tag Names. Deletes the selected tag. A Schedule Tag name is unique within a particular Group Scheduling table. lists tags that are currently defined. Confidential and Proprietary Information Working with the Group Editing Form 6-7 . its scheduling parameters are displayed in the other fields of this panel. After editing an existing tag or defining a new one. Each Schedule Tag definition consists of a Schedule Tag name and a set of scheduling criteria.

2. dates on which jobs should be scheduled. Each Schedule Tag has its own unique scheduling criteria that can be applied to a job. Specify scheduling criteria for the new tag. and click the button. (See “Defining a Set of Scheduling Criteria. Click on the desired tag in the list. or press Modifying an Existing Tag 1.) 4. Type the tag name in the text box immediately below the tag list. Confidential and Proprietary Information 6-8 CONTROL-M/Desktop User Guide . click Enter.Defining a New Tag To add a new tag after the already defined tags: 1. A list of days of the month and weekdays on which jobs should be scheduled. One of the following types of scheduling criteria can be specified for each Schedule tag: • Month Days/Week Days. 2. weekdays. (See “Defining a Set of Scheduling Criteria”). 3. The tag’s scheduling details are displayed in the scheduling fields. click .. select the tag above which you want to add the tag. Inc. Select the line at the bottom of the list. Change the scheduling parameters as required. Scheduling Criteria Scheduling criteria indicate days of the month. An empty line opens up in the list above the selected tag. When you have made all the changes. To add a new tag elsewhere in the list. The new tag is added to the list of defined tags.” below. When all required parameters have been defined. BMC Software. 3.

and the CONTROL-M Job Parameter and Variable Reference Guide. You can specify parameters in only the section whose option button is selected. used with Month Days to determine a set of working days. Table 6-3 Schedule Tags Panel – Field Descriptions Parameter Month Days Description Days of the month on which to order the job. For more information about scheduling criteria. Inc. Month Days Calendar and/or BMC Software.• Dates.. Each of these sections has an option button. The fields of the Schedule Tags panel are described in Table 6-3. Name of a user-defined calendar (DCAL calendar in CONTROL-M) containing a list of days of the month. see “Scheduling Panel” on page 5-13. (For more information on usage symbols see Days in the CONTROL-M Job Parameter and Variable Reference Guide). D5. e. Usage symbols should appear before the day. • If and is selected. • If or is selected. Days can be written in the Month Days text box separated by commas. and the day of the week is one of the days in Week Days. Confidential and Proprietary Information Working with the Group Editing Form 6-9 . a job should be scheduled if either the day of the month is one of the days in Month Days. a job should be scheduled only if the day of the month is one of the days in Month Days.g.The parameters of the unchecked section are not available. A list of dates (month and day) on which the jobs should be scheduled. or the day of the week is one of the days in Week Days. (For more information see Days Calendar in the CONTROL-M Job Parameter and Variable Reference Guide). -10. Indicate the relationship between Month Day values and Week Day values.

Dates are inserted into the list separately.. Confcal). see Dates in the CONTROL-M Job Parameter and Variable Reference Guide BMC Software. Alternatively. Choose a value between -62 and 62. it does not appear in the confirmation calendar. 1=Monday. 6=Saturday).2. If more dates are required. use a calendar..Table 6-3 Schedule Tags Panel – Field Descriptions Parameter Weekdays Description Day(s) of the week on which to schedule the job. (For more information see Week Days in the CONTROL-M Job Parameter and Variable Reference Guide) Example 1. . (For more information. A maximum of twelve dates can be specified. Months in which to order the job. The number of days by which to shift the job if the date is not confirmed (i. Dates Dates on which to order the job.5 would schedule the job on Monday through Friday (assuming the site standard is 0=Sunday. used with parameter Week Days to specify a set of working days.e.3. Weekdays Calendar Months Confcal Name of a user-defined calendar (WCAL calendar in CONTROL-M) containing a list of weekdays. Valid values are four character dates. Confidential and Proprietary Information 6-10 CONTROL-M/Desktop User Guide . A check box is provided for each day of the week (Sunday through Saturday). Specified codes should be separated by a comma. Calendar used to confirm Job Scheduling dates. in mmdd or ddmm format (depending on the site standard). This parameter uses the following sub-parameters: Name Shift Days Name of the calendar. Each month (Jan through Dec) is listed individually. Check the boxes for the days on which the job should be scheduled.4. Inc.. specify the desired weekdays in the Data Box below the Weekdays List using the numeric codes according to the site standard.

.) Retro BMC Software. see Max Wait in the CONTROL-M Job Parameter and Variable Reference Guide. (For more information. see Retro in the CONTROL-M Job Parameter and Variable Reference Guide. until it is deleted.Table 6-3 Schedule Tags Panel – Field Descriptions Parameter Max Wait Description Maximum number of extra days (beyond the original scheduling date) the job is allowed to remain in the Active Jobs File awaiting execution. Inc. Confidential and Proprietary Information Working with the Group Editing Form 6-11 .) Indicates whether or not the job should be scheduled for possible execution after its original scheduling date has passed. (For more information.

Note Even after a condition has been added or changed. The text box is used for editing existing conditions or defining new conditions. Figure 6-4 Group Editing Form – Conditions Panel Each half of the conditions panel consists of a list of already-defined conditions. see “Undo and Redo in the Job Editing Form” on page 5-5. IN conditions are defined in the left side of this panel. Confidential and Proprietary Information 6-12 CONTROL-M/Desktop User Guide . Inc. BMC Software.Conditions Panel The Conditions panel is used to define prerequisite IN and OUT conditions. For more information. After editing or creating a condition. When you select a condition in the list.. OUT conditions are defined in the right side. and a text box. its contents are displayed in the Text line. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. click the check button next to the Text box to save the changes or to add the condition to the list.

Table 6-4 describes the buttons that are available for each section of the Conditions panel.01 and above. BMC Software. Note: This value is valid only for CONTROL-M/Server version 6. Table 6-4 Conditions Panel – Buttons Button Description Enter a new condition. Paste data. Confidential and Proprietary Information Working with the Group Editing Form 6-13 . Next scheduling date of the group. Inc. The condition is not date-dependent. Previous scheduling date of the group. Delete the selected condition. The value for this field can be either a valid 4-character date reference in mmdd or ddmm format (depending on the site standard) or one of the following keywords: ODAT PREV NEXT STAT Original scheduling date of the group. **** or $$$$ And/Or Logical relationship between multiple conditions.0. and for CONTROL-M for OS/390. Copy data. and Change the order of the list. Note: This field is relevant only for OS/390 groups. Any scheduling date. (Option buttons) Parentheses Box. Used to indicate And/Or relationships. Table 6-5 In Condition Fields Field Name Date Description Name of the prerequisite condition. Defining IN Conditions Table 6-5 describes the fields used to define In conditions for a group. (Text) Date reference for the condition..

Any scheduling date. (Text) Date reference for the condition. Previous scheduling date of the group. The condition is not date-dependent. **** or $$$$ +/- Indicates whether to add (+) or delete (–) the condition. and for CONTROL-M for OS/390. Note: This value is valid only for CONTROL-M/Server version 6.01 and above. Table 6-6 Out Condition Fields Field Name Date Description Name of the prerequisite condition.0. (Option buttons) BMC Software. The value for this field can be either a valid 4-character date reference in mmdd or ddmm format (depending on the site standard) or one of the following keywords: ODAT PREV NEXT STAT Original scheduling date of the group.. Inc. Next scheduling date of the group. Confidential and Proprietary Information 6-14 CONTROL-M/Desktop User Guide .Defining OUT Conditions Table 6-6 describes the fields used for defining OUT conditions.

Note Quantitative resources cannot be defined for the Group Scheduling table. After editing or creating a resource. and a text box. Inc. its contents are displayed in the text box. click the check button next to the Text box to save the changes or to add the resource to the list. When you select a resource in the list. Confidential and Proprietary Information Working with the Group Editing Form 6-15 . The Quantitative resources window is not available. BMC Software. Control resources are defined in the right side.Resources Panel (OS/390) The Resources panel is used to define Control resources for the Group Scheduling table. The text box is used for editing existing resources or defining new resources.. The resources panel includes a list of already-defined resources. Table 6-7 describes the buttons that are available for each section of the Resources panel.

Inc. Delete the selected resource. Copy data. Confidential and Proprietary Information 6-16 CONTROL-M/Desktop User Guide ..Table 6-7 Resources Panel – Function Buttons Button Description Enter a new resource. and Change the order of the list. (Option buttons) BMC Software. (Text) Type of control that the job must have over the resource. Defining Control Resources for a Job The following fields must be specified for each Control resource: Name Shared/Exclusive Name of the resource required by the job. Paste data.

and edit its contents the Text boxes at the bottom of the Set panel. is a pair of text boxes for adding new variables and updating existing variables. and in each job’s JCL/Script before job submission. click the check button next to the Text line to save the changes or to add the variable to the list. select it in the list of existing variables. Inc. To edit a variable definition. Below this window. BMC Software.Set Panel The Set panel is used to specify AutoEdit variables to be resolved before group submission. see Do AutoEdit the CONTROL-M Job Parameter and Variable Reference Guide. After editing or creating a variable. For more information about definition of AutoEdit variables. Confidential and Proprietary Information Working with the Group Editing Form 6-17 . Figure 6-5 Group Editing Form – Set Panel AutoEdit variables that have already been defined for the group are displayed in the central window of this panel..

Inc.For general information about the AutoEdit facility. Copy data. Paste data. Note Even after data has been added or changed. For more information. completion of the last job in the group). see “Undo and Redo in the Job Editing Form” on page 5-5. Delete the selected variable. Table 6-8 Set Panel – Function Buttons Button Description Enter a new variable. Table 6-8 describes the buttons that are available for the Set panel. Confidential and Proprietary Information 6-18 CONTROL-M/Desktop User Guide . Shouts Panel This panel is used to specify shout messages to be sent on group completion (that is. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y.. and Change the order of the list. see the CONTROL-M Job Parameter and Variable Reference Guide. BMC Software.

. Note Even after shout data has been added or changed. Table 6-10 describes the fields that are used for definition of Shout statements. The panel includes a list of previously defined Shout statements for the group. For more information. BMC Software. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. • • Table 6-9 describes the buttons that are available for use with Shout statements. see “Undo and Redo in the Job Editing Form” on page 5-5.Figure 6-6 Group Editing Form – Shouts Panel The PostProc panel describes messages to be sent (shouted) to various destinations. Confidential and Proprietary Information Working with the Group Editing Form 6-19 . Inc. Below this list is series of fields for specifying additional Shout statements. to After editing or creating a Shout message. click the check button save the changes and/or add the message to the list.

BMC Software.. Valid values are: OK NOTOK Late Sub All jobs in the group ended with OK status. Copy data. Group’s elapsed runtime is greater than or less than the specified limit. where HH is 00-23 and MM is 00-59. where HH is 00-23 and MM is 00-59. • >n or <n where n is the absolute number of minutes by which the group’s elapsed runtime was outside the group’s average elapsed runtime. The time must be specified in HHMM format. Inc. First job in the group was submitted after the submission time limit. At least one job in the group ended NOTOK.Table 6-9 Shout Statements – Buttons Button Description Enter a new message. Table 6-10 Shout Statement Parameters Parameter When Description Indicates the conditions under which the messages should be issued. Paste data. The limit can be written in one of the following formats: • +n or -n where n is an absolute number of minutes. Late Time EXECTIME To Destination to which the message should be sent. Delete the selected statement. Last job in the group completed after the completion time limit. • +n% or –n% where n is the percentage time by which the group’s elapsed runtime was outside the group’s average elapsed runtime. Confidential and Proprietary Information 6-20 CONTROL-M/Desktop User Guide . and Change the order of the list. The time must be specified in HHMM format.

Inc. BMC Software. Confidential and Proprietary Information Working with the Group Editing Form 6-21 .Table 6-10 Shout Statement Parameters Parameter Very Urgent Urgent Regular message area Description These option buttons indicate the urgency level of the shout. This text box to the right of the other fields is used to specify the contents of the message..

BMC Software.PostProc Panel The panel indicates conditional post processing actions to be performed when the last job in the group finishes processing. DO statements indicate actions to be performed when the preceding ON statements are satisfied.. Confidential and Proprietary Information 6-22 CONTROL-M/Desktop User Guide . On statement fields are described on page 6-23. Inc. ON statements indicate conditions under which specified actions should be performed. Figure 6-7 Group Editing Form – Postproc Panel Each item in this panel indicates either an ON statement. depending on the successful or unsuccessful completion of all the jobs in the group. or a DO statement. The definition line below the list of statements can be toggled between fields for ON statements and fields for DO statements. • • • Table 6-11 describes the buttons that are available in the Postproc panel. Table 6-12 describes the fields that are used for definition of DO statements.

Delete the selected statement. Choose either OK or NOTOK from the drop-down list. the appropriate subparameters are displayed. Displays the ON statement definition line. the change can be undone or redone (if it was previously undone) using Ctrl-z and Ctrl-y. When a Do action is selected from the drop-down list.. Paste data. Do Statement Definition Line This line is used to define DO actions to be performed when the ON GROUP-END condition is satisfied.Table 6-11 Postproc Panel – Buttons Button Description Displays the DO statement definition line. click the DO button . After editing or creating an ON statement. To display this line. click the check button at the corner of the Step Codes section to save the changes and/or add the statements to the list. Note Even after data has been added or changed. Copy data. see “Undo and Redo in the Job Editing Form” on page 5-5. Confidential and Proprietary Information Working with the Group Editing Form 6-23 . This field is used to indicate whether the specified DO actions should be performed when the all jobs in the group end successfully (OK) or when at least one job in the group ended unsuccessfully (NOTOK). Inc. For more information. and Change the order of the list. On Statement Definition Line ON statements for groups contain the ON GROUP-END field. Available Do actions and their subparameters are described below: BMC Software.

[OS/390 only] Name of the library containing the specified scheduling table. Urgency of the shout: Regular. Message to be sent. Sets the group’s completion status to NOTOK regardless of the group’s completion status. Very Urgent. Name of the job to be forced. this parameter is known as Do AutoEdit. BMC Software. Urgent. Value to which the variable should be set. No subparameters. Note: In the CONTROL-M/EM. DO Force-job Forces a job or a complete scheduling table to be ordered under CONTROL-M regardless of the scheduling criteria. No sub-parameters. Scheduling date of the job to be forced. Confidential and Proprietary Information 6-24 CONTROL-M/Desktop User Guide . Assigns a value to an AutoEdit variable. Inc. The value must be either a constant or resolvable. The following subparameters are displayed: SCD Table Job Name Date Library Name of the scheduling table containing the job to be forced. DO Shout Specifies messages to be sent ("shouted") to different destinations.. The following subparameters are displayed: Name Value Name of the AutoEdit variable to be set. The following subparameters are displayed: Destination Urgency MSG Destination to which the message should be sent.Table 6-12 Postproc Panel (Groups) – Valid DO statements Parameter DO OK DO NOTOK DO Set-Var Description Sets the group’s completion status to OK regardless of the group’s completion status.

or Urgent.. Indicates whether to add (+) or delete (-) the condition. DO Mail Sends a brief message when the specified On condition is fulfilled. see the CONTROL-M Job Parameter and Variable Reference Guide. Subject CC text box After editing or creating a Do statement or On statement. Inc. Date of the prerequisite condition. click the check button to save the changes and/or add it to the list. A brief message that can describe the contents of a longer message. Regular. The following subparameters are displayed: Name Date +/Name of the prerequisite condition. Confidential and Proprietary Information Working with the Group Editing Form 6-25 .Table 6-12 Postproc Panel (Groups) – Valid DO statements Parameter DO Condition Description Specifies prerequisite conditions to be added or deleted. Priority for the shout message. To Regular or Urgent The e-mail address of the recipient of the DO Mail message. BMC Software. For more information about Do parameters and On parameters. Optional. The text of the message to be sent. The e-mail address of an additional recipient of the DO Mail message. Select the option button the reflects the level of urgency for the specified message.

Cancel. select one of the following: • Save to Draft to apply the changes you made in the Group Editing form. Confidential and Proprietary Information 6-26 CONTROL-M/Desktop User Guide . -orBMC Software.. • Changes applied in the Group Editing form are immediately applied to the Draft views in other panes and windows. to cancel the changes you made in the Group Editing form.Exiting the Group Editing Form To close the Group Editing form. To open the Copy Tags window: Choose Edit => Scheduling Group => Copy Tags from the menu bar. Copy Tags Window This window enables the user to copy Schedule Tags from one Group Scheduling table to another. Inc.

Click the Copy Tags

button.

The Copy Tags window contains a From section and a To section. These sections provide the information about the table from which to copy the tag and the table to which to copy it. To copy a tag from one table to another: 1. Choose the data center from which you want to copy the Schedule Tag, from the list of data centers in the From section of the window. 2. Choose the Group Scheduling table from which you want to copy the Schedule Tag, from the list of Group Scheduling tables in the From section. The name of the group is displayed in the From Group Name text box. 3. Choose the data center to which you want to copy the Schedule Tag, from the list of data centers in the To section. 4. Choose the Group Scheduling table to which you want to copy the Schedule Tag, from the list of Group Scheduling tables in the To section. The name of the group is displayed in the To Group Name text box. 5. Select the tag you want to copy from the list of tags in the From section by clicking on it. -orType the tag name in the text box above the schedule tag list in the From section. 6. Click the Arrow button. The selected tag is added to the list of tags in the To section.

BMC Software, Inc., Confidential and Proprietary Information

Working with the Group Editing Form

6-27

7. Click OK to save the current list of tags in the To section.
Note

For OS/390 groups, only uppercase letters are allowed in tag names. Tag names for groups on non-OS/390 platforms are case sensitive.

BMC Software, Inc., Confidential and Proprietary Information

6-28

CONTROL-M/Desktop User Guide

7

Creating and Updating Multiple Jobs7
You can define or modify many job processing definitions simultaneously by modifying job skeletons (templates) and applying the new or modified skeletons to the relevant jobs. The following topics are discussed in this chapter: • • Mass Creation of job processing definitions Skeletons. These are templates containing default values used to define multiple jobs with identical characteristics. Mass Updating jobs based on a Skeleton.

These features eliminate the need to create and modify each job processing definition individually. Instead, many job processing definitions can be defined or modified simultaneously.

BMC Software, Inc., Confidential and Proprietary Information

Creating and Updating Multiple Jobs

7-1

Mass Creation of Job Processing Definitions
Mass creation is the process of defining multiple job processing definitions using a common job skeleton (template). The job skeleton is created with parameters that should appear in all jobs to be created. After the jobs are created, they can be modified individually using the Job Editing form (described in Chapter 3 of this guide).
Note

Normally individual job processing definitions are created using the Edit => Job => New Job option, or by clicking the New Job button on the toolbar. To create multiple jobs with similar parameters: Select the Tools => Mass Create option from the menu bar. --orClick the Mass Job Creation button on the toolbar.

The Mass Create Form dialog box is displayed.

Specify the number of jobs to create and the name of the Skeleton that contains the parameters to be define for all the new job processing definitions. (Table 7-1 contains descriptions of all fields in this dialog box.)

BMC Software, Inc., Confidential and Proprietary Information

7-2

CONTROL-M/Desktop User Guide

Table 7-1

Fields of the Mass Create Form Dialog Box

Field
Number of jobs to create Skeleton

Description
Number of jobs to create using the specified skeleton. Default: 10. Skeleton to be applied to the new jobs. To select a different Skeleton, click on the arrow in the Skeleton field and select the desired Skeleton from the dropdown list box. Skeletons can be modified or created using the Skeleton Editor form. This form is displayed by clicking the Edit Skeletons button (described below). For more information, see “Job Skeletons” on page 7-4. Opens a skeleton editor for the specified skeleton. For more information, see “Job Skeletons” on page 7-4.

Edit Skeletons

Click OK to create the requested number of jobs using the specified Skeleton.

Helpful Hints
The Mass Create facility enables you to modify a job skeleton at various stages so that fewer changes are required later.
Example: Create multiple jobs for various applications

Create 40 job processing definitions for several different applications or groups which all include a certain set of parameters and values. The recommended method for creating these jobs using one skeleton is as follows: 1. Specify the desired Skeleton name in the Mass Create Form dialog box. 2. Specify the parameters and values in the Skeleton Editor work area. 3. Specify the first Application name and Group name (e.g., App1, and Group1).
BMC Software, Inc., Confidential and Proprietary Information

Creating and Updating Multiple Jobs

7-3

4. Click OK to save the changes. 5. Specify the number of jobs desired for the first group (e.g., 10). 6. Click OK to create the jobs. 7. Repeat Steps 3 through 6 for each application or group.

Job Skeletons
Job skeletons are templates that are used for the creation of multiple job processing definitions. Each job skeleton contains a set of parameters and values. When a job skeleton is used to create new jobs, the new jobs automatically include the parameters and values that are specified in the skeleton. By modifying a skeleton and reapplying it to related jobs, the jobs can also be modified simultaneously. All job skeletons are created and modified using the Skeleton Editor form. To open the Skeleton Editor form click the Edit Skeletons button in the Mass Create Form dialog box. The Skeleton Editor form can also be opened by selecting the Job Skeleton option on the menu bar or by clicking the Edit Skeleton button on the toolbar.

BMC Software, Inc., Confidential and Proprietary Information

7-4

CONTROL-M/Desktop User Guide

Figure 7-1 Skeleton Editor Window Skeleton Editor form controls are described in Table 7-2.. Inc. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-5 . BMC Software.

Creates a skeleton for Oracle Applications jobs.Creates a skeleton for SAP jobs. The General Panel in the Job Editing Form is modified to display the parameters for the specific application. The Skeleton name is case sensitive. Type of application for jobs created using this skeleton. • Windows 2000 . For more information. • SAP . Format for In Conditions and Out Conditions that are automatically created by job dependencies defined in the Flow Diagram view. Expands the Skeleton Editor window to include fields for defining skeletons for specific applications (such as SAP or Oracle Applications). Type of CONTROL-M platform that will process the job processing definitions produced by this Skeleton. CONTROL-M Application Condition Format The work area of the Skeleton Editor form contains a table for specifying job processing definition fields and their values (described below). Confidential and Proprietary Information 7-6 CONTROL-M/Desktop User Guide . BMC Software. The valid applications types are: • Oracle .Table 7-2 Skeleton Editor Controls Element Skeleton Name Description Name of the Skeleton to be used. The selected value determines which Job Editing form is displayed based on CONTROL-M platform type. The expanded Skeleton Editor window is displayed in Figure 7-2Expanded Skeleton Editor Window. see “Condition Format” on page 7-14.Creates skeletons for jobs running on Microsoft Windows 2000. Select a value from the list box. Inc.. Select a name from the drop-down list box or type in a new name.

Select the existing Skeleton in the Skeleton name list box on the CONTROL-M/Desktop tool bar. Specify the desired Skeleton fields and values in the work area. Click OK to save the Skeleton and to close the Skeleton Editor form. 4. To modify a Skeleton: 1. Click OK to save the new skeleton and to close the Skeleton Editor form. BMC Software. 5. Specify a name for the new Skeleton and click OK. Make the necessary changes in the Skeleton Editor work area. Specify a name for the new Skeleton and click OK.To create a new Skeleton: 1. 2. Select the desired Skeleton in the Mass Create Form dialog box. See “Specifying and Modifying Skeleton Fields” on page 7-11 for details about this part of the Skeleton Editor. 2. The Skeleton Editor form is displayed. Inc. Click Copy. See “Specifying and Modifying Skeleton Fields” on page 7-11 for details about this part of the Skeleton Editor. An empty Skeleton Editor form is displayed. 3. 4. To create a new Skeleton based on the values of an existing Skeleton: 1. Click the Edit Skeletons button. 3. Click New. The new Skeleton is displayed with the same fields and values as the Skeleton from which it was copied.. 2. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-7 .

together with the appropriate Control Module for CONTROL-M. BMC Software. Click OK to save the changes and to close the Skeleton Editor. To clear all fields in the currently displayed Skeleton: » Click the Clear button. To delete a Skeleton: 1. Inc. 2.. See “Specifying and Modifying Skeleton Fields” on page 7-11 for details about this part of the Skeleton Editor. To Add a row to the Skeleton window: » Place the cursor in the last cell of the table and press <Tab>.3. Note Do not specify values for the parameters discussed in this section if you do not have one of the supported applications (such as SAP) installed in your system. Click the Remove button. Make the necessary changes in the Skeleton Editor work area. 4. To Delete a row from the Skeleton window: » Place the cursor in any row of the table and press <Delete>. the Skeleton Editor window expands to display additional controls. such as SAP or Oracle Applications. Defining Skeletons for Jobs Running on Specific Applications When Application is clicked. These controls are used to define skeletons for jobs that are run on specific external applications. Select the Skeleton in the Skeleton name list box at the top of the Skeleton Editor form. Confidential and Proprietary Information 7-8 CONTROL-M/Desktop User Guide .

Application Version. the application (such as SAP) parameters that are included in the skeleton are fluid. Figure 7-2 Expanded Skeleton Editor Window BMC Software. Which parameters are displayed is dependent on which form (specified with the Form Name parameter) is chosen. Whereas regular CONTROL-M/EM job parameters are always included in the skeleton (even when you do not specify a value for them). Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-9 . These parameters are described in the CONTROL-M Job Parameter and Variable Reference Guide. and Control Module Version parameters.These additional controls specify parameters that determine which application parameters are included in the skeleton. Inc.. Which form can be selected is dependent on the values specified for the Application Type.

and Control Module Version. Click Load to import one of the available Application Groups from your CONTROL-M installation. Application Type Application Version CM Version Form Name BMC Software. Determined automatically by the Application Group that is loaded and displayed as Read Only. SAP or Oracle Applications) Control Module (CM) that is installed in the CONTROL-M installation. Determined automatically by the Application Group that is loaded and displayed as Read Only. Indicates the version of the external application (for example. Note: You must load any available forms onto your local computer using View => Import Forms. Specifies a predefined set of external application parameters that will be displayed in the External Application panel of the CONTROL-M/EM Job Editing form. and Control Module Version parameters. Confidential and Proprietary Information 7-10 CONTROL-M/Desktop User Guide .. SAP or Oracle Applications) on which the external application job will run. The forms that are available for selection is dependent on the values specified for Application Type. Indicates the type of external application (for example. Application Version. Selecting the Application Node Group determines the values for the Application Type. Inc.Table 7-3 Application Support Fields in the Skeleton Editor Field Application Node Group Description Logical name of the node group that will process the job. SAP or Oracle Applications) on which the external application job will run. Indicates the version of external application (for example. Forms must be loaded onto your computer to be available. Determined automatically by the Application Group that is loaded and displayed as Read Only. Application Version. A Control Module is a BMC Software product that enables your application to interoperate with your CONTROL-M installation.

5.Specifying and Modifying Skeleton Fields The work area of the Skeleton Editor dialog box contains a table of parameters and values to be applied to related job processing definitions. BMC Software. Select the type of CONTROL-M platform on which the job processing definitions using this Skeleton will be processed. If a field of this type has already been specified for the current skeleton. 4. Note Valid values for the job processing parameters displayed in the Skeleton Editor are described in the CONTROL-M Job Parameter and Variable Reference Guide. Click on the Field column in the line to be edited. 2. 3. Note Most fields can be specified only once in each job processing definition. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-11 . In Conditions and Out Conditions can be specified multiple times and are therefore always available from the field list box. “Valid Functions for Values in the Skeleton Editor. A list box is displayed containing valid field (parameter) names. Special functions can also be specified in the Value field.” on page 713 for a description of these functions.. See Table 7-4. To modify parameters in the Skeleton Editor work area: 1. Select the desired field. The field name appears on the line. Inc. Specify the value for the field in the Value column by either typing the value or selecting the value from a predefined list box. Specify a format (Condition Format) for In Conditions and Out Conditions to be automatically created when job dependencies are created by clicking and dragging from one job node to another in the Flowdiagram view. it no longer appears in the list box.

To delete multiple lines from the Skeleton Editor work area: 1. To move fields in the Skeleton Editor work area: 1. BMC Software. Click the number for the line. it is possible to make changes to one skeleton and click Apply to save them. Press the <Delete> key. 3. Pressing Apply or Done will save all changes. Press the <Delete> key. Confidential and Proprietary Information 7-12 CONTROL-M/Desktop User Guide . Click OK to save all the changes and close the Skeleton Editor form. Note Changes made to skeletons in the Skeleton Editor can be saved either by clicking the Apply button or the OK button.6. An arrow is displayed. The line is highlighted. An arrow is displayed.. 2. Further changes to the same skeleton or a different one can then be cancelled or saved without cancelling the changes made prior to Apply being clicked. You can make changes to one skeleton and then make changes to a second skeleton without saving changes to the first skeleton. Click on the number of the first line to be deleted. Place the cursor on the number (left column) of the line to be deleted. Place the cursor on the number (left column) of the line to be moved. 2. Clicking Cancel will cancel all changes. if necessary. Conversely. Inc. Drag the selection to the desired location. To remove lines from the Skeleton Editor work area: 1. and drag the cursor to highlight all lines to be deleted. Select and edit another Skeleton. 7. 2.

length. Inc. • Format for the conditions automatically defined when dependencies are created in the Flow Diagram view (by clicking on one job and dragging the cursor to the dependant job). This function can be used to reference a previous or subsequent job (e.g.Table 7-4 Valid Functions for Values in the Skeleton Editor Function {fieldname} {Counter} Description Name of a field in the job processing definition. In Conditions and Out Conditions Two types of information can be specified about prerequisite conditions in a job skeleton. position length fieldname function Offset of the substring within the field/function (zero-based) Number of characters Name of the field Name of the function For example. • Each of these types of condition information is described in the following pages. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-13 .quantity to add or subtract} Indicates an amount to be incremented or decremented from a number in the condition name format. Job#{-{Counter}.1}-ENDED). To indicate the first two characters of MemName.g.. This job is Job # {Counter}). specify: {Substr 1. Use the name of the field exactly as it appears in the from the list box of the Field column... {Substr position. {+ | -{numerical field| function}.{MemName}}.2.{fieldname | function}} Substring from a specified field or function. BMC Software. Incremental number to be inserted in the value (e. Actual In conditions and Out conditions defined in the job skeleton that should be part of each job processing definition that is created using the skeleton.

Inc. {Counter} {+ | -{numerical field| function}.g. This value assumes that the first in a line of independent jobs was job number 1. Use the name of the field exactly as it appears in the from the list box of the Field column. or you can specify your own format using the special functions described in Table 7-5.e. Job#{Counter}-ENDED). The second job is number 2. This value is incremented for each successive dependent job in line of dependent jobs. the job to which we are adding an Out Condition). When you do this.quantity to add or subtract} Indicates an amount to be incremented or decremented from a number in the condition name format. BMC Software..Condition Format In the Flow Diagram view of CONTROL-M/Desktop.. Note The format specified for these conditions has no effect on other In conditions and Out conditions specified in either the job skeleton or in specific job processing definitions. Incremental number to be inserted in the value (e.. The first job from which others are dependent is number one. and a corresponding In condition is added to the job processing definition of the second job. you can create dependencies between jobs by clicking on a job node and dragging the mouse cursor to a dependant job. This function can be used to reference a previous or subsequent job (e.The default condition format is: {MemName}-TO-{ToJob{MemName}}. Job#{-{Counter}. Confidential and Proprietary Information 7-14 CONTROL-M/Desktop User Guide . and so on.1}-ENDED). The value for the Condition Format can be either chosen from the list box containing predefined format.. The Condition Format field in the Skeleton Editor dialog box indicates the format these automatically defined conditions. Table 7-5 Valid Functions for the Condition Format Field Function {from fieldname} Description Name of a field in the first job (i.g. an Out condition is automatically defined in the job processing definition of the first job.

BMC Software. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-15 . Therefore. For example.. modification and deletion of these conditions differs from the methods used for specifying values for other job processing definition fields. specify: {Substr 1. to indicate the MemName of the from and to jobs. addition. Specifying In Conditions and Out Conditions in a Skeleton In Conditions and Out Conditions specified in a job skeleton are added to each job processing definition created using that skeleton. {ToJob[to fieldname]} Name of a field in the dependent job (i. position length fieldname function Offset of the substring within the field/function (zero-based) Number of characters Name of the field Name of the function For example.2. job to which we are adding an In condition).Table 7-5 Valid Functions for the Condition Format Field Function Description {Substr position.{from fieldname | function}} Substring from a specified field or function.e. use {MemName}-{ToJob[MemName]}. Each In condition or Out condition contains multiple fields.{MemName}}. Inc.length.. To indicate the first two characters of MemName.

Inc. 2. Click the ellipsis button dialog box is displayed. The following BMC Software. Place the cursor in the Field column of the Skeleton Editor work area and select In Conditions or Out Conditions from the list box.. Confidential and Proprietary Information 7-16 CONTROL-M/Desktop User Guide . in the value column.To add an In Condition or Out Condition to a job skeleton: 1. A pair of braces {} is displayed in the value column.

4.3. BMC Software. The Parentheses field is used to group conditions for implementation of And/Or logic with groups of conditions. Click OK when finished. Inc. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-17 . Enter the name of the In Condition or Out Condition in the Name field.. For more information about And/Or logic and prerequisite conditions see the CONTROL-M Job Parameter and Variable Reference Guide. Values for Date and And/Or can be selected from drop-down lists or they can be entered manually. Multiple In Conditions and Out Conditions can be defined in a job skeleton.

on the tool bar. Select the Tools => Mass Update. This facility can be applied to all job and Group Scheduling table definitions in the Draft or in the current Collection. Inc.Updating Multiple Jobs and Group Scheduling Tables The CONTROL-M/Desktop Mass Update facility updates fields and values in multiple job processing and Group Scheduling table definitions. To perform mass update of job processing definitions: 1. The Mass BMC Software. Collections of jobs are for viewing purposes only and cannot be saved. If you apply a filter to display only selected jobs from the draft. Confidential and Proprietary Information 7-18 CONTROL-M/Desktop User Guide .. By first defining a Collection. whether they are displayed or not. these displayed jobs comprise the current Collection. mass updates can be performed only on the definitions in the Collection. Note A Draft is comprised of all jobs and Group Scheduling tables currently in CONTROL-M/Desktop. -orClick the Mass Update button Update Window is displayed.

Each line in the table can specify criteria that determine which job processing definitions will be updated. 2. or the Collection option button to apply the changes only to jobs in the current Collection. or to specify a field to be added or updated. Click Apply to perform the update. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-19 . Inc. BMC Software. 3. Click the Draft option button to apply the changes to all jobs and Group Scheduling tables in the Draft. -orClick Close to close the Mass Update window without performing the requested function.Table 7-6 describes the fields in the Mass Update window. Fill in the table in the work area of the Mass Update window. 4..

BMC Software. When only the From value is specified. Operator Operator to apply to the specified value. The value in the specified field must be greater than the value in the table. = Like The value in the specified field must equal the value in the table. When both the From value and To value are specified. Click the arrow to display a list of possible fields. > < != In Not In Value Values to be searched for in the job or Group Scheduling table parameter field. Inc. Use commas to separate the values. The value in the specified field must not match any values in the table.Table 7-6 Fields of the Mass Update Form Function Field From Description Job or Group Scheduling table definition field to be searched. Confidential and Proprietary Information 7-20 CONTROL-M/Desktop User Guide . Search value for the field. Values in the table can contain an * (asterisk). Click the arrow to display a list of valid operators (described below). The value in the specified field must be less than the value in the table. The asterisk will match single character or multiple characters which occupy the same character position in the table.. The value in the specified field must match at least one of the values in the table. the Find function is performed using the specified field. The value in the specified field must not equal the value in the table. Each From specification consists of an Operator and a Value. the field is updated. Use commas to separate the values.

the From criteria are used to select jobs to be modified according to other lines in the Mass Update Form. Incremental number to be inserted in the value (for example.. Table 7-7 Valid Functions for To Values Function {fieldname} Description Name of a field in the job or Group Scheduling table definition.1}-ENDED). position length fieldname function Offset of the substring within the field/function (zero-based) Number of characters Name of the field Name of the function For example. Each To specification consists of a Function and a Value. Function Value This field contains either Find or Update.quantity to add or subtract} Indicates an amount to be incremented or decremented from a number in the condition name format. Special functions can be used to specify complex values to replace existing information. BMC Software. “Valid Functions for To Values. This function can be used to reference a previous or subsequent job (for example. Job#{-{Counter}.{MemName}}. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-21 . The MemName of this job is {MemName}). {Counter} {+ | -{numerical field| function}. To indicate the first two characters of MemName. {Substr position.Table 7-6 Fields of the Mass Update Form Function To Description A new value for the specified field if the search (From) criteria are satisfied. New value to replace the existing value in the field. Type in a value.length..{from fieldname | function}} Substring from a specified field or function. Inc. If a To value is specified. This job is Job # {Counter}).” on page 7-21. Use the field name exactly as it appears in the list box of the Field column (e.2. specify: {Substr 1. These functions are described below in Table 7-7. depending upon whether or not a To value is specified.g. or select the new value from a predefined list box. the specified field is updated. If a To value is not specified.

Confidential and Proprietary Information 7-22 CONTROL-M/Desktop User Guide . Inc. Date. job to which we are adding an In condition). use {MemName}-{ToJob[MemName]}. Update. Note The following steps describe how to find or update In condition data. To Find or Update In/Out Condition Data: BMC Software. Using the Mass Update facility. For example. Mass Updating In Conditions and Out Conditions Each In condition or Out condition contains multiple fields. addition. The only difference is that the Mass Update [Out Condition] dialog box contains rows for Name. Find and Update for Out conditions is handled in almost the same way as for In conditions. Therefore. to indicate the MemName of the from and to jobs. and Plus/Minus. add or remove any of the fields in each In condition. you can: • • • Search for job processing definitions with various types of In conditions or Out conditions..Table 7-7 Valid Functions for To Values Function {ToJob[to fieldname]} Description Name of a field in the dependent job (that is. modification and deletion of these conditions in the Mass Update Form dialog box differs from the methods used for specifying values for other job processing definition fields. Add new conditions to all job processing definitions that were selected according to the find criteria in the Mass Update Form.

You can specify search criteria for any number of these fields. A pair of braces {} are displayed in the merged From/To field.. Date. Inc. Click . Each condition is described by four fields: Name. Select Find/Update from the Operation drop down list box. Select In Conditions from the drop down list box in the Field column of the Mass Update Form. And/Or. 3. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-23 . and Parentheses. The From and To fields of the form merge and an ellipsis button is displayed on the right. 4. BMC Software. The Mass Update [In Condition] dialog box is displayed. 2.1.

To Add In Conditions: BMC Software. The word Find is displayed in the third cell. either enter a text string to be found or updated. A summary of the Find/Update data is displayed in braces in the In Conditions row. and select an operator from the drop down list box. Enter the update text string in the fourth cell of the Name row. continue with Step 5. B. The text string can contain all valid characters specified in the tables “Fields of the Mass Update Form” on page 7-20 and “Valid Functions for To Values” on page 7-21. Confidential and Proprietary Information 7-24 CONTROL-M/Desktop User Guide . And/Or and Parentheses). If certain fields should be updated. • If condition data is to be used only as search criteria. select update data from the drop down list boxes that are displayed when the cursor is placed in the last cell of each row. E. Inc. When data is entered in the fourth cell. In the second cell of the row. • D. 5. C.For each field to be used as search criteria: A. For the remaining rows (Date. Click OK to save your specifications and to return to the Mass Update Form. or select the search criteria from the drop down list box. continue with substep D (below).. The text string can contain all valid characters specified in the tables “Fields of the Mass Update Form” on page 7-20 and “Valid Functions for To Values” on page 7-21. the term Find in the third cell will automatically change to Update. Click the first cell in the row.

. A pair of braces {} are displayed in the merged To/From field. BMC Software. In the remaining rows. and an ellipsis button is displayed on the right. The From section of the table is disabled and the word Add is displayed in the first cell of the To section in each row. Click . Inc. 4. Date. enter the name of the new condition. Select Add from the Operation list box. The text string can contain all valid characters specified in the tables “Fields of the Mass Update Form” on page 720 and “Valid Functions for To Values” on page 7-21. 2. 3.1. In the fourth (last) cell in the row marked Name. The Mass Update [In Condition] dialog box is displayed. Confidential and Proprietary Information Creating and Updating Multiple Jobs 7-25 . select data to be added from the drop down list boxes that are displayed when the cursor is placed in the last cell of each row. 5. And/Or and Parentheses. The From and To fields of the In Condition line merges. Select In Conditions from the drop down list box in the Field column in the Mass Update Form.

BMC Software. To Remove Data from In Conditions: Follow the steps listed above in “To Find In Condition Data. The To section of the table is disabled and the word Remove is displayed in the first cell of the From section in each row. For example. select Remove from the Operation drop down list box.. Note It is not necessary to fill in values for all rows of the table for the Remove procedure to work. in order to add new In conditions. To Add and Remove Out Conditions: Use the same procedure as described above for In conditions. and Plus/Minus). entering only the operand = and a specific date would remove all In condition data that contain that date. in step 3. Note Values must be specified for all of the rows in the Mass Update [In Condition] dialog box. A summary of the added data is displayed in the braces in the In conditions row.” However. Note only that the Mass Update [Out Condition] dialog box contains slightly different rows (Name. Confidential and Proprietary Information 7-26 CONTROL-M/Desktop User Guide . Date. Inc.6. Click OK to enter the data and return to the Mass Update Form.

BMC Software. Confidential and Proprietary Information Filtering Data Using Collections 8-1 . You can adjust this Collection as often as you wish using the Collection Criteria form. a Collection is defined as a selection of jobs in a Draft. CONTROL-M/Desktop allows you to filter the current Draft into various Collections according to specified criteria.8 Filtering Data Using Collections 8 In CONTROL-M/Desktop. By default. and mass updates. the Collection on which you work contains all the jobs in the current Draft. search and replace techniques.. These Collections can then be used for filtered viewing. Inc.

These values act as selection criteria for filtering the Draft. The field values are compared against the parameters in job processing definitions to determine if the job should be included in the Collection.g.. The following dialog box is displayed: Figure 8-1 Collection Criteria Dialog Box button on Defining Selection Criteria The Collection Criteria window contains an empty table in which of fields. Confidential and Proprietary Information 8-2 CONTROL-M/Desktop User Guide . Operator to be applied to the specified value (e. >).. BMC Software. =. operators and values can be specified.To filter the Draft according to specified criteria: » Choose Tools => Collection or click the Edit Collection the toolbar. Value that determines whether or not the criteria are satisfied. The Collection Criteria table contains the following columns: Table 8-1 Collection Criteria Dialog Box Fields Column Field Operator Value Description Field to be checked in the job processing definition. Inc.

Cells in the Field column are filled using a drop-down list box. BMC Software. Figure 8-2 Collection Criteria – Fields Note Certain CONTROL-M/Desktop fields correspond to values for CONTROL-M parameters (e.g. The Operator column in the table is also a List box. August is a value for parameter MONTHS).. Confidential and Proprietary Information Filtering Data Using Collections 8-3 . Figure 82 shows the available fields. Inc. Figure 8-3 shows the available operators..

Value in the job must be greater than the value in the table.Figure 8-3 Collection Criteria – Operators List Box These operators are described in Table 8-2. BMC Software. Value in the job matches one of the values listed in the value field. Value in the job must be less than the value in the table. Use commas to separate the values. Confidential and Proprietary Information 8-4 CONTROL-M/Desktop User Guide . Value in the job must not equal the value in the field.. Table 8-2 Collection Criteria – Operators Operator = Like > < != In Not In Description Value in the job must equal the value in the table. Value in the job does not match any of the values listed in the value field. Inc. Use commas to separate the values. Use of wild card * in the value field.

BMC Software. Confidential and Proprietary Information Filtering Data Using Collections 8-5 ... Sample Collection Criteria Figure 8-4 Specifying the Selection Action The Collection window also contains an Action box that is used to specify the way in which the selection criteria are applied. Set the matching jobs to be the current Collection (i. the Collection will consist only of those jobs matching the currently specified criteria). Inc. Specify one of the following options: • • • • Select the full Draft. Remove the matching jobs from the current Collection.e.Example The following Collection criteria will include only those jobs that meet both of the following criteria: • • Job name begins with JOB4. Job belongs to a group whose name begins with GRP5. Add the matching jobs to the current Collection.

Confidential and Proprietary Information 8-6 CONTROL-M/Desktop User Guide ... option to add the appropriate jobs to the current collection.The fields and values in the Collection criteria are compared with the parameters each job processing definition to determine if it should be included in the Collection. For a job to be selected. Note All rows of Collection criteria table must be satisfied for each job in the collection. it must match all specified criteria.. fill in the first set of criteria to create the new collection. To use different sets of selection criteria for a single collection. BMC Software. Inc. and then fill in the table again for each addition set of criteria and use the Add matching jobs .

Confidential and Proprietary Information Working with Scheduling Tables 9-1 . Inc. jobs that are generally run together (concurrently or sequentially) are usually placed in the same Scheduling table.9 Working with Scheduling Tables 9 Job processing definitions are organized into Scheduling tables according to various criteria.. The following subjects are discussed in this chapter: • • • • • • Data Transfer From CONTROL-M/EM Logging in to CONTROL-M/EM Reading Scheduling Tables Writing Scheduling Tables Using Scheduling Tables in the Draft Window Managing Scheduling Tables BMC Software. For example. CONTROL-M/Desktop can be used to create a new Scheduling table or to read an existing one by downloading it from the CONTROL-M/EM database.

see “Managing Scheduling Tables” on page 9-16.Scheduling tables can be defined. delete. This change enables you to take advantage of group processing of jobs. modify. see the copydefjob utility description in the CONTROL-M/Enterprise Manager Utilities Reference Guide. maintained and controlled in the CONTROL-M/EM database using the Scheduling Table Manager. and upload and download Scheduling tables to/from CONTROL-M/Server databases on relevant CONTROL-M platforms.. Note You can convert an existing Scheduling table to a Group Scheduling table using the copydefjob utility. Inc. BMC Software. This feature enables the user to create new Scheduling tables. Confidential and Proprietary Information 9-2 CONTROL-M/Desktop User Guide . or order existing tables. force. For more information. For more information.

The diagram below illustrates the relationship between CONTROL-M/Desktop and the CONTROL-M/EM database..Data Transfer From CONTROL-M/EM For CONTROL-M/Desktop to access Scheduling tables defined in the CONTROL-M/EM database. A Draft is the repository for storing and working on job processing definitions in CONTROL-M/Desktop. The specified Scheduling tables are read from the CONTROL-M/EM database into the current CONTROL-M/Desktop Draft. Inc. the Scheduling table must be transferred (downloaded) to CONTROL-M/Desktop. A Draft can contain job processing definitions from either a single Scheduling table or from multiple Scheduling tables. To prevent multiple users from updating the same Scheduling tables concurrently. BMC Software. CONTROL-M/Desktop automatically Locks a Scheduling table when it is read by a specific user. Scheduling tables to be read are selected using the Edit=>Scheduling table option. Confidential and Proprietary Information Working with Scheduling Tables 9-3 . Communication with the CONTROL-M/EM database is controlled using Communication menu. The connection with CONTROL-M/EM must be active for a table to be uploaded to or downloaded from CONTROL-M/EM. it is uploaded back to CONTROL-M/EM. After the necessary changes are made to the table.

For more information. the Communication login window is displayed. Confidential and Proprietary Information 9-4 CONTROL-M/Desktop User Guide . all definitions for a single Scheduling table can be written (uploaded) to the CONTROL-M/EM database.After creating or modifying job processing definitions in a Draft. Inc.. “Communicating with CONTROLM/EM. Logging in to CONTROL-M/EM The first time you initiate communication with CONTROL-M/Enterprise Manager (CONTROL-M/EM) during a session of CONTROL-M/Desktop. For more information. CONTROL-M/Desktop automatically unlocks a Scheduling table when it is written to by a specific user. BMC Software. see “Lock/Unlock” on page 9-9.”. see Chapter 3.

. 2. The Select Scheduling Table window is displayed: BMC Software. Click Next to continue. Confidential and Proprietary Information Working with Scheduling Tables 9-5 . Select a CONTROL-M by clicking on the appropriate icon. Choose Edit => Scheduling Tables => Read. Inc. 4. or click 3. The Select CONTROL-M window is displayed: . Open a new Draft or use the current Draft.Reading Scheduling Tables To Read a Scheduling table from the CONTROL-M/EM Database: 1.

The window also contains the option of selecting only specific jobs in a table to read. -orClick Back to return to the Select CONTROL-M window to select a different CONTROL-M installation. Confidential and Proprietary Information 9-6 CONTROL-M/Desktop User Guide . Select one or more Scheduling tables from the list.. -orSelect the Load Specific Jobs from that table check box to select specific jobs in the selected Scheduling table to read (see below) and click Next. Click Finish to read the selected Scheduling tables. 5. Inc.This window lists all the available Scheduling tables in the selected CONTROL-M installation. BMC Software. 6.

Confidential and Proprietary Information Working with Scheduling Tables 9-7 . When you are reading two or more Scheduling tables from the CONTROL-M/EM database. you specify which Scheduling tables you want to overwrite.. BMC Software. Note A locked Scheduling table cannot be read by a user other than the one who locked it. Inc. A locking check box is not displayed for Scheduling tables that are currently locked. In this dialog box. the Draft copy of the table is overwritten. the Confirm Read Scheduling Tables dialog box is displayed.Reading Multiple Scheduling Tables If you have a copy of a Scheduling table open in your draft and you read a table of the same name from the CONTROL-M/EM database.

Inc. the following window is displayed to enable selection of the jobs to be read.Select the check box of any Scheduling table you want to overwrite and click Read. Select Jobs Window If you selected the Load Specific Jobs check box. Confidential and Proprietary Information 9-8 CONTROL-M/Desktop User Guide . Figure 9-1 Select Jobs Window The Select Jobs window lists all the existing jobs in the selected Scheduling table. BMC Software. Note You can select all listed Scheduling tables by clicking Check All..

Inc. To deselect a job. it is unlocked automatically. 2. The following rules apply to Lock/Unlock: • • • When you Read a Scheduling table. When you Write a Scheduling table. • • BMC Software. it is locked automatically. close a Draft. CONTROL-M/Desktop automatically Locks a Scheduling table when it is read by a specific user. To unlock a Scheduling table locked by someone else or unlock a Scheduling table that you locked in a different session you must have Full authorization for Definitions. or click Back to return to the Select Scheduling table window to select a different Scheduling table. click on the name while holding down the Ctrl key. or exit CONTROL-M/Desktop with a table still locked. When you disconnect communication with the GUI Server.To select specific jobs to read: 1. Select jobs from the list by clicking on the MemName while holding down the Ctrl key or Shift key. Click Finish to read the selected jobs.. Lock/Unlock To prevent multiple users from updating the same Scheduling tables at the same time. The user reading the Scheduling table can unlock that Scheduling table using the Unlock option in the Scheduling Table Manager. Confidential and Proprietary Information Working with Scheduling Tables 9-9 . a window is displayed prompting you to Unlock the table.

Correct errors and specify missing fields. Choose Edit => Scheduling Tables => Write to CONTROL-M/EM. 3. or click . For more information.Writing Scheduling Tables You can write one or more Scheduling tables to the CONTROL-M/EM database at one time. Inc.” Errors are displayed in the Message window.. Open the Draft containing the job processing definitions for the Scheduling table. “CONTROL-M Definitions and Validity Checks. 2. see Chapter 11. Confidential and Proprietary Information 9-10 CONTROL-M/Desktop User Guide . the Write to CONTROL-M/EM window is displayed. 4. Choose Tools => Validity Checks or click to validate the fields in the jobs. BMC Software. To write a Scheduling table to the CONTROL-M/EM database: 1.

Select the Scheduling tables that you want to write to the CONTROL-M/EM database. the Scheduling tables are written to the database.. the Confirm Write Scheduling Tables dialog box is displayed. Click Write. Inc. although two or more tables are selected for writing. In this dialog box. 6. If no errors are detected before the write process. Confidential and Proprietary Information Working with Scheduling Tables 9-11 .5. If you are writing multiple Scheduling tables and one or more of them already exist in the CONTROL-M/EM database. you must indicate whether you want these Scheduling tables overwritten. BMC Software. a summary window is displayed: Figure 9-2 Write Scheduling Tables results Window Writing Multiple Scheduling Tables The procedure for writing multiple Scheduling tables is the same as for writing a single Scheduling table.

BMC Software. Confidential and Proprietary Information 9-12 CONTROL-M/Desktop User Guide .. A locking check box is not displayed for Scheduling tables that are currently locked. Note A locked Scheduling table cannot be read by a user other than the one who locked it.Select the check box of any Scheduling table you want to overwrite and click Write. You can select all listed Scheduling tables by clicking Check All. Inc.

Choose View => Hierarchy => Data Center/Sched. To select multiple Scheduling tables: BMC Software. Table/Job. select the required nodes from the Draft window and then specify the required action from the node popup menu or from the menu bar. Confidential and Proprietary Information Working with Scheduling Tables 9-13 . The CONTROL-M hierarchy is displayed. The Scheduling table is selected. When you want to perform an action on a specific Scheduling table of group of Scheduling tables.Using Scheduling Tables in the Draft Window Scheduling tables are displayed as nodes in the CONTROL-M/Desktop Draft window navigation tree and flow diagram. described in “Managing Scheduling Tables” on page 9-16. Note Alternatively. To display the CONTROL-M hierarchy: » Click on the CONTROL-M Tree -or- button in the toolbar. you can select and perform actions on a Scheduling table selected from the Scheduling Table Manager window. To select a single Scheduling table: » Click on a Scheduling table node in either the navigation tree or the flow diagram. Inc.. Selecting Scheduling Tables Scheduling table nodes are displayed only when the CONTROL-M hierarchy is displayed in the CONTROL-M/Desktop Draft window.

-orPress and hold the Ctrl key and click on a Scheduling table node. The nodes are selected.. Click on the last node in the required group of nodes. Click on the last node in the required group of nodes. Release Shift. Release Ctrl. Inc. BMC Software. The options on the popup menu are described in “Writing Scheduling Tables” on page 9-10. These nodes do not need to be contiguous. To display the popup menu for a node or group of nodes: » Right-click on a Scheduling table node to display the popup menu for that node. All contiguous nodes are selected.» Press and hold the Shift key and click on the first in a row of contiguous Scheduling table nodes in either the navigation tree or the flow diagram. Confidential and Proprietary Information 9-14 CONTROL-M/Desktop User Guide . Click on other Scheduling table nodes.

only those options are displayed that are available for all selected Scheduling tables. If two or more nodes are selected. none of the options are available. Availability of an option is subject to your user authorization level for Scheduling tables. Some limitations: • If you have not logged in to the CONTROL-M/EM database. Confidential and Proprietary Information Working with Scheduling Tables 9-15 . Inc. • • BMC Software..Option Availability The availability of the options is dependent on the number and status of the node or nodes selected and whether you are in communication with the CONTROL-M/EM database.

The Scheduling Table Manager window allows you to: • View a list of all Scheduling tables in the CONTROL-M/EM database. Force or order one or more Scheduling tables.Managing Scheduling Tables The Scheduling Table manager is used to define. that table is removed from all User dailies except the one that is associated with it in CONTROL-M/EM. maintain and control Scheduling tables in the CONTROL-M/EM database.. or create a new one. Modify or delete existing Scheduling tables. BMC Software. Confidential and Proprietary Information 9-16 CONTROL-M/Desktop User Guide . Inc. Note • • • • • If a table that is associated with more than one User daily is modified using CONTROL-M/EM and then uploaded to CONTROL-M. Download tables from a CONTROL-M/Server database to the CONTROL-M/EM workstation. View the details for all the jobs in a selected table. Upload new or modified tables to the CONTROL-M/Server database in a specified CONTROL-M installation.

Buttons on the right side of this window offer a wide variety of actions that can be performed on Scheduling tables selected in this window. • • BMC Software. These buttons are described in Table 9-3. The fields at the top of this window can be used to filter the scheduling tables that are displayed.. choose Edit => Scheduling Tables => Scheduling Table Manager. or click • . Inc. These fields are described in Table 9-1. The columns in the Scheduling Table Manager window are described in Table 9-2.” on page 9-19. “Command Buttons – Scheduling Table Manager. Confidential and Proprietary Information Working with Scheduling Tables 9-17 .Figure 9-3 Scheduling Tables Window » To open the Scheduling Table Manager window.

this checkbox indicates that the filter criteria should be applied. case sensitive). Use pattern matching characters to specify generic Scheduling table names. tables that have not been modified (blank). Column Descriptions – Scheduling Table Manager Library Modified Table 9-2 Column CONTROL-M Table Library Platform Version Locked by Description Name of the CONTROL-M. Name of the Scheduling table (1-20 characters. BMC Software. A Scheduling table can be modified by only one user at a time. or both (gray). Version of CONTROL-M. Type of CONTROL-M platform.Table 9-1 Filter Fields – Scheduling Table Manager Field Filter CONTROL-M Table Description When selected. List Scheduling tables only for the specified CONTROL-M installation. List the specified Scheduling tables only.. Inc. See Modified below. [For OS/390 users] List Scheduling tables for the specified library only. Name of the CONTROL-M/EM user currently modifying the Scheduling table. Confidential and Proprietary Information 9-18 CONTROL-M/Desktop User Guide . Toggles between display of only Modified (√) tables. [For OS/390 users] Name of the library in which the Scheduling table is located.

see “Table Synchronization” in the CONTROL-M/Enterprise Manager User Guide. case-sensitive). Command Buttons – Scheduling Table Manager (Part 1 of 3) Modified Table 9-3 Button New Description Opens the Scheduling Table Details window to define a new Scheduling table. Inc. If “SYSTEM” (uppercase only) is specified.. The New Day procedure and User Daily Jobs are described in the CONTROL-M/Enterprise Manager User Guide. see “Scheduling Table Details Window” on page 9-22. This window is described in “Scheduling Table Details Window” on page 9-22. the Scheduling table is ordered by the New Day procedure. regardless of whether or not a later version of the table exists in the CONTROL-M/Server database. Confidential and Proprietary Information Working with Scheduling Tables 9-19 . For more information. Note for OS/390 users: Assignment of the Scheduling table to the New Day procedure or to a specific User Daily Job is described in Section 5 of the (OS/390) CONTROL-M User Manual. Delete Force Delete Local Delete Remote Delete Table Details BMC Software.Table 9-2 Column Descriptions – Scheduling Table Manager Column User Daily Description Identifier used to assign the Scheduling table to a specific User Daily Job (1-10 characters. Displays a window from which you can modify the selected Scheduling table. Deletes the table from the CONTROL-M/Server database. Deletes the table from both the CONTROL-M/EM and CONTROL-M/Server databases. For more information. Yes indicates that the Scheduling table has been updated but not yet uploaded. Deletes the table from the CONTROL-M/EM database. Deletes the table from both the CONTROL-M/EM and CONTROL-M/Server databases.

This restriction can be overridden using the Force Upload option (described below). On completion. Force Upload Download Order BMC Software. On completion. On completion. Confidential and Proprietary Information 9-20 CONTROL-M/Desktop User Guide . • To upload or download multiple Scheduling tables. Copies the selected Scheduling table from the CONTROL-M/Server database to the CONTROL-M/EM database. regardless of whether a more recent version of the table exists in the CONTROL-M/Server database. a message appears indicating that the Upload is not allowed. Download is a background process. Scheduling tables can also be ordered from the Order/Force Jobs window in CONTROL-M/EM. you can perform other actions during transmission. see “Ordering/Forcing Jobs” in the CONTROL-M/Enterprise Manager User Guide. Orders the selected table. Upload is a background process.Table 9-3 Command Buttons – Scheduling Table Manager (Part 2 of 3) Button Upload Description Copies the selected Scheduling table to the specified CONTROL-M/Server database. Inc. For more information. Specify either ODAT or a specific date. Upload is a background process. To download a Scheduling table that is not displayed in the Scheduling Table Manager window. create the Scheduling table and then download the Scheduling table normally. the Modified field changes to No. hold down the <Ctrl> key and select the required tables. You can perform other actions during transmission. Copies the selected Scheduling table to the specified CONTROL-M/Server database.. When Order is clicked. the Modified field changes to No. You can perform other actions during transmission. the Modified field changes to No. • If the Scheduling table in the CONTROL-M/Server database is a more recent version. a dialog box is displayed in which you specify the order date.

. When Force is clicked. Refreshes the status of the Scheduling tables in the window. For more information. Scheduling tables can also be forced from the Order/Force Jobs window in CONTROL-M/EM. see “Ordering/Forcing Jobs” in the CONTROL-M/Enterprise Manager User Guide. Selects all Scheduling tables displayed in the window. Confidential and Proprietary Information Working with Scheduling Tables 9-21 . Unlocks the selected Scheduling table to allow modification by a different user. Inc.Table 9-3 Command Buttons – Scheduling Table Manager (Part 3 of 3) Button Force Description Forces the selected table. Note: This option is not available if all of the Scheduling tables are already selected. Unlock Refresh Select All Jobs List BMC Software. a dialog box is displayed in which you specify the force date. This window is described in “Jobs List Window” on page 9-24. Specify either ODAT or a specific date. Opens a window containing a list of all of the jobs contained in the Scheduling table.

. [OS/390] Name of the library in which the Scheduling table is located. This window is displayed by clicking New or Update in the Scheduling Table Manager window (described above).Scheduling Table Details Window The Scheduling Table Details Window enables the user to define new Scheduling tables and edit existing ones. The fields of this window are described in Table 9-4. Figure 9-4 Scheduling Table Details Window Table 9-4 Field Descriptions – Scheduling Table Details Window Field CONTROL-M Name Library Description Name of the CONTROL-M installation. no blanks). Name of the Scheduling table (1-20 characters. Inc. Confidential and Proprietary Information 9-22 CONTROL-M/Desktop User Guide . BMC Software. case sensitive.

Assignment of the Scheduling table to the New Day procedure or to a specific User Daily Job is described in Section 5 of the (OS/390) CONTROL-M User Manual. Click New in the Scheduling Table Manager window. the Scheduling table is ordered by the New Day procedure. If “SYSTEM” (uppercase only) is specified.. the fields of the window are disabled. displaying the specifications of the selected Scheduling table. To change details of an existing Scheduling table: 1.Table 9-4 Field Descriptions – Scheduling Table Details Window Field User Daily Description (Optional) Identifier used to assign the Scheduling table to a specific User Daily Job (1-10 characters. The Scheduling Table Details window opens. Inc. Select a scheduling table in the Scheduling Table Manager window. 2. The scheduling table is added to the CONTROL-M/EM database. Confidential and Proprietary Information Working with Scheduling Tables 9-23 . Last Upload To define a new Scheduling table: 1. BMC Software. Click OK. Time (24 hour format) of last upload of the Scheduling table to the CONTROL-M/Server database in the indicated installation. The New Day procedure and User Daily Jobs are described in the CONTROL-M/Enterprise Manager User Guide. 2. [OS/390] Documentation purposes only. case sensitive). Click Update. Note You must be authorized to modify Scheduling tables. Specify criteria for the new scheduling table in the details window. Otherwise. 3.

all jobs and Group Scheduling tables are displayed. Confidential and Proprietary Information 9-24 CONTROL-M/Desktop User Guide . Note By default. You can modify the processing definitions of jobs and Group Scheduling tables displayed in the Jobs List window. To display the Jobs List for a selected Scheduling table: 1. The changes are saved in the CONTROL-M/EM database. or double-click the selected Scheduling table name. Click Jobs List. Modify the Scheduling table criteria. 3. Choose Edit => Scheduling Tables => Scheduling Table Manager. BMC Software.3. Inc. you can apply a filter to display only selected jobs (the filter does not work with Group Scheduling tables). However. 2. or click to open the Scheduling Table Manager window. These modifications are applied to the CONTROL-M/EM database.. 4. a message is displayed instead of the Jobs List window. The filter elements are described in Table 9-5. Select a Scheduling table from the list.The Jobs List window is displayed: Note If the Scheduling table is empty of jobs. Jobs List Window The Jobs List window lists the jobs and Group Scheduling tables comprising a selected Scheduling table. Click OK.

Confidential and Proprietary Information Working with Scheduling Tables 9-25 . Name of a library/directory in which a job script is located that is used as a filter criterion. Name of a job that is used as a filter criterion. Used to supply a descriptive name to a set of related groups of jobs. Name of a file containing a job script that is used as a filter criterion. Name of an application that is used as a filter criterion.Figure 9-5 Jobs List Window Table 9-5 Jobs List Window Elements Element Filter Jobs List Job Name Mem Name Mem Lib Group Application Description Enables filtering of displayed jobs. Inc. For more information. Name of a group of jobs that is used as a filter criterion. see page 9-26. BMC Software..

Note You can use an asterisk (*) as a wildcard. The filter fields are enabled.. BMC Software. Note Click Clear to remove filter criteria from the filter fields. Applies the specified filter. Enter valid values into any or all of the filter text boxes. Closes the Jobs List window. Confidential and Proprietary Information 9-26 CONTROL-M/Desktop User Guide . All applicable jobs in the Scheduling table are displayed. 3.Table 9-5 Jobs List Window Elements Element Clear Apply Close Description Clears filter criteria from the filter fields. Click Apply to apply the filter. To display selected jobs in the Jobs List window: 1. 2. Inc. Job parameters and their valid values are described in the CONTROL-M Job Parameter and Variable Reference Guide. Select the Filter Jobs List check box.

2..To display and modify details for a job or Group Scheduling table: Note Any changes made to a definition are applied to the Active environment. containing the values for the selected job. Confidential and Proprietary Information Working with Scheduling Tables 9-27 . 1. Inc. Note The Save to Database button replaces the Save to Draft button when the Job Editing form and the Group Editing form are opened from the Jobs List window. Users with Update authorization or higher can modify the job or Group Scheduling table parameter fields. The Job Editing form (Group Editing form) is displayed. Double-click on a job (or Group Scheduling table) in the list. with the following exceptions BMC Software.

The modifications to the job or Group Scheduling table definition are saved to the CONTROL-M/Enterprise Manager database. The Group parameter describes the Group Scheduling table. the Table and Group fields cannot be modified. the Table and Scheduling Table Library (OS/390 only) fields cannot be modified. Confidential and Proprietary Information 9-28 CONTROL-M/Desktop User Guide . • 3. itself.• When the Job Editing form is displayed. and the Group Scheduling table is already associated with the Scheduling table from which the Jobs List window was displayed. Inc. BMC Software. Click Save to Database. When the Group Editing form is displayed. The job is already associated with the Scheduling table (and Library) from which the Jobs List window was displayed.. Note None of the jobs in the jobs list can be modified if another user is already editing one of the jobs in the same Scheduling table.

BMC Software.. Months). and so on. holidays. Days or Calendar).10 Working with Calendars 10 A calendar contains a list of dates. accounting dates. usually spanning a number of months or years. Uploading and downloading of calendars is discussed in “Table Synchronization” in the CONTROL-M/Enterprise Manager User Guide. If no calendar is specified. it must be uploaded to the CONTROL-M/Server database of the appropriate CONTROL-M installation. A new or modified calendar is saved in the CONTROL-M/EM database.. Specific days in a calendar can be designated as working days. CONTROL-M uses three types of calendars. each calendar is used to specify a different set of dates. The dates on which a job can be ordered are limited by the calendars named in the scheduling parameters of the job processing definition (e. which are described in Table 10-1.g. in your data center.g. that can be used to determine when a job can and cannot be scheduled. the job is ordered only on the basis of other scheduling parameters (e. Days.. Confidential and Proprietary Information Working with Calendars 10-1 . Inc. Any number of calendars can be defined. Typically. before a calendar can be referenced from a job processing definition.

A relative calendar is combined (using the CONTROL-M IOABLCAL utility) with a regular calendar or with another relative calendar to generate a new regular calendar. [OS/390] A relative calendar is one which is intended for use in conjunction with another calendar. A job whose job processing definition points to a calendar in the Days Calendar and/or Week Days Calendar parameter is ordered based on the set of dates in that calendar. For examples of how calendars are used to schedule jobs. 20 periods. The new calendar that results from this process is a combination of the two calendars input to the utility. and so on). 13 periods. A periodic calendar is used in conjunction with the Days or Week Days parameters to specify on which dates a job should be ordered. refer to the CONTROL-M for OS/390 User Manual. Inc. Periods do not have to be specified using consecutive dates. Note: Each period can be up to a maximum of 255 days in length. A periodic calendar can be used to divide the year into working periods (that is. [OS/390] For examples of how calendars are used to schedule jobs under OS/390.Table 10-1 Calendar Types Calendar Type Regular Description A regular calendar consists of a succession of dates. Each period can be the same or different in length. refer to the description of the Days Calendar parameter in CONTROL-M Job Parameter and Variable Reference Guide. and they can overlap. BMC Software. instead of into twelve months. For more information regarding relative calendars and examples of how the IOABLCAL utility is used.. Other Scheduling parameters can be used in conjunction with a regular calendar to further control the dates on which the job is ordered. Relative Periodic A job processing definition that points to a calendar from the Days Calendar And/Or Week Days Calendar parameter is ordered based on the dates in that calendar. Confidential and Proprietary Information 10-2 CONTROL-M/Desktop User Guide . Other Scheduling parameters can be used with a calendar to further control the dates on which the job is ordered. refer to the description of Basic Job Scheduling Parameters in Section 3 of the CONTROL-M for OS/390 User Manual. specifying when a job can or cannot be ordered.

This utility produces a report that indicates when jobs in a selected Scheduling table are scheduled to run. run the CTMRPLN utility. The Communication Login window is displayed. Inc. Upload calendars from the CONTROL-M/EM database to the CONTROL-M/Server database. BMC Software. • • Opening the Calendars window Use the following steps to open the Calendars window: 1. see the Utilities references in the CONTROL-M/Server Administrator Guide and the CONTROL-M for OS/390 User Manual. For more information about the CTMRPLN utility. or choose Edit => Calendar Manager. In this window. Click . you can: • • Delete existing calendars. Confidential and Proprietary Information Working with Calendars 10-3 .To see the effect of a calendar on a job’s schedule plan. Managing Calendars Calendars are listed in the Calendars window. Download calendars from the CONTROL-M/Server database to the CONTROL-M/EM database.. Define new calendars and edit existing calendars in the Calendar Definition window.

“Command Buttons – Command Buttons.” 3. “Communicating with CONTROL-M/EM. Fields of the Calendars Manager Window • The columns in the Calendars Manager window are described in Table 10-2. the connection with CONTROL-M/EM is broken. The Calendars Manager window is displayed. These buttons are described in Table 10-3.2. Buttons on the right side of this window offer a wide variety of actions that can be performed on calendars selected in this window. use the Connect feature described in Chapter 3. • Figure 10-1 Calendars Manager Window BMC Software. Inc. You optionally establish a connection that is closed only when you specify.” on page 10-6. Click Login. Enter your username and password and the name of the server to which you are connecting. Confidential and Proprietary Information 10-4 CONTROL-M/Desktop User Guide .. Note When you close the Calendars Manager window.

This is the name by which the calendar is specified in the job processing definition. Confidential and Proprietary Information Working with Calendars 10-5 . A calendar can be modified by only one user at a time. Name of the CONTROL-M/EM user currently modifying the calendar..Table 10-2 Column Descriptions – Calendars Manager Window Column CONTROL-M Calendar Description Name of the CONTROL-M to which the calendar belongs. Regular. Inc. Yes indicates that the calendar has been modified on the CONTROL-M/EM workstation but not yet uploaded to the CONTROL-M. or Periodic. Type of calendar. Locked by Last Upload Modified Type BMC Software. User-defined name of the calendar (maximum of 10 characters). Relative. Date and time of last upload (or download) of the calendar between CONTROL-M/EM and the CONTROL-M/Server database in the indicated installation.

Upon completion. the Modified field changes to No. Note: To delete a Calendar in the CONTROL-M/Server database that was modified more recently than the one in the CONTROL-M/EM database use the Force Delete option. Deletes the selected Calendar from the CONTROL-M/EM and CONTROL-M/Server databases. allowing the user to perform other actions during transmission. Upon completion. Confidential and Proprietary Information 10-6 CONTROL-M/Desktop User Guide . Deletes the Calendar from the CONTROL-M/EM database.. Delete the Calendar from both the CONTROL-M/EM and CONTROL-M/Server databases. Copies the selected calendar to the indicated CONTROL-M/Server database. This restriction can be overridden using the Force Upload option (described below). The upload takes place as a background process. For additional information. The upload takes place as a background process. If the calendar in the CONTROL-M/Server database is a later version. Opens the Calendar Definition window to update the selected calendar. Copies the selected calendar to the indicated CONTROL-M/Server database. Deletes the Calendar from the CONTROL-M/Server database. Inc. a message appears indicating that the Upload is not allowed.Table 10-3 Command Buttons – Command Buttons (Part 1 of 2) Button New Delete Force Delete Description Opens the Calendar Definition window to define a new calendar. regardless of whether a later version of the Calendar exists in the CONTROL-M/Server database. Local Delete Remote Delete Update Upload Force Upload BMC Software. see “Table Synchronization” in the CONTROL-M/Enterprise Manager User Guide. regardless of whether or not a later version of the calendar exists in the CONTROL-M/Server database. allowing the user to perform other actions during transmission. the Modified field changes to No.

Upon completion. To download a calendar that does not appear in the Calendar Manager window (and therefore cannot be selected). Refresh the status of calendars in the window. The download takes place as a background process. “Lock/Unlock”. the Modified field changes to No. Confidential and Proprietary Information Working with Calendars 10-7 . allowing the user to perform other actions during transmission. See “Chapter 9. Unlock Refresh BMC Software. Unlocks the selected calendar to allow modification by a different user. Inc.Table 10-3 Command Buttons – Command Buttons (Part 2 of 2) Button Download Description Copies the selected calendar from the CONTROL-M/Server database to the CONTROL-M/EM database. for an explanation of this feature.. first create the calendar (using the Calendar Definition window) and then download the calendar normally.

Defining Calendars The Calendar Definition Window enables the user to define new calendars and edit existing calendars.. Confidential and Proprietary Information 10-8 CONTROL-M/Desktop User Guide . Inc. This window is displayed by clicking either New or Update in the Calendars window. Figure 10-2 Calendar Definition Window BMC Software.

. When you have finished selecting dates in the new calendar. Confidential and Proprietary Information Working with Calendars 10-9 . 4. Modify the calendar criteria as described in “Defining Calendar Criteria” on page 10-10. 3. Select a calendar in the Calendar Manager window. Click New in the Calendars window. The Calendar Definition window is displayed for the selected calendar. Define the calendar criteria as described in “Defining Calendar Criteria” on page 10-10. Specify the CONTROL-M and a name for the new calendar. BMC Software. click OK in the Calendar Definition window to create the calendar in the CONTROL-M/EM database. Indicate whether the calendar is Regular. The Calendar Definition window is displayed (see Figure 10-2 on page 10-8). Inc. To modify an existing calendar: 1. Relative or Periodic. 3. Click Update. Click OK. The following dialog box is displayed: 2.To define a new calendar 1. 2.

select the year from the drop-down list in the upper left of the Calendar Definition window. For CONTROL-M to use a calendar. Changes are saved to the CONTROL-M/EM database. Confidential and Proprietary Information 10-10 CONTROL-M/Desktop User Guide . Inc. The text is saved when you click OK. click New. This definition is specified in text box (labeled Description) in the upper portion of the calender definition window. If a calendar for the required year has not been defined. and specify the year. The following paragraphs describe the different types of calendar criteria and how they can be specified in the Calendar Definition window (Figure 102 on page 10-8). Selecting years for a calendar: Each calendar can span one or more years.4.. BMC Software.. Defining Calendar Criteria Calendar criteria can be defined in a variety of different ways. it must be uploaded to a CONTROL-M/Server database (for example.. General Calendar Criteria Adding a description to a calendar: A free text description can be saved for each calendar. To edit an existing year in the calendar. using the Upload button in the Calendars window). Note The Calendar Definition window saves calendars only to the CONTROL-M/EM database. Click OK.

Criteria for Regular or Relative Calendars

In regular calendars dates on which the job can be ordered, are marked by a Y. In a relative calendar, they are marked by Y, + or -. Dates that contain the actual date (a number) indicate dates on which the job cannot be ordered. This is equivalent to the value N for that date. For more information about symbols and colors in the calendar, see “Dates and Colors” on page 10-13.
To mark a date in the calendar:

1. Click the date and type Y, + or -. The selected mark and an appropriate color appear in place of the date and the cursor is advanced to the next date. -orRight-click the date and select an option from the popup menu (N, Y, +, -). The selected mark and color appear in place of the date and the cursor is advanced to the next date. 2. To unmark a date, click the selected date again and change the mark to N. The actual date is then displayed.
To select all weekdays in a month:

Click the column heading for the appropriate day. For example, click M to select all Mondays in the month.
To select an entire week in a month:

Click the button to the left of a calendar week to select the entire week.
Note

The number in the week button indicates the date of the first day in that week.
To select an entire month:

Click the top left button of the month.
BMC Software, Inc., Confidential and Proprietary Information

Working with Calendars

10-11

Criteria for Periodic Calendars

Dates in a periodic calendar are marked by a periodic identifier. These identifiers can be any character except Y, N, +, or -.
To specify a periodic identifier

1. Click a date and type a periodic identifier (any character except Y, N, + and -). 2. To unmark a date, click the selected date again and either right-click or press the <Del> key to remove the identifier.
Note

Each period can be up to a maximum of 255 days in length.

To apply General Calendar criteria to every month in a year:

1. Click the Advanced button. The General Calendar definition window opens.

2. Select the date(s) in the Month or select the day(s) of the Week. 3. Click OK. All the selected dates are highlighted each month in the Calendar Definition window.

BMC Software, Inc., Confidential and Proprietary Information

10-12

CONTROL-M/Desktop User Guide

4. Type the desired mark (Y, + or -) or periodic identifier or right-click to open and select an option from the pop-up menu (N, Y, +, or -). The selected mark and color appear in place of the dates.
Dates and Colors

The characters and colors displayed in regular, relative and periodic calendars indicate how a job should be handled on each date. The meaning of each character and color is as follows:
Table 10-4 Dates and Colors

Mark
Date (N)

Color

Type
Regular, Relative or Periodic

Description
The job cannot be ordered on this date.

Y –

Green Pink

Regular or Relative Relative

The job can be ordered on this date. For OS/390 jobs only. When matched against a Y in the associated calendar by the IOABLCAL utility, causes the generated calendar to have a Y in the corresponding date. When not matched against a Y, causes the generated calendar to have a Y on the nearest prior working date. For OS/390 jobs only. When matched against a Y in the associated calendar by the IOABLCAL utility, causes the generated calendar to have a Y in the corresponding date. When not matched against a Y, causes the generated calendar to have a Y on the nearest following working date. Dates are marked with unique period identifiers. Identifiers can be any character except Y, N, + and -. Each identifier has its own unique color. Note: Each period can be up to a maximum of 255 days in length.

+

Yellow

Relative

*

different color for each period

Periodic

BMC Software, Inc., Confidential and Proprietary Information

Working with Calendars

10-13

BMC Software, Inc., Confidential and Proprietary Information

10-14

CONTROL-M/Desktop User Guide

11

CONTROL-M Definitions and Validity Checks 11
The following topics are described in this chapter: • • “CONTROL-M Definitions” on page 11-1 “Validity Checking” on page 11-4

CONTROL-M Definitions
CONTROL-M/Desktop identifies each job processing definition being edited or created with a specific CONTROL-M installation. The definition of the related CONTROL-M installation determines the format of the Job Editing form to be displayed and the required validity checks to be performed for the job processing definition. CONTROL-M installations are defined to CONTROL-M/Desktop using the CONTROL-M window. Each CONTROL-M represents a single CONTROL-M on a specific platform. When a scheduling table is downloaded, CONTROL-M/Desktop checks for the appropriate CONTROL-M name and associated platform in the existing CONTROL-M definitions. If no appropriate definition exists, a new one is created for this CONTROL-M installation. Additional fields describing the CONTROL-M installation may need to be updated in the CONTROL-M window.
BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M Definitions and Validity Checks

11-1

To define a CONTROL-M to CONTROL-M/Desktop:

1. Select Edit => CONTROL-M Definitions from the menu bar.

2. Click Add. The following dialog box is displayed:

3. Fill in the fields of this dialog box as indicated in Table 11-1.

BMC Software, Inc., Confidential and Proprietary Information

11-2

CONTROL-M/Desktop User Guide

Table 11-1

Fields in the CONTROL-M Dialog Box

Field
Name

Description
Enter the name of the CONTROL-M. This name is used by CONTROL-M/Desktop only. It will appear in the drop-down list for the CONTROL-M field in the Job Editing form. It is a required field for the Validity Checks function (described on page 11-4). Select the type of platform (MVS, Unix/NT/TANDEM, VAX/VMS, or iSeries (AS/400)). Version number of the CONTROL-M at the specified installation. iSeries (AS/400): When defining an iSeries (AS/400) data center, select 224 (or 225, if available). Indicates if all parameters in the Job Editing form for this CONTROL-M must be in uppercase. For most installations this option should not be selected. Indicates the first day of the week for use in the Week Days field in the Job Editing form. Note: The day selected in this field is used to ensure that the display of calendars for this CONTROL-M are properly adjusted. However, this value is not passed back to the CONTROL-M installation. Use the ctmsys utility, to ensure that the start day of the week for the CONTROL-M installation is the same as the value specified in this field. For OS/390 platforms only: Indicate which other CONTROL-M products are installed with CONTROL-M for OS/390 and z/OS: (CONTROL-M/Restart, CONTROL-M/Analyzer, or CONTROL-M/Tape).

Type Version

Uppercase Only Start Day of the Week

Installed Products

4. Click OK to add the CONTROL-M to CONTROL-M/Desktop. 5. Click OK to save the changes and close the window.
To modify an existing CONTROL-M definition:

1. Select Edit => CONTROL-M Definitions from the menu bar. 2. Select the CONTROL-M definition to be updated and click Update.

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M Definitions and Validity Checks

11-3

3. Modify the fields in the CONTROL-M window and click OK.
To delete a CONTROL-M from CONTROL-M/Desktop:

1. Select the CONTROL-M and click the Remove button. A confirmation window is displayed. 2. Indicate whether you want to Remove all jobs from this CONTROL-M in the current Draft and click OK.

Validity Checking
One of the advantages of CONTROL-M/Desktop is that it can work with job processing definitions independently of CONTROL-M. This allows you to create and update job processing parameters without having to undergo validity checks that occur in CONTROL-M/Enterprise Manager (CONTROL-M/EM). This means that you can work much faster, especially when creating multiple jobs using the Mass Create facility (described in Chapter 7, “Creating and Updating Multiple Jobs”).
Note

This does not mean that job processing definitions should not be checked for validity before they are used in the production environment. After job processing definitions are created or updated, they should be checked before they are written to the CONTROL-M/EM database. This section describes a CONTROL-M/Desktop facility that is used for checking validity of new and updated job processing definitions.
To check the validity of all jobs in a Draft:

1. Open the Draft. 2. Choose Tools => Validity Checks or click .

BMC Software, Inc., Confidential and Proprietary Information

11-4

CONTROL-M/Desktop User Guide

CONTROL-M/Desktop checks all parameters in all job processing definitions in the Draft and displays the errors in a messages window.
Figure 11-1 Validity Check – Messages Window

To correct the errors found during a validity check:

Use either of the following methods to correct errors found during a validity check: • Double-click the Job Name in the Messages window to open the Job Editing form for the job. Make the necessary corrections and then click OK to save the changes to the job definition. Choose Tools => Mass Update or click .

These actions start the Mass Update facility, and can be used to correct common errors in multiple jobs in the draft. For more information, see Chapter 7, “Creating and Updating Multiple Jobs.”

BMC Software, Inc., Confidential and Proprietary Information

CONTROL-M Definitions and Validity Checks

11-5

For more information about this option. see Chapter 12.Checking Validity by Default CONTROL-M/Desktop can optionally validate all parameter values in the Job Editing form when each time it is used to open or create a job processing definition.” Note This option should not be set when using the Mass Create or Mass Update facilities. Confidential and Proprietary Information 11-6 CONTROL-M/Desktop User Guide . BMC Software. “Customization. Inc. This option is set using Tools=>Options =>General=>Validity Checks option..

BMC Software.12 Customization 12 This chapter describes the various way in which CONTROL-M/Desktop can be customized for your site. Confidential and Proprietary Information Customization 12-1 . Choose Tools => Options to display the Options dialog box. This information includes: • • The options dialog box. This dialog box has the following panels: • General General defaults for the CONTROL-M/Desktop environment. Flowdiagram Default features for Flow Diagram view. Inc.. • Each of these panels is described in detail on the following pages. Modifying display of CONTROL-M/Desktop toolbars Options Dialog Box A wide variety of CONTROL-M/Desktop settings can be modified using the Options dialog box.

Confidential and Proprietary Information 12-2 CONTROL-M/Desktop User Guide . Figure 12-1 Options Dialog Box – General Panel The fields of this panel are described in Table 12-1. Inc.. BMC Software.General Panel The General panel is used to specify various miscellaneous options.

indicates that CONTROL-M/Desktop should automatically check the validity of parameter values as they are entered in the Job Editing form. actions can be undone and redone. diagnostic information is collected regarding CONTROL-M/Desktop functioning. Inc. The default directory to which Drafts are saved. Controls the Undo feature for the Job Editing form. see “Job Skeletons” on page 7-4 and “Updating Multiple Jobs and Group Scheduling Tables” on page 7-18. For more information. Validity checks can also be performed on all jobs in a Draft using the Tools => Validity Checks option. When the Enable checkbox is selected. Confidential and Proprietary Information Customization 12-3 . JEF Undo Mass Job Create/Update Load or Save Drafts Diagnostics BMC Software. Default: 100. These fields should be used only if requested by Technical Support. Indicates the current value of the {Counter} variable used by the Mass Job Create and Mass Job Update facility. see “Validity Checking” on page 11-4. Note: Enabling diagnostics slows down performance. For more information. see “Undo and Redo in the Job Editing Form” on page 5-5.Table 12-1 General Panel – Options Dialog Box (Part 1 of 2) Field Job Validity Description When the Always check the validity of jobs checkbox is selected. • When the Enable checkbox is selected. For more information. The Context and Level fields are used to indicate additional information about the type of information that should be collected. • The Undo Size field determines the number of levels of Undo that can be performed..

A Start Day of the Week can also be specified for each CONTROL-M using the CONTROL-M Definition window. The value in the CONTROL-M definition window overrides the default value specified in the Options dialog box.. This is the default value used for all data centers. • Automatic Connection. see Chapter 3. CONTROL-M/Desktop opens and closes the connection as communication as necessary depending on selected actions. • Manual Connection.” Connection Mode BMC Software. Confidential and Proprietary Information 12-4 CONTROL-M/Desktop User Guide . “Communicating with CONTROL-M/EM. Inc. Determines how CONTROL-M/Desktop should connect to CONTROL-M/EM. CONTROL-M/Desktop maintains an open connection with the CONTROL-M/EM GUI Server until the user closes the connection. For more information.Table 12-1 General Panel – Options Dialog Box (Part 2 of 2) Field Default Start Day of the Week Description Indicates the first day of the week for use in the Week Days field in the Job Editing form.

see “To open the Job Editing form from List mode:” on page 4-25. BMC Software. For more information about the flow diagram. Inc. Confidential and Proprietary Information Customization 12-5 .. Figure 12-2 Options Dialog Box – Flowdiagram Panel The fields of this panel are described in Table 12-2.Flow Diagram Panel The Flowdiagram panel defines characteristics of the CONTROL-M Flow Diagram view.

Confidential and Proprietary Information 12-6 CONTROL-M/Desktop User Guide .. indicates that conditions should be displayed as nodes (including the condition name.Table 12-2 Flowdiagram Panel – Options Dialog Box (Part 1 of 3) Field Job Node Settings Description Determine what information (what job processing parameter) will be displayed in Job nodes. Inc. The jobname. Default: Overlib First Field Second Field Conditions Determine how to display prerequisite conditions in the flow diagram. Note: These fields do not affect the display of condition nodes. conditions are displayed as lines between the predecessor and successor jobs. or Description can be displayed. Default: Memlib Indicates what to display in the second field of the node body. and CONTROL-M nodes in the Flow Diagram. application nodes. Display DoConditions (as links or nodes) BMC Software. Memname. Node Title Indicates what information will be displayed in the title bar of the node. indicates that conditions created using the Do Condition parameter should be displayed in the same way as those created by the Out statement. Default: Name Indicates what to display in the first field of the node body. group nodes. By default. When selected. Display condition nodes When selected.

see ‘Step In/ Step Out" in the CONTROL-M/ Enterprise Manager User Guide. Deletes both the In condition and the Out condition. Expand-item Expand or Collapse function. Default.Table 12-2 Flowdiagram Panel – Options Dialog Box (Part 2 of 3) Field Double Click Action Description Indicates what function should be performed when a node is double-clicked in the Flow Diagram. StepInto item Delete Dependency Indicates what action the Delete Dependency feature performs. Step In function. For more information. see page 4-51. or collapses the selected node to hide all lower levels.. Displays the Delete Dependency dialog box. OUT cond Ask what to delete BMC Software. when Delete Dependency is selected from a condition line popup menu. Delete IN. Expands the selected node to display levels lower than the current selected node. Note: This option is not available when condition nodes are displayed. For more information. Changes the Flow Diagram to display nodes one level lower than the current selected node. Confidential and Proprietary Information Customization 12-7 . Delete IN cond Deletes the In condition. when Delete Dependency is selected from a condition line popup menu. Inc.

Node Shape Indicates the shape for nodes in the flow diagram. (for prerequisite conditions) Color for lines between connectors. • Rounded displays nodes with rounded corners. Background Group/ Application Connector Dependency Frames Conditions BMC Software. Color for group and application nodes. Confidential and Proprietary Information 12-8 CONTROL-M/Desktop User Guide . Color for In/Out connector triangles. Color for condition nodes.. Inc. Color for frames surrounding nodes in Flow Diagram view and in Net Overview.Table 12-2 Flowdiagram Panel – Options Dialog Box (Part 3 of 3) Field Colors and Shapes Description Indicate the shapes and colors to be used for the various components of the flow diagram. Color for the Flow Diagram background. • Rectangular displays nodes with square corners.

Zoom In. Edit Skeleton. Copy Tags. BMC Software. and Application Hierarchy. The Toolbars dialog box is displayed: Table 12-3 Toolbar Contents (Part 1 of 2) Toolbar General Tree Flowdiagram Communication Tools Contents New. Mass Update.Viewing Toolbars The buttons in the CONTROL-M/Desktop window are arranged in several different toolbars that can be displayed or not displayed depending on your preference. Delete Job. New Job. Open. To modify the Toolbar display: 1. Confidential and Proprietary Information Customization 12-9 . Zoom Out.. and Validity Check. Edit Calendars. Copy. Write. Scheduling Table Manager. Mass Job Creation. Connect. and Step Out. Choose Edit => Toolbars. Flowdiagram Zoom. and Disconnect Current Skeleton list. Inc. and New Scheduling Group CONTROL-M Hierarchy. Arrange All Items. Save. Edit Collection. Step In. Read.

Table 12-3 describes the contents of each toolbar.Table 12-3 Toolbar Contents (Part 2 of 2) Toolbar Wizard Mouse pointer modes Contents Starts the Wizard. Select the toolbars to be displayed. Selection mode 2.. Definition mode. Click the Close button. Confidential and Proprietary Information 12-10 CONTROL-M/Desktop User Guide . Inc. 3. BMC Software.

Before printing. To preview the flow diagram to be printed 1. Click in the flow diagram to select the flow diagram window. The Print Preview window is displayed: BMC Software.13 Printing Facility 13 You can print the contents of Flow Diagram view to a selected printer at any time during a CONTROL-M/Desktop session. Previewing a Flow Diagram Print Preview allows you to preview the flow diagram before printing. you can preview the report using the Print Preview option. 2. Confidential and Proprietary Information Printing Facility 13-1 . You can also choose to print only selected portions of the flow diagram. Display the flow diagram you want to print. 3. Choose File => Print Preview.. Inc.

Table 13-1 Print Preview – Buttons Button Print. Displays the current page at a larger magnification. Click Print to open the Print Window and print the flow diagram.. Next Page Prev Page Two Page Zoom In Zoom Out Close Description Opens the Print window. or click Close to return to the CONTROL-M/Desktop window. 4.. Closes the Print Preview window and returns to the main CONTROL-M/Desktop window. Toggles between a one page view and a two-page view. Note If necessary.. BMC Software. you can return to the Flow Diagram view and modify the display of the flow diagram before printing. Inc. Displays the page after the currently displayed page. Confidential and Proprietary Information 13-2 CONTROL-M/Desktop User Guide . Displays the page preceding the currently displayed page.Figure 13-1 Flow Diagram Print Preview Window The buttons in this window are described in Table 13-1. Displays the current page at a smaller magnification.

5. BMC Software. 4. Use the Next Page. Confidential and Proprietary Information Printing Facility 13-3 .. Choose File => Print to display the Print window and click OK. Inc. 2. In the from and to text boxes. The Print Preview window is displayed (Figure 13-1 on page 13-2). Prev Page. Make a note of the desired page numbers. to display the page(s) of the flow diagram that you wish to print. Display the flow diagram. Click in the flow diagram to select the flow diagram window. 6. Display the flow diagram.Printing the Flow Diagram To print an entire flow diagram: 1. and Two Page buttons. 2. In the Print window. The Print Preview window closes automatically. select the Pages option in the Print Range section of the Print window. 3. 7. enter numbers of the first and last pages in the range of pages you wish to print and click OK. Click in the flow diagram to select the flow diagram window. 3. To print selected pages of the flow diagram: 1. Click Print to display the Print Window. Choose File => Print Preview.

Inc. Confidential and Proprietary Information 13-4 CONTROL-M/Desktop User Guide ..BMC Software.

Options dialog box 12-3 and parameter Group Editing form 6-9 and/or options conditions panel 5-26 Scheduling panel 5-14 Application icon in tree view 4-17 Application hierarchy description 1-7.. 11-3 In conditions in mass update 7-25 jobs in flow diagram 4-37 jobs to a collection 8-5 Schedule tags 5-52 Adjust Condition parameter Group Editing form 6-6 Always check the validity. Collection criteria 8-5 adding BMC Software. See ERP Symbols + symbol condition format 7-14 Mass Update form 7-21 skeleton editor value 7-13 < symbol Mass Update form 7-20 = symbol Mass Update form 7-20 > symbol Mass Update form 7-20 A action statements.. 4-16 Application parameter Group Editing form 6-6 Job Editing form 5-9 Job Editing form (OS/390) 5-11 moving a job 4-19 application support import application forms 4-11 Application Type field Skeleton Editor form 7-6 applications.. See Do statements actions undoing and redoing 5-5 Add matching jobs . Inc..Index Index ..symbol condition format 7-14 Mass Update form 7-21 skeleton editor value 7-13 CONTROL-M definitions 11-2. Confidential and Proprietary Information Index 1 .

Tree view 4-18 buttons in toolbars 12-9 Schedule Tags panel 6-7 Scheduling Tables window 9-19 shout statements 5-48. skeleton fields 7-8 closing.Apply button skeleton Editor 7-12 Arg field DO CTBrule parameter 5-45 Arrange All function flow diagram 4-22 AS/400.. 10-2 years 10-10 Calendars column Calendars window 10-5 Category parameter Job Editing form 5-23 cleanup. See iSeries (AS/400) Author parameter Job Editing form 5-8 AutoArchive field Sysout handling 5-50 AutoEdit variables for jobs in a group 6-17 in Job Editing form 5-30 Set panel (groups) 6-17 Automatic Connection option Options dialog box 12-4 B Background field Options dialog box 12-8 basic scheduling parameters Job Editing form 5-13 Big Icon option Editing View pop-up menu 4-7 Boolean. See maintenance clearing. Inc. 6-10 dates and colors 10-13 Days Calendar parameter 10-2 defining 10-10 deleting 10-6 description 10-1 downloading 10-7 general criteria 10-12 month days 5-14. See and/or branch. See exiting codes step codes 5-41 sysout options 5-37. 6-10. 6-20 step codes 5-42 step range definition 5-40 C Calendar Definition window 10-8 Calendar Manager commands 10-6 definition window 10-8 description 10-3 fields 10-5 window 10-3 calendars adding a description 10-10 Calendar Definition window 10-8 Calendar Manager 10-3 Calendars window 10-3 confcal parameter 5-15. 5-45 BMC Software. Confidential and Proprietary Information 2 CONTROL-M/Desktop User Guide . 6-9 periodic 10-2 regular 10-2 relative 10-2 selecting a month 10-11 selecting a week 10-11 unlocking 10-7 updating 10-9 uploading 10-6 weekdays 5-15.

Codes parameter Job Editing form 5-43 collapsing. Inc. Confidential and Proprietary Information identifying dependent jobs 4-42 Job Editing form 5-25 Conditions panel Group Editing form 6-12 Job Editing form 5-25 Confcal parameter detailed description 5-18 Group Editing form 6-10 Job Editing form 5-15 Confirm parameter Group Editing form 6-6 Job Editing form 5-22 connection automatic communication mode 3-3 changing GUI Servers 3-6 changing login properties 3-6 choosing a connection mode 3-4 Connection Mode (Options) 12-4 manual communication mode 3-3 to CONTROL-M/EM 3-3 to GUI Server (Communication menu) 3-5 Connector field Options dialog box 12-8 Control resources Job Editing form 5-28 CONTROL-B invoking a rule 5-45 with CONTROL-M 11-3 CONTROL-D Category parameter 5-23 CONTROL-M definitions window 11-2 field in Scheduling Table details 9-22 field in Scheduling Tables window 9-18 hierarchy 4-16 icon in tree view 4-16 in Calendars window 10-5 in Job Editing form 5-9 in Scheduling Tables window 9-18 Index 3 . 9-4 with CONTROL-M/EM 3-3 Communication Login window 3-5 Communication menu Connect to GUI Server 3-5 Communication toolbar 12-9 components CONTROL-M/Desktop 1-3 Condition Format field creating conditions in flow diagram 4-49 conditions See also prerequisite conditions color options 12-8 creating in flow diagram 4-48 delete options 4-53 deleting 4-51 display options 12-6 BMC Software. See stepping out Collection option job menu 8-2 Mass Update form 7-19 Collections applying criteria 8-5 defining criteria 8-2 description 8-1 colors calendars 10-13 flow diagram 12-8 Colors and Shapes fields Options dialog box 12-8 columns Scheduling Tables window 9-18 Command parameter Job Editing form 5-9 Command tasktype Job Editing form 5-8 communication logging in to CONTROL-M/EM 3-1..

9-4 server name 3-2 CONTROL-M/EM menus Communication menu 4-12 descriptions 4-9 Edit menu 4-9 File menu 4-9 Tools menu 4-11 View menu 4-10 CONTROL-M/Server utilities scheduling 5-54 CONTROL-R with CONTROL-M 11-3 CONTROL-T with CONTROL-M 11-3 copying jobs in flow diagram 4-37 correcting job definition errors 11-5 Counter function skeleton editor 7-13 creating See also defining conditions in a flow diagram 4-48 dependencies in Definition mode 4-34 Drafts 4-14 Group Scheduling table 4-46 job dependencies 4-48 multiple jobs 7-1 new jobs 4-34 Scheduling tables 9-22 skeletons 7-7 Critical parameter Job Editing form 5-22 customizing CONTROL-M/Desktop 12-1 flow diagram color 12-8 toolbars 12-9 Cyclic parameter Job Editing form 5-22 D datacenter definition. See CONTROL-M definition date reference In conditions (groups) 6-13 In conditions (jobs) 5-26 Dates parameter Group Editing form 6-10 Job Editing form 5-15 days weekdays 5-14 weekdays parameter 6-10 debugging CONTROL-M/Desktop diagnostics 12-3 Default Start Day of the Week field Options dialog box 12-4 defining See also creating group conditions 6-13 job conditions 5-26 Schedule tags 6-8 step codes 5-41 step range 5-40 variables for a job 5-30 BMC Software.OS/390 job parameter 5-11 parameter (moving a job) 4-19 parameter in Group Editing form 6-6 CONTROL-M/Desktop components 1-3 customizing 12-1 description 1-1 exiting 4-15 feature list 1-1 installation 1-1 toolbars 12-9 window description 4-1 window forms 4-13 CONTROL-M/EM logging in 3-1.. Inc. Confidential and Proprietary Information 4 CONTROL-M/Desktop User Guide .

Confidential and Proprietary Information Detached task type Job Editing form 5-8 Diagnostics Options dialog box 12-3 Disconnect from GUI Server option Edit menu 3-6 disconnecting from CONTROL-M/EM 3-3 Display 4-50 Display condition nodes Options dialog box 12-6 Display Do-Conditions Options dialog box 12-6 displaying See also viewing condition nodes 4-55 items in Tree view 4-18 list of Scheduling tables 9-18 Do AutoEdit parameter Group Editing form 6-24 Job Editing form 5-36 Do Condition parameter Group Editing form 6-25 Job Editing form 5-46 Do Conditions displaying in flow diagram 4-50 Do CTBRule parameter Job Editing form 5-45 Do Force-job parameter Group Editing form 6-24 Job Editing form 5-37. 5-43 Do OK parameter Group Editing form 6-24 Job Editing form 5-36.. Inc. 5-44 Do Ifrerun parameter Job Editing form 5-46 Do NOTOK parameter Group Editing form 6-24 Job Editing form 5-36.Definition mode choosing 4-35 description 4-34 Delete button Calendars window 10-6 Scheduling Tables window 9-19 delete dependency configuring 4-53. 12-7 description 4-51 deleting calendars 10-6 CONTROL-M definitions 11-4 data from In conditions 7-26 Group Scheduling table 4-47 in the skeleton editor 7-12 job dependencies 4-51 jobs in flow diagram 4-38 jobs in List view 4-25 jobs in Tree view 4-21 Schedule tags 5-52 Scheduling tables 9-19 skeletons 7-8 step ranges 5-40 dependencies See also In conditions See also job dependencies See also Out conditions condition nodes 4-55 creating 4-48 creating in Definition mode 4-34 in Flow Diagram view 4-28 job skeletons 7-13 viewing 4-50 Dependency field Options dialog box 12-8 Description parameter calendars 10-10 Group Editing form 6-6 Job Editing form 5-9 Job Editing form (OS/390) 5-11 BMC Software. 5-43 Do Rerun parameter Index 5 .

. 5-44 Do Shout parameter Group Editing form 6-24 Job Editing form 5-36. Inc. See ERP equal sign (=) Mass Update form 7-20 ERP Application Type field 7-6 Job Editing form 5-12 errors validity checking 11-5 examples collection criteria 8-5 mass job creation 7-3 EXECTIME Shout When parameter (groups) 6-20 Shout When parameter (jobs) 5-49 Execution panel description 5-21 exiting CONTROL-M/Desktop 4-15 BMC Software. Confidential and Proprietary Information 6 CONTROL-M/Desktop User Guide . 5-44 Do statements Group Editing form 6-23 in Job Editing form 5-34. 5-44 Do Set-Var parameter Group Editing form 6-24 Job Editing form 5-36. 5-45 Doc Lib parameter Job Editing form 5-9 Job Editing form (OS/390) 5-11 Doc Mem parameter Group Editing form 6-6 Job Editing form 5-9 Job Editing form (OS/390) 5-11 documentation Doc Lib parameter 5-9 Doc Mem parameter 5-9 double-click action Options dialog box 12-7 Download button Calendars window 10-7 Scheduling Tables window 9-20 downloading calendars 10-7 Scheduling tables 9-20 drafts creating 4-14 description 9-3 filtering 8-1 opening 4-13 option in Mass Update form 7-19 saving 4-14 selecting 4-13 viewing 1-6 window description 4-3 Due Out parameter Group Editing form 6-6 Job Editing form 5-24 Dummy task type Job Editing form 5-8 E Edit Collection button 8-2 Edit Job option Editing View pop-up menu 4-7 Edit Skeletons field Mass Create form 7-3 editing jobs in flow diagram 4-33 jobs in List view 4-25 skeletons 7-4 Emergency parameter Job Editing form 5-22 Enable checkbox diagnostics 12-3 Options dialog box 12-3 Enterprise Resource Planning.Job Editing form 5-36. 5-43 Do Sysout parameter Job Editing form 5-37.

9-20. 9-21 format conditions in a flow diagram 4-49 conditions in skeletons 7-14 Frames field Options dialog box 12-8 From column in Mass Update form 7-20 job submission time 5-23 parameter in Group Editing form 6-6 step range definition 5-40 From Class field Sysout handling 5-50 functions for Condition format 7-14 for values in Mass Update form 7-21 Index 7 . Inc. See zooming Force Delete button Calendars window 10-6 Scheduling Tables window 9-19 Force Upload button Calendars window 10-6 Scheduling Tables window 9-20 forcing jobs in Group Editing form 6-24 Scheduling tables 9-16.Group Editing form 6-26 Job Editing form 5-53 expanding. See stepping in Expand-item field Options dialog box 12-7 extended shift in Job Editing form 5-19 Shift Num parameter 5-15 F features CONTROL-M/Desktop 1-1 Field column Collection Criteria dialog box 8-2 Mass Update form 7-20 skeleton editor 7-11 File Name parameter See also memname in Job Editing form 5-8 Filter checkbox Scheduling Tables window 9-18 filtering Drafts 8-1 Scheduling Tables window 9-17 Find keyword Mass update conditions 7-24 Find/Highlight window 4-39 First Field Options dialog box 12-6 flow diagram adding jobs 4-37 arranging the display 4-22 colors 12-8 copying jobs 4-37 creating conditions 4-48 creating Group Scheduling tables 4-46 creating job dependencies 4-48 deleting Group Scheduling tables 4-47 deleting jobs 4-38 BMC Software. Confidential and Proprietary Information description 1-9 Do Condition statements 4-50 editing jobs 4-33 expanding/collapsing entries 4-28 Options dialog box 12-5 printing 13-1 selecting nodes 4-42 stepping in/out 4-29 switching to List/Job Editing view 4-22 toolbar 12-9 viewing job dependencies 4-50 working in 4-27 zooming in/out 4-31 Flowdiagram View pop-up menu option 4-7 focusing..

. 6-7 Group Tag list Job Editing form 5-51 Group/Application field Options dialog box 12-8 GROUP-END parameter Group Editing form 6-23 8 CONTROL-M/Desktop User Guide groups See also node ID icon in tree view 4-17 H hiding items in Tree view 4-18 hierarchies Tree view sort order 4-16 I icons Application hierarchy 4-17 CONTROL-M hierarchy 4-16 displaying large icons 4-7 Ignore Job value Shift parameter 5-15 Import Forms option 4-11 importing default directory 12-3 Scheduling tables 4-15 In conditions See also prerequisite conditions Group Editing form 6-12 in flow diagram 4-28. Confidential and Proprietary Information . Inc.for values in skeleton editor 7-13 G General panel description 5-7 ERP jobs 5-12 Group Editing form 6-5 Options dialog box 12-2 OS/390 platforms 5-10 General toolbar 12-9 Group Editing form Conditions panel 6-12 description 6-1 exiting 6-26 General panel 6-5 panel descriptions 6-3 Postproc panel 6-22 Set panel 6-17 Group parameter Group Editing form 6-6 Job Editing form 5-9 Job Editing form (OS/390) 5-11 moving a job 4-19 Group Scheduling table modifying with the Jobs List window 9-26 group scheduling tables creating in flow diagram 4-46 deleting in flow diagram 4-47 Group editing form 6-1 icon in tree view 4-16 On statements 6-23 Schedule tags 5-51. 4-48 job skeletons 7-13 in conditions deleting 4-51 In keyword Mass Update form 7-20 Installed Products fields CONTROL-M definition 11-3 installing CONTROL-M/Desktop 1-1 Interval parameter Job Editing form 5-22 IOABLCAL utility with relative calendars 10-2 BMC Software.

5-1 BMC Software. Confidential and Proprietary Information modifying 4-33 Job Tag list Job Editing form 5-51 Job task type Job Editing form 5-8 Job Validity field Options dialog box 12-3 jobs adding in flow diagram 4-37 copying in flow diagram 4-37 creating 4-34 creating multiple jobs 7-1 deleting 4-21 deleting in flow diagram 4-38 deleting in List view 4-25 dependencies. 4-50 Job Editing form accessing from Flow Diagram view 4-33 Conditions panel 5-25 description 5-1 ERP jobs 5-12 exiting 5-53 from Desktop Editing view 4-7 from Flow Diagram view 4-33 from List view 4-25 from Tree view 4-25 General panel 5-7 General panel (OS/390) 5-10 new jobs 4-34 opening 4-33 PostProc panel 5-47 Resources panel 5-28 Scheduling panel 5-13 Set panel 5-30 step range 5-40 Steps panel 5-32 Steps panel (OS/390) 5-39 Tag Selection panel 5-51 job name display in job nodes 12-6 in Job Editing form 5-8 Job Node Settings fields Options dialog box 12-6 job parameters See also specific parameter name job processing definitions Job Editing form 1-10..J JEF Undo field Options dialog box 12-3 job modifying with the Jobs List window 9-26 job dependency creating 4-48. in Flow Diagram 4-28 editing in flow diagram 4-33 editing in List view 4-25 filtering for a collection 8-5 icon in tree view 4-16 mass update 7-18 moving 4-19 Net Overview 4-57 path name in Job Editing form 5-8 skeletons (description) 1-13 skeletons (implementation) 7-4 submission time 5-23 Jobs List window description 9-24 displaying Group Scheduling tables 9-24 displaying jobs 9-24 L Last Upload column Calendars window 10-5 Last Upload field Scheduling Table details 9-23 Late Sub value Index 9 . Inc.

6-19 minus sign condition format 7-14 Mass Update form 7-21 skeleton editor value 7-13 Tree view 4-6 modes offline 1-2 online (CTM/Desktop) 1-2 Modified checkbox Scheduling Tables window 9-18 Modified column Calendars window 10-5 Scheduling Tables window 9-19 modifying See also creating See also editing See also updating BMC Software. 5-10 in Scheduling Table details 9-22 in Scheduling Tables window 9-18 See also doclib Like value Mass Update form 7-20 List view deleting jobs 4-25 description 4-23 editing jobs 4-25 List/Job Editing Form option view menu 4-25 Load or Save Drafts field Options dialog box 12-3 Load Specific Jobs option reading a scheduling table 9-8 location. See moving Locked by column Calendars window 10-5 Scheduling Tables window 9-18 locking Scheduling tables 9-9. Inc. Tools menu 7-2 mass job creation counter 12-3 10 CONTROL-M/Desktop User Guide description 7-1 field in Options dialog box 12-3 Mass Create form 7-2 mass job updating counter 12-3 Mass Update form 7-20 tools menu 7-18 MAX DAYS parameter Sysout handling 5-50 Max Run 5-50 Max Wait parameter Group Editing form 6-11 Job Editing form 5-23 Mem Lib parameter Job Editing form (OS/390) 5-10 Mem Name Group Editing form 6-6 Job Editing form (OS/390) 5-10 Member parameter Job Editing form 5-23 messages See also shout messages shout statements 5-48. Confidential and Proprietary Information .. 9-21 logging in CONTROL-M/EM 3-1.Shout When parameter (groups) 6-20 Shout When parameter (jobs) 5-49 Late Time value Shout When parameter (groups) 6-20 Shout When parameter (jobs) 5-49 Lib parameter Group Editing form 6-6 libraries in Job Editing form 5-8. 9-4 M Manual Connection option Options dialog box 12-4 Mass Create option.

See SAP N Name field CONTROL-M definition 11-3 Scheduling Table details 9-22 step range definition 5-40 Name option Editing View pop-up menu 4-7 Name parameter Group Editing form 6-6 names file name in Job Editing form 5-8 job name in Job Editing form 5-8 BMC Software. Inc. Confidential and Proprietary Information step ranges (OS/390) 5-40 Neighborhood identifying dependencies 4-42 selecting nodes 4-42 Net Overview description 1-10 working with 4-57 Network searching 4-39 New button Calendars window 10-6 Scheduling Tables window 9-19 New Job button 4-34 Next Day value Shift parameter 5-15 No Confcal value Shift parameter 5-15 Node ID Job Editing form 5-23 Node Shape fields Options dialog box 12-8 node title Options dialog box 12-6 nodes condition nodes 4-55 locating 4-39 selecting 4-34.. See OS/390 mySAP.CONTROL-M definitions 11-3 group Scheduling tables from the Jobs List window 9-27 job processing definitions 4-33 jobs from the Jobs List window 9-27 Schedule tags 6-8 skeletons 7-7 Month Days Calendar parameter Group Editing form 6-9 Job Editing form 5-14 Month Days parameter Group Editing form 6-9 Job Editing form 5-16 months selecting in a calendar 10-11 Months parameter Group Editing form 6-10 Job Editing form 5-15 mouse pointer modes enable Definition mode 12-10 enable Selection mode 12-10 moving in the skeleton editor 7-12 jobs in Tree view 4-19 MVS. 4-42 selecting using Select All 4-36 Not In keywords Mass Update form 7-20 NOTOK value Shout When parameter 5-49 Shout When parameter (groups) 6-20 Number of jobs to create Mass Create form 7-3 O OK value Shout When parameter 5-49 Index 11 . 4-36.

. Confidential and Proprietary Information 12 CONTROL-M/Desktop User Guide .Shout When parameter (groups) 6-20 On statements Group Editing form 6-23 in Job Editing form 5-33 in Job Editing form (OS/390) 5-42 online mode description 1-2 opening Drafts 4-13 Group Editing form 6-2 Job Editing form 4-33 OpenVMS Detached task type 5-8 operating systems CONTROL-M/Desktop 1-1. See and/or Oracle Applications Application Type field 7-6 job parameters 5-12 Orbix Locator changing properties during login 3-6 Order/Force button Scheduling Tables window 9-20 ordering Scheduling tables 9-16. 4-1 Operation list box Mass Updating conditions 7-25 operators Collection Criteria dialog box 8-2 Mass Update form 7-20 Options dialog box description 12-1 Or parameter Group Editing form 6-9 or. 6-20 Parentheses field condition format (skeletons) 7-17 Mass Updating conditions 7-23 Partial Details option Editing View pop-up menu 4-7 Path parameter See also memlib Job Editing form 5-8 periodic calendars dates and colors 10-13 defining criteria 10-12 description 10-2 PGMST parameter Job Editing form 5-43 Platform column Scheduling Tables window 9-18 plus sign BMC Software. 9-21 OS/390 direct transfer 1-2 Job Editing form 5-10 other INCONTROL products 11-3 postprocessing 5-39 Out conditions Flow Diagram view 4-48 Group Editing form 6-12 in Flow Diagram 4-28 job skeletons 7-13 mass updating 7-26 out conditions deleting 4-51 output Sysout handling 5-49 Over Lib parameter display in job node 12-6 Job Editing form 5-8 Job Editing form (OS/390) 5-10 overview. See Net Overview Owner parameter Group Editing form 6-6 Job Editing form 5-8 Job Editing form (OS/390) 5-10 P parameters shout statements 5-49. 9-20. Inc.

9-5 redo in Job Editing form 5-5 Refresh button Calendars window 10-7 Scheduling Tables window 9-21 Regular calendars dates and colors 10-13 Relative calendars 10-2 Index 13 . 5-42 OS/390 jobs 5-39 prerequisite conditions Adjust Condition parameter 6-6 creating via Flow Diagram view 4-48 format in skeletons 7-14 formatting functions 7-14 Group Editing form 6-12 identifying dependent jobs 4-42 Job Editing form 5-25. 5-46 job skeletons 7-13 listing via Flow Diagram view 4-50 Mass Update form 7-22 modifying 4-50 nodes in a flow diagram 4-55 prerequisites deleting conditions 4-51 Prev Day value Shift parameter 5-15 Prevent-NCT2 parameter Job Editing form 5-22 preview printing a flow diagram 13-1 printing flow diagram 13-1 preview 13-1 Priority parameter Group Editing form 6-6 Job Editing form 5-22 PRM field BMC Software. Inc. 5-45 procedure step Do IFRerun parameter 5-46 step range definition 5-40 PROCST parameter Job Editing form 5-43 program step Do IFRerun parameter 5-46 step range definition 5-40 Q Quantitative resources Job Editing form 5-28 R R/3 Application Type field 7-6 job parameters 5-12 R/3.condition format 7-14 Mass Update form 7-21 skeleton editor value 7-13 Tree view 4-18 PostProc panel Group Editing form 6-22 Job Editing form 5-47 postprocessing Do statements 5-34.. Confidential and Proprietary Information DO Sysout parameter 5-37. See SAP range job steps 5-40 Read/Write facility description (CTM/Desktop) 1-5 reading See also copying See also downloading See also uploading jobs from CONTROL-M/EM 1-5 Scheduling tables 4-15. 5-43 Job Editing form 5-47 On statements 5-33.

See zooming Resources panel description 5-28 Retro parameter Group Editing form 6-11 Job Editing form 5-15 running CONTROL-M/Server utilities 5-54 S SAP. 9-20.. 9-21 BMC Software. 5-44 SCD Table subparameter Group Editing form 6-24 SCH files. Collection criteria 8-5 removing. 9-16 Select CONTROL-M window 9-5 Select Jobs window 9-8 Select Scheduling Table window 9-5 transfer from CONTROL-M/EM 9-3 unlocking 9-9. Confidential and Proprietary Information .. 9-21 moving a job 4-19 new 9-19. 9-24 columns 9-18 commands 9-19 description 9-16 details window 9-22 jobs list 9-24 window 9-17 Scheduling tables deleting 9-19 description 9-1 Details window 9-22 downloading 9-20 Edit menu 9-3 filter fields 9-18 forcing 9-16. 9-21 icon in tree view 4-16 importing 4-15 Job Editing form (OS/390) 5-11 locking 9-9.. 9-22 ordering 9-16. 9-20. CONTROL-M for OS/390 1-2 Schedule tags adding 5-52 defining 6-8 definition 6-7 deleting 5-52 modifying 6-8 Schedule Tags panel buttons 6-7 field descriptions 6-9 14 CONTROL-M/Desktop User Guide Group Editing form 6-7 scheduling CONTROL-M/Server utilities 5-54 Scheduling Group menu 6-2 Scheduling panel Job Editing form 5-13 Scheduling table jobs list 9-24 Scheduling Table Lib parameter Job Editing form (OS/390) 5-11 Scheduling Table Manager button 9-17. See deleting Rerun Shout When parameter 5-49 Rerun parameter Job Editing form 5-22 resolution.dates and colors 10-13 Remote Delete button Calendars window 10-6 Scheduling Tables window 9-19 Remove matching jobs . Inc. 9-21 reading 4-15. See R/3 saving changes to a skeleton 7-12 Drafts 4-14 SCD Table field Job Editing form 5-37. 9-5 Scheduling Table manager 1-14.

. See filtering Start Day of the Week CONTROL-M definition 11-3 default 12-4 step codes buttons 5-42 defining 5-41 step range Job Editing form 5-40 StepInto item field Options dialog box 12-7 stepping in and out See also collapsing See also expanding Index 15 .. 6-19 Shouts panel Group Editing form 6-18 size See also zooming skeleton editor Apply button 7-12 deleting fields 7-12 description 7-4 Field column 7-11 functions for values 7-13 moving fields 7-12 Skeleton field Mass Create form 7-3 skeletons application type 7-6 clearing 7-8 conditions format 7-14 creating 7-7 definition 7-4 deleting 7-8 description 1-13 modifying 7-7 prerequisite conditions 7-13 saving changes 7-12 specifying fields 7-11 sorting.. Collection criteria 8-5 Set panel Group Editing form 6-17 Job Editing form 5-30 setting. See customizing Shift Days parameter Group Editing form 6-10 Shift Num parameter Job Editing form 5-15 Shift parameter detailed description 5-19 valid values 5-19 Shout messages Group Editing form 6-18. 6-24 BMC Software. 4-35 servers CONTROL-M/EM 3-2 Set matching jobs. Confidential and Proprietary Information Job Editing form 5-48.uploading 9-20 window buttons 9-19 writing 9-10 Scheduling Tags Job Editing form 5-51 Second Field Options dialog box 12-6 Select All 4-36 Select CONTROL-M window 9-5 Select Jobs window 9-8 Select Scheduling Table window 9-5 Select the full Draft Collection criteria 8-5 selecting dependent nodes 4-42 Drafts 4-13 multiple nodes 4-36 predecessor nodes 4-42 selection criteria collections 8-2 Selection mode choosing 4-35 description 4-34. Inc.

. 4-16 displaying items 4-18 hiding items 4-18 moving jobs 4-19 Type column Calendars window 10-5 Type field CONTROL-M definition 11-3 U Undo Size field Options dialog box 12-3 undoing actions in Job Editing form 5-5 Unlock button Calendars window 10-7 Scheduling Tables window 9-21 unlocking calendars 10-7 Scheduling tables 9-9.Flow Diagram view 4-29 Steps panel Job Editing form 5-32 Job Editing form (OS/390) 5-39 Substr function condition format 7-15 Mass Update form 7-21 skeleton editor 7-13 SYS DB field. Confidential and Proprietary Information . Inc. See skeletons time in the Group Editing form 6-6 parameter in Job Editing form 5-23 To column Mass Update form 7-21 To field step range definition 5-40 ToJob function condition format 7-15 Mass Update form 7-22 toolbar enable Communication toolbar 12-9 16 CONTROL-M/Desktop User Guide enable Flow Diagram toolbar 12-9 enable general toolbar 12-9 enable Tools toolbar 12-9 enable Tree toolbar 12-9 enable Wizard toolbar 12-10 mouse pointer modes 12-10 toolbars viewing 12-9 Tools toolbar 12-9 Tree toolbar 12-9 Tree view deleting jobs 4-21 description 1-7. Sysout handling 5-50 Sysout handling 5-49 T tables See also Scheduling tables Job Editing form 5-8 Scheduling Tables window 9-18 Tag Selection panel Job Editing form 5-51 Task Type emergency tasktypes 5-22 Task Type parameter Group Editing form 6-6 Job Editing form 5-8 Job Editing form (OS/390) 5-11 Task type parameter cyclic jobs 5-22 templates. 9-21 Until job submission time 5-23 parameter in Group Editing form 6-6 Update button Calendars window 10-6 Update keyword Mass update conditions 7-24 BMC Software.

. See AutoEdit variables Version column Scheduling Tables window 9-18 Version field CONTROL-M definition 11-3 viewing See also displaying BMC Software. 7-18 scheduling tables 9-20 Upload button Calendars window 10-6 Scheduling Tables window 9-20 uploading calendars 10-6 Scheduling tables 9-20 Uppercase Only field CONTROL-M definition 11-3 urgency shout messages 5-49 shout messages (groups) 6-21 User Daily column Scheduling Tables window 9-19 User Daily field Scheduling Table details 9-23 user ID See also owner Owner parameter 6-6 Drafts 1-6 Drafts (CTM/Desktop) 1-6 Group Scheduling tables 6-2 job dependencies 4-50 Net Overview 4-57 print preview 13-1 toolbars 12-9 views list 4-23 tree 4-16 VMS. Inc. Confidential and Proprietary Information Index 17 . See OpenVMS W waiting period.updating See also modifying calendars 10-9 multiple jobs 7-1. 12-3 button 9-10. 11-4 correcting errors 11-5 description 11-4 Value column Collection Criteria dialog box 8-2 variables. Max Wait parameter 5-23 Week Days Calendar parameter Job Editing form 5-15 Week Days parameter Job Editing form 5-14 weekdays default start day 12-4 selecting in a calendar 10-11 Weekdays Calendar parameter Group Editing form 6-10 Weekdays parameter Group Editing form 6-10 weeks selecting in a calendar 10-11 When parameter Group Editing form 6-20 Job Editing form 5-49 Wizard enable toolbar 12-10 Write to CONTROL-M/EM button 9-10 writing jobs from CONTROL-M/EM 1-5 Scheduling tables 9-10 V validity checks automatic 11-6.

. Inc.Y years calendar definition 10-10 Z zooming Flow Diagram view 4-31 BMC Software. Confidential and Proprietary Information 18 CONTROL-M/Desktop User Guide .

then you agree to only use such modifications or new software programs for Your internal purposes or otherwise consistent with the License. is controlled by or shares common control with a party. gigabyte limit. on the date that You received the Product from BMC. via delivery or electronic transmission. PROMPTLY RETURN THE PRODUCT TO BMC OR YOUR BMC RESELLER. DO NOT INSTALL OR USE THE PRODUCT. and/or other capacity limitations regarding the Software. to do the following: (a) install the Software on Your owned or leased hardware located at a facility owned or controlled by You in the country where You acquired the license. PRODUCT AND CAPACITY. upgrades. decompile or otherwise attempt to derive any Software from executable code. use in a service bureau. to You. or (c) provide a third party with the results of any functional evaluation or benchmarking or performance tests.END USER LICENSE AGREEMENT NOTICE BY OPENING THE PACKAGE.com or can be provided to You upon request. "Product" means the Software and Documentation. or processing the data of third parties. "Documentation" means all written or graphical material provided by BMC in any medium. and error corrections. a Delaware corporation located at 2101 CityWest Blvd. YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT. and (c) make one copy of the Software for backup and archival purposes only (collectively a "License"). In addition to the restrictions imposed under this Agreement. AND IF YOU ACQUIRED THE LICENSE WITHIN 30 DAYS OF THE DATE OF YOUR ORDER CONTACT BMC OR YOUR BMC RESELLER FOR A REFUND OF LICENSE FEES PAID. total allowed users. maintenance modifications. LICENSE UPGRADES. Houston. BMC grants You a license to use the Documentation solely for Your internal use in Your operations. or sublicense). THE ELECTRONIC AGREEMENT PROVIDED WITH THE PRODUCT AS PART OF THE INSTALLATION OF THE PRODUCT WILL NOT APPLY. such as tier limit.. without BMC’s prior written approval. or for rental. IF YOU REJECT THIS AGREEMENT. which is available at http://www. 77042. You agree to use BMC’s current computer classification scheme. If the Software is designed by BMC to permit you to modify such Software. as well as Your payment of applicable fees. outsourcing environment. up to the License Capacity. INSTALLING. "License Capacity" means the licensed capacity for the Software with the pricing and other license defining terms. unless prohibited by local law. (b) distribute or provide the Software to any third party (including without limitation. UNLESS (1) YOU AGREED TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT.bmc. including any technical specifications. . reverse engineer. Subject to the terms of this Agreement. enhancements. (b) operate the Software solely for processing Your own data in Your business operations. THEN THAT WRITTEN AGREEMENT GOVERNS THE USE OF THE PRODUCT. quantity of Software. relating to the functionality or operation of the Software. PRESSING "AGREE" OR "YES" OR USING THE PRODUCT. non-transferable. updates. USA or its affiliated local licensing entity ("BMC").. You may expand the scope of the License Capacity only pursuant to a separate agreement with BMC for such expanded usage and Your payment of applicable fees. lease. IN WHICH CASE THAT WEB BASED LICENSE AGREEMENT GOVERNS THE USE OF THE PRODUCT. The Product is deemed accepted by You. "Affiliate" is defined as an entity which controls. This Agreement ("Agreement") is between the entity or individual entering into this Agreement ("You") and BMC Software Distribution. IF YOU DO NOT AGREE WITH ANY OF THESE TERMS. any other usage restrictions contained in the Product installation instructions or release notes shall apply to Your use of the Product. BMC grants You a non-exclusive. THE ENTITY OR INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. "Software" means the object code version of the computer programs provided. OR (2) IF YOU DID NOT AGREE TO A WEB BASED LICENSE AGREEMENT WITH BMC WHEN ORDERING THE PRODUCT AND YOU HAVE A WRITTEN LICENSE AGREEMENT WITH BMC. Texas. For licenses based on the power of a computer. "You" includes you and your Affiliates. ACCEPTANCE. including capacity restrictions. RESTRICTIONS: You agree to NOT: (a) disassemble. bug fixes. Software includes computer files. LICENSE. perpetual (unless a term license is provided on an order) license for each copy of the Software. Inc. There is no additional warranty period or free support period for license upgrades. THIS AGREEMENT WILL APPLY TO THE PRODUCT.

as part of the ordering process. THE IMPLIED WARRANTIES OF MERCHANTABILITY. for any defect in the Software during the warranty period or breach of the warranty above shall be limited to the following: BMC shall use reasonable efforts to remedy defects covered by the warranty or replace the defective Software within a reasonable period of time. or if BMC cannot remedy or replace such defective copy of the Software. and BMC. Confidential Information means non-public technical and non-technical information relating to the BMC Products and Support. BMC’S AGGREGATE LIABILITY FOR DAMAGES IS LIMITED TO THE AMOUNT PAID BY YOU FOR THE LICENSE TO THE PRODUCT. THE IMPLIED WARRANTIES OF MERCHANTABILITY. This warranty shall not apply to any problems caused by software or hardware not supplied by BMC or to any misuse of the 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. BMC Products are protected by applicable copyright. and Your exclusive remedy. AND DAMAGE OR LOSS OF USE OF DATA). The BMC Products are and contain valuable confidential information of BMC ("Confidential Information"). and the structure and organization of the Software. CONFIDENTIAL AND PROPRIETARY INFORMATION. You must uninstall the Software. AND IRRESPECTIVE OF ANY NEGLIGENCE OF BMC OR WHETHER SUCH DAMAGES RESULT FROM A CLAIM ARISING UNDER TORT OR CONTRACT LAW. PUNITIVE OR CONSEQUENTIAL DAMAGES RELATING TO OR ARISING OUT OF THIS AGREEMENT. WITHOUT LIMITATION. DISCLAIMER OF DAMAGES. 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.5 times what You would have paid if You were enrolled in Support during that time period. BMC’s entire liability. ITS AFFILIATES OR LICENSORS LIABLE FOR ANY SPECIAL. including. You will be automatically re-enrolled in Support on an annual basis unless BMC receives notice of termination from You as provided below. Upon termination. non-transferable evaluation license to operate the Software for the period of time specified from BMC or. . INCLUDING. LIMITS ON LIABILITY. so long as such new releases or versions are furnished by BMC to all other enrolled Support customers without additional charge. INDIRECT. SUPPORT. BMC or its Affiliates or licensors retain all right. contact BMC to acquire a capacity-based license to the Product for a fee. WITHOUT LIMITATION. without limitation. If Your order includes support for the Software.TRIAL LICENSE. BMC warrants that the Software will perform in substantial accordance with the Documentation for a period of one year from the date of the order. If You want to continue Your use of the Product beyond the Trial Period. THE PRODUCT IS PROVIDED "AS IS. Your right to use this Product automatically expires. informational. a 30 day time period ("Trial Period") only for evaluating whether You desire to acquire a capacity-based license to the Product for a fee. BMC may terminate for its convenience a Trial License upon notice to You. ITS AFFILIATES AND RESELLERS. WITHOUT LIMITATION. trade secret. You agree to use all reasonable efforts to prevent the unauthorized use. AND/OR THE PRODUCT (INCLUDING. FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT) AND HAVE NO LIABILITY WHATSOEVER RESULTING FROM THE USE OF THIS PRODUCT UNDER THIS TRIAL LICENSE ("Trial License"). BMC provides bug fixes. This Agreement shall immediately terminate if You breach any of its terms. publication or dissemination of the Product. LOST COMPUTER USAGE TIME. BMC agrees to make commercially reasonable efforts to provide the following Support: (i) For malfunctions of supported versions of the Software. TERMINATION. and either certify the destruction of the Product or return it to BMC. industrial property and proprietary rights therein. then BMC agrees to provide support (24 hours a day/7 days a week) ("Support"). Except for a Trial License. If. BMC neither grants nor otherwise transfers any rights of ownership in the BMC Product to You. EXCLUSIVE REMEDY. patches or workarounds in order to cause that copy of the Software to operate in substantial conformity with its then-current operating specifications. There is a free support period during the one year warranty period. LOST PROFITS. ITS AFFILIATES AND LICENSORS SPECIFICALLY DISCLAIM ALL OTHER WARRANTIES. EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. the Product is provided on a trial basis. BMC may charge You a reinstatement fee of 1. BMC reserves any rights not expressly granted to You herein. then these terms apply: (i) this license consists solely of a non-exclusive. You may not disclose the Confidential Information to third parties. OWNERSHIP OF THE PRODUCT. trade secret and proprietary information. OR THAT ALL DEFECTS CAN BE CORRECTED. SUPPORT. BMC may change its prices for the Software and/or Support upon at least 30 days notice prior to Your support anniversary date. AND NON-INFRINGEMENT. and industrial and intellectual property laws. (b) Fees. AND LICENSORS DISCLAIM ANY AND ALL WARRANTIES (INCLUDING. The annual fee for Support is 20% of the Software’s list price less the applicable discount or a flat capacity based annual fee. (a) Support Terms. When the Trial Period ends. then BMC shall refund the amount paid by You for the License for that Software. DISCLAIMER. 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. BMC DOES NOT WARRANT THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE." BMC. if not specified. If You re-enroll in Support. EXCEPT FOR THE EXPRESS WARRANTIES ABOVE. copying. for any reason. INCIDENTAL. FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT IS BMC. and (ii) Your use of the Product is on an AS IS basis without any warranty. and (ii) BMC provides new releases or versions. title and interest to and in the BMC Product and all intellectual property. WARRANTY.

AS APPLICABLE. at its expense. RULES OF THE AMERICAN ARBITRATION ASSOCIATION. or Thailand (collectively.VERIFICATION.R. THE COSTS OF THE ARBITRATION SHALL BE BORNE EQUALLY PENDING THE ARBITRATOR’S AWARD. re-export. 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 PARTY’S CONFIDENTIAL INFORMATION.211 (Technical Data) of the Federal Acquisition Regulations ("FAR") and its successors. IF THE DISPUTE IS INITIATED IN THE AMERICAS REGION. Puerto Rico.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. If acquired by or on behalf of a civilian agency. tariffs. BMC may. NETHERLANDS UNDER THE CURRENT UNCITRAL ARBITRATION RULES. THE ARBITRATION SHALL BE HELD IN NEW YORK. ARBITRATION. or any country in Central or South America. written or displayed electronically. state or local taxes (other than taxes based on BMC’s net income) imposed in connection with the Product and/or the Support. U. Les parties exigent que la présente convention ainsi que les documents qui s’y rattachent soient rédigés en anglais. the remainder of the provisions will remain in effect. IF THE DISPUTE IS INITIATED IN A COUNTRY OUTSIDE OF THE AMERICAS REGION OR ASIA PACIFIC REGION. any part of the Product or any underlying information or technology except in full compliance with all United States. without limitation. 252. MISCELLANEOUS TERMS. foreign and other applicable laws and regulations. If the underpaid fees exceed 5% of the fees paid. This Agreement is governed by the substantive laws in force. You may not assign or transfer this Agreement or a License to a third party without BMC’s prior written consent. The parties have agreed that this Agreement and the documents related thereto be drawn up in the English language. if you acquired the License in the United States. the U. THE AWARD RENDERED SHALL BE FINAL AND BINDING UPON THE PARTIES AND SHALL NOT BE SUBJECT TO APPEAL TO ANY COURT. audit Your use of the Software to confirm Your compliance with the Agreement. whether generated manually or electronically. U. property. customs. Republic of China.F. including.F. Peoples Republic of China. South Korea. OWNERSHIP.212 (Computer Software) and 12. 227. If an audit reveals that You have underpaid fees. Malaysia. SHALL BE DETERMINED BY BINDING ARBITRATION CONDUCTED IN ENGLISH. concerning the Product and related subject matter.7202 of the DOD FAR Supplement and its successors. without regard to conflict of laws principles: (a) in the State of New York. (b) in the Province of Ontario. You agree to pay BMC all amounts owed no later than 30 days from the date of the applicable invoice. You agree to pay such underpaid fees. SW EULA Int 030102 . export. the License Capacity. value-added (VAT). GOVERNMENT RESTRICTED RIGHTS. and other similar federal.S. Indonesia. If acquired by or on behalf of any agency within the Department of Defense ("DOD"). Should any provision of this Agreement be invalid or unenforceable. or reimburse BMC. GOVERNING LAW. Government acquires this commercial computer software and/or commercial computer software documentation subject to the terms of this Agreement as specified in 48 C. India. or transfer. IF THE DISPUTE IS INITIATED IN A COUNTRY IN THE ASIA PACIFIC REGION. No modification or waiver of any provision hereof will be effective unless made in a writing signed by both BMC and You. You agree not to import. OR ANY OTHER PROPRIETARY RIGHTS. Australia. or (d) in the Netherlands. "Asia Pacific Region"). unless otherwise provided on the order for the License to the Products. if you acquired the License in Canada (subsections (a) and (b) collectively referred to as the "Americas Region"). directly or indirectly. including sales.A.R. THE ARBITRATION SHALL BE HELD IN AMSTERDAM. if you acquired the License in any other country not described above. (c) in Singapore.227-7014(a)(1). SINGAPORE UNDER THE CURRENT UNCITRAL ARBITRATION RULES.S. then You agree to also pay BMC’s reasonable costs of conducting the audit. EXPORT CONTROLS. use.S. New Zealand. for taxes of any kind. The United Nations Convention on Contracts for the International Sale of Goods is specifically disclaimed in its entirety. You agree to deliver to BMC periodic written reports. ANY DISPUTE BETWEEN YOU AND BMC ARISING OUT OF THIS AGREEMENT OR THE BREACH OR ALLEGED BREACH. 12.F. THE ARBITRATION SHALL BE HELD IN SINGAPORE.. detailing Your use of the Software in accordance with this Agreement. duty. withholding. UNDER THE CURRENT COMMERCIAL OR INTERNATIONAL. You will pay. the U. The Software under this Agreement is "commercial computer software" as that term is described in 48 C. 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.R. whether oral. This Agreement constitutes the entire agreement between You and BMC and supersedes any prior or contemporaneous negotiations or agreements. Special Administrative Region of Hong Kong. If requested by BMC. Singapore. Philippines. if you acquired the License in Japan. ALL ARBITRATION PROCEEDINGS SHALL BE CONDUCTED IN CONFIDENCE. AND MAY BE ENFORCED IN ANY COURT OF COMPETENT JURISDICTION.

.

Notes .

ÄÄ ÄÄ ÄÄ ÄÄ *17543* .