About This Guide

Control-M is a component member of the INCONTROL™ by BMC family of products. The Control-M for z/OS User Guide is the main publication that describes the components and usage of Control-M software.

This guide is designed for use by everyone who defines job schedules or who uses Control-M to actively control jobs in the production environment.

This guide provides detailed information on all Control-M functions and facilities. It contains the following chapters:

  • Introduction to Control-M: Control-M introduction and overview. This chapter briefly describes the main components of Control-M from a functional perspective, and introduces the user to Control-M facilities and features, concepts and logic. INCONTROL and IOA components and concepts are also described.

  • It is highly recommended that all users read this chapter before reading other chapters in the guide.

  • Online Facilities: Guide to using Control-M and IOA online facilities. Control-M and IOA screens are illustrated and discussed in logical sequence.

  • Job Production Parameters: Detailed description, accompanied by examples, of the parameters and statements in the Control-M Job Scheduling Definition screen.

  • Control-M Event Manager (CMEM): Overview of Control-M Event Manager logic and a detailed description of the parameters and statements in CMEM rule definitions. This facility enables Control-M to respond to external events (that is, events in the MVS environment that occur outside of Control-M's direct control).

  • JCL and AutoEdit Facility: Guide to the Control-M AutoEdit facility, and its application to JCL. Usage of AutoEdit terms in the JCL can eliminate the need for manual changes to the JCL prior to job submission.

  • Selected Implementation Issues: Provides concepts, hints, and procedures for successful implementation and maintenance of Control-M.

  • Simulation and Forecasting Facility: Guide to simulating the effects of operations and procedures in your production environment and forecasting the potential impact of proposed changes.

  • The Control-M Application Program Interface (CTMAPI): Guide to the Control-M Application Program Interface (CTMAPI), which is an open interface between the application environment and Control-M. CTMAPI enables your application program to interface with Control-M so that you can access services and extract data from Control-M into your own programs.

  • Control-M for z/OS UNIX System Services (USS): Provides details for the implementation of Control-M in the IBM z/OS Unix Systems Services (USS) environment.

  • Editing Job Scheduling Definitions in the Edit Environment: Usage of the IOA Edit environment for editing job scheduling definitions.

  • Editing CMEM Rule Definitions in the Edit Environment: Usage of the IOA Edit environment for editing CMEM rule definitions.

  • MVS Job Restart Without Control-M/Restart: Instructions for using Control-M to perform an MVS restart (for sites that do not have Control-M/Restart installed).

Conventions Used in This Guide

Notational conventions that might be used in this guide are explained below.

Standard Keyboard Keys

Keys that appear on the standard keyboard are identified in boldface, for example, Enter, Shift, Ctrl+S (a key combination), or Ctrl S (a key sequence).

The commands, instructions, procedures, and syntax illustrated in this guide presume that the keyboards at your site are mapped in accordance with the EBCDIC character set. Certain special characters are referred to in this documentation, and you must ensure that your keyboard enables you to generate accurate EBCDIC hex codes. This is particularly true on keyboards that have been adapted to show local or national symbols. You should verify that

  • $ is mapped to x'5B'.

  • # is mapped to x'7B'.

  • @ is mapped to x'7C'.

If you have any questions about whether your keyboard is properly mapped, contact your system administrator.

Preconfigured PFKeys

Many commands are preconfigured to specific keys or key combinations. This is particularly true with regard to numbered PF keys, or pairs of numbered PF Keys. For example, the END command is preconfigured to, and indicated as, PF03/PF15. To execute the END command, press either the PF03 key or the PF15 key.

Instructions to enter commands may include:

  • Only the name of the command, such as, enter the END command.

  • Only the PF keys, such as, press PF03/PF15.

  • Or both, such as, press PF03/PF15, or enter the END command.

Command Lines and Option Fields

Most screens contain a command line, which is primarily used to identify a single field where commands, or options, or both, are to be entered. These fields are usually designated COMMAND, but they are occasionally identified as COMMAND/OPT or COMMAND/OPTION.

Option field headings appear in many screens. These headings sometimes appear in the screen examples as OPTION, or OPT, or O.

Names of Commands, Fields, Files, Functions, Jobs, Libraries, Members, Missions, Options, Parameters, Reports, Subparameters, and Users

The names of commands, fields, functions, jobs, libraries, members, missions, options, parameters, reports, subparameters, users, and most files, are shown in standard UPPERCASE font.

Syntax Statements

In syntax, the following additional conventions apply:

  • A vertical bar ( | ) separating items indicates that you must choose one item. In the following example, you would choose a, b, or c:

    Copy 
    a | b | c

  • An ellipsis ( . . . ) indicates that you can repeat the preceding item or items as many times as necessary.

  • Square brackets ( [ ] ) around an item indicate that the item is optional. If square brackets ( [ ] ) are around a group of items, this indicates that the item is optional, and you may choose to implement any single item in the group. Square brackets can open ( [ ) and close ( ] ) on the same line of text, or may begin on one line of text and end, with the choices being stacked, one or more lines later.

  • Braces ({ }) around a group of items indicates that the item is mandatory, and you must choose to implement a single item in the group. Braces can open ( { ) and close ( } ) on the same line of text, or may begin on one line of text and end, with the choices being stacked, one or more lines later.

Screen Characters

Copy 
All syntax, operating system terms, and literal examples are presented in this typeface.

This includes JCL calls, code examples, control statements, and system messages. Examples of this are:

  • Calls, such as:

    Copy 
    CALL 'CBLTDLI'

  • Code examples, such as:

    Copy 
    FOR TABLE owner.name USE option, . . . ;

  • Control statements, such as:

    Copy 
    //PRDSYSIN DD * USERLOAD PRD(2) PRINT

  • System messages are displayed on the screen, such as

    • Stand-alone messages:

      Copy 
      You are not logged on to database database_name

    • Messages embedded in text:

      Copy 
      You are not logged on to database database_name

Variables

Variables are identified with italic text. Examples of this are:

  • In syntax or message text, such as:
    Specify database database_name

  • In regular text, such as:
    replace database database_name1 with database database_name2 for the current session

  • In a version number, such as:
    EXTENDED BUFFER MANAGER for IMS 4.1.xx

Special Elements

This guide includes special elements called Notes and Warnings.

Notes provide additional information about the current subject.

Warnings alert you to situations that can cause problems, such as loss of data, if you do not follow instructions carefully.

Information New to This Version

Additional information that is new to this version is described in the INCONTROL for z/OS Installation Guide: Upgrading and the What’s New section of the INCONTROL for z/OS Release Notes.

Information Relating to Control-M/Restart Users

Certain information presented in the guide is relevant only to Control-M users who have Control-M/Restart installed at their site.

Control-M/Restart was called Control-R in earlier versions.

Control-M/Restart information is identified in this guide by the §Restart§ symbol, which is shown at the beginning of the Control-M/Restart information. This symbol is shown using the following guidelines:

  • If an entire topic level is dedicated to Control-M/Restart material, the heading of that topic begins with the §Restart§ symbol. Similarly, if there are lower level topics within that level that are also dedicated to Control-M/Restart material, the headings of those lower level topics will also begin with the §Restart§ symbol.

  • This provision also applies to Control-M/Restart paragraphs, each of which will begin with the §Restart§ symbol, or, on occasion, to single sentences, or even phrases or words, if they exclusively pertain to Control-M/Restart material.

  • The same §Restart§ symbol is placed at the conclusion of each unbroken block of text material that contains Control-M/Restart material, regardless of whether the material spans more than one heading level, paragraph, or sentence. For example, if a first level Control-M/Restart topic includes second and/or third and/or fourth and/or fifth level topic headings, with no intervening material that is not related to Control-M/Restart, the §Restart§ symbol will be placed at the end of the text in the lowest level sentence of unbroken Control-M/Restart material.

  • If a figure or table is used exclusively to identify or explain Control-M/Restart material, the following statement will appear immediately preceding the figure title or the table title:

  • §Restart§ The following (figure)(table) is for users who have Control-M/Restart installed at their site.

  • If Control-M/Restart material is included only in part of a figure or table otherwise used to illustrate standard Control-M material, the §Restart§ symbol will be used within the figure or table to identify the information relevant only to Control-M/Restart users.

If Control-M/Restart is not installed at your site, you can skip any material in this guide that is identified with the §Restart§ symbol.

Related Publications

INCONTROL for z/OS Installation Guide

A step-by-step guide to installing, customizing, maintaining, and upgrading INCONTROL products using the INCONTROL Customization and Installation Engine (ICE) application.

The guide is divided into the following volumes:

INCONTROL for z/OS Messages Manual

A comprehensive listing and explanation of all IOA and INCONTROL messages.

INCONTROL for z/OS Administrator Guide

This guide provides information for system administrators about customizing and maintaining INCONTROL products.

INCONTROL for z/OS Utilities Guide

A detailed description of the utilities designed to perform specific administrative tasks that are available to INCONTROL products. The guide contains an alphabetized reference of all utilities for each INCONTROL product.

User Guides

Product-specific guides containing comprehensive information about the operation and implementation of each INCONTROL product.