Cisco Workload Automation Oracle Adapter Guide
Cisco Workload Automation Oracle Adapter Guide
Version 6.3
2
Contents
Contents 3
Preface 5
Audience 5
Related Documentation 5
Obtaining Documentation and Submitting a Service Request 5
Document Change History 6
Introducing the Oracle Applications Adapter 7
Overview 7
Monitoring Oracle Applications Jobs 7
Multi-Organization Access (MOAC) 8
Terms to Know 8
Minimum Software Requirements 9
Configuring the Oracle Applications Adapter 11
Overview 11
Installing the Oracle Applications Bridge 11
Prerequisites for Installing the Oracle Applications Bridge 12
Installing the Bridge for 11i or R12 12
Initial Installation or Upgrade Windows Forms Server 13
Initial Installation or Upgrade Unix Forms Server 13
Verifying Successful Bridge Installation or Upgrade 14
Uninstalling the Bridge 14
Installing the Oracle Application Bridge Using a Custom APPS User 15
Licensing an Adapter 16
Defining a Security Policy 17
Configuring Users for the Oracle Applications Adapter 17
Adding the APPS database user to CWA 18
Authorizing Users 19
Adding an Oracle Applications User as a Runtime User 20
Verifying TNS File Formatting (Oracle Users Only) 20
Configuring SSL and HTTPS Protocol for the Oracle Applications Adapter 21
Obtaining the Security Certificates 21
Exporting the Security Certificates 22
Importing the Target Server Certificates into a Java Keystore 23
Defining an Oracle Applications Connection 24
Checking the Connection Status 30
Configuring Oracle for Scheduler 31
Configuring Oracle Parameters 31
Configuring User Access 31
Configuring Interception Criteria Access 31
Configuring Interception Parameters 32
Defining an Oracle Applications Agent List 32
Using the Oracle Applications Adapter 35
Overview 35
Prerequisites 35
Creating an Oracle Applications Job 36
Defining an Oracle Applications Job 36
Working with Request Sets 40
3
Substituting Different Parameter Values 40
Working with Oracle Applications Jobs 41
Oracle Application Procedures 41
Adding a Concurrent Program to an Oracle Application Job 41
Adding a Request Set to an Oracle Application Job 42
Substituting Parameter Values 42
Viewing the Parameters of a Completed Job 42
Deleting Oracle Applications Jobs from the CWA Database 43
Deleting Oracle Applications Jobs from the Oracle Database 43
Managing User-Submitted Oracle Applications Jobs 43
Intercepting Oracle Applications Jobs 44
Studying Details of the Oracle Applications Concurrent Request 46
Oracle Applications Job Details Dialog 46
Viewing Oracle Applications Job Output 48
Performing Routine Maintenance 49
Monitoring Oracle Applications Jobs 49
Controlling Adapter and Agent Jobs 49
Holding a Job 49
Aborting a Job 49
Rerunning a Job 50
Making One Time Changes to an Adapter or Agent Job Instance 50
Deleting a Job Instance before It Has Run 50
Working with Multiple Organization Access (MOAC) 50
Concurrent Programs Behavior with MOAC 50
CWA Support for Multiple Organizations 51
Run the Request for Multiple Operating Units 52
Select a Particular Operating Unit 53
MOAC Feature Disabled 53
Using an Alternative Database User 53
Configuring [Link] 57
About Configuring [Link] 57
[Link] Properties 57
Appendix A—Custom APPS User SQL Commands 61
[Link] Commands 61
tidal_syn.sql Commands 74
sys_grant.sql Commands 76
Appendix B—sabdg_global Package 77
4
Preface
This guide describes the installation, configuration, and usage of the Oracle Applications Adapter with Cisco Workload
Automation (CWA).
Audience
This guide is for administrators who install and configure the Oracle Applications Adapter for use with CWA, and who
troubleshoot CWA installation and requirements issues.
Related Documentation
See the Cisco Workload Automation Documentation Overview for your release on [Link] at:
[Link]
[Link]
Note: We sometimes update the documentation after original publication. Therefore, you should also review the
documentation on [Link] for any updates.
[Link]
Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical
documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds
are a free service.
5
Preface
Added new section for Installing the Oracle Application Bridge Using a Custom APPS
User, page 15 and appendices to support this process.
Added a new section for Working with Multiple Organization Access (MOAC), page 50.
6.3 BETA June 2016 Rebranded “Cisco Tidal Enterprise Scheduler (TES)” to “Cisco Workload Automation
(CWA)”.
Added the Configuring SSL and HTTPS Protocol for the Oracle Applications Adapter,
page 21 section.
6
1
Introducing the Oracle Applications Adapter
This chapter provides an overview of the Oracle Applications Adapter and its requirements:
Overview, page 7
Overview
The CWA adapter for Oracle Applications integrates Oracle Applications into CWA using a concurrent manager bridge.
The Oracle Applications Adapter from CWA uses Net*8 (SQL*NET) to connect directly to Oracle databases when
accessing Oracle Applications.
Oracle databases compile and store procedures and functions in units called packages. The Oracle Applications Adapter
uses Oracle’s packages and other packages customized by CWA in combination with SQL statements to integrate the
CWA job scheduler with the Concurrent Manager process that monitors and controls the Oracle Applications job. The
Concurrent Manager monitors and responds to the data stored within the Oracle database using the packages available
to it.
The customized packages supplied by CWA must be compiled in Oracle Applications before a connection between CWA
and Oracle Applications can be established. An error occurs in CWA if you try to establish a connection to an Oracle
Applications instance before the proper customized packages are installed on the designated Oracle Applications
instance.
Any inserting and updating to the standard tables of Oracle Applications is done using standard APIs present in the
Oracle Applications database. Nothing is deleted from the standard Oracle Applications database just as no database
schema objects are modified.
The Oracle Applications adapter is part of the regular Scheduler installation. It can only be used though if the appropriate
license is applied to Scheduler. Though no installation is required for the adapter, you must install a Bridge component
that links the adapter to the Oracle Applications program. After the Bridge is installed, you must perform some
configuration procedures for the adapter.
7
Introducing the Oracle Applications Adapter
Overview
request set comprising a job. It tracks the request set as a whole and thus does not have control over individual requests
within a request set. The ID number in Scheduler is assigned to the first request and applies to all of the requests within
the request set.
Oracle Applications, on the other hand, does not treat a request set as a whole. It assigns each request within the request
set an individual request ID number. The request ID number assigned by Oracle to the first request of a request set is
displayed in the Ext ID column (External ID) of the Job Activity pane. The ID numbers of each individual request are listed
on the Oracle Apps tab of the Job Detail dialog of the job.
To achieve control over individual requests and to assign dependencies to a single request within a request set, break
down the request set into separate requests for each job and organize the single requests into a job group in Scheduler.
In Release 11i, you had to enter or process data for multiple operating units; you had to login to different responsibilities
because each responsibility could only access one operating unit. For example, if you were managing Payables for
Sweden, Norway, and Finland, you needed to define three different responsibilities. In Release 12, you can create a
Security Profile and assign as many operating units as you required. You can tie that security profile to a single
responsibility using a profile option called MO: Security Profile. For example, you can assign the security profile to the
EMEA Payables responsibility to allow that responsibility to process invoices across all three operating units.
The CWA Oracle Applications Adapter supports multiple organization access for Oracle Application Server R12 and later.
See Working with Multiple Organization Access (MOAC), page 50 in the Using the Oracle Applications Adapter, page 35
chapter for how to configure an Oracle Applications job definition for multiple organization access.
Terms to Know
Application – Group of modules that perform a particular enterprise func- tion, such as Accounts Receivable,
Accounts Payable, General Ledger, etc.
Concurrent Manager – Concurrent processing facility that monitors and runs your requests/processes/reports
without tying up the users terminal.
Concurrent Process – Task that is in process in the concurrent manager. Each time you submit a task to the
concurrent manager, then a concurrent process is created to run that task. Many concurrent processes can be
running simultaneously without tying up the users terminal or requiring user intervention.
Concurrent Queue – The list of concurrent requests that are in the concurrent manager awaiting processing. The
concurrent manager can be set up to have multiple concurrent queues, each queue having its own list of concurrent
requests waiting for processing. Each Concurrent Request can be setup to run in specific queues or in any queue,
then the Concurrent Manager assigns the request to a Concurrent Queue accordingly.
Concurrent Request – A request to run a process/report/job in the Concurrent Manager. Once a Concurrent
Request is submitted to the Concurrent Manager, then the Concurrent Manager takes over the processing of the
request without any intervention from the user or tying up the users terminal.
Internal Concurrent Manager (ICM) – The ICM oversees all of the other worker concurrent managers and
assigns requests to the appropriate concurrent manager. The ICM monitors the health of the other concurrent
managers, restarting them if necessary, and follows the status of requests that run on the other worker concurrent
managers.
List of Values – List of valid values available for a particular parameter in Oracle Applications.
Module – Programs and/or procedures that implement a particular business function within an application, such as
forms/screens, reports, concurrent programs and subroutines.
8
Introducing the Oracle Applications Adapter
Open Interface – A function that lets you import or export data from other systems through open interface tables
and processes provided by Oracle.
Parameter – Variables used in concurrent processes to restrict information or determine the form of the report.
Report Group – List of concurrent programs (reports, processes, etc.) that is grouped together based upon a
particular function. Each Oracle Applications Responsibility has at least one Report Group assigned to it, though
some responsibilities can have multiple Report Groups. If a responsibility has multiple Report Groups associated with
it, then it will have multiple menu entries to launch the Submit Concurrent Request screen, one for each Report Group
the responsibility has access to.
Report Options – Options for sorting, formatting, selecting and summarizing the information on a report. Not all
Oracle reports use report options. Report Set – Group of reports that are always run together.
Request Set – One or more sequential stages each of which include one or more concurrent programs that may or
may not run in a particular sequence. Links can be maintained between stages for warning, completion and error
handling.
Responsibility – Security feature that restricts Oracle Application users to a specific set of screens and reports
based on their user login name.
Stage – Represents the sequence for concurrent programs in a request set (report set). Each stage of a request set
has a sequence number, stage name, concurrent program name with On Success, On Error and On Warning links as
well as a critical flag that determines whether the stage affects the entire report set.
The minimum software requirements for the Oracle Applications Adapter for CWA are:
Oracle Applications software 11.5.8, 11.5.9, 11.5.10, 12 - 12.04, 12.1.1, 12.1.3, 12.2.0
Cisco Workload Automation Adapters require Java 7. (Refer to Cisco Workload Automation Compatibility Guide for
further details).
9
Introducing the Oracle Applications Adapter
10
2
Configuring the Oracle Applications
Adapter
Overview
The Oracle Applications Adapter software is installed as part of a standard installation of Cisco Workload Automation.
However, before the Oracle Applications Adapter can be used, the following configuration procedures must be
completed:
Installing the Oracle Applications Bridge, page 11—Install the Oracle Applications Bridge (install_11i or install_R12).
Licensing an Adapter, page 16—License the Oracle Applications Adapter to work with CWA.
Defining a Security Policy, page 17—Define a security policy for running Oracle Applications jobs.
Configuring Users for the Oracle Applications Adapter, page 17—Define a user account that can access the Oracle
database.
Authorizing Users, page 19—Authorize users to run Oracle Applications jobs using the database user account.
Configuring SSL and HTTPS Protocol for the Oracle Applications Adapter, page 21—Obtain, export, and import the
security certificate into the Java keystore.
Defining an Oracle Applications Connection, page 24—Define a connection to the Oracle database.
Configuring Oracle for Scheduler, page 31—Configure Oracle to work with CWA.
See Configuring [Link], page 57 for information about general and adapter-specific properties that can be set to
control things like logging and connection properties.
The Oracle Applications Bridge is comprised of various PL/SQL stored procedures and forms used to pass job
parameters to the Oracle database. The Bridge component of the Oracle Applications adapter is not part of the regular
CWA installation and requires a separate installation procedure.
Note: If you need to create a custom APPS user for CWA, then you also need to use a different installation process for
the Oracle Applications Bridge as described in Installing the Oracle Application Bridge Using a Custom APPS User,
page 15.
11
Configuring the Oracle Applications Adapter
This section describes the prerequisites and processes for the Oracle Applications Bridge:
Installing the Oracle Application Bridge Using a Custom APPS User, page 15
The user must be logged on to Windows/Unix as the application owner (usually applmgr).
Run the application environment file (usually [Link] under $APPL_TOP) in the current shell.
Grant the execute privilege on sys.dbms_obfuscation_toolkit file to the APPLSYSPUB user. This package is used
by the Bridge to encrypt and decrypt the data. To grant this privilege, connect to the database as system (or
SYSDBA) and from the SQL prompt, enter:
Create the tablespace for the Table and Index spaces before starting installation. To configure the tablespaces to
autoextend:
While no existing $APPL_TOP objects/files are modified when installing the Bridge, three new objects/files that start
with SABDG are created.
Note: The database schema names used above are only examples. You can use your own names for the database
schemas.
APPS user (or equivalent) – The equivalent Apps user in the Oracle Applications program.
APPS password – The password of the Apps user used to access Oracle Applications.
TNS name – The TNS string to connect to the database (Windows only)
12
Configuring the Oracle Applications Adapter
System password – The database user system password. This is required for when the installation process creates
the SABDG user in the database to own tables, sequences and indexes.
Use these parameters when running the batch file to install the Bridge. The installation and upgrade procedures for both
Windows and Unix forms server are described next.
install_11i <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <TNS Alias Name> <Temp
Tablespace> <System Password>
-or-
install_R12 <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <TNS Alias Name> <Temp
Tablespace> <System Password>
upgrade_11i <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <TNS Alias Name> <Temp
Tablespace> <System Password>
-or-
upgrade_R12i <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <TNS Alias Name>
<Temp Tablespace> <System Password>
2. From the temporary directory where you copied the Bridge files, at the cursor, enter:
chmod 777*
sh ./install_11i.sh <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <Temp
Tablespace> <System Password>
-or-
13
Configuring the Oracle Applications Adapter
sh ./install_R12.sh <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <Temp
Tablespace> <System Password>
2. From the temporary directory where you copied the Bridge files, at the cursor, enter:
chmod 777*
sh ./upgrade_11i.sh <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <Temp
Tablespace> <System Password>
-or-
sh ./upgrade_R12.sh <APPS User> <APPS Password> <Data Tablespace> <Index Tablespace> <Temp
Tablespace> <System Password>
Note: If you have a multi-tier architecture of Oracle Applications containing multiple form servers, then the Bridge
for Oracle Applications must be installed on only one forms server and upgraded on the rest of the form servers to
ensure distribution of the Bridge forms.
TOT(Total Objects)
VAL(Valid Objects)
INV(Invalid Objects)
If the values displayed in the log file are the proper values, then installation/upgrade was successful. Any deviation from
these values indicates that the installation/upgrade was unsuccessful.
2. Run the sabdg_drobj.sql script that is found in the \OraAppsBridge\Windows\sabdg_obj.sql file in the
Windows directory on the installation DVD-ROM.
14
Configuring the Oracle Applications Adapter
rm %AU_TOP%\forms\US\SABDG\*.fmb
rm -r %FND_TOP%\forms\US\sabdg
rm -r %APPL_TOP%\sabdg
Unix:
rm $AU_TOP/forms/US/SABDG/*.fmb
rm -r $FND_TOP/forms/US/sabdg
rm -r $APPL_TOP/sabdg
2. Install the Bridge using the custom APPS user named TIDAL:
CREATE USER “TIDAL" PROFILE "DEFAULT" IDENTIFIED BY "tidal12345" DEFAULT TABLESPACE "SABDG_DATA"
TEMPORARY TABLESPACE "TEMP" QUOTA UNLIMITED ON "SABDG_DATA" QUOTA UNLIMITED ON "SABDG_INDEX"
ACCOUNT UNLOCK;
b. Run the [Link] as the system user from [Link] Commands, page 61 in Appendix A.
c. Run the sys_grant.sql as the sys user from sys_grant.sql Commands, page 76 in Appendix A.
d. Run the tidal_syn.sql from tidal_syn.sql Commands, page 74 in Appendix A as the TIDAL user created in step a.
e. Copy the [Link] / [Link] to any location in the OracleApps server and
unzip it.
15
Configuring the Oracle Applications Adapter
Licensing an Adapter
$ ./install_R12.sh ADT_TIDAL adt123 SABDG_DATA SABDG_INDEX TEMP1 <system user (system) password >
Installation Output:
TNS Ping Utility for Linux: Version [Link].0 - Production on 10-SEP-2013 09:38:04
Copyright (c) 1997, 2003, Oracle. All rights reserved.
Used parameter files:
Used TNSNAMES adapter to resolve the alias
Attempting to contact (DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=YES) (FAILOVER=YES)
(ADDRESS=(PROTOCOL=tcp)(HOST=[Link])(PORT=1541))
(ADDRESS=(PROTOCOL=tcp)(HOST=[Link])(PORT=1541))) (CONNECT_DATA= (SERVICE_NAME=erpcrp2)))
OK (0 msec)
Installing Tidal OraApps Bridge
************* Installing Oracle Bridge ***************
Unable to install Tidal OraApps Bridge
INS:21 All objects did not get created
g. Install the custom sabdg_global package as the TIDAL user using the sabdg_global_new.sql in Appendix
B—sabdg_global Package, page 77.
h. Make the OracleApps connection from CWA master using the custom Apps user.
Licensing an Adapter
Each CWA Adapter must be separately licensed. You cannot use an Adapter until you apply the license file. If you
purchase the Adapter after the original installation of CWA, you will receive a new license file authorizing the use of the
Adapter.
You might have a Demo license which is good for 30 days, or you might have a Permanent license. The procedures to
install these license files are described below.
To license an Adapter:
1. Stop the master:
Windows:
b. Verify that the master is displayed in the Service list and click on the Stop button to stop the master.
UNIX:
— For a Demo license, create a file called [Link], then type the demo code into the [Link] file.
Windows:
UNIX:
The master will read and apply the license when it starts.
16
Configuring the Oracle Applications Adapter
5. To validate that the license was applied, select Registered License from Activities main menu.
2. Select a security policy for the Oracle Application job privileges and double-click on it to display its Security Policy
Definition dialog.
3. Scroll down the list of function categories and double-click on the OracleApps Jobs category to display the
available functions that can be assigned to the security policy:
A check mark appears next to the OracleApps Jobs function category indicating that one or more functions are selected
within the category.
If needed, different security policies with varying authorized functions can be created to provide different levels of access
for a variety of users.
For more information about the Security Policy Definition dialog, refer to the chapter on User Administration in your CWA
User Guide.
There are two types of users that must be defined before you can submit Oracle Application jobs:
17
Configuring the Oracle Applications Adapter
Database user (APPS) – This is the user definition created in Scheduler with the APPS authority to access the
Oracle instance. This user adds other users defined in Scheduler to its runtime user list. The APPS user grants or
revokes the access of every other user in CWA to Oracle Applications jobs. Only Scheduler users that belong to the
APPS user’s runtime list can run or create jobs in Oracle Applications.
If your security does not allow the APPS user the authority to access Oracle Applications jobs from CWA, then you
might need to create a custom APPS user. This process is described in this section.
Runtime user – These users are defined in CWA without access rights to run Oracle Applications jobs on their own.
These other users in CWA may have varying levels of security privileges but none of them can run Oracle Applications
without being on the APPS runtime user list. Once these users are added to the APPS runtime user list they can
create and/or modify existing Oracle Applications jobs.
Note: If necessary, you can create multiple APPS users with different passwords. In the user definition, use the Domain
field to distinguish one APPS user from another. The Full Name field can describe which APPS user is which.
2. Either click the Add button in the toolbar, or right-click in the Users pane and select Add Runtime User from the
context menu to display the User Definition dialog.
3. In the User Name field, enter the user name for the database user account provided by the Oracle Applications
System Administrator for CWA use.
It is recommended to use APPS for easy identification and security purposes. No value is necessary in the Full
Name field or the Domain field.
18
Configuring the Oracle Applications Adapter
Authorizing Users
5. On the Passwords tab, click Add to display the Change Password dialog.
Only those users with a password specified for Oracle Applications will be available for use with Oracle Applications
jobs. The password might be the same as the one specified for Windows/FTP jobs.
9. Click OK.
If the OracleApps Password and Confirm Password values do not match, you must re-enter the password in both
columns. For more information about the User Definition dialog, refer to the chapter on Users in your CWA User Guide.
Authorizing Users
If a user is to work with Oracle Applications jobs, the user needs the defined Oracle Applications user added to their
runtime users list. When the user runs an Oracle Applications job, the user is recognized and allowed to access the
Concurrent Manager datatables as needed.
Note: The runtime users defined in CWA are subject to the same limitations placed on the Oracle Applications user in
the Oracle Applications environment.
19
Configuring the Oracle Applications Adapter
2. Double-click the name of the user who will be running Oracle Applications jobs to display the User Definition
dialog.
4. In the Runtime Users list, select the check box(es) next to the name(s) of the Oracle Applications user(s) you
created in Adding the APPS database user to CWA, page 18 and click OK.
TNSNamesFile=<directory pathname>
For example:
20
Configuring the Oracle Applications Adapter
Configuring SSL and HTTPS Protocol for the Oracle Applications Adapter
TNSNamesFile=C:/oracle/ora90/network/ADMIN/[Link]
Note: If you are using Unix, then there is no drive letter at the beginning of the pathname. The directory pathname
is case-sensitive.
Solution Open the TNS file and using the same name specified in the TNS Name field of the Connection Definition
dialog for the Oracle Applications adapter, do a search to find that name.
Solution When you find the definition of the TNS, replace the service name or if the using the SID verify that the
parameters specifying the protocol, host and port are provided. The parameters are case-sensitive and must be in
capital letters as in the following example:
Configuring SSL and HTTPS Protocol for the Oracle Applications Adapter
It is recommended that Oracle Applications Web servers be configured to use SSL via the HTTPS protocol for Data
Services/Data Integrator. If your environment is configured to use HTTP, you can skip this section.
For complete instructions on configuring Oracle Applications servers to use the HTTP or HTTPS protocol, refer to the
Oracle Applications documentation that ships with the product.
Note: Although other procedures are available for obtaining the required certificates, the procedure below can be
performed from your Windows desktop.
Note: You need to carry out the following instructions only if your server certificate is generated in-house (that is,
self-signed) or if your server certificate is signed by a Certification Authority that is not trusted by the version of Java you
are using. Alternatively, if your adapter connection fails by reporting the error “unable to find valid certification path to
requested target” you need to carry out the following instructions.
[Link]
21
Configuring the Oracle Applications Adapter
Configuring SSL and HTTPS Protocol for the Oracle Applications Adapter
where adminHost is where the Data Integrator Administrator is installed and adminPort is the port the Data Integrator
Administrator is listening on.
5. On the Certificate Store panel, use the default option Automatically select the certificate store based on
the type of certificate and click Next.
A Security Warning message displays informing you that you are about to install a certificate from a certification
authority.
9. Click OK on the Certificate dialog. You can close your browser now.
10. Repeat the process for each Oracle Applications server that you want to connect to with the Oracle Applications
adapter.
C:\OA-Certs
5. On the Certificates dialog, select the Trusted Root Certification Authorities tab to display the list of trusted
certificates. This list should contain the certificates for the target servers that were obtained in the previous
procedure (see Obtaining the Security Certificates, page 21).
a. Select the certificate and click Export to launch the Certificate Export Wizard.
c. On the Export File Format panel, use the default option DER encoded binary X.509 (.CER) and click Next.
d. On the File To Export panel, enter the complete path to the OA-Certs directory and a unique name for the
certificate:
22
Configuring the Oracle Applications Adapter
Configuring SSL and HTTPS Protocol for the Oracle Applications Adapter
C:\OA-Certs\[Link]
e. Click Next.
f. On the Completing the Certificate Export Wizard panel, click Finish to complete the export.
8. After all target server certificates have been exported, click Close to exit the Certificates dialog.
Note: These instructions assume that a JRE or JDK is in your system PATH.
2. Change to the directory where the certificates are stored by entering the following commands:
c:
cd \OA-Certs
3. Use the Java keytool utility to import a certificate. The following syntax is used:
For example:
4. When prompted to create a password for the keystore, enter a password at the prompt. The keystore utility displays
the certificate information.
5. At the Trust this certificate? [no] prompt, type yes and press Enter. The certificate is imported into the
<your_trusted_keystore>.keystore keystore and the following message displays:
7. Navigate to the following folder where the Cisco Workload Automation Oracle Applications Adapter is installed and
create a new directory named config:
<install dir>\master\services\{88EBA24D-7B9A-4EAC-855B-F29D99CE37E9}\config
8. Create a text file named [Link] in the \config directory located under the Adapter’s GUID directoryif it doesn’t
already exist.
9. Open the [Link] text file and add the following line:
Keystore=c:\\OA-Certs\\<your_trusted_keystore>.keystore
23
Configuring the Oracle Applications Adapter
See also Configuring [Link], page 57 for information about general and adapter-specific properties that can be
set to control things like logging and connection properties.
To define a connection:
1. From the Navigator pane, select Administration>Connections to display the Connections pane.
2. Click the Add button to display a menu that lists the various types of connections that you can define and select the
OracleApps Adapter option, or right-click in the Connections pane and select Add Connection>OracleApps
Adapter from the context menu to display the Connection Definition dialog.
Note: You can add an Oracle Applications connection only if you have purchased a license and installed the bridge
supplied with the CWA software.
Note: You cannot modify the connection parameters once the connection is created. You must delete the connection
and create a new connection.
3. In the Job Limit field of the General tab, enter the maximum number of jobs that should run on the server
concurrently. This number is checked and enforced by CWA prior to job launch.
4. From the Default Runtime User field, select an Oracle Applications user to be used as the default runtime user
for Oracle Applications jobs.
Do not use the Oracle database user; this list refers to an application user. The user entered here is automatically
supplied as the runtime user in CWA Oracle Applications job definitions.
24
Configuring the Oracle Applications Adapter
The OracleApps Connection tab supplies CWA the information needed to logon to the Oracle database instance.
7. From the APPS User list, select the database user to be used when the CWA master connects to the Oracle
Applications database.
If you followed the recommendation in Adding the APPS database user to CWA, page 18, APPS is the proper user.
8. In the Host Name field, enter the host IP address or host name.
10. From the OracleApps Version list, select the version of the application being used.
25
Configuring the Oracle Applications Adapter
The Concurrent Managers tab defines how CWA determines the health of the Oracle Applications connection. The
health of an Oracle Applications connection is determined by monitoring the status of specified concurrent managers.
Only the concurrent managers that have been selected are monitored. The status of the concurrent managers not
selected are irrelevant to the status of the defined Oracle Applications connection. You should select only the concurrent
managers that control processes affecting the jobs you create.
Internal Manager
Standard Manager
There are several columns of information on the Concurrent Managers tab describing the current status of the listed
concurrent managers.
Node – Name of the machine that the Concurrent Manager is located on.
Actual – Displays how many defined instances (or threads) of the listed concurrent manager are actually running.
Any concurrent managers with a 0 value in the Actual column are considered to have an unhealthy status. However,
only a 0 value for a selected concurrent manager is of concern.
Target – Displays how many instances (or threads) of the listed concurrent manager are defined (running or not).
Pending – Displays how many requests are queued up and waiting to run as soon as resources are available to
process the job.
Status – Displays the status of the listed concurrent manager. The status column should be blank unless there is a
problem. Any messages in the status column are usually error messages concerning a problem with the concurrent
manager. Possible status values are:
— Deactivated
— Terminated
26
Configuring the Oracle Applications Adapter
The Interception tab configures criteria for managing unscheduled jobs that are submitted to Scheduler. Ad-hoc jobs
bypass the scheduled management of jobs that were compiled into the day’s schedule. An excessive number of ad-hoc
jobs impacts the running of jobs within the production schedule by consuming system resources. By imposing criteria on
the concurrent requests that are submitted to the concurrent manager outside of CWA, you can create queue filters and
use queue limits to control when these ad-hoc requests actually run. Ad-hoc jobs that do not match the interception
criteria are not intercepted.
Using the Oracle Profile option, CONC_HOLD, the Applications adapter can impose an increasingly more detailed
interception criteria when evaluating unscheduled jobs. The four levels of interception criteria ranging from the broadest
based criteria to the most detailed criteria are: Site, Application, Responsibility and User. Through the careful
selection of the options on this tab, you can create an interception profile as specific as your system requires.
Intercept Oracle Application Concurrent Requests (Site CONC_HOLD=Y) – Selecting this option enables
the interception feature at its broadest definition. Any concurrent request that comes from any application, from any
responsibility and from any user will be held. This Site setting will enable all of the interception criteria ensuring that
all unscheduled jobs are directed to a designated queue where their entry into production can be managed by
Scheduler. By default, this option is selected during installation. After selecting the Site setting, you can still go to
the other options on the tabs of this tab to specify that concurrent requests originating from designated applications,
responsibilities or users can bypass interception.
Update – Clicking this button refreshes the information on this tab to display the current interception configuration
after any changes are made to this tab.
Applications tab – Lists the various applications available within Oracle Applications. If the Site level option is not
selected, you would select only those applications that you want to include. Any concurrent requests that originate
from those applications with a check mark are intercepted. If the Site level setting option is selected then all of the
listed applications are in gray text to indicate that they are selected by default as part of the Site level setting. Any
applications displayed in bold text indicate that the application is overriding its default setting.
27
Configuring the Oracle Applications Adapter
Responsibility tab – Lists the various responsibilities available within a selected application. On this tab, you can
select an application listed on the Applications tab and refine its interception criteria by adjusting its
responsibilities.
— Application option – Selects all of the responsibilities for the selected application for interception. Only the
concurrent requests that originate from those responsibilities with a check mark are intercepted. Any
responsibility displayed in gray text indicates that it is selected by default as part of a higher level setting (Site
or Application). You can override the default setting by clearing the check box beside the responsibility. Any
responsibilities displayed in bold text indicate that the responsibility is overriding its default setting.
Caution: A bug in Oracle prevents responsibilities from functioning properly as interception criteria. Service
Request 5099851.992 reporting this problem has been logged with Oracle. Until Oracle resolves the issue, do not
use responsibilities to flag jobs for interception.
— Users tab – Lists the defined users within the Oracle Applications instance. All of the users on this tab with a
check mark beside them will have their ad-hoc concurrent requests intercepted. If the check box beside the
user name is cleared then none of the concurrent requests submitted by that user are intercepted. Any user
name displayed in gray text indicates that user is selected by default as part of the Site level setting. You can
override the default setting by clearing the check box beside the user name.
28
Configuring the Oracle Applications Adapter
This tab provides a window to the Internal Concurrent Manager (ICM) of Oracle without having to leave CWA. The
ICM oversees all of the other concurrent managers and assigns requests to the appropriate worker concurrent
manager. The ICM monitors the health and status of the requests that run on the other worker concurrent managers.
A user can check the log of the ICM by going to this tab. This is a convenient way to check the status of current
processes that are running within Oracle Applications.
The Options tab of a Connection Definition dialog allows for the configuration of polling for the connection and for
the addition of any configuration parameters as needed.
— Connection poll – Enter the interval of time (in seconds) before the master checks that the connection is
working.
29
Configuring the Oracle Applications Adapter
The Name section can contain the following parameters and default values:
— BATCH_STATUS_CHECK – Indicates whether the status of requests will be performed in batches (default =
Y). If set, BATCH_STATUS_CHECK_SIZE specifies the batch size (default=100). When request statuses are
checked in batches, fewer Database transactions are sent to the server. Only after the batch size limit is
reached, will a single Database transaction be initiated to get the status of all requests defined in the batch.
Using this parameter may result in a slight delay in retrieving request statuses, if many requests are running. If
BATCH_STATUS_CHECK = N, then request statuses are not performed in batches. This means a Database
transaction is initiated for every request, resulting in more transactions being sent to the server. With this option,
there is no delay in waiting for the batch limit to be reached, however, it may result in slower performance as
more Database transactions are initiated, 1 for every request.
— DATA_CACHE_TIMEOUT – Specifies the expiration time (in seconds) of any cached data. The default is 600
seconds or 10 minutes.
— ORADEBUG – Enables debugging for the Oracle Applications adapter. Default value is OFF.
— OraAppsDBConnections – Specifies the maximum number of connections opened to the Oracle Applications
database. Default value is 5.
— IGNORESTDMGR – If IGNORESTDMGR=Y, the health of the Standard Manager will be ignored when verifying
the connection health.
To add/edit a variable:
a. Click Add or Edit to display the Variable Definition dialog.
b. Enter the name of the variable into the Variable Name field.
c. Enter the value for the variable in the Variable Value field.
The Scheduler master continually monitors the health of the connection. If the Oracle Applications connection is not
available to the master, the status light in front of the connection name is red, and the Connections status light at the
bottom of the console is red (or yellow if other agents are connected to the master).
30
Configuring the Oracle Applications Adapter
You can test the Oracle Applications connection by right-clicking within the Connections pane and selecting the Test
option from the context menu. This test checks the status of the connection between the database and the client but
does not verify the health of the connection between the master and the client.
Parameter Value
REL_EXT_REQ Specifies whether external requests should be released. Valid values are Y or N.
LOG_EXT_REQ Specifies whether to log the messages about external requests. Valid values are Y or N
MASTER_ALLOWED Specifies which Scheduler master can release external requests.
PURGE_FREQUENCY Specifies how often the log data recorded about the external requests should be purged.
Values are numerical expressing the number of days to keep the data.
PROFILE_ACCESS Specifies whether the Scheduler administrator can access the Oracle Applications Profile
settings to modify the interception criteria. Valid values are Y or N.
The Oracle DBA should configure each user’s access to their profile to prevent users from accessing the profile to make
changes. On the CONC_HOLD screen of a profile, configure the profile’s security by clearing the checkmark in the
Updatable option in the User Access section. The user can still access their account but they cannot modify the profile.
If a user in Scheduler cannot modify the interception criteria, the Update button on the Interception tab of the Oracle
connection definition is unavailable.
31
Configuring the Oracle Applications Adapter
PROFILE_ACCESS – Specifies whether a user can configure the job interception queue filter criteria. The value is
either Y or N.
MASTER_ALLOWED – Specifies which CWA Master is allowed to release jobs. The value is the host machine name.
The Oracle Database Administrator should use the following SQL statements to populate the SABDG_PARAMETERS
table:
2. Right-click on the OracleApps Agent Lists pane and select Add Agent List from the context menu.
-or-
Click the Add button on the Scheduler toolbar to display the Agent List Definition dialog.
3. In the List Name field, enter the name of the OracleApps adapter list (up to 60 characters).
4. In the Parent List field, you can select a parent list if you want to create nested lists.
If you specify a parent list, the list you are editing will be a child list of the parent and will appear below its parent in
the list hierarchy.
5. From the List Type list, select the type of list based on how you want your jobs to be assigned to a PeopleSoft
connection in the list.
32
Configuring the Oracle Applications Adapter
— Ordered – In support of high-availability, Scheduler chooses the first available agent to run the job based on
the order that the connections appear in the Agents Selected section. For example, if the first (primary)
connection in the list is not available, Scheduler tries the second (alternative) connection in the list. You might
want to use this list type for critical jobs where multiple connections are capable of processing the request.
— Random – Chooses connections from the Agents Selected field randomly. This is a crude form of workload
balancing. For more advanced load balancing, you should choose the Balanced option.
— Rotation – Scheduler cycles through the list of connections in the Agents Selected field and launches jobs
assigned to that list in rotation. When the end of the list is reached, the first connection in this list is chosen. This
is a form of workload balancing where you can predict where the next job will run.
— Broadcast – Scheduler runs the job on every connection in the Agents Selected section. For example, you
can use this option to schedule a maintenance process on each machine in the list using the same job.
6. From the Agents Available section on the List tab, highlight the appropriate OracleApps agent.
7. Click the left arrow button to add the selected connection to the list by moving it from the Agents Available section
to the Agents Selected section. You can also drag and drop connections from one section to another.
8. Click OK.
33
Configuring the Oracle Applications Adapter
34
3
Using the Oracle Applications Adapter
This chapter describes how to use the Oracle Applications Adapter with Cisco Workload Automation which entails:
Overview
Overview
To schedule and monitor an Oracle Applications job from CWA, you must create a CWA job definition for it. An Oracle
Applications job consists of one or more concurrent requests or programs. These requests may already exist in
Concurrent Manager or a new request can be created using the CWA adapter when defining the job.
For greater control over all aspects of an Oracle Applications job, it is recommended that a separate CWA job be created
for each concurrent program. All of the resulting CWA jobs with their respective concurrent requests can then be
organized and processed as a CWA job group.
When scheduling an Oracle Applications job in CWA, dependencies (job, calendar, etc.) are defined like any other CWA
job. Once the dependencies of the job are satisfied and a slot within a job queue becomes available, CWA notifies the
Concurrent Manager(s) to launch the appropriate request. For request sets, as each request completes, the next
appropriate request of the defined request set is launched in proper sequence.
The Oracle Applications Concurrent Manager maintains control over requests, launching and tracking the status of each
request to completion. CWA monitors this activity. When the request is completed, the output and log files are available
to CWA users.
Prerequisites
An Oracle Applications job created in CWA contains all the information necessary to define and launch processes in an
Oracle Applications environment.
Install, license and verify that CWA is fully operational before installing this adapter. (Refer to the CWA Installation
Guide for more information.)
35
Using the Oracle Applications Adapter
Verify that you can log into the Oracle instance from all clients that will modify job parameters. (Refer to your Oracle
Applications documentation for more information.)
License the Oracle Applications Adapter for CWA. (Refer to “Licensing an Adapter”.)
Verify that the database alias entry for the Oracle Applications database in the [Link] is the same for the
master and all client machines. (Refer to your Oracle database documentation for more information.)
Install Oracle Net*8 database connectivity software on each master and its clients.
Provide the CWA master or client with the alias listed in the [Link] file. (Refer to Verifying TNS File Formatting
(Oracle Users Only), page 20.)
Ensure that there is no other user called SABDG. The Bridge installation creates a user called SABDG and if a user
called SABDG already exists the Bridge installation will fail.
Ensure the user account installing the Oracle Applications adapter has Administrator or Super User capabilities.
(Refer to Configuring Users for the Oracle Applications Adapter, page 17.)
Add the Oracle Applications database user to CWA as a CWA user. (Refer to Authorizing Users, page 19.)
This integration does not place any significant resource requirements on any of the systems beyond what is expected by
normal operation of the CWA and Oracle Applications products. Refer to the documentation of CWA and Oracle
Applications to determine your actual system requirements.
Note: To define a job in Oracle Applications, you need to go to Oracle’s website to download and install Oracle’s JInitiator
component. Before installing the JInitiator, go to the Internet options for your browser and on the Security tab, adjust the
security level for the internet to the Low setting. After downloading the JInitiator, reset the internet security setting to its
original configuration.
To define a job:
1. From the Navigator pane, select Definitions>Jobs to display the Jobs pane.
36
Using the Oracle Applications Adapter
2. Right-click in either the Navigator or Jobs pane and select Add OraApps Job from the context menu to display
the OracleApps Job Definition dialog.
3. In the OracleApps Job Name field, enter a name for your job. You can choose a name of up to 50 characters in
length.
You can use a name of up to 50 characters in length. The OracleApps Job Name is an identifier for CWA only. All of
the other job definition information, such as Job Class, Owner and Parent Group, is the same as any other CWA job.
If you are putting your Oracle Applications job into a job group, note that unless the parent group selected has an
Oracle Applications agent connection assigned, you must clear the Inherited option.
4. On the Run tab, in the Agent/Adapter Name list, select an Oracle Applications instance. If no Oracle Applications
instances are available from the menu, verify that an Oracle Applications connection has been defined.
The Agent/Adapter Name refers to the connection definition to the Oracle Applications database instance on
which the Concurrent Manager requests will run. This is the name used by CWA to identify the Oracle Applications
database instance specified in the OracleApps Connection Definition dialog.
Note that the name in this list represents all the information in the OracleApps connection definition, including the
version number, runtime user, database instance, database user ID, etc. To use different parameters, modify the
connection definition, or define a new Oracle Applications connection with a new agent name and then use that
agent.
The default user is specified as the Default OraApps User in the OracleApps Connection Definition dialog.
The user must be authorized as a valid runtime user for the user defining the job.
6. In the Tracking section, select a method to determine a job’s completion status. While a standard CWA job has an
exit code option, an Oracle Applications job has a Request Status option. If you select Request Status then a job
has completed normally when the job status in Oracle Applications is Normal or Warning.
37
Using the Oracle Applications Adapter
A Warning status is much like a Normal status except that warning notices were generated as the job completed
successfully. To differentiate between a Normal status and a Warning status, you can select the Translate
“Warning” status to “Completed Abnormally” option. Selecting this option means that a job that completes
with a Warning status is converted to a Completed Abnormally status.
For more information on the other Tracking and Duration options, refer to the Run tab section in Jobs chapter of
the CWA User Guide.
Note: If you wish to change the default job output settings for individual job instances, select the Options tab and
modify the Job Output Option setting. Subsequent job instances will revert to the default job output setting specified
in the System Configuration dialog.
The responsibility is a set of programs or job groups that a user is authorized to access. The responsibilities available
vary according to the OraApps User selected.
9. Select the concurrent program or request set that CWA should run in Oracle Applications when the job is ready to
run.
— Request Set – Select this option to run a defined request set. (A request set is a group of requests similar to a
job group in CWA.)
Note: It is recommended that any Oracle Applications job consisting of multiple concurrent programs be broken
down into simpler jobs with just one concurrent program per job. This practice offers greater control over the job
from the CWA.
38
Using the Oracle Applications Adapter
This will narrow down the number of programs or displayed request sets to show only those that belong to the
selected application.
11. From the Operating Units list, specify the concurrent program for multiple organizations.
See Working with Multiple Organization Access (MOAC), page 50 for more information.
12. From the Name list, select a concurrent program or request set associated with the selected application.
If you choose a request set, the selected request set is displayed in the Stages list. The meaning of the columns are:
— Seq – The sequence number of the listed programs within the stage.
If you want to modify the parameters and/or runtime options of a concurrent program of the stages within the Stages
list, select the desired program or stage and click the Parameters button.
Clicking the Parameters button, opens a custom form to enter information pertaining to the selected program or
request set stage. The parameter information entered on the form is stored in a custom CWA table in the Oracle
Applications database until the request is submitted to the Concurrent Manager.
Note: If you are defining a request set, each program needs to have its own set of parameters defined.
13. (Optional) Select any of these options to refine the Oracle Applications job definition:
— Track spawned child processes – Select to track child processes for an OracleApps Request Set (RS) or
Concurrent Program (CP) and consider the child process’s status in the final completion status of the RS or CP.
The final status will be the most severe status of all processes, including child processes. For example, if there
is a child process which has completed with an error, then the final CWA status will be Completed
Abnormally.
— Account child statuses in completion status – Select to cancel all non-completed processes, if any child
process completes in error.
— Cancel process if any child process errors – Select to cancel all processes if any child process completes
in error.
— Translate "Warning" status to "Completed Abnormally" – Select the to differentiate between a job that
completes successfully with a Normal status and one that ends with a Warning status.
A Warning status is much like a Normal status except that warning notices were generated as the job completed
successfully. Note that a job that ends with a Warning status still completes successfully but a job that generates
warnings as it runs may indicate potential problems that you may want to be aware of.
14. (Optional) Specify the report format, notification, and printing options for this job:
39
Using the Oracle Applications Adapter
a. Click Options.
Template Layout: Apply the preferred layout to the report. From the drop down, select from the available layouts.
Notify the following people: Use to send notifications to people once the job is completed. You can type in few
characters in the Filter text box and then click on the drop down to select the notification names. Use % as a
wildcard character.
Print the Output To: Use to send the output to the printer. You can select the style and the printer available for the
appropriate profile and the number of copies to print. By default the number of copies to print is 1.
c. Click Add.
2. Click the OracleApps tab to display a list of the stages that comprise the job.
40
Using the Oracle Applications Adapter
3. Select the stage that will have a different parameter value by clicking on it
4. Click the Parameter Values button to display the Oracle Applications Job Parameter Details dialog. (This
button is unavailable until the newly created job is saved.)
At the top of the dialog are listed the name of the stage, name of its associated program and the stage number and
sequence number of the selected stage.
The Parameters section displays a table with columns listing the names of the parameters associated with that
stage, defined value of each parameter and the value that will replace the current value.
5. To substitute a different value for a parameter, click the check box in front of the parameter name to make the
Replacement Value column available for entering different values. If desired, you can click the Variables button
to use an existing variable as the replacement value.
The next time that the job runs, the current value of the parameter is replaced by the replacement value that you entered
or the value of a variable at the time that the job runs.
The same procedure is used to replace existing parameter values for an Oracle Applications job consisting of a
concurrent program.
2. In the Application list, select an application to narrow down which programs are available.
3. In the Name list, select a program associated with the specified application.
41
Using the Oracle Applications Adapter
4. You can modify the parameters of any listed program by clicking Parameters to display the Job Parameters screen.
2. In the Application list, select an application to narrow down which request sets are available.
3. In the Name list, select a request set associated with the specified application to display its requests.
4. You can modify the parameters of any listed request by selecting the request and clicking the Parameters button to
display the Job Parameters dialog.
2. Click on the OracleApps tab to display a list of the stages that comprise the job.
3. Select the stage that will have a different parameter value by clicking on it.
4. Once the stage is selected, click Parameter Values to display the Oracle Applications Job Parameter Details
dialog. (This button is unavailable until the newly created job is saved.)
The Parameters section displays a table with columns listing the names of the parameters associated with that
stage, current value of each parameter and the value that will replace the current value.
5. To substitute a different value for a parameter, click the check box in front of the parameter name to make the
Replacement Value column available for entering different values. If desired, you can click Variables to use an
existing variable as the replacement value.
The next time that the job runs, the current value of the parameter is replaced by the replacement value that you entered
or the value of a variable at the time that the job runs.
2. Select one of the requests listed on the tab and click Parameters at the bottom of the tab to display the Oracle
Applications Job Parameter Details dialog.
The parameter and the value used when the job was processed is displayed.
42
Using the Oracle Applications Adapter
The default job history retention period for jobs in general is configured on the Defaults tab of the System Configuration
dialog. You can set job history retention for an individual job on the Options tab of its job definition. CWA will
automatically delete job history from its own logs when the job history retention limit is reached. The default retention
period is 30 days. To delete the job history from Oracle database is a separate procedure.
Concurrent request records are created each time an Oracle Applications job is submitted by the CWA. As these records
accumulate and become obsolete, they must be deleted as a routine maintenance task.
Oracle Applications provides a concurrent program, called Purge Concurrent Request and/or Manager Data Program, to
purge the datatables of these old request records. You can schedule this program in CWA to purge request records on
a regular basis.
To improve manageability, CWA’s queue management facility supports a queue filter that can be configured to monitor
an Oracle Applications instance for ad hoc jobs submitted by users or programs and assign them to a designated queue
where they can be managed. By intercepting the ad hoc jobs and directing them to designated queues, the launching of
unscheduled jobs can be regulated with priorities and limits of both jobs and queues, to manage resources better.
This queue filter, called Oracle Job (Intercepted), can be created to designate a queue or queues that will capture
any submitted Oracle jobs that do not belong to the day’s production schedule.
With this interception filter monitoring for Oracle jobs, you can separate unscheduled Applications jobs generated
outside of CWA from other scheduled jobs and direct those unscheduled Oracle Applications jobs to different queues
where the jobs are controlled by the Queue Manager using the same limits on jobs, priorities and hierarchies typically
assigned to a queue. You can add as many Oracle queue filters as needed to cover any combination of users, jobs and
instances. By intercepting these ad hoc Oracle jobs before they are launched, CWA manages system resources by
controlling when the jobs are launched based on queuing rules.
Caution: Do not configure two different CWA masters to intercept jobs from the same Oracle Applications system.
Neither Cisco Workload Automation nor Oracle is designed to accommodate simultaneous interception with
multiple schedulers and will produce erratic results.
43
Using the Oracle Applications Adapter
This Queue Filter Condition dialog contains the following options that can be used as needed to fine-tune filter criteria:
OraApps Instance – Specifies the Oracle instance that should be monitored for jobs scheduled outside of CWA.
Application – Specifies that jobs that originate from the specified application will be intercepted.
Responsibility – Specifies that jobs that originate from the specified responsibility will be intercepted.
User – Designates that the queue filter monitor for jobs submitted by the specified user (or creator) of the Oracle
jobs. A mask using the asterisk (*) wildcard character can be used here.
Program Mask – Creates a mask with the asterisk (*) wildcard character (though wildcards do not need to be used)
to intercept particular jobs that originating from programs that meet the specified criteria.
Request Set Mask – Creates a mask using the asterisk (*) wildcard character (though wildcards do not need to be
used) to intercept jobs originating from requests that meet the specified criteria.
You can use as much of the criteria as needed to create a broad based or specific filter. Only the Oracle jobs that match
all of the specified criteria will be filtered out for controlled release. These intercepted jobs are placed on hold and can
be viewed from the Queue Definition dialog.
The Current Jobs tab of the Queue Definition dialog for the queue defined to accept the intercepted Oracle jobs
displays all jobs that are active or waiting to run. You can double-click on any of the jobs listed on the Current Jobs tab
to see basic information about the Oracle job in the OraApps Request Details dialog.
The Oracle Job (Intercepted) queue filter manages the launching of ad hoc Oracle jobs. Here are a few scenarios to
demonstrate how the queue filter works.
For the scenarios, let us assume that an Oracle Applications parent queue contains two child queues–one for externally
submitted jobs and one for production jobs created by CWA. The externally scheduled jobs queue (called EB Queue for
External Jobs in this example) also has an Oracle interception filter defined, with a limit of one, and the production queue
(called EB Queue for Cisco Workload Automation Jobs) has a Production Oracle Connection filter and a queue limit of 3.
Release a scheduled job from CWA. It will go to the EB Queue for Cisco Workload Automation jobs, launch and go into
an Active status since an execution slot is available.
From Oracle, release a job (using the same user defined in the Oracle Applications interception filter). Since there is a
queue with a defined Oracle Applications job interception filter, the unscheduled job goes to the EB Queue for External
Jobs. There is an execution slot available so the job is launched and the EB queue for externally scheduled jobs shows
the job is active.
44
Using the Oracle Applications Adapter
Again from within Oracle Applications, release another job (again as the same user defined in the Oracle Applications
interception filter). This job also is directed to the EB Queue for External Jobs. However, there is no execution slot
available since the queue has a queue limit of one. You can see that one job is active and the other is waiting. Instead of
unexpectedly interfering with the production workload, the external Oracle Applications job is captured by a queue and
held up based on the criteria defined for this queue.
Normally, the second job cannot run until the first external job completes because of the queue limit. However, an
authorized operator can override the defined queue criteria and release an Oracle Applications job that is waiting.
You can view the active and waiting jobs for a queue by double-clicking on the queue and selecting the Current Jobs
tab. The ID, job name, status, agent, external ID and priority of a queue’s active and/or waiting jobs can be viewed. If a
large number of jobs are in the queue, you may only want to see either just the active or just the waiting jobs. In any case,
you must select at least one of the options or no jobs will display on the tab. The numbers next to the check boxes
indicate how many of that type of job are in the queue. Releasing a job that is waiting results in the following queue
situation where the active jobs in a queue exceeds its defined limit.
You can release unscheduled jobs that are waiting (or cancel a job if it is active) from the Current Jobs tab of the queue’s
definition dialog.
Select one of the jobs on the Current Jobs tab and right-click to display a context menu of options. Select the Release
option to launch a waiting job immediately. (The user must be authorized with the appropriate security functions to be
able to use the job control menu options.)
Warning: The job that is in Waiting on Resource status can be released even if this would cause a queue to exceed
its limit.
The context menu also allows you to manually refresh the queue status or to configure the tab to update the job status
automatically every 10 seconds, so you can watch the jobs in real time.
Each job displayed in the text field has a color-coded status light to denote a job’s status at a glance. The color green
indicates a job that is in active or launched status, the color yellow indicates a job in a waiting status and the color red
indicates a job unable to run due to an unavailable connection.
The listing of current jobs in the queue has the following columns of information about the jobs:
45
Using the Oracle Applications Adapter
Duration – The time in minutes that a job has remained in its present status within the queue.
User Name – The user name of the user running the job.
External ID – The identification number assigned by jobs created in applications other than CWA. For Oracle
Applications, this is the ID.
Node ID – The identification number assigned to nodes in applications other than CWA.
This dialog contains the following columns of information about the request:
ID – The identification number that Oracle Applications assigns to the request instance. This number corresponds
to the external identification number displayed for the job in the Ext ID column of the Job Activity pane.
46
Using the Oracle Applications Adapter
The responsibility is a set of programs or job groups that a user is authorized to access. The responsibilities available
vary according to the OraApps User selected.
It is recommended that any Oracle Applications job consisting of multiple concurrent programs be broken down into
simpler jobs with just one concurrent program per job. This practice offers greater control over the job from the CWA.
Name – Contains the selected concurrent program or request set associated with the selected application.
Request Set – Selected to run a defined request set. (A request set is a group of requests similar to a job group in
CWA.)
If you choose a request set, the selected request set is displayed in the Stages list. The meaning of the columns are:
— Seq – The sequence number of the listed programs within the stage.
Track spawned child processes – Select to consider the child process’s status in the final completion status of
the RS or CP. The final status will be the most severe status of all processes, including child processes. For example,
if there is a child process which has completed with an error, then the final CWA status will be Completed
Abnormally.
47
Using the Oracle Applications Adapter
Account child statuses in completion status – Select to cancel all non-completed processes, if any child
process completes in error.
Translate "Warning" status to "Completed Abnormally" – Selected to differentiate between a job that
completes successfully with a Normal status and one that ends with a Warning status.
A Warning status is much like a Normal status except that warning notices were generated as the job completed
successfully. Note that a job that ends with a Warning status still completes successfully but a job that generates
warnings as it runs may indicate potential problems that you may want to be aware of.
Parameter Values – At the bottom of the tab is the Parameters Values button. You can view the parameters of
any request in a job that completed by selecting the request and clicking this button to display the Oracle
Applications Job Parameter Details dialog containing the parameter information.
48
Using the Oracle Applications Adapter
The Output tab displays the Oracle Applications output generated for the job.
Oracle Applications provides a concurrent program, called Purge Concurrent Request and/or Manager Data
Program, to purge the datatables of these old request records. You can schedule this program in CWA to purge request
records on a regular basis.
Making One Time Changes to an Adapter or Agent Job Instance—Make last minute changes to a job.
Deleting a Job Instance before It Has Run—Delete a job instance before it has run.
Holding a Job
Adapter/agent jobs are held in the same way as any other Scheduler jobs.
Adapter/agent jobs can only be held before they are launched. Once a job reaches the Adapter/Agent system, it cannot
be held or suspended.
To hold a job:
1. From the Job Activity pane, right-click on the job.
Aborting a Job
Adapter/agent jobs are aborted in the same way as any other Scheduler jobs.
To abort a job:
1. From the Job Activity pane, right-click on the job.
49
Using the Oracle Applications Adapter
Rerunning a Job
On occasion, you may need to rerun an Adapter/Agent job. You can override parameter values first, if necessary, from
the Adapter/Agent tab.
To rerun a job:
1. From the Job Activity pane, right-click the Adapter/Agent job you need to rerun.
3. Make the desired changes to the job and click OK to close the Job Details dialog.
Deleting a job from the Job Activity pane removes the job from the Scheduler job activity only. The original definition is
left in tact.
50
Using the Oracle Applications Adapter
Users may choose to enter a value for the Operating Unit or leave it blank and submit the request. If you specify a value,
the operating units invoices are processed for the respective operating units else invoices are processed for all the
operating units in the security profile.
Note: MOAC is supported for R12 versions. MOAC is not supported for request set jobs.
51
Using the Oracle Applications Adapter
52
Using the Oracle Applications Adapter
Packages
dbms_obfuscation_toolkit
fnd_amp_private.
fnd_application_pkg.
fnd_global
fnd_message
Fnd_profile
fnd_request
fnd_submit
53
Using the Oracle Applications Adapter
Packages
fnd_web_sec.
fnd_webfile
Htp
Utl raw
Sequences
fnd application s
54
Using the Oracle Applications Adapter
55
Using the Oracle Applications Adapter
56
5
Configuring [Link]
About Configuring [Link]
The [Link] file is used to configure adapter behavior. [Link] is located in the \config directory located
under the Adapter’s GUID directory, You can create both the directory and file if it does not yet exist. Properties that can
be specified in [Link] control things like logging and connection configuration. Many of the properties are specific
to certain adapters; others are common across all adapters.
[Link] Properties
The table below lists many of the parameters that can be specified in [Link]. Some properties apply to all
adapters (shaded in the table) and some properties are adapter-specific as indicated by the Applicable Adapter(s)
column. The properties are listed in alphabetical order.
43
Configuring [Link]
[Link] Properties
44
Configuring [Link]
[Link] Properties
45
Configuring [Link]
[Link] Properties
46
A
Appendix A—Custom APPS User SQL
Commands
This appendix contains the SQL commands used to install the Oracle Applications Adapter Bridge as the custom APPS
user as described in Installing the Oracle Application Bridge Using a Custom APPS User, page 15.
[Link] Commands
GRANT ALTER SYSTEM TO "TIDAL";
GRANT CREATE PROCEDURE TO "TIDAL";
GRANT CREATE PUBLIC SYNONYM TO "TIDAL";
GRANT CREATE SYNONYM TO "TIDAL";
GRANT CREATE TABLE TO "TIDAL";
GRANT CREATE VIEW TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_APPLICATION" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_APPLICATION" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_APPLICATION_S" TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_APPLICATION_TL" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_APPLICATION_TL" TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_APPL_TOPS" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_APPL_TOPS" TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_CACHE_VERSIONS" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_CACHE_VERSIONS" TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_CONCURRENT_PROCESSES" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_CONCURRENT_PROCESSES" TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_CONCURRENT_PROGRAMS" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_CONCURRENT_PROGRAMS" TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_CONCURRENT_PROGRAMS_TL" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_CONCURRENT_PROGRAMS_TL" TO "TIDAL";
GRANT ALTER ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT DEBUG ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT DELETE ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT FLASHBACK ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT INDEX ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT INSERT ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT ON COMMIT REFRESH ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT QUERY REWRITE ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT REFERENCES ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT SELECT ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT UPDATE ON "APPLSYS"."FND_CONCURRENT_QUEUES" TO "TIDAL";
GRANT ALTER ON "APPLSYS"."FND_CONCURRENT_REQUESTS" TO "TIDAL";
GRANT DEBUG ON "APPLSYS"."FND_CONCURRENT_REQUESTS" TO "TIDAL";
61
Appendix A—Custom APPS User SQL Commands
[Link] Commands
62
Appendix A—Custom APPS User SQL Commands
[Link] Commands
63
Appendix A—Custom APPS User SQL Commands
[Link] Commands
64
Appendix A—Custom APPS User SQL Commands
[Link] Commands
65
Appendix A—Custom APPS User SQL Commands
[Link] Commands
66
Appendix A—Custom APPS User SQL Commands
[Link] Commands
67
Appendix A—Custom APPS User SQL Commands
[Link] Commands
68
Appendix A—Custom APPS User SQL Commands
[Link] Commands
69
Appendix A—Custom APPS User SQL Commands
[Link] Commands
70
Appendix A—Custom APPS User SQL Commands
[Link] Commands
71
Appendix A—Custom APPS User SQL Commands
[Link] Commands
72
Appendix A—Custom APPS User SQL Commands
[Link] Commands
73
Appendix A—Custom APPS User SQL Commands
tidal_syn.sql Commands
tidal_syn.sql Commands
CREATE OR REPLACE SYNONYM APP_EXCEPTION FOR APPS.APP_EXCEPTION;
CREATE OR REPLACE SYNONYM DBMS_OBFUSCATION_TOOLKIT FOR SYS.DBMS_OBFUSCATION_TOOLKIT;
CREATE OR REPLACE SYNONYM FNDCP_CRM FOR APPS.FNDCP_CRM;
CREATE OR REPLACE SYNONYM FND_AMP_PRIVATE FOR APPS.FND_AMP_PRIVATE;
CREATE OR REPLACE SYNONYM FND_APPLICATION FOR APPS.FND_APPLICATION;
CREATE OR REPLACE SYNONYM FND_APPLICATION_PKG FOR APPS.FND_APPLICATION_PKG;
CREATE OR REPLACE SYNONYM FND_APPLICATION_S FOR APPS.FND_APPLICATION_S;
CREATE OR REPLACE SYNONYM FND_APPLICATION_TL FOR APPS.FND_APPLICATION_TL;
CREATE OR REPLACE SYNONYM FND_APPLICATION_VL FOR APPS.FND_APPLICATION_VL;
CREATE OR REPLACE SYNONYM FND_APPL_TOPS FOR APPS.FND_APPL_TOPS;
CREATE OR REPLACE SYNONYM FND_CACHE_VERSIONS FOR APPS.FND_CACHE_VERSIONS;
CREATE OR REPLACE SYNONYM FND_CLIENT_INFO FOR APPS.FND_CLIENT_INFO;
CREATE OR REPLACE SYNONYM FND_CODE_PKG FOR APPS.FND_CODE_PKG;
CREATE OR REPLACE SYNONYM FND_CONCURRENT FOR APPS.FND_CONCURRENT;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_BUSINESS_EVENT FOR APPS.FND_CONCURRENT_BUSINESS_EVENT;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_FILE FOR APPS.FND_CONCURRENT_FILE;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_PROCESSES FOR APPS.FND_CONCURRENT_PROCESSES;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_PROGRAMS FOR APPS.FND_CONCURRENT_PROGRAMS;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_PROGRAMS_TL FOR APPS.FND_CONCURRENT_PROGRAMS_TL;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_PROGRAMS_VL FOR APPS.FND_CONCURRENT_PROGRAMS_VL;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_QUEUES FOR APPS.FND_CONCURRENT_QUEUES;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_QUEUES_VL FOR APPS.FND_CONCURRENT_QUEUES_VL;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_REQUESTS FOR APPS.FND_CONCURRENT_REQUESTS;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_REQUESTS_S FOR APPS.FND_CONCURRENT_REQUESTS_S;
CREATE OR REPLACE SYNONYM FND_CONCURRENT_WORKER_REQUESTS FOR APPS.FND_CONCURRENT_WORKER_REQUESTS;
CREATE OR REPLACE SYNONYM FND_CONC_DATE FOR APPS.FND_CONC_DATE;
CREATE OR REPLACE SYNONYM FND_CONC_DEFERRED_ARGUMENTS FOR APPS.FND_CONC_DEFERRED_ARGUMENTS;
CREATE OR REPLACE SYNONYM FND_CONC_GLOBAL FOR APPS.FND_CONC_GLOBAL;
CREATE OR REPLACE SYNONYM FND_CONC_PP FOR APPS.FND_CONC_PP;
CREATE OR REPLACE SYNONYM FND_CONC_PP_ACTIONS FOR APPS.FND_CONC_PP_ACTIONS;
CREATE OR REPLACE SYNONYM FND_CONC_PROG_ONSITE_INFO FOR APPS.FND_CONC_PROG_ONSITE_INFO;
CREATE OR REPLACE SYNONYM FND_CONC_RELEASE_CLASSES FOR APPS.FND_CONC_RELEASE_CLASSES;
CREATE OR REPLACE SYNONYM FND_CONC_RELEASE_CLASSES_S FOR APPS.FND_CONC_RELEASE_CLASSES_S;
CREATE OR REPLACE SYNONYM FND_CONC_RELEASE_CLASSES_TL FOR APPS.FND_CONC_RELEASE_CLASSES_TL;
CREATE OR REPLACE SYNONYM FND_CONC_RELEASE_CLASSES_VL FOR APPS.FND_CONC_RELEASE_CLASSES_VL;
CREATE OR REPLACE SYNONYM FND_CONC_RELEASE_CLASS_UTILS FOR APPS.FND_CONC_RELEASE_CLASS_UTILS;
CREATE OR REPLACE SYNONYM FND_CONC_REQUEST_ARGUMENTS FOR APPS.FND_CONC_REQUEST_ARGUMENTS;
CREATE OR REPLACE SYNONYM FND_CONC_REQ_OUTPUTS FOR APPS.FND_CONC_REQ_OUTPUTS;
CREATE OR REPLACE SYNONYM FND_CONC_SSWA FOR APPS.FND_CONC_SSWA;
CREATE OR REPLACE SYNONYM FND_CP_IPP_PRINTERS FOR APPS.FND_CP_IPP_PRINTERS;
CREATE OR REPLACE SYNONYM FND_CP_SERVICES FOR APPS.FND_CP_SERVICES;
CREATE OR REPLACE SYNONYM FND_CRYPT_PKG FOR APPS.FND_CRYPT_PKG;
CREATE OR REPLACE SYNONYM FND_DATA_GROUPS FOR APPS.FND_DATA_GROUPS;
CREATE OR REPLACE SYNONYM FND_DATA_GROUP_UNITS FOR APPS.FND_DATA_GROUP_UNITS;
CREATE OR REPLACE SYNONYM FND_DATE FOR APPS.FND_DATE;
CREATE OR REPLACE SYNONYM FND_DEBUG_RULES FOR APPS.FND_DEBUG_RULES;
CREATE OR REPLACE SYNONYM FND_DEBUG_RULES_S FOR APPS.FND_DEBUG_RULES_S;
CREATE OR REPLACE SYNONYM FND_DEBUG_RULE_OPTIONS FOR APPS.FND_DEBUG_RULE_OPTIONS;
CREATE OR REPLACE SYNONYM FND_DESCRIPTIVE_FLEXS FOR APPS.FND_DESCRIPTIVE_FLEXS;
CREATE OR REPLACE SYNONYM FND_DESCRIPTIVE_FLEXS_TL FOR APPS.FND_DESCRIPTIVE_FLEXS_TL;
CREATE OR REPLACE SYNONYM FND_DESCR_FLEX_COLUMN_USAGES FOR APPS.FND_DESCR_FLEX_COLUMN_USAGES;
CREATE OR REPLACE SYNONYM FND_DESCR_FLEX_COL_USAGE_TL FOR APPS.FND_DESCR_FLEX_COL_USAGE_TL;
CREATE OR REPLACE SYNONYM FND_DESCR_FLEX_COL_USAGE_VL FOR APPS.FND_DESCR_FLEX_COL_USAGE_VL;
CREATE OR REPLACE SYNONYM FND_DESCR_FLEX_CONTEXTS FOR APPS.FND_DESCR_FLEX_CONTEXTS;
CREATE OR REPLACE SYNONYM FND_DESCR_FLEX_CONTEXTS_TL FOR APPS.FND_DESCR_FLEX_CONTEXTS_TL;
CREATE OR REPLACE SYNONYM FND_FILE_TEMP FOR APPS.FND_FILE_TEMP;
CREATE OR REPLACE SYNONYM FND_FLEX_VALIDATION_TABLES FOR APPS.FND_FLEX_VALIDATION_TABLES;
74
Appendix A—Custom APPS User SQL Commands
tidal_syn.sql Commands
75
Appendix A—Custom APPS User SQL Commands
sys_grant.sql Commands
sys_grant.sql Commands
GRANT EXECUTE ON "SYS"."DBMS_APPLICATION_INFO" TO "TIDAL";
GRANT DEBUG ON "SYS"."DBMS_OBFUSCATION_TOOLKIT" TO "TIDAL";
GRANT EXECUTE ON "SYS"."DBMS_OBFUSCATION_TOOLKIT" TO "TIDAL";
GRANT EXECUTE ON "SYS"."DBMS_SYSTEM" TO "TIDAL";
GRANT SELECT ON "SYS"."ERROR$" TO "TIDAL";
GRANT EXECUTE ON "SYS"."HTP" TO "TIDAL";
GRANT SELECT ON "SYS"."TRIGGER$" TO "TIDAL";
GRANT DEBUG ON "SYS"."UTL_RAW" TO "TIDAL";
GRANT EXECUTE ON "SYS"."UTL_RAW" TO "TIDAL";
76
B
Appendix B—sabdg_global Package
The sabdg_global package contained in this appendix is used when you need to install the Oracle Applications Bridge
using a custom APPS user as described in Installing the Oracle Application Bridge Using a Custom APPS User, page 15.
BEGIN
DECLARE
vc_err_code VARCHAR2(100);
vc_dbg_err_code VARCHAR2(100);
vc_debug VARCHAR2(100) := substr(pc_debug,1,32);
vc_module VARCHAR2(100) := '[Link]';
vc_message VARCHAR2(100);
vh_input VARCHAR2(2048) := pc_input;
vc_input VARCHAR2(2048) ;
vt_job_trx_id NUMBER := pn_job_trx_id;
vc_decrypt VARCHAR2(2048);
vc_key VARCHAR2(56);
BEGIN
BEGIN
SELECT to_char(creation_date,'YYYYHH24MMMIDDSSMM')
INTO vc_key
FROM TIDAL.sabdg_jobs
WHERE job_trx_id = vt_job_trx_id;
EXCEPTION
WHEN NO_DATA_FOUND THEN
vc_err_code := 'BDG-10092 '||'Job does not exists';
IF vc_debug IS NOT NULL THEN
vc_message := vc_err_code;
END IF;
END;
IF vc_err_code IS NULL THEN
vc_input := UTL_RAW.CAST_TO_VARCHAR2(HEXTORAW(vh_input));
dbms_obfuscation_toolkit.DESDecrypt(input_string => vc_input,key_string =>
vc_key,decrypted_string => vc_decrypt);
pc_output := ltrim(rtrim(vc_decrypt));
pc_err_code := vc_err_code;
ELSE
pc_output := NULL;
pc_err_code := vc_err_code;
END IF;
77
Appendix B—sabdg_global Package
EXCEPTION
WHEN OTHERS THEN
pc_err_code := SUBSTR(SQLERRM,1,100);
RAISE;
END;
END decrypt;
END sabdg_global;
/
78