BMC Control-M for Oracle E-Business Suite 9.0.00 Administrator Guide
Publicité
Publicité
Control-M for Oracle E-Business
Suite
9.0.00
Administrator Guide
April 2015
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
2101 CITYWEST BLVD
HOUSTON TX
77042-2827
USA
Telephone 713 918 8800
800 841 2031
Fax 713 918 8000
Outside United States and Canada
Telephone (01) 713 918 8800 Fax (01) 713 918 8000
© Copyright 1999-2015 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.
IBM® Tivoli® Business Service Manager, IBM Tivoli Workload Scheduler, IBM Cognos, IBM InfoSphere
DataStage, IBM iSeries, IBM Websphere, and AIX® are the trademarks or registered trademarks of
International Business Machines Corporation in the United States, other countries, or both.
UNIX® is the registered trademark of The Open Group in the US and other countries.
Linux is the registered trademark of Linus Torvalds.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
SAP® R/2 and SAP R/3, SAP Business Objects, and SAP NetWeaver are trademarks or registered trademarks of SAP AG in Germany and in several 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
2
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.”
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 [email protected]
(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
3
Serial numbers
Related software (database, application, and communication) including type, version, and service pack or maintenance level
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 [email protected]
.
(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 [email protected]
.
(Asia-Pacific) Contact your BMC sales representative or your local BMC office.
Third party Software
For the provisions described in the BMC License Agreement and Order related to third party products or technologies included in the BMC Product, see https://docs.bmc.com/docs/display/workloadautomation/Control-M+Workload+Automation+Documentati on and click Third-party software (TPS).
4
Contents
5
1
1
Introduction to Control-M for Oracle E-Business
Suite
Chapter
Control-M for Oracle E-Business Suite overview
Control-M for Oracle E-Business Suite is an application plug-in that enables you to communicate between
Control-M and Oracle-E Business Suite and serves as the unified interface for the transmission and monitoring of scheduled and alert initiated jobs.
Before you begin, do the following:
Install Control-M for Oracle E-Business Suite, as described in Installation
Connect to an OEBS server as described in Connection profile management (on page 16 ).
Control-M for Oracle E-Business Suite jobs are integrated with other Control-M jobs into a single scheduling environment. This enables you to control OEBS within Control-M and enables you to do the following:
Define and monitor Control-M for Oracle E-Business Suite jobs, as described in Control-M for Oracle
E-Business Suite job definition.
Trigger Control-M jobs and conditions as a result of ad-hoc events occurring in the Oracle E-Business system.
Integrate OEBS jobs with other Control-M jobs into a single scheduling environment, as described in
Using Control-M Workload Automation.
Introduce all Control-M capabilities to OEBS, including advanced scheduling criteria, complex dependencies, quantitative and control resources, and variables, as described in
Workload Automation
.
Using Control-M
6
Control-M for Oracle E-Business Suite Administrator Guide
Administrative roles
Certain Control-M for Oracle E-Business Suite tasks might need to be performed by different professionals in your organization, as follows:
System Administrator: Responsible for reviewing the system requirements and performing the installation process.
Control-M Administrator : Responsible for the administration of all Control-M processes.
Control-M Production Controller : Responsible for defining and/or monitoring Control-M jobs.
The following table lists the tasks performed when working with Control-M for Oracle E-Business Suite and the role of the professional who is responsible for its administration.
Tasks
Install Control-M for Oracle E-Business Suite on a
Control-M/Agent on UNIX, as described in Installing
Installing Control-M for Oracle E-Business Suite on
Control-M/Agent on Windows (on page 10 ).
Install Control-M for Oracle E-Business Suite plug in on
Control-M/Agent on UNIX and Windows, as described in
Installation on Control-M/EM (on page 11 )
Manage Control-M for Oracle E-Business Suite connection
profiles, as described in Control-M Configuration Manager administration (on page 16 ).
Define Control-M for Oracle E-Business Suite jobs, as
described in Job definition (on page 50 ).
Roles
System Administrator
Control-M Administrator
System Administrator
Control-M Administrator
Control-M Administrator
Control-M Administrator
7
2
Installation
2
Control-M for Oracle E-Business Suite can be installed on a Windows Control-M/Agent or on a UNIX
Control-M/Agent. If Control-M for OEBS version 6.4.01 is already installed, you must upgrade to version
8.0.00, as prompted by the installation wizard. Before performing an upgrade, you must stop the
Extractor process.
The following procedures describe how to install and uninstall Control-M for Oracle E-Business Suite:
Setting environment variables in UNIX (on page 8 ): Describes how to set environment variables in
UNIX.
Installing Control-M for Oracle E-Business Suite on Control-M/Agent on UNIX (on page 9 ): Describes
how to install Control-M for Oracle E-Business Suite on Control-M/Agent on UNIX via an interactive and automatic installation.
Installing Control-M for Oracle E-Business Suite on Control-M/Agent on Windows (on page 10 ):
Describes how to install Control-M for Oracle E-Business Suite on Control-M/Agent on Windows via an interactive and automatic installation.
Installation on Control-M/EM (on page 11 ): Describes how to install Control-M for Oracle E-Business
Suite plug-in on a Control-M/EM client computer and on a Control-M/EM Server computer.
Oracle E-Business Suite on UNIX and on Windows.
Setting environment variables in UNIX
This procedure describes how to set environment variables in UNIX, which enables you to see messages from the console.
To set environment variables in UNIX:
Do one of the following:
If you use csh or tcsh , use the following syntax: setenv
<envVar> <value>
EXAMPLE: setenv DISPLAY myhost:0.0
If you use sh or ksh , use the following syntax:
<envVar>=<value>
export
<envVar>
EXAMPLE:
DISPLAY=myhost:0.0 export DISPLAY
<envVar>
is the name of the environment variable.
8
Control-M for Oracle E-Business Suite Administrator Guide
<value>
is the value assigned to the environment variable.
Installing Control-M for Oracle E-Business Suite on
Control-M/Agent on UNIX
This procedure describes how to install Control-M for Oracle E-Business Suite on Control-M/Agent on
UNIX interactively or automatically. If you want to install multiple instances of Control-M for Oracle
E-Business Suite on several computers using the same configuration, use the automatic installation, as described in this procedure.
NOTE: The default installation is interactive and uses a GUI display. XServer must be running and configured using the DISPLAY environment variable. If you do not have XServer available, BMC recommends that you continue with the console installation or perform an automatic installation.
Before You Begin
Ensure the following:
Verify that all jobs running on Control-M/Agent have ended.
If you are using Linux x86_64 platform that runs 32bit version of the Control-M/Agent, install the following 32bit libraries: libXtst.so.6
and libXi.so.6
.
To install Control-M for Oracle E-Business Suite on Control-M/Agent on UNIX:
1.
Log in as the Control-M/Agent user, and stop the Control-M/Agent by typing the following command:
$CONTROLM/scripts/shut-ag -u <agentUser> -p all
If the Control-M/Agent was installed with user root , then log in as user root every time you start up or shut down the Control-M/Agent throughout this procedure.
If you are using an AIX operating system, you must remove unused libraries from memory, by typing the following command as a root user:
2.
/usr/sbin/slibclean
Do one of the following:
Mount the installation DVD.
Extract the files from the temporary directory that you created when obtaining the installation files via EPD (
see Control-M for Oracle E-Business Suite Release Notes
).
3.
Use one of the following modes:
Display : If you install using GUI (or XServer), set your DISPLAY environment variable, as
described in Setting environment variables in UNIX (on page 8 ).
Console : It is not necessary to set DISPLAY.
4.
From the installation DVD or from the installation files via EPD, activate the installation script with the following command:
<
source_path
>/setup.sh
5.
Do one of the following:
Interactive install : Continue with the on-screen instructions until the installation is complete.
9
Control-M for Oracle E-Business Suite Administrator Guide
Automatic install : Do the following: a.
Continue with the on-screen instructions until the Summary window. b.
Click Generate and select the location to create the XML parameter file. c.
Click Yes.
d.
Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation. e.
To run the installation script, type the following command:
<source_path>
/setup.sh –silent <
filename.xml
>
The installation logs can be found at the following location:
$HOME/BMCINSTALL/log/cmoebs/BMC_Control-M_For_OEBS_Install_<date-time>.log
6.
Log out of the Control-M/Agent account.
7.
Start the Control-M/Agent by running the following command:
$CONTROLM/scripts/start-ag -u <agentUser> -p all
8.
To use the Control-M for Oracle E-Business Suite utilities in Control-M Configuration Manager, run the ctmgetcm utility in the Control-M/Server, as described in
ctmgetcm in Control-M Workload
Automation Utilities.
Installing Control-M for Oracle E-Business Suite on
Control-M/Agent on Windows
This procedure describes how to install Control-M for Oracle E-Business Suite on Control-M/Agent on
Windows.
If you want to install multiple instances of Control-M for Oracle E-Business Suite on several computers using the same configuration, use the automatic installation, as described in this procedure.
Before You Begin
Verify that all jobs running on Control-M/Agent have ended.
To install Control-M for Oracle E-Business Suite on Control-M/Agent on Windows:
1.
Log in to the computer as a user who has Administrator authorization.
2.
Do one of the following:
From the installation DVD, double-click the setup.exe
file.
From a command prompt window, type <
source_path
>\setup.exe
.
3.
Do one of the following:
Interactive install : Continue with the on-screen instructions until the installation is complete.
Automatic install : Do the following: a.
Continue with the on-screen instructions until the Summary window. b.
Click Generate and select the location to create the XML parameter file.
10
Control-M for Oracle E-Business Suite Administrator Guide c.
Click Yes .
The automatic installation XML parameters file that is created (< only for computers with the same Control-M/EM version. Otherwise, a separate
<
filename
computer.
filename
>.xml) is relevant
>.xml file must be created for each computer, or modified manually for each d.
Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation. e.
Run the installation script, as follows:
<DVD>\setup.exe -silent <filename.xml>
The installation log can be found at the following location:
BMCINSTALL\log\cmoebs\BMC_Control-M_For_OEBS_Install_<
date-time
>.log
In case of installation failure, the log file is located in the following location:
%temp%\BMC_Control-M_For_OEBS_Install_<date-time>.log
4.
To use the Control-M for Oracle E-Business Suite utilities in the Control-M Configuration Manager, you must run the ctmgetcm utility in the Control-M/Server, as described in
ctmgetcm
in
Control-M
Workload Automation Utilities.
NOTE: When upgrading from a previous version, if the remote client is uninstalled, you need to re-start Windows.
Installation on Control-M/EM
After you have installed Control-M for Oracle E-Business Suite on the Control-M/Agent, you must install
Control-M for Oracle E-Business Suite plug-in on the Control-M/EM client and Control-M/EM Server computer.
This procedure must be performed on every computer that has Control-M/EM client or Control-M/EM
Server components installed.
The following procedures describe how to install the Control-M for Oracle E-Business Suite plug-in on
Control-M/EM:
Installing the Control-M for Oracle E-Business Suite plug-in on Control-M/EM on UNIX (on page 11 )
Installing the Control-M for Oracle E-Business Suite plug-in on Control-M/EM on Windows (on page
Installing the Control-M for Oracle E-Business Suite plug-in on
Control-M/EM on UNIX
This procedure describes how to install Control-M for Oracle E-Business Suite plug-in on the Control-M/EM on UNIX, which installs the CCM, self service, Find and Update and forms in Control-M/EM.
Before you begin
Ensure that Control-M for Oracle E-Business Suite LPOAC.9.0.00 DVD is mounted or accessible through your network.
11
Control-M for Oracle E-Business Suite Administrator Guide
To install the Control-M for Oracle E-Business Suite plug-in on Control-M/EM on
UNIX:
1.
Log in as the Control-M/EM user.
2.
Use one of the following modes:
Display : If you install using the GUI (or XServer), set your DISPLAY environment variable,
according to your computer name, as described in Setting environment variables in UNIX (on page 8 ).
For csh or tcsh shell users: setenv DISPLAY <your computer name>:0.0
Console : It is not necessary to set DISPLAY.
3.
From the installation DVD or from the installation files via EPD, activate the installation script with the following command:
<
DVDROM_path
> /EM/setup.sh
4.
Do one of the following:
Interactive install : Continue with the on-screen instructions until the installation is complete.
Automatic install : Do the following: a.
Continue with the on-screen instructions until the Summary window. b.
Click Generate and select the location to create the XML parameter file. c.
Click Yes.
The automatic installation XML parameters file that is created (< only for computers with the same Control-M/EM version. Otherwise, a separate
<
filename
computer.
filename
>.xml) is relevant
>.xml file must be created for each computer, or modified manually for each d.
Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation. e.
To run the installation script, type the following command:
<
source_path
>/EM/setup.sh -silent <
filename.xml>
The installation logs can be found at the following location:
$HOME/BMCINSTALL/log/BMC_Control-M-CM_EM_Install_<date-time>.log
5.
Once completed, run the following commands to restart Control-M Configuration Server:
stop_cms
start_cms
The plug in is now installed on Control-M/EM.
12
Control-M for Oracle E-Business Suite Administrator Guide
Installing the Control-M for Oracle E-Business Suite plug-in on
Control-M/EM on Windows
This procedure describes how to install Control-M for Oracle E-Business Suite plug-in on the Control-M/EM on Windows, which installs the CCM, Self Service, Find and Update and forms in Control-M/EM.
Before you begin
Ensure the following:
Control-M for Oracle E-Business Suite LPOAC.9.0.00 DVD is mounted or accessible through your network.
Control-M Configuration Manager and Control-M Workload Automation are closed.
To install the Control-M for Oracle E-Business Suite plug-in on Control-M/EM on
Windows:
1.
Log in with a user ID with administrator privileges on the specific computer.
2.
On the LPOAC.9.0.00 DVD, navigate to the EM directory.
3.
Do one of the following:
From the installation DVD, double-click the EM\setup.exe file.
From a command prompt window, enter <
DVDROM_path
>\EM\setup.exe.
4.
Do one of the following:
Interactive install : Continue with the on-screen instructions until the installation is complete.
Automatic install : Do the following: a.
Continue with the on-screen instructions until the Summary window. b.
Click Generate and select the location to create the XML parameter file. c.
Click Yes .
The automatic installation XML parameters file that is created (< only for computers with the same Control-M/EM version. Otherwise, a separate
<
filename
computer.
filename
>.xml) is relevant
>.xml file must be created for each computer, or modified manually for each d.
Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation. e.
Run the installation script, as follows:
<
DVDROM_path
>\EM\setup.exe -silent <
silent.xml
>
The installation log can be found at the following location or under the directory that contains the
%temp% directory:
%temp%\BMC_Control-M-CM_EM_Install_<date-time>.log
5.
If the Control-M for Oracle E-Business Suite was installed on Control-M/EM Server, you need to restart the Control-M GUI Server.
The plug-in is now installed.
13
Control-M for Oracle E-Business Suite Administrator Guide
Control-M for Oracle E-Business Suite Uninstall
The following procedures describe how to uninstall Control-M for Oracle E-Business Suite from UNIX and
Microsoft Windows:
Uninstalling Control-M for Oracle E-Business Suite from UNIX (on page 14 )
Uninstalling Control-M for Oracle E-Business Suite from Windows (on page 14 )
Performing an automatic uninstall from Windows (on page 15 )
Uninstalling Control-M for Oracle E-Business Suite from UNIX
This procedure describes how to uninstall Control-M for Oracle E-Business Suite from UNIX.
Before You Begin
Verify that all jobs have ended.
To uninstall Control-M for Oracle E-Business Suite from UNIX:
1.
From a Control-M/Agent computer, log in as a Control-M/Agent user, and type the following command to shut down Control-M/Agent:
$CONTROLM/scripts/shut-ag -u <agentUser> -p all
NOTE: If the Control-M/Agent was installed with user root, then log in as user root every time you start up or shut down the Control-M/Agent throughout this procedure.
2.
Set your DISPLAY
3.
Navigate to the following directory:
$HOME/BMCINSTALL/uninstall/DROAC.9.0.00
4.
Type one of the following commands:
Interactive: ./uninstall.sh
Automatic: /uninstall.sh -silent
Control-M for Oracle E-Business Suite has been successfully removed from your computer.The installation logs can be found at the following location:
$HOME/BMCINSTALL/log/cmoebs/BMC_Control-M_OEBS_Uninstall_<date-time>.log
5.
To restart Control-M/Agent, type the following command:
$CONTROLM/scripts/start-ag -u <agentUser> -p all
Uninstalling Control-M for Oracle E-Business Suite from Windows
This procedure describes how to uninstall Control-M for Oracle E-Business Suite from Windows.
Before You Begin
Verify that all jobs have ended.
14
Control-M for Oracle E-Business Suite Administrator Guide
To uninstall Control-M for Oracle E-Business Suite from Windows:
1.
From the Start menu, select Settings > Control Panel .
2.
Double-click Add/Remove Programs .
3.
Select Control-M for Oracle E-Business Suite 9.0.00
, and click Add/Remove .
4.
Click OK to continue.
Control-M for Oracle E-Business Suite is successfully removed from your computer.
Performing an automatic uninstall from Windows
This procedure describes how to perform an automatic uninstall from Windows.
Before You Begin
Verify that all jobs have ended.
To perform an automatic uninstall from Windows:
1.
Log in to the computer using a user ID that has Administrator authorizations.
2.
Navigate to the following directory:
<Agent Install Path>\BMCINSTALL\uninstall\DROAC.9.0.00\
3.
Open a command prompt window as an Administrator and type the following command: uninstall.exe -silent
Control-M for Oracle E-Business Suite is successfully removed from your computer. The installation log can be found at the following location:
BMCINSTALL\log\cmoebs\BMC_Control-M_OEBS_Uninstall_<
timestamp
>.log
15
3
3
Control-M Configuration Manager administration
Control-M for Oracle E-Business Suite enables you to perform the following configuration and administrative tasks in the Control-M Configuration Manager (CCM):
Connection profile management (on page 16 ): Enables you to create, update, delete, test, copy, and
export connection profiles.
Event Watcher Management (on page 22 ): Enables you to activate the Event Watcher for a specified
connection profile, define, update, copy, delete, and prioritize events. You can also define, edit, copy and delete Control-M actions to execute after alert confirmation.
Connection profile management
Before you can define a Control-M for Oracle E-Business Suite job in Control-M Workload Automation, you need to create a connection profile in the Control-M Configuration Manager, which enables you to connect to the required OEBS server.
A connection profile contains the connection parameters to a specified OEBS server, such as host name, port, user name, and password. By adding a connection profile to the Control-M Configuration Manager, you enable Control-M for Oracle E-Business Suite users to connect to the required OEBS server with only the connection profile name.
Users then can run a job without having to provide authentication details every time they connect to the
OEBS server.
The following procedures describe how to create, edit, delete, test, copy, and export a connection profile in the Control-M Configuration Manager.
Creating a connection profile (on page 17 )
Editing a connection profile (on page 20 )
Deleting a connection profile (on page 20 )
Testing a connection profile (on page 20 )
Copying a connection profile (on page 21 )
Exporting a connection profile (on page 21 )
16
Control-M for Oracle E-Business Suite Administrator Guide
Connection Profile user permissions
The following table describes the Control-M user permissions for Connection Profile management.
Permission Description
BROWSE
UPDATE
FULL
View already defined Connection Profiles
Update an existing Connection Profile
Test Connection Profile
Add new Connection Profile
Delete Connection Profile
Creating a connection profile
This procedure describes how to create an OEBS connection profile in the Control-M Configuration
Manager, which enables you to define an OEBS job in Control-M Workload Automation.
To create a connection profile:
1.
From Control-M Configuration Manager, select Control-M for Oracle E-Business Suite on the host that you want to manage, right-click and select Connection Profile Management .
The CM for Oracle E-Business Suite -Connection Profile Management dialog box appears.
2.
Click .
The Add Connection Profile - Set Connection Details dialog box appears.
3.
In the Connection Profile Name field, type the name of the connection profile that you want to add.
The connection profile name must begin with a letter and without any blanks or special characters.
4.
5.
Click Next .
The Add Connection Profile - Default Control-M Options dialog box appears.
6.
Complete the Control-M Job Output handling parameters, as described in Default Control-M Job
Options parameters (on page 19 ).
7.
The Add Connection Profile - Summary dialog box appears.
8.
(Optional) Review the connection profile details, and click Test .
If the test completed successfully, the connection profile is validated and you can now define an OEBS job, as described in Defining a Control-M for Oracle E-Business Suite job. If the test failed, review the error message and test it again.
17
Control-M for Oracle E-Business Suite Administrator Guide
9.
Click Finish .
The connection profile is added to the CM for Oracle E-Business Suite -Connection Profile
Management dialog box.
Control-M for Oracle E-Business Suite connection profile parameters
The following table lists the set connection detail parameters to add a connection profile.
Field
Service Name
User Name
Password
Description
Defines the Oracle client connection identifier registered in tnsnames.ora file. Click Load to select a service name from tnsnames.ora file. Mandatory.
For more information, consult your Oracle database administrator.
Defines the user name for the OEBS server
Defines the password for the OEBS server
Confirm Password Confirms the password for the OEBS server
Use Default Client Language Defines the NLS language used by Oracle client.
Default: Oracle client language
For more information consult your Oracle database administrator.
18
Control-M for Oracle E-Business Suite Administrator Guide
Default Control-M Job Options parameters
The following table describes the Control-M Job Options parameters.
NOTE: When selecting any of the Control-M Job Options parameters, you install PL/SQL package in the database.
Parameter Description
Control-M Job - Output handling
Enable viewing Request log/output in job output
Append Request log to job output
Append Request output to job output
Enables you attach the Control-M for OEBS concurrent request log and output to the Control-M job output.
Default: Selected
For more information, see Oracle E-Business Suite job output (on page 36 ).
When selected, the Control-M for Oracle E-Business Suite request log is copied to the Control-M job output.
Default: Selected
When selected, the Control-M for Oracle E-Business Suite request output is copied to the Control-M job output.
Default: Not selected
Control-M Job Completion Status
Allow job to complete successfully even if OEBS warning occurred
When selected, Control-M job ends successfully even if Control-M for Oracle E-Business Suite request ended with a Warning status.
Default: Not selected
Monitor all child requests (Wait
Child)
Job completion status will depend on child request status
When selected, the status of child jobs are tracked. If not selected, only the status of the parent job is tracked.
Default: Selected
When selected, the Control-M job’s ending status is set according to the “worst” completion status of all the child requests. If not selected, the job status is determined by the parent job’s ending status.
Default: Not selected
19
Control-M for Oracle E-Business Suite Administrator Guide
Editing a connection profile
This procedure describes how to edit a connection profile in the Control-M Configuration Manager.
To edit a connection profile:
1.
From the Control-M Configuration Manager, select Control-M for Oracle E-Business Suite , right-click and select Connection Profile Management .
The CM for Oracle E-Business Suite -Connection Profile Management dialog box appears.
2.
Select the connection profile that you want to edit, and click .
The Update <
connection profile
> Connection Profile dialog box appears.
3.
In the Oracle Connection Details
tab, type the required value, as described in Control-M for Oracle
E-Business Suite connection profile parameters (on page 18 ).
4.
In the Default Control-M Job Options
tab type the required value, as described in Default
Control-M Job Options parameters (on page 19 ).
5.
Review the connection profile details and click Test (optional).
If the test completes successfully, the connection profile validates and you can now define an OEBS job, as described in Defining a Control-M for Oracle E-Business Suite job. If the test fails, review the error message and test it again.
6.
Click OK .
The connection profile is updated in the CM for Oracle E-Business Suite -Connection Profile
Management dialog box.
Deleting a connection profile
This procedure describes how to delete a connection profile from the Control-M Configuration Manager.
To delete a connection profile:
1.
From the Control-M Configuration Manager, select Control-M for Oracle E-Business Suite , right-click and select Connection Profile Management .
The CM for Oracle E-Business Suite -Connection Profile Management dialog box appears.
2.
Select the connection profile that you want to delete, and click
A confirmation message appears.
3.
Click Yes .
The connection profile is deleted.
.
Testing a connection profile
This procedure describes how to test a connection profile in the Control-M Configuration Manager, to validate the connection parameters.
20
Control-M for Oracle E-Business Suite Administrator Guide
To test a connection profile:
1.
From Control-M Configuration Manager, select Control-M for Oracle E-Business Suite , right click and select Connection Profile Management .
The CM for Oracle E-Business Suite -Connection Profile Management dialog box appears.
2.
Select the connection profile that you want to test, and click .
If the test completes successfully, the connection profile validates and you can now define an OEBS
job, as described in Defining a Control-M for Oracle E-Business Suite job (on page 50 ). If the test
fails, review the error message(s), fix any problems as necessary, and test it again.
Copying a connection profile
This procedure describes how to copy a connection profile in the Control-M Configuration Manager, which enables you to create an additional connection profile using the parameters of an existing connection profile.
To copy a connection profile:
1.
From the Control-M Configuration Manager, select Control-M for Oracle E-Business Suite , right-click and select Connection Profile Management .
The CM for Oracle E-Business Suite -Connection Profile Management dialog box appears.
2.
Select the connection profile that you want to copy, and click .
The Copy <
connection profile
> Connection Profile dialog box appears.
3.
In the Connection Profile Name field, enter a name for the new connection profile and click OK .
4.
Click Test (
optional
).
If the test completes successfully, the connection is validated and you can now define an OEBS job,
review the error message and test it again.
5.
Click OK .
Exporting a connection profile
This procedure describes how to export a connection profile from one Control-M/Agent to another
Control-M/Agent, where Control-M for Oracle E-Business Suite is installed.
To export a connection profile:
1.
From the Control-M Configuration Manager, select Control-M for Oracle E-Business Suite on the host that you want to manage, right-click and select Connection Profile Management .
The CM for Oracle E-Business Suite -Connection Profile Management dialog box appears.
2.
Select the connection profile that you want to export, and click .
21
Control-M for Oracle E-Business Suite Administrator Guide
The Connection Profile Management - Export Connection Profile Destination dialog box appears.
3.
From the Control-M/Server name drop-down list, select the Control-M/Server that contains the
Control-M/Agent, where you want to export the connection profile.
4.
From the Control-M/CM Host Name drop-down list, select the Control-M/Agent that contains the connection profile on the CM you want to export.
5.
Click OK .
The Export Connection Profile Destination dialog box appears.
6.
In the Connection Profile Name field, enter a name for the exported connection profile and click
OK .
7.
Click Test (
optional
).
If the test completed successfully, the connection profile is validated and you can now define a OEBS
job, as described in Defining a Control-M for Oracle E-Business Suite job (on page 50 ). If the test
failed, review the error message and test it again.
8.
Click OK .
Event Watcher Management
The Event Watcher utility integrates Control-M with the Oracle Application by enabling events in the
Oracle Application to trigger Control-M jobs and conditions This enables the integration of Control-M managed batch processes and flows with ad-hoc events occurring with the OEBS system.
The following topics how to manage alerts including set up and definition of the Event Watcher Manager.
The definition, includes defining, updating, copying, deleting, and prioritizing an event in the Control-M
Configuration Manager:
Setting up Control-M for Oracle E-Business Suite Watcher process (on page 22 )
Event Watcher definition (on page 23 )
Control-M for Oracle E-Business Suite Order Jobs (on page 26 )
Job condition configuration (on page 32 )
Setting up Control-M for Oracle E-Business Suite Watcher process
The procedure describes how to set up Control-M for Oracle E-Business Suite Watcher process, which needs to be activated on the Control-M for Oracle E-Business Suite node.
To set up Control-M for Oracle E-Business Suite:
1.
Do one of the following:
UNIX: Do the following: a.
Login to the relevant Control-M/Agent account where the Control-M for Oracle E-Business Suite is installed.
22
Control-M for Oracle E-Business Suite Administrator Guide b.
In the command prompt type the following: o start-ow: Starts Control-M for Oracle E-Business Suite Watcher process. o show-ow: Shows whether Control-M for Oracle E-Business Suite Watcher process is up.
o stop-ow: Stops the Control-M for Oracle E-Business Suite Watcher process.
Windows: Do the following: c.
Select Start => Settings => Control Panel => Administrative Tools => Services. d.
In the Windows Services dialog box, start or stop the Control-M for Oracle E-Business Suite
Watcher service.
NOTE: If the Control-M for Oracle E-Business Suite is installed on a non-default Control-M Agent, the service name is Control-M <Agent Name> OEBS Watcher.
2.
Ensure you have the following Control-M/EM user permissions in CCM:
BROWSE : Enables you to view Event Watcher general configuration and rules.
UPDATE : Enables you to change Event Watcher general configuration and rules, and to clear
Events from OEBS system.
Event Watcher definition
You can define the alerts that you want the Control-M for Oracle E-Business Suite utility to watch for to trigger a job to run, or a condition to be raised or deleted.
There are two types of alerts that can be monitored:
Periodic alerts
Event alerts
For more information on alerts, see the
Oracle Alert
documentation.
The Event Watcher can only monitor alerts that have been kept in the Oracle Alert History of your Oracle
E-Business Suite system by specifying the value of the Keep_Days field in the Oracle alert. The following procedures describe how to define, update, delete, copy, and move alerts from the Event Watcher
Manager:
Defining alerts to watch (on page 23 )
Updating an alert to watch (on page 25 )
Copying an alert to watch (on page 25 )
Deleting an alert to watch (on page 26 )
NOTE: You can prioritize events by clicking either the following events area. or the icon in the Watch for the
Defining alerts to watch
This procedure describes how to define alerts to watch so that Control-M for Oracle E-Business Suite can detect when the specified alert occurs and what action to take, such as, running a job, or adding or deleting a condition to the active conditions.
23
Control-M for Oracle E-Business Suite Administrator Guide
To define alerts to watch:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite - Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose events must be watched.
5.
Click in the Watch for the following alerts area.
The Add Event dialog box appears.
6.
In the Application field, type the name of the application that owns the alert or click Load to select an Oracle E-Business Suite application.
7.
In the Alert Name field, type the name of the alert that you want the Event Watcher to monitor or click Load to select an Oracle E-Business Suite alert.
8.
In the Execute Control-M actions if at least one field, select one of the actions, as described in
Control-M for Oracle E-Business Suite alert parameters (on page 24 ).
9.
Click OK .
Control-M for Oracle E-Business Suite alerts is now defined.
10.
Repeat this procedure for all required alerts.
Control-M for Oracle E-Business Suite alert parameters
Every alert that is raised in Oracle E-Business Suite can return exceptions and/or trigger actions.
The following table describes the options that Control-M for Oracle E-Business Suite Event Watcher executes the defined Control-M actions.
Alert Description
Alert Exception found AND
Action performed
Executes Control-M Actions if at least one Alert Exception AND one
Alert action are found. (default)
Alert Exception found OR Action performed
Executes Control-M Actions if at least one Alert Exception OR one
Alert action are found.
Alert Exception found
Alert Action performed
Executes Control-M Actions if at least one Alert Exception is found.
Executes Control-M Actions are executed if at least one Alert action is found.
24
Control-M for Oracle E-Business Suite Administrator Guide
Updating an alert to watch
This procedure describes how to update an alert in the Control-M Configuration Manager.
To update an alert to watch:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite - Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose events must be watched.
5.
Select an event in the Watch for the following events area that you want to update and click .
The Update Event dialog box appears.
6.
In the Application field, type the name of the application that owns the alert or click Load to select an Oracle E-Business Suite application.
7.
In the Alert Name field, type the name of the alert that you want the Event Watcher to monitor or click Load to select an Oracle E-Business Suite alert.
8.
In the Execute Control-M actions if at least one field, select one of the actions, as described in
Control-M for Oracle E-Business Suite alert parameters (on page 24 ).
9.
Click OK .
Control-M for Oracle E-Business Suite alert and parameters are updated.
Copying an alert to watch
This procedure describes how to copy an alert in the Control-M Configuration Manager and how to use the copied parameter values to create a new alert.
To copy an alert:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose events must be watched.
5.
Select the event in the Watch for the following events area that you want to copy and click .
The Copy Event dialog box appears.
6.
In the Application field, type the name of the application that owns the alert or click Load to select an Oracle E-Business Suite application.
7.
In the Alert Name field, type the name of the alert that you want the Event Watcher to monitor or click Load to select an Oracle E-Business Suite alert.
25
Control-M for Oracle E-Business Suite Administrator Guide
8.
In the Execute Control-M actions if at least one field, select one of the actions, as described in
Control-M for Oracle E-Business Suite alert parameters (on page 24 ).
9.
Click OK .
A new alert is created, based on the Control-M for Oracle E-Business Suite alert and parameters that were copied.
Deleting an alert to watch
This procedure describes how to delete an alert from the Control-M Configuration Manager.
To delete an alert:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
2.
The CM for Oracle E-Business Suite - Event Watcher Management dialog box appears.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose events must be watched.
5.
Select the event in the Watch for the following events area that you want to delete and click
.
A confirmation message appears.
6.
Click Yes .
The specified alert is deleted.
Control-M for Oracle E-Business Suite Order Jobs
When using this feature, Control-M for Oracle E-Business Suite can order jobs in Control-M to perform the required procedure when the specified event occurs.
The jobs and folders for the parameter values, must be defined in Control-M Workload Automation, before running the Control-M for Oracle E-Business Suite Event Watcher utility.
Ordered jobs are always automatically “Forced”. Once the job has run, the Control-M for Oracle
E-Business Suite Event Watcher variables and its values are displayed in the Variables area in the Job
Properties pane in Control-M Workload Automation. For more information about ordering Control-M jobs, see
Using Control-M Workload Automation
.
The following procedures describe how to add, edit copy and delete jobs to be ordered after an event confirmation.
Adding jobs to be ordered after an event confirmation (on page 27 )
Updating a job to be ordered after an event confirmation (on page 30 )
Copying a job to be ordered after an event confirmation (on page 31 )
Deleting a job to be ordered after an event confirmation (on page 31 )
26
Control-M for Oracle E-Business Suite Administrator Guide
Adding jobs to be ordered after an event confirmation
This procedure describes how to add jobs to events so that Control-M for Oracle E-Business Suite can perform the required procedure when the specified event has occurred. The jobs specified should be defined in Control-M before the event takes place.
To add jobs to be ordered on event confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose alerts can be monitored.
5.
In the Define Control-M actions to execute after alert confirmation area, in the Order Jobs tab, click .
The Add Control-M Job to Order dialog box appears.
6.
In the Job Name field, type the name of the job that you want to add that must begin with a letter and without any blanks or special characters.
7.
In the Folder/Sub-application field, type the name of the folder or sub application that you want to add, which must begin with a letter and without any blanks or special characters. In the case of a sub-application, use "/" to separate between sub-application names.
8.
To add specifications that are required to identify the job do the following: a.
Click Advanced .
The expanded Add Control-M Job to Order dialog box appears. b.
In the Scheduling Date area, select one of the following dates: o ODAT: Defines the job's order date: Default o Any ctmorder date value by selecting the required date in the calendar that appears. c.
In the Scheduling Group Parameters area, for each field define the required value as
described in Scheduling Group Parameters (on page 27 ).
In the Variable area, you can create an alert variable for the job. For more information, see:
Additional variables for ordered jobs (on page 28 ).
9.
Click OK .
The job to be ordered is added to the event.
Scheduling Group Parameters
The scheduling group in which the job is defined. This option is only relevant if you specify jobs in a
Group Scheduling table, otherwise the jobs fail to be ordered.
27
Control-M for Oracle E-Business Suite Administrator Guide
The following table lists the Scheduling Group Parameters.
Parameter Description
Into Group Identifies into which Control-M folder the job is submitted
Valid values are:
None (Default) - use when the job template does not belong to a folder
Recent - add the job to the folder that was most recently ordered
Standalone - order the job by adding it to a folder
New Group - order the job to a new folder
Specific - set a folder Order ID to which to add the job
The last four options are similar to the Force Into options of Control-M/EM.
For more information about Control-M folders and Force Into parameters, see
Using Control-M Workload Automation
.
Group ID Identifies the specified folder of jobs to be ordered
This field is enabled only when Specific is specified in the Into Folder field.
Additional variables for ordered jobs
When the Control-M for Oracle E-Business Suite Event Watcher has ordered a job, as a result of an ad-hoc Oracle E-Business Suite alert, additional variables are added to the job that contains the information regarding the alert that caused the job to be ordered.
The following procedures describe how to add, edit, copy and delete variables for a job to order.
Creating an alert variable for a job (on page 28 )
Editing alert variables for a job (on page 29 )
Copying alert variable for a job (on page 30 )
Deleting an alert variable for a job (on page 30 )
Creating an alert variable for a job
The following procedure describes how to create an alert variable for a job.
To create an alert variable:
1.
From the Add Control-M Job To Order , in the Variables field, click .
The Add Auto-Edit dialog box appears.
2.
Add the Variable and Value (blank spaces permitted).
Structure: %%<
variable name
> <
variable value
>
28
Control-M for Oracle E-Business Suite Administrator Guide
3.
Click OK .
Alert variables for ordered jobs
The following table describes alert variables for ordered jobs.
Variable Description
%%ALERT-APPLICATION-NAME Defines the application that owns the alert.
%%ALERT-APPLICATION-ID Defines the application ID.
%%ALERT-NAME Defines the name of the alert.
%%ALERT-CHECK-DATE Defines the time that the alert was raised in Oracle E-Business
Suite system.
%%ALERT-CM_CONNECTION_P
ROFILE
Defines the Control-M for Oracle E-Business Suite connection profile name that represents Oracle E-Business Suite where the alert was monitored.
%%<OUTPUT name>_n If the output variables exist as a result of the alert check, the following variables are added for each output:
<OUTPUT value as returned by the alert>
EXAMPLE:
%%ORDER_ID_1 zzz
The maximum number of output variables that are added to the ordered job is set in the ALERT_MAX_OUTPUT parameter in event_cfg.dat file. The default is 20.
NOTE: The output variable contains the output of the SQL statement performed by the alert (the exceptions values). You can see the database information retrieved by the alert in the newly ordered job according to the output variables defined in the Oracle
E-Business Suite alert.
Editing alert variables for a job
The following procedure describes how to add edit variables for a job.
To edit variables:
1.
From the Add Control-M Job To Order , in the Variables field, highlight the variable, and click .
The Update Auto-Edit dialog box appears.
2.
Edit the Variable and Value (blank spaces permitted) as required.
Structure: %%<
variable name
> <
variable value
>
29
Control-M for Oracle E-Business Suite Administrator Guide
3.
Click OK .
Copying alert variable for a job
The following procedure describes how to copy an alert variable for a job.
To copy variables:
1.
From the Add Control-M Job To Order , in the Variables field, highlight the variable and click .
The Copy Auto-Edit dialog box appears.
2.
Change the Variable and Value (blank spaces permitted) as required.
Structure: %%<
variable name
> <
variable value
>
3.
Click OK .
Deleting an alert variable for a job
The following procedure describes how to add delete an alert variable for a job.
To delete variables:
1.
From the Add Control-M Job To Order , in the Variables field, highlight the variable and click
.
2.
A confirmation dialog box appears and click OK.
The variable is now deleted.
Updating a job to be ordered after an event confirmation
This procedure describes how to update a job to be ordered after an event confirmation in the Control-M
Configuration Manager.
To update a job to be ordered after an event confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the Define Control-M actions to execute after event confirmation area, in the Order Jobs tab, click .
5.
The Update Control-M Job to Order dialog box appears.
Update the required parameters.
30
Control-M for Oracle E-Business Suite Administrator Guide
6.
Click OK .
The job to be ordered is updated.
Copying a job to be ordered after an event confirmation
This procedure describes how to copy a job to be ordered after an alert confirmation in the Control-M
Configuration Manager.
To copy a job to be ordered after an alert confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose alerts can be monitored.
5.
In the Define Control-M actions to execute after event confirmation area, in the Order Jobs tab, click .
The Copy Control-M Job to Order dialog box appears.
6.
Update the required parameters.
7.
Click OK .
The details of a new Control-M job to be ordered is defined, based on the Control-M job definitions that were copied.
Deleting a job to be ordered after an event confirmation
This procedure describes how to delete a job to be ordered after an event confirmation from the
Control-M Configuration Manager.
To delete a job to be ordered after an event confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose alerts can be monitored.
5.
In the Define Control-M actions to execute after event confirmation area, in the Order Jobs tab, click .
A confirmation message appears.
6.
Click Yes .
The selected job to be ordered after an event confirmation is deleted.
31
Control-M for Oracle E-Business Suite Administrator Guide
Job condition configuration
The following procedures in this section describe how to define and manage conditions to jobs in the
Control-M Configuration Manager so that Control-M can perform the required condition when the specified event occurs.
Adding conditions to execute after an alert confirmation (on page 32 )
Editing a condition to execute after an alert confirmation (on page 33 )
Copying a condition to execute after an alert confirmation (on page 33 )
Deleting a condition to be executed after an alert confirmation (on page 34 )
Adding conditions to execute after an alert confirmation
This procedure describes how to add conditions to execute so that Control-M for Oracle E-Business Suite can perform the required procedure when the specified condition has occurred.
To add conditions to execute after an alert confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose alerts can be monitored.
5.
In the Define Control-M actions to execute after alert confirmation area, in the Conditions tab, click .
6.
The Add Control-M Condition dialog box appears.
In the Name field, type the unique name of the condition that you want to add that must begin with a letter and without any blanks or special characters.
NOTE: If the Name parameter is left empty, the condition created in Control-M is named in the following way: oebs_<
Event_ID
>_<
Event_Param
>
If the Event ID parameter value is OEBS_END_OF_JOB , the OEBS event parameter value is truncated, and the job count number is omitted from the condition.
If the OEBS event parameter value is left blank, the condition structure is: oebs_<
Event_ID
>
7.
In the Date field, select either ODAT (default) or STAT .
NOTE:
Specify ODAT to use the Control-M scheduling date. (Default)
Specify STAT if a date is not relevant.
Specify a date in mmdd format (a date only exists in the current year). The asterisk "*" wildcard character is supported.
32
Control-M for Oracle E-Business Suite Administrator Guide
8.
In the Action field, select either ADD (default) or DELETE .
NOTE: Specify "*" by itself to include all dates (only valid for DELETE actions).
9.
Click OK .
The condition is added to the alert. For more information about specifying conditions, see
Control-M Workload Automation
.
Using
Editing a condition to execute after an alert confirmation
This procedure describes how to edit a condition to be executed after an alert confirmation in the
Control-M Configuration Manager.
To edit a condition to execute after an alert confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
2.
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose alerts can be monitored.
5.
In the Define Control-M actions to execute after event confirmation area, in the Condition tab, click .
The Update Control-M Condition dialog box appears.
6.
7.
Click OK .
The condition to be executed is updated.
Copying a condition to execute after an alert confirmation
This procedure describes how to copy a condition to execute after an alert confirmation in the Control-M
Configuration Manager.
To copy a condition to execute after an alert confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
2.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose alerts can be monitored.
5.
In the Define Control-M actions to execute after event confirmation area, in the Condition tab, click .
33
Control-M for Oracle E-Business Suite Administrator Guide
The Copy Control-M Condition dialog box appears.
6.
Update the required parameter values.
7.
Click OK .
The details of a new condition to be alerted is defined, based on the definitions that were copied.
Deleting a condition to be executed after an alert confirmation
This procedure describes how to delete a condition to order after an alert confirmation from the Control-M
Configuration Manager.
To delete a condition to execute after an alert confirmation:
1.
From the CCM, right-click the Control-M for Oracle E-Business Suite component on the host that you want to manage, and select Event Watcher Management .
2.
The CM for Oracle E-Business Suite Event Watcher Management dialog box appears.
In the Activate Event Watcher field, select On .
3.
In the Watching Interval Time field, select how often in seconds to check for alerts.
4.
In the OEBS Connection Profile field, select the connection profile whose alerts can be monitored.
5.
In the Define Control-M actions to execute after event confirmation area, in the Condition tab, click .
A confirmation message appears.
6.
Click Yes .
The selected condition is deleted.
34
4
Oracle E-Business Suite configuration
4
The following section describes how to add a database user, how to handle job output, and how to import
Oracle E-Business Suite requests and request sets.
Oracle E-Business Suite job output (on page 36 )
Oracle E-Business Suite requests and request sets (on page 38 )
Database users
You can run a script to create a new BMC user, with the minimum authorizations required to work with
Control-M for Oracle E-Business Suite, which removes the necessity for using the APPS user. The script supports the Oracle Database Server 9.2 and later.
The newly-created BMC user has the following permissions automatically granted:
APPS tables, views and synonyms: All
APPS procedures, packages and functions: Execute
SYSTEM objects: Select and Execute .
These permissions are only granted on objects for which an APPS user has permissions.
All tables from different users, (all other database schemas) for which APPS users have Select permissions with grant option enabled: Select .
Additionally, proper synonyms are automatically created for all the objects for the BMC user.
NOTE : If a new table is added to the database to which a BMC user requires access, run the script again for the BMC user.
The following procedures describe how to add a database user in UNIX and Windows:
Creating a database user on UNIX (on page 35 )
Creating a database user on Windows (on page 36 )
Creating a database user on UNIX
This procedure describes how to create a database user on UNIX.
To create a database user on UNIX:
1.
Log in as the Agent user.
2.
Navigate to the following location:
<agent_home_dir>
/ctm/cm/OAP/
35
Control-M for Oracle E-Business Suite Administrator Guide
3.
Change the data directory permission by entering the following at the command prompt:
chmod 777 data
4.
Navigate to the data directory and run the following script:
./create_bmc_user.sh <system password> <tnsnames name (ORACLE_SID)> <apps password> <BMC user name> <BMC user password>
5.
Do not run the script from a different directory.
Specify the appropriate values for all parameters. Messages similar to the following are displayed.
Creating user <BMC user name>. This may take several hours. Please wait…
Done.
6.
Change the data directory permission back to the original setting by entering the following at the command prompt:
chmod 755 data
Creating a database user on Windows
This procedure describes how to create a database user on Windows.
To create a database user on Windows:
1.
Navigate to the following location:
<
agent_home_dir
>\ ctm\CM\OAP\data
Do not run the script from a different folder.
2.
Run the following script:
create_bmc_user.bat <system password> <tnsnames name (ORACLE_SID)> <apps password> <BMC user name> <BMC user password>
3.
Specify the appropriate values for all parameters. Messages similar to the following are displayed.
Creating user <BMC user name>. This may take several hours. Please wait…
Done.
Oracle E-Business Suite job output
The following sections describe how to set the output file name prefix, the output mode (UNIX), view request logs and output in Control-M job output and read the output from a remote computer.
Setting the output file name prefix (on page 37 )
Setting the Output mode (UNIX only) (on page 37 )
Viewing request logs and output in Control-M job output (on page 37 )
Reading the output from a remote computer (on page 38 )
36
Control-M for Oracle E-Business Suite Administrator Guide
Setting the output file name prefix
You can assign a specific prefix to the output file name. The following procedure describes how to set the output file name prefix.
To set the output file name prefix:
1.
Do one of the following:
UNIX: Open the <agent_home_dir>/ctm/data/OEBS.dat file.
Windows: Open the Windows registry and navigate to the relevant Control-M for Oracle
E-Business Suite registry.
EXAMPLE:
On the default agent:
HKEY_LOCAL_MACHINE\SOFTWARE\BMC Software\CONTROL-M/AGENT\OEBS
2.
Edit the value of the OUTPUT_NAME parameter to one of the following:
JOBNAME
3.
FILE NAME
N
Upon completion, restart the CONTROL-M Agent processes.
If the value of OUTPUT_NAME is JOBNAME, the name of the output file will be the following:
<jobname>_<order id>_<run no.>.dat.
NOTE: When the New Day Procedure deletes old output files, it uses the OUTPUT_NAME parameter value to determine the format of the Output file names. Old Output files that have a different format are not deleted and must therefore be deleted manually.
Setting the Output mode (UNIX only)
You can configure authorization levels when generating Control-M for Oracle E-Business Suite output file permissions.
To set output file permissions:
1.
Open the <
agent_home_dir
>/ctm/data/OEBS.dat file.
2.
From the command line, type the following command:
OUTPUT_MODE <required file permission>
EXAMPLE:
OUTPUT_MODE 755
3.
Upon completion, restart the Control-M Agent processes.
Viewing request logs and output in Control-M job output
After the concurrent program has completed running, the program log file and the output file are generated. You can view these files in the Control-M for Oracle E-Business Suite job’s output. This procedure describes how to view request logs and output in Control-M job output.
37
Control-M for Oracle E-Business Suite Administrator Guide
To view request logs and output in Control-M job output:
1.
In Control-M for Oracle E-Business Suite Connection Profile, select Enable viewing Request log/output in output.
2.
In Control-M for Oracle E-Business Suite Properties pane, in the Post Process Actions area, select:
Append Request output to output to append the request log.
Append Request log to output to append the request log.
Reading the output from a remote computer
If the Oracle Applications system and the Concurrent Manager module exist on separate computers, you can view the output from Control-M for Oracle E-Business Suite. This procedure describes how to read the output from a remote computer.
To read the output from a remote computer:
Do one of the following:
Windows: Do the following:
a.
Share the log and out directories (in which the job logs and output are stored), using the following shared names BMClog and BMCout . b.
In the security options of the shared directories, ensure that you grant Read permissions to the operating system account that owns the Oracle database.
UNIX: Ensure that the log and out directories (in which the job logs and output are stored), are accessible (Read permissions) within the Network File System (NFS), by the operating system account that owns the Oracle database.
Oracle E-Business Suite requests and request sets
Control-M for Oracle E-Business Suite provides the ability to extract, intercept and monitor existing concurrent requests and request sets.
This section provides information on the following Control-M for Oracle E-Business Suite abilities:
Extracting definitions of existing requests and request sets (on page 39 ): Converts automatically
existing Oracle E-Business Suite concurrent requests and request sets to the equivalent Control-M for
Oracle E-Business Suite jobs.
Intercepting Oracle E-Business Suite requests and request sets (on page 40 ): Releases Oracle
E-Business Suite concurrent requests and request sets that are in On Hold status in the Oracle
E-Business Suite system and monitors them through Control-M.
Monitoring requests and request sets running in Oracle E-Business Suite (on page 40 ): Creates a
mirror-image of the concurrent requests and request sets running in the Oracle E-Business Suite system and monitors them through Control-M.
38
Control-M for Oracle E-Business Suite Administrator Guide
Extracting definitions of existing requests and request sets
The Extract Definition utility enables users to automatically copy one or more existing Oracle E-Business
Suite concurrent requests and request sets from their Oracle E-Business Suite environment to their equivalent Control-M for Oracle E-Business Suite jobs.
To use the extract definition utility:
1.
Create the required extract definition rule file.
The Extract Definition utility acts in accordance to the details in the rule file. For more information,
see Extract definition rule file (on page 41 ).
2.
In the Oracle E-Business Suite system submit the requests or request sets (that are to be copied to
Control-M to a future date), to ensure that the required request or request set remain in
Pending-Scheduled status.
NOTE: The Extract Definition utility can extract any status of Oracle E-Business Suite requests, as long as the request is in Pending phase. There are several statuses within the Pending phase. If a specific status is needed for the extraction behavior, the OAP-STATUS_CODE can be used in the extract definition rule file. By default, if no OAP-STATUS_CODE is indicated in the rule file, Normal status (I) is set.
After the Extract Definition utility copies the required request/request set definition to Control-M, the original request/request set in the Oracle E-Business Suite system is canceled.
3.
Type the extract definition command:
UNIX: a.
Ensure that you are logged in as a Control-M/Agent user. b.
Run the following command:
ctmextract -CM_APPL_TYPE OEBS -OAP-INSTANCE <Account name> -RULETABLE
<path to extract rule file> [-DBGLVL 0-5]
Windows: c.
Open command prompt and navigate to: d.
< Agent home directory >\CM\OAP\EXE\
Run the following command:
ctmextract -CM_APPL_TYPE OEBS -OAP-INSTANCE <Account name>
-RULETABLE <path to extract rule file> [-DBGLVL 0-5] [-AGENT
<agent_name>]
For more information regarding ctmextract command-line parameters, see
ctmextract/agintercept command line parameters (on page 46 ).
After the extract definition is completed, the extracted jobs are created in the Control-M/Server definition folder (folder name is set in extract rule file). To use these jobs, use Control-M Workload
Automation to download the relevant folder from the Control-M/Server to Control-M/EM. After the relevant folder has been downloaded the extracted jobs can be used.
39
Control-M for Oracle E-Business Suite Administrator Guide
Intercepting Oracle E-Business Suite requests and request sets
The Control-M for Oracle E-Business Suite Interception utility enables you to intercept concurrent requests and request sets submitted in Oracle E-Business Suite and to release and monitor them through
Control-M.
You can use the Interception utility to intercept requests and request sets that are in On Hold status in
Oracle E-Business Suite. The Interception utility creates a mirror-image of the intercepted job in
Control-M. After which, the intercepted job is released in Oracle E-Business Suite and monitored from
Control-M using the mirror image.
To use the Interception utility:
1.
Create the required interception rule file.
The interception utility acts in accordance to the details in the rule file. For more information, see
Interception rule file (on page 43 ).
2.
In Oracle E-Business Suite, assure that the requests and request sets to be intercepted are in On Hold status.
You can place a request and request set to On Hold status by using the Oracle E-Business Suite
Concurrent: Hold Requests profile. For more information about configuring profiles, see the
Oracle
E-Business Suite System Administrator Guide.
3.
Type the Intercept command:
UNIX: a.
Ensure that you are logged in as the Control-M/Agent user. b.
Run the following command:
agintercept -CM_APPL_TYPE OEBS -OAP-INSTANCE <Account name>
-RULETABLE <path to interception rule file> [-DBGLVL 0-5]
Windows: c.
Open a command prompt and navigate to
<Agent home directory>\CM\OAP\EXE\ d.
Run the following command:
agintercept -CM_APPL_TYPE OEBS -OAP-INSTANCE <Account name>
-RULETABLE <path to extract rule file> [-DBGLVL 0-5] [-AGENT
<agent_name>]
Monitoring requests and request sets running in Oracle E-Business
Suite
The Control-M for Oracle E-Business Suite Monitoring utility enables you to monitor concurrent requests and request sets submitted in the Oracle E-Business Suite through Control-M.
40
Control-M for Oracle E-Business Suite Administrator Guide
When concurrent requests/request sets that match the monitoring rules file’s search criteria are found, the Control-M for Oracle E-Business Suite Monitoring utility creates a mirror-image Control-M job, and the concurrent requests/request sets are monitored from Control-M using that image.
To use the Monitoring utility:
1.
Create the required monitoring rule file.
The Monitoring utility acts in accordance to the details in the rule file. For more information, see
Creating a rule file (on page 41 ).
2.
Enter the Monitoring command:
UNIX: a.
Ensure that you are logged in as the Control-M/Agent user. b.
Run the following command:
ctmextract -CM_APPL_TYPE OEBS -OAP-INSTANCE <Account name> -RULETABLE
<path to monitoring rule file> [-DBGLVL 0-5]
Windows: c.
Open command prompt and navigate to d.
<Agent home directory>\CM\OAP\EXE\
Run the following command:
ctmextract -CM_APPL_TYPE OEBS -OAP-INSTANCE <Account name> -RULETABLE
<path to monitoring rule file> [-DBGLVL 0-5] [-AGENT <agent_name>]
Creating a rule file
Rule files are used as input for the agintercept and ctmextract utilities. This section provides instructions on the following:
Extract definition rule file (on page 41 )
Interception rule file (on page 43 )
Monitoring rule file (on page 45 )
Extract definition rule file
The extract definition rule file is used as input file for the Control-M for Oracle E-Business Suite Extract
Definition command. It contains the following information:
41
Control-M for Oracle E-Business Suite Administrator Guide
The type of OEBS request or request set definitions to search for (Conditions section)
How to define equivalent Control-M for Oracle E-Business Suite jobs (CTMDEFINE section), if matching Oracle E-Business Suite requests or request sets are found.
The ctmextract command utility searches for any Oracle E-Business Suite requests or request sets that match the search criteria defined in the extract definitions rule file CONDITION section. For each match an equivalent Control-M for OEBS job is defined according to the information found in the CTMDEFINE
The extract definition rule file is built from two main sections:
CONDITIONS - built from one or more [CONDITION<n>] segments. In each [CONDITION<n>] segment, the selections criteria is defined for Oracle E-Business Suite concurrent requests or request
sets that you want to extract. For more information, see Conditions Section creation (on page 46 ).
CTMDEFINE - this section contains information on how to define Control-M for Oracle E-Business Suite jobs. The information is built from couples of parameters and their values separated by a blank. For
NOTE : In the CTMDEFINE section, you can define any parameter accepted by the Control-M ctmdefine utility. For more information about ctmdefine parameters, see
Control-M Workload Automation Utilities
.
Examples - Extract definition rule file
The following example describes the Extract definition rule file.
[
CONDITION1]
OAP-USERNAME OPERATIONS
OAP-REQUEST_ID = 2795092
[CTMDEFINE]
APPLFORM OEBS
APPLTYPE OEBS
APPLVER ANY
CMVER 9.0.00
TASKTYPE job
JOBNAME extracted_job
SUBAPPLLICATION extracted_subapplication
FILE_PATH extracted_job
FILE_NAME extracted_job
FOLDER extract_folder
42
Control-M for Oracle E-Business Suite Administrator Guide
ctmcreate/ctmdefine mandatory parameters
The following table describes the ctmcreate/ctmdefine mandatory parameters.
Parameter Description
APPLFORM
APPLTYPE
APPLVER
CMVER
SUBAPPLICATION
JOBNAME
FILE_PATH
FILE_NAME
HOSTGRP
FOLDER
Control-M Workload Automation job palette name. Valid values:
OEBS
Specific Oracle E-Business Suite version Valid values: OEBS
Oracle Application version. Valid values: ANY
Application plug in version. Valid value: 9.0.00
Control-M sub application name.
Control-M job name.
Any non-null string.
Any non-null string.
Control-M Host Group where Control-M for Oracle E-Business Suite is installed.
Control-M folder name. (ctmdefine only)
TASKTYPE Control-M job type. Valid value: job
Interception rule file
The interception rule file is used as an input file for the Control-M for Oracle E-Business Suite Interception command. The rule file contains the following information:
The type of Oracle E-Business Suite requests or request sets to intercept.(CONDITIONS section)
How to create an equivalent mirror-image Control-M job, if matching Oracle E-Business Suite requests or request sets are found (CTMCREATE section).
The agintercept command utility searches for any Oracle E-Business Suite request or request set that matches the search criteria defined in the interception rule file CONDITION section. For each match, it creates an equivalent mirror-image Control-M job according to the information available in the
43
Control-M for Oracle E-Business Suite Administrator Guide
The interception rule file is built from two main sections:
CONDITIONS section - built from one or more [CONDITION<n>] segments. In each
[CONDITION<n>] segment, you can define search criteria for the Oracle E-Business Suite concurrent
CTMCREATE section - contains information on how to create a mirror-image Control-M job/s. The information inside the CTMCREATE section is built from couples of parameters and values separated
In the CTMCREATE section, you can define any parameter accepted by the Control-M ctmcreate utility. For more information about ctmcreate parameters, see
Control-M Workload Automation
Utilities
.
Example - Interception rule file
Example - Interception rule file
[CONDITION1]
OAP-USERNAME OPERATIONS
OAP-REQUEST_ID = 2795092
[CTMCREATE]
SUBAPPLICATION test
JOBNAME intercept
TASKTYPE job
HOSTGRP gamma
FILE_NAME file name
FILE_PATH path
FOLDER test
44
Control-M for Oracle E-Business Suite Administrator Guide
Monitoring rule file
The monitoring rule file is used as an input file for the Control-M for Oracle E-Business Suite Monitoring command. The rule file contains the following information:
The type of Oracle E-Business Suite requests or request sets to monitor (CONDITIONS section).
How to create an equivalent mirror-image Control-M job, if matching Oracle E-Business Suite requests or request sets are found (CTMCREATE section).
The ctmextract command utility searches for any Oracle E-Business Suite request or request set that matches the search criteria defined in the Monitoring rule file CONDITION section. For each match, it creates an equivalent mirror-image Control-M job according to the information available in the
CTMCREATE section. For more information, see: Monitoring requests and request sets running in Oracle
E-Business Suite (on page 40 ).
The monitoring rule file is built from two main sections:
Conditions section - built from one or more [CONDITION<n>] segments. In each [CONDITION<n>] segment, you can define search criteria for the Oracle E-Business Suite concurrent request or request
set that you want to monitor. For more information, see Conditions Section creation (on page 46 ).
CTMCREATE section - contain information on how to create mirror-image CONTROL-M job/s. The information inside the CTMCREATE section is built from couples of parameters and values separated
NOTE: In the CTMCREATE section, you can define any parameter accepted by the Control-M ctmcreate utility. For more information about ctmcreate parameters, see the Control-M Utilities.
NOTE : To create a Control-M mirror-image job with values retrieved from the equivalent monitored
Oracle E-Business Suite job, set the values in the CTMCREATE section to the required CONDITION search criteria using the following format:
$<variable name>$
See Example - Monitoring rule file (on page 45 ).
Example - Monitoring rule file
The following example describes the Monitoring rule file.
[CONDITION1]
OAP-USERNAME S*
OAP-REQUEST_ID = 2795089
[CTMCREATE]
SUBAPPLICATION test
JOBNAME $OAP-USERNAME$
TASKTYPE job
HOSTGRP beta
FILE_NAME $OAP-REQUEST_ID$
45
Control-M for Oracle E-Business Suite Administrator Guide
FILE_PATH path
FOLDER test ctmextract/agintercept command line parameters
The following table describes the ctmextract/agintercept command line parameters.
Parameter Description
CM_APPL_TYPE
RULETABLE
OAP-INSTANCE
DBGLVL
-AGENT
Represents Oracle E-Business Suite as an external application.
Valid values: OEBS
The full path to the rule file.
Control-M for Oracle E-Business Suite Connection Profile name.
Maximum Length: 30 characters
Debug level. Range: 0 - 5
A value > 0 creates a debug log file in the proclog directory in
Control-M/Agent.
For agintercept, the debug log file name is:
{AGINTERCEPT}_<process_id>.log
For ctmextract, the debug log file name is:
CTMEXTRACT_<process_id>.log
For Windows only
Optional
If Control-M for Oracle E-Business Suite is installed on a non-default Control-M/Agent, specify the name of the
Control-M/Agent.
Conditions Section creation
A Conditions section is built from one or more [CONDITION<n>] segments. Each search
[CONDITION<n>] segment contains required search criteria, while each search criteria is built from a coupled variable and value separated by a blank. For possible search criteria variables and values, see
Search criteria variable options inside a Condition segment (on page 48 ).
All search criteria inside a single [CONDITION<n>] segment have an AND relationship between them.
If you have more than one [CONDITION<n>] segment in your rule file, the [CONDITION<n>] segments have OR relationships between them.
For an example of a Conditions section, see: Example - Conditions section (on page 47 ).
46
Control-M for Oracle E-Business Suite Administrator Guide
Example - Conditions section
In the CONDITION section below, the following search is being conducted for all concurrent requests that:
Belongs to OPERATION user AND
The program short name starts with HR prefix AND
The Request ID is larger than 2795090 or
Belongs to FINANCE user AND
The program short name is FN AND
The Request ID is larger than 2795092
[CONDITION1]
OAP-USERNAME OPERATION
OAP-PROGNAME HR*
OAP-REQUEST_ID > 2795090
[CONDITION2]
OAP-USERNAME FINANCE
OAP-PROGNAME FN
OAP-REQUEST_ID > 2795092
47
Control-M for Oracle E-Business Suite Administrator Guide
Search criteria variable options inside a Condition segment
The following table describes the Search criteria variable options inside a Condition segment.
Variable name Description
OAP-APPNAME
OAP-PROGNAME
OAP-REQUEST_ID
OAP-REQTYPE
OAP-RESPAPP
OAP-RESPNAME
OAP-SETNAME
OAP-USERNAME
OAP-STATUS_CODE
Oracle E-Business Suite short name of a single request or request set. Free text. Length: 1-50 characters
Concurrent program short name for OAP-TASKTYPE is REQUEST.
Free text. Maximum length: 30 characters
Request ID for Oracle E-Business Suite jobs.
Format: {=|>|<|>=|<=} < request_ID >
Name of request type. Only for agintercept utility.
Oracle E-Business Suite short name associated with the responsibility. Free text. Length: 1-50 characters
Name of the specified responsibility. Free text. Maximum length:
100 characters
Short name for the request set. Free text. Maximum length: 30 characters
Oracle E-Business Suite user name. Maximum length: 100 characters
Request or Request Set status code
Valid values:
I - Normal (default)
Q - Standby
F - Scheduled
A - Waiting
Configuring Windows cluster environments
This procedure describes how to configure a Windows Cluster environment.
NOTE: The Oracle Client must be installed on the same computer as Control-M/Agent. On UNIX, the
Oracle client must be installed on a different account.
48
Control-M for Oracle E-Business Suite Administrator Guide
To configure Windows cluster environments:
1.
In a Windows Cluster environment, do the following:
The path to the Oracle Home Directory is identical on all nodes.
In Oracle Client version 9.2.04, the following registry keys are identical on all nodes:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\ALL_HOMES
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\ID<n>
HKEY_L
OCAL_MACHINE\SOFTWARE\ORACLE\HOME<n>
All sub-keys and values must be duplicated to all nodes.
In Oracle Client version 10G and 11, the following registry key is identical on all nodes:
HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_<Client_Name>
All sub-keys and values must be duplicated to all nodes.
The ORACLE_HOME\bin directory exists in the PATH environment variable on all nodes. The PATH registry key is located under the following:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SessionManager\E nvironment\ PATH
2.
On all Windows environments:
Ensure that the ORACLE_HOME and TNS_ADMIN environment variables are set properly, according to Oracle instructions.
49
5
Job definition
5
Control-M for Oracle E-Business Suite is an application plug-in that connects to a OEBS server and enables you to define jobs that run reports and distribute them in various output formats and distribution methods, as described in Defining a Control-M for Oracle E-Business Suite job.
Control-M for Oracle E-Business Suite jobs are integrated with other Control-M jobs into a single scheduling environment. Control-M capabilities are available for Control-M for Oracle E-Business Suite, including advanced scheduling criteria, complex dependencies, quantitative and control resources, and variables.
After you have ordered an OEBS job, you can view data about the job from the Monitoring pane in Active
Job definition parameters in Control-M for Oracle E-Business Suite enable you to set values for the variables, as described in the
Using Workload Automation
. For a list of Control-M for Oracle E-Business
Suite parameters, see Control-M for Oracle E-Business Suite parameters.
Accessing the Oracle E-Business Suite job properties pane
This procedure describes how to access the Oracle E-Business Suite job properties pane, which enables you to define a OEBS job.
To access the Oracle E-Business Suite job properties pane:
1.
Log in to the Control-M Workload Automation, as described in
Using Control-M Workload Automation.
2.
From the Planning domain, select Blank workspace or open an existing workspace .
A workspace appears and is automatically checked out.
3.
From the Workspace tab, drag and drop the Oracle E-Business Suite job template from the job palette into the workspace.
4.
If the Control-M Server Selection dialog box appears, select the Control-M/Server for the job you are defining, and click OK .
An Oracle E-Business Suite job is created in a new folder or in the existing folder in the workspace that you opened. The job properties appear in the right pane.
Defining a Control-M for Oracle E-Business Suite job
This procedure describes how to define a Control-M for Oracle E-Business Suite job, which enables you to run OEBS jobs and reports on an OEBS server.
50
Control-M for Oracle E-Business Suite Administrator Guide
Before You Begin
Ensure that you have met the following requirements:
A configured OEBS connection profile, as described for the Connection profile management (on page
Successful completion of Accessing the Oracle E-Business Suite job properties pane (on page 50 ).
To define a Control-M for Oracle E-Business Suite job:
1.
From the Connection Profile field, click .
The Connection Profile Selection dialog box appears.
2.
Select the connection profile that you want to use to run an OEBS job or report, and click OK .
The Connection Profile field is set .
3.
In the User Name field, type the Oracle E-Business Suite user name.
4.
In the Responsibility field, type or click to select the Oracle E-Business Suite responsibility that has been pre-defined for the specified Oracle user.
NOTE: The Responsibility list is dependent on the selected user. The Programs/Request Set lists are dependent on the responsibility selected.
5.
From the Submit area, select one of the following:
Single Request : Enables you to submit an individual request. For more information, see:
Creating a Single Request (on page 51 ).
Request Set : Enables you to submit a pre-defined set of requests. For more information, see:
Creating a Request Set (on page 53 ).
6.
(optional) If your OEBS application requires additional menus, select the Use Menu function checkbox.
NOTE : Some OEBS applications may require additional menus, which enable you to restrict application functionality for authorized users.
7.
Complete the Post Process Action parameters, as described in Post Process Actions (on page 70 ).
8.
9.
Select Increment date parameters each run checkbox, if you want to job parameters to increase on each run and type the date in the First run date field.
10.
Continue defining the job as described in see
Using Control-M Workload Automation
.
Creating a Single Request
The following procedure describes how to create a Single Request.
Before you begin
Complete the procedure as described in Defining a Control-M for Oracle E-Business Suite job (on page
51
Control-M for Oracle E-Business Suite Administrator Guide
To create a Single Request:
1.
In the Program Name field, click user and responsibility.
to retrieve a list of Oracle programs available for the specified
2.
The Program Name dialog box appears.
NOTE: Program parameters are retrieved from the Oracle E-Business Suite.
3.
Select the Program Name and click OK .
NOTE: If the program requires input parameters, the Request Parameters dialog box appears and complete the request parameters as required.
4.
In the Operating Unit field, click to find Operating Unit from the Oracle program.
NOTE : When loading a program this field is only enabled when a program has an associated
Operating Unit.
5.
If the Program requires input parameters, in the Parameters field, type the parameter or click Edit .
6.
To validate parameters, select the Parameter Validation checkbox.
7.
(Optional) to change the default output language for the selected job click
The Language Dialog box appears.
.
8.
Select a Language from the list and click OK .
9.
In the Description field, type a text string, which is added to the program name in the Oracle
E-Business Suite GUI.
10.
To add completion parameters, in the Upon Completion field, click Options.
The Upon Completion dialog box appears. For more information about completion in the
parameters: Upon Completion parameters (on page 65 ).
11.
Editing Request or Request Set parameters
You can edit parameter values when creating a Single Request or Request Set. This procedure describes how to edit parameters.
NOTE : If the default value is calculated during run time, the words Calculated During Submission are displayed in the value field. A mandatory parameters is marked with an asterisk. Parameters not marked in Oracle E-Business Suite as displayed are not displayed in this dialog box.
To Edit parameters:
1.
In the Parameters field, click Edit .
The Request Parameters dialog box appears. The
2.
In the Value field, click next to a parameter to retrieve a list of all its available values.
52
Control-M for Oracle E-Business Suite Administrator Guide
The Parameter Value dialog box appears.
3.
Select a value and click OK .
4.
In order to retrieve all the default values, click to reload parameters.
Creating a Request Set
The following procedure describes how to create a Request Set.
Before you begin
Complete the procedure as described in Defining a Control-M for Oracle E-Business Suite job (on page
To create a Request Set:
1.
In the Request Set field, click user and responsibility.
to retrieve the Request Set list authorized to run by the specified
The Program Name dialog box appears.
2.
Select a Program Name and click OK .
3.
The Program details are populated.
To validate parameters, select the Parameter Validation checkbox.
4.
In the Operating Unit field, click to find Operating Unit from the Oracle program.
NOTE: When loading a program this field is only enabled when a program has an associated
Operating Unit.
5.
If the Program requires input parameters click Edit.
For more information, see: Editing Request or
Request Set parameters (on page 52 ).
6.
(Optional) to change the default output language for the selected job click
The Language Dialog box appears.
7.
Select a Language from the list and click OK .
8.
To add completion parameters, in the Upon Completion field, click Options.
.
The Upon Completion dialog box appears. For more information about completion in the
parameters: Upon Completion parameters (on page 65 ).
Control-M for Oracle E-Business Suite profiles
The Oracle E-Business Suite profile enables you to change the way your application looks and responds.
You can add profile options to Control-M for Oracle E-Business Suite job that is set by Control-M before submitting the Request or Request Set. If the profile already exists in Oracle E-Business Suite, the newly specified value overrides the value set in the Oracle E-Business Suite during the job submission.
The following procedures describe how to add or delete a profile:
53
Control-M for Oracle E-Business Suite Administrator Guide
Adding a profile (on page 54 )
Deleting a profile (on page 54 )
Adding a profile
You can add profile options to Control-M for Oracle E-Business Suite job that is set by Control-M before submitting the Request or Request Set. If the profile already exists in Oracle E-Business Suite, the newly specified value overrides the value set in the Oracle E-Business Suite during the job submission.
To add a profile:
1.
In the Profiles section, click to add a new row to the Profiles table.
2.
In the Profile Name field, type a profile name or click from the Oracle E-Business Suite system.
, to retrieve a list of available profiles
NOTE: The asterisk wild card is supported.
EXAMPLE:
Conc* retrieves a list of profile names that start with Conc.
3.
Set the Profile Values required and click OK.
Deleting a profile
The following procedure describes how to delete a profile.
To delete a profile:
In the Profiles section, highlight the profile and click .
The profile is now deleted.
Monitoring a job in Active Jobs
You can display data about a job that is currently running in the Monitoring pane in Active Jobs in
Control-M Workload Automation. For more information, see:
Automation
.
Monitoring
in
Using Control-M Workload
To change the priority status of an Oracle E-Business Suite job in Active Jobs the status of the job must be set to Hold in Control-M Workload Automation and cannot be Running or Completed in Oracle
E-Business Suite.
To monitor a job in active jobs:
1.
From the Monitoring pane, double click All Active Jobs and then double click the running job to be monitored.
The Job: <Job Name> dialog box appears.
2.
In the Monitor Request Properties field, do one or more of the following:
To change the priority of a running job, specify the desired priority by clicking Set Priority .
To change the status of a running job, click Hold .
54
Control-M for Oracle E-Business Suite Administrator Guide
To release the job, click Unhold .
For more information about Monitor Request Properties
, see: Monitor Request Properties parameters (on page 74 ).
3.
If you want to view the output in a defined format, click View Output .
NOTE : When clicking View Output you can open non textual output reports such as PDF, XLS, and
TXT.
Control-M for Oracle E-Business Suite parameters
Job definition parameters in Control-M for Oracle E-Business Suite enable you to apply values for the variables, as described in Using
Control-M Workload Automation.
The following table describes the parameters for the Control-M for Oracle E-Business Suite.
Parameter Description
Connection Profile (on page 57 )
Use Menu function (on page 58 )
Defines the Control-M for Oracle E-Business Suite
Connection Profile.
Defines an authorized Oracle E-Business Suite user who has at least one responsibility.
Enables authorization for accessing data and running programs or requests, or both.
Defines the Application short name associated with the
Responsibility name.
Defines the Security group associated with the
Responsibility name.
Enables you to restrict application functionality to authorized users.
Indicates whether the request is a Request Set or Single
Request.
Enables you to select concurrent programs in the request set.
Defines the concurrent program name which causes the
Oracle E-Business Suite server to generate a list in real time that satisfies relevant criteria.
Defines the Program display long name.
55
Control-M for Oracle E-Business Suite Administrator Guide
Program Name (Program Name dialog box) (on page 61 )
Application Name (on page 61 )
Defines the Program short name.
Defines the application short name associated with the concurrent program.
Application Display Name (on page
Defines the application long name associated with the concurrent program.
Enables you to set the Operating Unit field.
Enables you to specify parameter values for the specified concurrent program.
Parameter Validation (on page 64 ) Enables you to validate parameter values.
Defines the job output language.
Defines the text description of a request.
Enables various tasks to be performed upon completion of a job.
Post Process Actions (on page 70 )
Enables you to set post completion actions.
Increment date parameters each run (on page 73 )
Defines the Profile internal name.
Defines the Profile value.
Enables the date of the job's parameters to increase on each run.
Defines the first run date for the Increment Date
Parameter.
56
Control-M for Oracle E-Business Suite Administrator Guide
Connection Profile
Defines the name of the Control-M for Oracle E-Business Suite connection profile.
Usage
Length
Case Sensitive
Variable Name
Mandatory
1 - 30 characters
Yes - only capital letters
%%-OAP-INSTANCE
User Name
Defines an authorized Oracle E-Business Suite user who has at least one responsibility.
Usage
Length
Case Sensitive
Variable Name
Mandatory
1 - 100 characters
No
%%OAP-USERNAME
Responsibility
Enables authorization for accessing data and running programs or requests, or both.
Usage
Length
Mandatory
1 - 100 characters
Case Sensitive Yes
Invalid Characters Blanks
Variable Name %%OAP-RESPNAME
57
Control-M for Oracle E-Business Suite Administrator Guide
Application
Defines the Application short name associated with the Responsibility name.
Usage
Length
Mandatory
1 - 50 characters
Case Sensitive Uppercase only
Invalid Characters Blanks
Variable Name %%OAP-RESPAPP
Security Group
Defines the Security group associated with the Responsibility name.
Usage
Length
Case Sensitive
Optional
1 - 80 characters
Yes
Invalid Characters NONE
Variable Name %%OAP-SECURITY_GROUPNAME
Use Menu function
Enables you to restrict application functionality to authorized users. A menu entry is a menu component that identifies a function or a menu of functions. In some applications, additional menus restrict the application's functionality by omitting specific forms and sub-functions.
Usage
Format
Default
Variable Name
Optional
Checkbox
Unchecked
%%OAP-USE_MENU_FUNCTION
58
Control-M for Oracle E-Business Suite Administrator Guide
Submit
Indicates whether the request is a Request Set or Single Request.
Usage
Format
Default
Variable Name
Mandatory
Option buttons
Valid values:
Single Request : Specifies a single request.
Request Set: Specifies a number of requests.
NOTE : Each option has sub parameters
Single Request
%%OAP-TASKTYPE
Request Set
Enables you to select concurrent programs in the request set by clicking the Request Set button, which causes the Oracle E-Business Suite server to generate a list of programs. Each program is listed in a table displaying Program and Stage .
Usage
Variable Name
Optional
%%OAP-SETPROG-P<n>-PROGDESP
59
Control-M for Oracle E-Business Suite Administrator Guide
Program Name
Defines the concurrent program name which causes the Oracle E-Business Suite server to generate a list in real time that satisfies relevant criteria. For Single Request select an item from the generated list.
Usage
Format
Length
Mandatory
Appears in the Properties pane
1 - 30 characters
Case Sensitive Yes (uppercase)
Invalid Characters Blanks
Variable Name Single Request: %%OAP-PROGNAME
Request Set: %%OAP-SETPROG-P<n>-PROGDESP
Program Display Name
Defines the Program display long name.
NOTE : In a Single Request, the Program Display Name is the same as the Program Name in the
Properties Pane in Control-M Workload Automation. In a Request Set, the Program Display Name is the same as the Request Set field.
Usage
Format
Optional
Appears in the Program Name dialog box
Length
Case Sensitive
1-214 characters
Yes
Invalid Characters None
Variable Name Single Request: %%OAP-PROGDESP
Request Set: %%OAP-SETDESP
60
Control-M for Oracle E-Business Suite Administrator Guide
Program Name (Program Name dialog box)
Defines the Program short name.
Usage
Format
Length
Case Sensitive
Mandatory
Appears in the Program Name dialog box.
1 - 30 characters
Yes (uppercase only)
Invalid Characters Blanks
Variable Name Single Request: %%OAP-PROGNAME
Request Set: %%OAP-SETNAME
Application Name
Defines the application short name associated with the concurrent program.
NOTE: The parameter appears in the Program Name dialog box.
Usage
Format
Length
Mandatory
Appears in the Program Name dialog box.
1 - 50 characters
Case Sensitive Yes (uppercase only)
Invalid Characters Blanks
Variable Name %%OAP-APPNAME
61
Control-M for Oracle E-Business Suite Administrator Guide
Application Display Name
Defines the application long name associated with the concurrent program.
Usage
Format
Length
Case Sensitive
Optional
Appears in the Program Name dialog box.
1 - 214 characters
Yes (uppercase only)
Invalid Characters Blanks
Variable Name %%OAP-APPDESP
Operating Unit
Enables you to set the Operating Unit field.
NOTE : The field is valid only when loading a program that is defined to work with Operating Unit.
Usage
Length
Optional
1-100 characters
Case Sensitive Yes
Invalid Characters Blanks
Variable Name Single Request: %%OAP-OPERATING_UNIT
Request Set: %%OAP-SETPROG-P<n>-OPERATING_UNIT
62
Control-M for Oracle E-Business Suite Administrator Guide
Parameters
Enables you to specify parameter values for the specified concurrent program.
NOTE: All fields must be specified or the default value is used. If not default value is specified in
Control-M, default is automatically NULL.
Usage
Format
Variable Name
Optional
Parameters:
Organization ID
BOM or ENG
Item Selection
Specific Item
Revision
Date
Items From
Items To
Category Set
Category Structure
Categories From
Categories To
Single Request:
%%OAP-PARMS-P<n>NAME
%%OAP-PARMS-P<n>VALUE
Request Set:
%%OAP-SETPROG-P<n>-PARMS-P<n>-NAME
%%OAP-SETPROG-P<n>-PARMS-P<n>-VALUE
63
Control-M for Oracle E-Business Suite Administrator Guide
Parameter Validation
Enables you to validate parameter values. All specified parameter values are validated. If no value is specified, the default value is retrieved.
Usage
Format
Variable Name
Optional
Check box
Default: Selected (parameter values are validated).
%%OAP-PARAM_VALIDATION
Language
Defines the job output language.
Usage
Format
Default
Variable Name
Optional
<Language>_<TERRITORY>
AMERICAN_AMERICA
%%OAP-LANGUAGE
Description
Defines the text description of a request. Displayed only when the request type is Single Request .
Usage
Length
Case Sensitive
Optional
1-214 characters
Yes
Invalid Characters None
Variable Name %%OAP-DESCRIPTION
64
Control-M for Oracle E-Business Suite Administrator Guide
Upon Completion parameters
Upon Completion parameters enable various tasks to be performed upon completion of a job. The following table describes the Upon Completion parameters.
NOTE: To add Upon Completion parameters, click Options .
Parameter Description
Notify the following people (on page 67 )
Enables you to set the template options for your job.
Enables you to add a text string for the workflow role names. You can add predefined names by clicking .
Print the output to (on page 68 ) Enables you to select print output options.
Layout
Enables you to set the template options for your job. If no template is available this option is disabled.
Parameter Table Header
Defines the name of the selected template. You can add a template by clicking . You can also delete a template by clicking
.
Single Request: %%OAP-LOUT-P<n>-NAME
Request Set: %%OAP-SETPROG-P<n>-LOUT-P<n>-NAME
Defines the output language of the selected template.
Single Request: %%OAP-LOUT-P<n>-LANG
Request Set: %%OAP-SETPROG-P<n>-LOUT-P<n>-LANG
Defines the type of the selected template. Supported formats:
RTF
EXCEL
HTML
Single Request: %%OAP-LOUT-P<n>-TYPE
Request Set: %%OAP-SETPROG-P<n>-LOUT-P<n>-TYPE
65
Control-M for Oracle E-Business Suite Administrator Guide
Template Name
Defines the name of the selected template.
Usage
Format
Optional
Variable Name
You can add a template by clicking . You can also delete a template by clicking .
Single Request: %%OAP-LOUT-P<n>-NAME
Request Set: %%OAP-SETPROG-P<n>-LOUT-P<n>-NAME
Language (Template)
Defines the output language of the selected template.
Usage Optional
Format
Default
Variable Name
<Language>_<TERRITORY>
AMERICAN_AMERICA
Single Request: %%OAP-LOUT-P<n>-LANG
Request Set: %%OAP-SETPROG-P<n>-LOUT-P<n>-LANG
66
Control-M for Oracle E-Business Suite Administrator Guide
Type
Defines the type of the selected template.
Usage
Format
Default
Variable Name
Optional
One of the following options:
RTF
EXCEL
HTML
RTF
Single Request: %%OAP-LOUT-P<n>-TYPE
Request Set: %%OAP-SETPROG-P<n>-LOUT-P<n>-TYPE
Notify/Notify the following people
Enables you to generate a selection list containing all Oracle workflow roles. You can add parameters by clicking on in the relevant field. You can also delete a parameter by clicking on .
Usage
Format
Length
Optional
List generated by Control-M.
1-214 characters
Case sensitive
Variable Name
Yes
Single Request: %%OAP-NOTIFCATIONS-Nn-NAME
Request Set:
%%OAP-SETPROG-P<n>-NOTIFY-N001-DISP_NAME
67
Control-M for Oracle E-Business Suite Administrator Guide
Print to/Print the output to:
Determines print settings. The following table describes the Print to parameters.
Parameter Description
Defines the format in which the job output is printed.
Enables the Oracle E-Business Suite server to generate a list in real time of all available printers.
Defines the number of required copies.
Style
Defines the format in which the job output is printed.
Usage Optional. Mandatory if a value is supplied for the Printer parameter.
Common for all defined printers. You can add predefined styles by clicking .
Length
Case Sensitive
1-20 characters
Yes
Invalid Characters None
Variable Name %%OAP-PRINTSTYLE
Request Set: %%OAP-SETPROG-P<n>PRINTSTYLE
68
Control-M for Oracle E-Business Suite Administrator Guide
Printer
Defines the unique name for the printer. The Oracle E-Business Suite server to generate a list in real time of all available printers. Select the required printer for job output.
Usage
Length
Optional
1-100 characters
Case Sensitive Yes
Invalid Characters None
Variable Name Single Request: %%OAP-PRINTERS-P<n>NAME
Request Set: %%OAP-SETPROG-P<n>PRINTERNAME
No of copies
Defines the number of required copies.
Usage
Length
Optional
Integer. 1-4 digits
Variable Name Single Request: %%OAP-PRINTERS-P<n>VALUE
Request Set: %%OAP-SETPROG-P<n>PRINTCOPIES
69
Control-M for Oracle E-Business Suite Administrator Guide
Post Process Actions
Enables you to set post completion actions. The following table describes the Post Process Actions.
Parameter Description
Output Handling
Enables Control-M for Oracle E-Business Suite request log is copied to the Control-M job output. Default: Selected.
Enables Control-M for Oracle E-Business Suite request output is copied to Control-M job output. Default: Not Selected.
Completion Status
Allow job to complete successfully even if OEBS warning occurred (on page 71 )
Enables a job to complete even if Control-M for Oracle E-Business
Suite request ended with a Warning status. Default Not selected.
Monitor all child request (Wait
Tracks the status of child jobs. If not selected, only the status of the parent job is tracked. Default: Selected.
Job completion status will depend on child requests status
Enables Control-M jobs ending status to be set according to the worst completion status of all the child requests. If not selected, the job status is determined by the parent job's ending status.
Default: Not selected.
Append Request Log to Job Output
Enables the request log to be copied to Control-M output.
Usage
Format
Variable Name
Optional
Checkbox
Default: Selected
%%OAP-DISPLAY_LOGFILE
70
Control-M for Oracle E-Business Suite Administrator Guide
Append Request Output to Job Output
Enables the output of the Oracle Job appends to the job output.
Usage
Format
Optional
Checkbox
Default: Not selected
Variable Name %%OAP-DISPLAY_OUTPUT
Allow job to complete successfully even if OEBS warning occurred
Enables a job to complete even if Control-M for Oracle E-Business Suite request ended with a Warning status.
Usage Optional
Format
Variable Name
Checkbox
Default: Not selected
%%OAP-CONVERT_WARNING2OK
Monitor all child request (Wait Child)
Enables Control-M to track the status of all child jobs, if an Oracle job spawned multiple jobs. If not,
Control-M only checks the original job status, stopping as soon as it finishes.
Usage
Format
Variable Name
Optional
Checkbox
Default: Selected (Tracks child job status)
%%OAP_WAITCHILD
71
Control-M for Oracle E-Business Suite Administrator Guide
Job completion status will depend on child requests status
Enables Control-M jobs ending status to be set according to the worst completion status of all the child requests. If not selected, the job status is determined by the parent job's ending status.
Usage
Format
Variable Name
Optional
Checkbox
Default: Not selected
%%OAP-SUBSTATUS
Profile Name
Defines the Profile internal name.
Usage
Length
Case Sensitive
Optional
1-214 characters
Yes
Invalid Characters None
Variable Name Single Request: %%OAP-PROFILES-P<n>-USER_NAME
Request Set: %%OAP-PROFILES-P<n>NAME
Profile Value
Defines the Profile value.
Usage
Length
Case Sensitive
Optional
1-214 characters
Yes
Invalid Characters None
Variable Name %%OAP-PROFILES-P<n>VALUE
72
Control-M for Oracle E-Business Suite Administrator Guide
Increment date parameters each run
Enables the job parameter's date to increase on each run. If your request contains date parameters, by selecting this parameter, the value for date parameter can be adjusted to match the resubmission interval.
EXAMPLE
: If the value for the parameter is 1 January 2014 09:00:00 and your interval is monthly, the parameter is adjusted to 1 February 2014 09:00:00 for the next submission. For more information, see the
Oracle Applications User Guide.
NOTE: When submitting a job, which each parameter has a date format X, Y, or T (the format values are stored in the Oracle database for Standard Date, Standard DateTime and DateTime) and its override value is not blank, the new incremented date is calculated as follows:
ODATE - (First Run Date - Parameter current date value)
Usage
Format
Variable Name
Optional
Checkbox
Default: Unchecked
%%-OAP-INCREMENT_DATE
First run date
Defines the first run date for the Increment Date Parameter.
Usage Optional
Format
Variable Name
YYYY/MM/DD HH:MM:SS
%%OAP-FIRST_RUN_DATE
73
Control-M for Oracle E-Business Suite Administrator Guide
Monitor Request Properties parameters
The following table describes the Monitor Request Properties parameters in Active jobs in the
Monitoring pane. You can analyze jobs, manage job flows, and certain details for the job run. For more information, see
Active Job analysis
in
Using Control-M Workload Automation
.
Field Definition
Defines the OEBS Request ID number
Defines the name of the program
Defines the parent of the job or process
Defines the phase of the job or process
Defines the status of the job or process
Defines the priority of the job or process
NOTE: If you want to view the output in a defined format, in the Output field, click View , which enables you to open non textual output reports such as PDF, XLS, and TXT.
Request ID
Defines the Oracle E-Business request ID number.
NOTE: The value of this parameter is supplied by the Oracle E-Business Suite and cannot be modified.
Usage Optional
Format
Variable Name
Number, 1-15 digits in length.
Displayed only in Active Jobs in Control-M Workload Automation.
%%OAP-ACTIVE_ATTR<n>REQUEST_ID
74
Control-M for Oracle E-Business Suite Administrator Guide
Name
Defines the name of the program.
Usage
Length
Case Sensitive
Invalid characters
Format
Variable Name
Optional
1-30 characters
Yes (uppercase)
Blanks
Displayed only in Active Jobs in Control-M Workload Automation.
Single Request: %%OAP-ACTIVE-ATTR001-REQ_NAME
Request Set:
OAP-ACTIVE-ATTR001-REQ_NAME
OAP-ACTIVE-ATTR002-REQ_NAME
Parent
Defines the parent of the job or process.
NOTE: The value of this parameter is supplied by Oracle E-Business Suite and cannot be modified.
Usage
Format
Optional
Number, 1-15 digits in length.
Displayed only in Active Jobs in Control-M Workload Automation.
Variable Name %%OAP-ACTIVE-ATTRn-PARENT
Phase
Defines the phase of the job or process.
NOTE: The value of this parameter is supplied by the Oracle E-Business Suite and cannot be modified.
75
Control-M for Oracle E-Business Suite Administrator Guide
Usage
Length
Case sensitive
Format
Optional
1-50 characters
Uppercase only
Displayed only in Active Jobs in Control-M Workload Automation.
Invalid Characters Blanks
Variable Name %%OAP-ACTIVE-ATTRn-PHASE
Status
Defines the Oracle E-Business Suite status of the job or process.
After the job is submitted for execution in Oracle E-Business Suite, Oracle E-Business Suite determines how the job is handled (such as Hold or Free).
NOTE: The value of this parameter is supplied by the Oracle E-Business Suite and cannot be modified.
Usage Optional
Format
Variable Name
Displayed only in Active Jobs in Control-M Workload Automation.
%%OAP-ACTIVE-ATTR<
n
>-STATUS
Priority
Defines the priority of the job or process.
Usage Optional
Format
Variable Name
Displayed only in Active Jobs in Control-M Workload Automation.
%%OAP-ACTIVE-ATTR<
n
>-PRIORITY
NOTE: Control-M priority determines the priority submission of the job in Control-M, whereas Priority under Oracle E-Business Suite determines the priority of the job in Oracle E- Business Suite. There are two Priority settings for an Oracle E-Business Suite job that is scheduled in the Control-M data center. The priority of a job in Control-M is first used to determine when Control-M Workload Automation schedules the job for execution. After the job is submitted for execution in the Oracle E-Business Suite, the Oracle E-
Business Suite Priority of the job determines when it is run in the Oracle E-Business Suite. For more information about Priority, see
Priority
in
Control-M Workload Parameters
.
76
Télécharger
Lien public mis à jour
Le lien public vers votre chat a été mis à jour. Vous pouvez afficher et gérer vos liens de chat après inscription ici.
Lien public du document
Publicité