Control-M Workload Automation 8.0.00.100 Self Service User Guide

Control-M Workload Automation
8.0.00.100
Self Service User Guide
April 2013
www.bmc.com
Contacting BMC Software
You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain
information about the company, its products, corporate offices, special events, and career opportunities.
United States and Canada
Address BMC SOFTWARE INC Telephone  713 918 8800 Fax 713 918 8000
2101 CITYWEST BLVD  800 841 2031
HOUSTON TX
77042-2827
USA
Outside United States and Canada
Telephone (01) 713 918 8800 Fax (01) 713 918 8000
© Copyright 2013 BMC Software, Inc.

BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are
registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other
countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in
the U.S. or in other countries. All other trademarks or registered trademarks are the property of their
respective owners. IT Infrastructure Library® is a registered trademark of the Office of Government
Commerce and is used here by BMC Software, Inc., under license from and with the permission of OGC.
ITIL® is a registered trademark, and a registered community trademark of the Office of Government
Commerce, and is registered in the U.S. Patent and Trademark Office, and is used here by BMC Software,
Inc., under license from and with the permission of OGC.
Linux is the registered trademark of Linus Torvalds.
Oracle is a registered trademark of Oracle Corporation.
UNIX is the registered trademark of The Open Group in the US and other countries.
BMC Software considers information included in this documentation to be proprietary and confidential. Your
use of this information is subject to the terms and conditions of the applicable End User License Agreement
for the product and the proprietary and restricted rights notices included in this documentation.
Restricted rights legend
U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDER THE
COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer
software by the U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14,
DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, 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.
Customer support
You can obtain technical support by using the BMC Software Customer Support website or by contacting
Customer Support by telephone or e-mail. To expedite your inquiry, see “Before contacting BMC.”
2
Support website
You can obtain technical support from BMC 24 hours a day, 7 days a week at http://www.bmc.com/support.
From this website, you can:
 Read overviews about support services and programs that BMC offers
 Find the most current information about BMC products
 Search a database for issues similar to yours and possible solutions
 Order or download product documentation
 Download products and maintenance
 Report an issue or ask a question
 Subscribe to receive proactive e-mail alerts when new product notices are released
 Find worldwide BMC 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 or send an e-mail message to customer_support@bmc.com. (In the subject line, enter
SupID:<yourSupportContractID>, such as SupID:12345). Outside the United States and Canada,
contact your local support center for assistance.
Before contacting BMC
Have the following information available so that Customer Support can begin working on your issue
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
3
 Sequence of events leading to the issue
 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
License key and password information
If you have questions about your license key or password, contact BMC as follows:
 (USA or Canada) Contact the Order Services Password Team at 800 841 2031, or send an e-mail
message to ContractsPasswordAdministration@bmc.com.
 (Europe, the Middle East, and Africa) Fax your questions to EMEA Contracts Administration at +31 20
354 8702, or send an e-mail message to password@bmc.com.
 (Asia-Pacific) Contact your BMC sales representative or your local BMC office.
For the provisions described in the BMC License Agreement and Order related to third party products or
technologies included in the BMC Product, see the "ThirdParty" subdirectory in the installation directory of
this product.
4
Contents
Introduction to Control-M Self Service .............................................................................. 6
Control-M Self Service navigation ....................................................................................................6
Service view ...................................................................................................................................7
Jobs view .......................................................................................................................................8
Control-M Self Service service management .................................................................... 10

Finding services............................................................................................................................ 10
Holding a service .......................................................................................................................... 11
Releasing a service ....................................................................................................................... 11
Viewing the history of services ...................................................................................................... 11
Ordering a service ........................................................................................................................ 12
Service details .............................................................................................................................. 12
Control-M Self Service job management ......................................................................... 15

Finding jobs ................................................................................................................................. 15
Holding a job ............................................................................................................................... 16
Releasing a job ............................................................................................................................ 16
Re-running a job .......................................................................................................................... 17
Confirming a job .......................................................................................................................... 17
Restarting a job ........................................................................................................................... 17
Restart job parameters ................................................................................................................. 18
Ordering a job now ...................................................................................................................... 19
Setting a job to OK ....................................................................................................................... 19
Terminating a job ......................................................................................................................... 19
Updating a job ............................................................................................................................. 20
Update job parameters ................................................................................................................. 20
Job details ................................................................................................................................... 21
5
1
Chapter
1
Introduction to Control-M Self Service
Control-M Self Service is a Control-M client web application, which enables you to view your services with a
Web-based application and analyze the problematic services and jobs. After you have determined what the
problems are, you can resolve them by performing various service and job actions, depending on your
authorizations.
A service is created from the Service Manager, as described in Service definition.
Control-M Self Service provides the following functionality:
 Service management: Enables you to hold, release, filter, show history, and order services, as
described in Control-M Self Service service management (on page 10).
 Job management: Enables you to find, hold, release, re-run, confirm, restart, set to OK, kill, order and
update jobs, as described in Control-M Self Service job management (on page 15).
For a description of the Control-M Self Service user interface, see Control-M Self Service navigation (on page
6).
Control-M Self Service navigation

Control-M Self Service is divided into the following two views:
 Service view: Services appear on the left in List view or Tile view and service details appear in the right
pane based on the selected service, as described in Service view (on page 7).
 Jobs view: Jobs appear on the left after double-clicking a service and shows jobs in List view or Tile
view and job details appear in the right pane based on the selected job, as described in Jobs view (on
page 8).
6
Control-M Workload Automation Self Service User Guide
Service view
The following figure shows the services in the left pane and the related details of the selected service in the
right pane:
The following table describes the various actions you can perform in the Service view:
Option Description
Enables you to refresh the Service View manually.

The services are automatically refreshed at defined intervals.
Enables you to view the details of a service from specific date,

as described in Viewing the history of services (on page 11).
Enables you to hold and release the selected service, as

described in Control-M Self Service service management (on
page 10).
Enables you to order a service, as described Ordering a service

(on page 12).
7
Option Description
Enables you to view the services in Tile view that shows

limited details of the service.
Enables you to view the services in List view that shows

descriptive details of the service, as described in Service
details (on page 12). You can also choose which fields you
want to appear in List view, by right-clicking any column and
selecting the items you want.
Jobs view
The following figure shows jobs that belong to a specific service in the left pane and the related details of the
selected job in the right pane:
For a detailed description of the analysis panel in the right pane, see Job details (on page 21).
8
The following table describes the various actions you can perform in the Jobs view:
Option Description
Enables you to navigate to the previous job in your job

selection.
Enables you to navigate to the next job in your job selection.
Enables you to refresh the Jobs View manually.

The jobs are automatically refreshed at defined intervals.
Enables you to navigate to the predecessor or successor of a

selected job.
Enables you to hold, release, re-run, confirm, restart, set to

OK, kill, order or update the selected job, as described in
Control-M Self Service service management (on page 10).
Enables you to view the jobs in Tile view that shows limited
details of the selected job.
Enables you to view the jobs in List view that shows

descriptive details of the selected job, as described in Job
details (on page 21). You can also choose which fields you
want to appear in List view, by right-clicking any column and
selecting the items you want.
Zoom Enables you to zoom in and out on jobs in Tile view.
9
2
Chapter
2
Control-M Self Service service management
Control-M Self Service enables you to view the status of your services, check for problems, and perform
various service actions.
The following procedures describe how to filter, hold, release, view history, and order services:
 Finding services (on page 10): Describes how to filter and find services, which enables you to see the
status of specific services.
 Holding a service (on page 11): Describes how to hold a service, which stops the service from Control-M
processing and enables you to fix any problems that might have occurred hold a job.
 Releasing a service (on page 11): Describes how to release a service from a Hold state, which enables
the service to run.
 Viewing the history of services (on page 11): Describes how to view the history of services, which
enables you to see the status and service details of specific services from a previous date.
 Ordering a service (on page 12): Describes how to order a service, which enables you to run all the jobs
within the service.
Finding services
This procedure describes how to find services, which enables you to see the status of specific services.
 To find a service:
1. From the Status dropdown list, select the service status that you want to view.
2. In the Search field, type the name or part of the name of the service(s) that you want to find.
3. If you want to search for services with name, file name, and order ID job properties, select Search in
job properties.
4. Click Search.
The services that match the filtered criteria appear.
5. To view the service details, click one of the tabs in the right pane, as described in Service details (on page
12).
6. To view all services, click Reset.
10
Holding a service
This procedure describes how to hold a service, which stops the service from Control-M processing and
enables you to fix any problems that might have occurred.
NOTE: You cannot hold a BMC Batch Impact Manager service.
 To hold a service:
1. Select a service that you want to hold.
2. From the Actions dropdown list, select Hold.
Control-M Self Service automatically refreshes the services at defined intervals.
A Hold icon appears on the service and is no longer running.
Releasing a service
This procedure describes how to release a service from a Hold state, which enables the service to run.
 To release a service:
1. Select a held service that you want to release.
2. From Actions dropdown list, select Release.
Control-M Self Service automatically refreshes the services at defined intervals.
The Hold icon disappears from the service and the service is now available to continue running.
Viewing the history of services

This procedure describes how to view the history of services, which enables you to see the status and service
details of specific services from a previous date.
 To view the history of services:
1. Click .
The Service History View appears.
2. In the Date field, click and select the date that you want to view.
The services that match your criteria appear.
11
Ordering a service
This procedure describes how to order a service, which enables you to run all the jobs within the service.
 To order a service:
1. Click Order Service.
The Service Ordering Wizard appears.
2. In the Filter field, type the name or part of the name of a service that you want to order and select the
service or just select from the available list of services, and then click Next.
The Parameters tab appears.
NOTE: Parameters in the Selected Service: <serviceName> dialog box only appears if service
parameters were defined in the Service Manager in the Control-M Workload Automation.
3. For each parameter, type the required values, and then click Order.
The service has been ordered successfully and a service order ID appears.
4. Do one of the following:
• Click Close this window
• To order another service, click Order another service.
Service details
The following table describes the details of each tab in the Service view in Control-M Self Service.
Tab Description
General Shows details such as, start and end time, progress, number
of jobs in the service, number of jobs completed, order ID, and
description of the selected service, as described in Service
General tab (on page 13).
Parameters Shows the defined parameters and values of the selected

service
Log Shows the activity log of the selected service, as described in

Service Log tab (on page 14)
12
Service General tab

The following table describes the basic parameters for the selected service.
Parameter Description
Status Shows one of the following possible statuses:

 OK
 Not OK
 Warning
 Completed
 Completed Late
 OK and Completed OK
 Not OK and Completed Late
Start Time Shows the timestamp when the service started to run.
End Time Shows the timestamp when the service stopped running.
Ordered By Shows the name of the person who ordered the service.
Deadline Shows the time when a Batch Impact Manager service must
complete to not be considered late (Batch Impact Manager
services only).
Order ID Shows the Order ID number.
Total Jobs Shows how many jobs are in the service.
Jobs Completed Shows how many jobs within the service completed.
Priority Shows the priority level of the service (Batch Impact Manager
services only).
13
Service Log tab

The following table describes the activity parameters of the service.
Event Time Shows the timestamp of the service activity.
From Status Shows the previous status of the service.
To Status Shows the current status of the service.
Message ID Shows the ID number of the event message.
14
3
Chapter
3
Control-M Self Service job management
Control-M Self Service enables you to view the status of your jobs, check for problems, and perform various
job actions.
The following procedures describe how to filter, hold, release, re-run, confirm, restart, set to OK, kill, order,
and update jobs:
 Finding jobs (on page 15): Describes how to find a job in Control-M Self Service
 Holding a job (on page 16): Describes how to hold a job, which stops the job from Control-M processing
and enables you to update the job
 Releasing a job (on page 16): Describes how to release a job from a Hold state, which enables the job
to run
 Re-running a job (on page 17): Describes how to run a job in Control-M Self Service
 Confirming a job (on page 17): Describes how to confirm a job, which enables the job to continue
running
 Restarting a job (on page 17): Describes how to re-run a Control-M for z/OS job from a specific state
 Setting a job to OK (on page 19): Describes how to set a job to end OK, which overrides any defined
scheduling criteria and sends the job to the active job environment
 Terminating a job (on page 19): Describes how to terminate a job from the Control-M Self Service, which
cancels a job from running in the middle of the execution
 Ordering a job now (on page 19): Describes how to order a job, which runs the job and overrides the
submission criteria
 Updating a job (on page 20): Describes how to update properties
If you want to enable Audit Annotations on each job action, contact your Control-M Administrator.
Finding jobs
This procedure describes how to find jobs in Control-M Self Service, which enables you to check for problems
and resolve them by performing various job actions.
 To find jobs:
1. From the Service View tab, right-click the service that contains the jobs you want to find and select
Browse Jobs.
2. In the Search toolbar, click the Show/Hide arrow .

3. Find jobs by doing one or more of the following:
15
• In the Job properties containing field, type the name or part of a name of the job that you want
to find.
• From the Job status is dropdown list, select the job status that you want to filter.
4. Click .
The jobs that match the filtered criteria appear.
5. To view the job details, click one of the tabs in the right pane, as described in Job details (on page 21).
Holding a job
This procedure describes how to hold a job, which stops the job from Control-M processing and enables you
to update the job.
 To hold a job:
1. From the Service View tab, right-click the service that contains the jobs you want to hold and select
Browse Jobs.
2. Select the job you want to hold.
3. From the Actions dropdown list, select Hold.
The job is on hold and you can now update the job. Control-M Self Service automatically refreshes the
jobs at defined intervals.
Releasing a job
This procedure describes how to release a job from a Hold state, which enables the job to run.
 To release a job:
1. From the Service View tab, right-click the service that contains the jobs you want to release and select
Browse Jobs.
2. Select the job you want to release.
3. From the Actions dropdown list, select Release.
The job is released and can now continue processing according to its definition. Control-M Self Service
automatically refreshes the jobs at defined intervals.
16
Re-running a job
This procedure describes how to re-run a job in Control-M Self Service.
 To run a job:
1. From the Service View tab, right-click the service that contains the jobs you want to re-run and select
Browse Jobs.
2. Select a job that has finished running that you want to re-run.
3. From the Actions dropdown list, select Rerun.
The job executes. Control-M Self Service automatically refreshes the jobs at defined intervals.
Confirming a job
This procedure describes how to confirm a job that is waiting for confirmation, which enables the job to
continue running.
NOTE: If the job is not defined to request user confirmation, you do not need to do this procedure.
 To confirm a job:
1. From the Service View tab, right-click the service that contains the jobs you want to confirm and select
Browse Jobs.
2. Select a Wait User job you want to confirm.
3. From the Actions dropdown list, select Confirm.
A confirmation message appears.
4. Click Yes.
The job is confirmed and continues to execute. Control-M Self Service automatically refreshes the jobs at
defined intervals.
Restarting a job
This procedure describes how to restart a Control-M for z/OS job from a specific state.
 To restart a job:
1. From the Service View tab, right-click the service that contains the Control-M for z/OS job you want to
restart and select Browse Jobs.
2. Select the Control-M/for z/OS job you want to restart.
3. From the Actions dropdown list, select Restart.
The Restart job dialog box appears.
17
4. For each field, type the required value, as described in Restart job parameters (on page 18).
5. Click Yes.
The Control-M/for z/OS job restarts. Control-M Self Service automatically refreshes the jobs at defined
intervals.
Restart job parameters

The following table describes Restart job parameters for Control-M for z/OS jobs. To define Restart job
parameters, see Restarting a job (on page 17).
Restart job dialog box
Field Description
From Step/Proc Determines the job restart point of the pgmstep and
procstep steps.
To Step/Proc Determines the job restart end point of the pgmstep and
procstep steps.
If a from step/proc value is defined, and the To
step/proc field is blank, the job reruns up to and including
the last step.
Recapture Abend Codes Determines whether to save the Abend codes from the original
job execution
Recapture Cond Codes Determines whether to save the condition codes from the
original job execution
Step Adjustment Determines whether to enable automatic Step Adjustment.

For more details about Step Adjustment, see the
Control-M/Restart User Guide.
Restart Parm Member Name Defines the name of the member that contains control
parameters for the job to restart (1-8 characters only). The
default value is the member that contains the JCL of the job.
18
Ordering a job now

This procedure describes how to order a job, which runs the job and overrides the submission criteria.
 To order a job now:

1. From the Service View tab, right-click the service that contains the jobs you want to order and select
Browse Jobs.
2. Select the job you want to order.
3. From the Actions dropdown list, select Order Now.
The job runs overriding any submission criteria. Control-M Self Service automatically refreshes the jobs
at defined intervals.
Setting a job to OK
This procedure describes how to set a job to end OK, which overrides any defined scheduling criteria and
sends the job to the active job environment.
 To set a job:
1. From the Service View tab, right-click the service that contains the jobs you want to set to OK and
select Browse Jobs.
2. Select the job you want to set to OK.
3. From the Actions dropdown list, select Set to OK.
The job ends OK. Control-M Self Service automatically refreshes the jobs at defined intervals.
Terminating a job
This procedure describes how to terminate a job from the Control-M Self Service, which cancels a job from
running in the middle of the execution.
 To terminate a job:
1. From the Service View tab, right-click the service that contains the jobs you want to terminate and
select Browse Jobs.
2. Select the job you want to terminate.
3. From the Actions dropdown list, select Kill.
The job is terminated and no longer continues to run. Control-M Self Service automatically refreshes the
jobs at defined intervals.
19
Updating a job
This procedure describes how to update job properties.
 To update a job:
1. From the Service View tab, right-click the service that contains the jobs you want to update and select
Browse Jobs.
2. Select the command line job you want to update and hold, as described in Holding a job (on page 16).
3. From the Actions dropdown list, select Update.
The Update job dialog box appears.
4. For each field, type the required value, as described in Update job parameters (on page 20).
5. Click OK.
Update job parameters

The following table describes update job parameters. To define the update job parameters, see Updating a
job (on page 20).
Update job parameters
General script Defines the name of the script that the job uses to run
This field is only enabled when the job task type is command.
Activity period submit Determines the start time for the job to run
between
to Determines the end time for the job to run
Time zone Determines which time zone Control-M Self Service uses to
determine when to run the job
20
Job details
The following table describes the details of each tab in the Jobs view in Control-M Self Service.
Tab Description
General Shows fields such as, start time and end time, order ID, order
date, status, attributes of the selected job, as described in Job
General tab (on page 22).
Log Shows the activity log of the selected job.
Waiting Info Shows the reasons why the job did not run.
Output Shows the different outputs of the selected job. To view, see
Viewing job output (on page 23).
Statistics Shows the statistics of the selected job, as described in

Statistics tab (on page 23).
Script Shows the script of the selected job.
Variables Shows the defined variables and values of the selected job.
Applications Shows the fields and values of the specific application job
form.
21
Job General tab

The following table describes the basic parameters for the selected job.
Run As Shows the name of a user with authorized to run the job.
Run Where Shows the host ID and host group of the job.
Status Shows one of the following possible statuses:

 Failure/Error
 Ended OK
 Executing
 Unknown
 Wait Condition
 Wait Resource
 Wait User
Start Time Shows the timestamp when the job started to run.
End Time Shows the timestamp when the job stopped running.
Execution Time Shows the number of seconds that it takes to run the job.
Order ID Shows the Order ID number.
ODate Shows the date that the job was ordered.
Description Shows a description of the job.
Job Type Shows one of the following possible job types:

 OS
 z/OS
 BIM
 Applications (SAP, Oracle E-Business Suite, AFT,
Databases, BPI, PeopleSoft)
Sub Application Shows the Sub Application that the job is associated with at
the third level in the node hierarchy in the Control-M
environment.
22
Application Shows the application that the job is associated with at the
second level in the node hierarchy in the Control-M
environment.
Parent Folder Shows the folder container that the job is associated with at
the fourth level in the node hierarchy in the Control-M
environment.
Cyclic Shows whether the job runs at defined cyclic intervals.
Viewing job output

This procedure describes how to view output of a job in Control-M Self Service, which enables you to review
the actions of a job to determine if and where the job did not process correctly.
 To view job output:

1. Select a job and click the Output tab.
2. From the dropdown list, select the output file you want to view.
3. Do one or more of the following:
• To view the latest version of the output, click View latest.
• To view specific characters or words in the output, in the Search field, type the words or characters
that you want to view and then click .
• To view job output in a separate window, click Open job output in a separate window.
Statistics tab
The following table describes the start time, end time, and projection parameters for the selected job.
Statistics tab
Start Time Shows the start time of the job
End Time Shows the end time of the job
Projection Shows the estimated start and end time of the job
23

Control-M Workload Automation 8.0.00.100 Self Service User Guide

Uploaded by

Copyright:

Available Formats

Control-M Workload Automation 8.0.00.100 Self Service User Guide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Control-M Workload Automation 8.0.00.100 Self Service User Guide

Uploaded by

Copyright:

Available Formats

Control-M Workload Automation

Outside United States and Canada

© Copyright 2013 BMC Software, Inc.

Control-M Self Service service management .................................................................... 10

Control-M Self Service job management ......................................................................... 15

Control-M Self Service navigation

Enables you to refresh the Service View manually.

Enables you to view the details of a service from specific date,

Enables you to hold and release the selected service, as

Enables you to order a service, as described Ordering a service

Enables you to view the services in Tile view that shows

Enables you to view the services in List view that shows

Enables you to navigate to the previous job in your job

Enables you to navigate to the next job in your job selection.

Enables you to refresh the Jobs View manually.

Enables you to navigate to the predecessor or successor of a

Enables you to hold, release, re-run, confirm, restart, set to

Enables you to view the jobs in List view that shows

Zoom Enables you to zoom in and out on jobs in Tile view.

Viewing the history of services

Parameters Shows the defined parameters and values of the selected

Log Shows the activity log of the selected service, as described in

Service General tab

Status Shows one of the following possible statuses:

Order ID Shows the Order ID number.

Total Jobs Shows how many jobs are in the service.

Service Log tab

Event Time Shows the timestamp of the service activity.

From Status Shows the previous status of the service.

To Status Shows the current status of the service.

Message ID Shows the ID number of the event message.

2. In the Search toolbar, click the Show/Hide arrow .

Restart job parameters

Step Adjustment Determines whether to enable automatic Step Adjustment.

Ordering a job now

 To order a job now:

Update job parameters

to Determines the end time for the job to run

Log Shows the activity log of the selected job.

Statistics Shows the statistics of the selected job, as described in

Script Shows the script of the selected job.

Job General tab

Status Shows one of the following possible statuses:

Order ID Shows the Order ID number.

ODate Shows the date that the job was ordered.

Description Shows a description of the job.

Job Type Shows one of the following possible job types:

Cyclic Shows whether the job runs at defined cyclic intervals.

Viewing job output

 To view job output:

Start Time Shows the start time of the job

End Time Shows the end time of the job

You might also like