Installing the Batch Adapter

This topic contains installation information for the Batch Adapter. It includes the following sections:

• Batch Adapter System Requirements

• Installing the Batch Adapter

• Monitoring and Alerts

Batch Adapter System Requirements

System requirements, supported operating systems, and specific issues that affect the Batch Adapter can be found in the following documents:

• Planning for Java CAPS Installation

• Java CAPS 6 Update Release 1 Release Notes

Installing the Batch Adapter

The Oracle Java Adapter for Batch is installed by default with the Java Composite Application Platform Suite. For more information about installing this component or other components, see the following documents:

• Installing Additional Components for Java CAPS 6

• Using the Java CAPS 6 Installation GUI

• Using the Java CAPS 6 Installation CLI

Monitoring and Alerts

The Enterprise Manageris a Web-based interface that allows you to monitor and manage your Oracle Java Composite Application Platform Suite applications.

Using the Enterprise Manager

The following links provide information on how to use the Enterprise Manager to monitor and manage Java CAPS

• Using Enterprise Manager Management Application in Java CAPS

• Monitoring Java CAPS Business Processes

• Alert Codes for Java CAPS Adapters

• Java CAPS Management and Monitoring APIs

The Enterprise Manager requires an adapter specific “plug-in” for each of your installed adapters. These plug-ins enable the Enterprise Manager to target specific alert codes for each adapter type, as well as to start and stop the inbound adapters.

Installing Adapter Enterprise Manager plug-ins

The Adapter Enterprise Manager plug-ins are available Enterprise Manager's Web Application Manager.

To Install Enterprise Manager Plug-Ins

1. From the Enterprise Manager’s Explorer toolbar, click the Configuration icon.
2. Click the Web Applications Manager tab, click the Auto-Install from Repository tab, and connect to your Repository.
3. Select the application plug-ins you require, and click Install.

   The application plug-ins are installed and deployed.

Batch Adapter Alert Codes

You can view and delete alerts using the Enterprise Manager. An alert is triggered when a specified condition occurs in a Project component. The purpose of the alert is to warn the administrator or user that a condition has occurred.

To View the Adapter Alert Codes

1. Add the Adapter Enterprise Manager plug-in for this Adapter.
2. From the Enterprise Manager’s Explorer toolbar, click the Configuration icon.
3. Click the Web Applications Manager tab and go to the Manage Alert Codes tab.

   Your installed alert codes appear under the Results section. If your adapter alert codes are not displayed under Results, do the following

   1. From the Install New Alert Codes section, browse to and select the adapter alert properties file for the application plug-in that you added. The alert properties files are located in the alertcodes folder of your Java CAPS home directory.
   2. Click Deploy. The available alert codes for your application are displayed under Results. A listing of available this adapter’s alert codes is displayed in the following table.
      

      Alert Code Description Detail/Action BATCH-FTP-EWAY-CONFIG-FAILED Batch FTP Adapter configuration error, message=[{0}]. An error occurred related to configuration. Check IS log for details. Parameter 0– the error message. BATCH-FTP-EWAY-CONN-ACQUIRE-FAILED Batch FTP Adapter error when acquiring connection from pool, message=[{0}]. An error occurred when looking up a connection from the connection pool. Check IS log for details. Parameter 0– the error message. BATCH-FTP-EWAY-CONN-INIT-FAILED Batch FTP Adapter connection initialization failed, message=[{0}]. An error occurred when initializing a connection. Check IS log for details. Parameter 0– the error message. BATCH-FTP-EWAY-CONNECTION-FAILED Batch FTP Adapter connection failed, method=[{0}], message=[{1}]. An error occurred when connecting to remote. Check IS log for details. Parameter 0– the method in which the error occurred. Parameter 1– the error message. BATCH-FTP-EWAY-ERROR Batch FTP Adapter error, message=[{0}]. An error occurred. Check IS log for details. Parameter 0– the error message. BATCH-FTP-EWAY-OPERATION-ERROR Batch FTP Adapter error when doing data transfer operation in [{0}], message=[{1}]. An error occurred when doing a data operation, such as put/get, etc. Parameter 0– the method in which the error occurred. Parameter 1– the error message. Check IS log for details. BATCH-INBOUND-EWAY-CONFIG-FAILED Batch Inbound Adapter configuration error, message=[{0}]. An error occurred related to configuration. Check IS log for details. Parameter 0– the error message. BATCH-INBOUND-EWAY-ERROR Batch Inbound Adapter error, message=[{0}]. BATCH-INBOUND-EWAY-RUNNING RUNNING Batch Inbound Adapter is running. Inbound adapter is running. Check IS log for details. BATCH-INBOUND-EWAY-STARTED Batch Inbound Adapter started. Inbound adapter started. Check IS log for details. BATCH-INBOUND-EWAY-STOPPED STOPPED Batch Inbound Adapter is stopped. Batch Inbound Adapter is stopped. Check IS log for details, or restart the Batch Inbound Adapter. BATCH-INBOUND-EWAY-STOPPING STOPPING Batch Inbound Adapter is being stopped. Batch Inbound Adapter is stopping. Check IS log for details, or restart the Batch Inbound Adapter. BATCH-INBOUND-EWAY-SUSPENDED SUSPENDED Batch Inbound Adapter is suspended. Batch Inbound Adapter is suspended. Check IS log for details, or restart the Batch Inbound Adapter. BATCH-INBOUND-EWAY-SUSPENDING SUSPENDING Batch Inbound Adapter is suspending. Batch Inbound Adapter is suspending. Check IS log for details, or restart the Batch Inbound Adapter. BATCH-LOCALFILE-EWAY-CONFIG-FAILED Batch Local File Adapter configuration error, message=[{0}]. An error occurred related to configuration. Check IS log for details. Parameter 0– the error message. BATCH-LOCALFILE-EWAY-CONN-ACQUIRE-FAILED Batch Local File Adapter error when acquiring connection from pool, message=[{0}]. An error occurred when looking up a connection from connection pool. Check IS log for details. Parameter 0– the error message. BATCH-LOCALFILE-EWAY-CONN-INIT-FAILED Batch Local File Adapter connection initialization failed, message=[{0}]. An error occurred when initializing connection. Check IS log for details. Note: A connection object for local file is only an object pooled in the connection pool. It does not physically connect to any host. Parameter 0– the error message. BATCH-LOCALFILE-EWAY-ERROR Batch Local File Adapter error, message=[{0}]. A general error occurred. Check IS log for details. Parameter 0– the error message. BATCH-LOCALFILE-EWAY-OPERATION-ERROR Batch Local File Adapter error when doing file operation in [{0}], message=[{1}]. An error occurred when doing local file operations, such as put/get. Check IS log for details. Parameter 0– the method in which the error occurred Parameter 1– the error message. BATCH-REC-EWAY-CONFIG-FAILED Batch Record Adapter configuration error, message=[{0}]. An error occurred related to configuration. Check IS log for details. Parameter 0– the error message. BATCH-REC-EWAY-CONN-ACQUIRE-FAILED Batch Record Adapter error when acquiring connection from pool, message=[{0}]. An error occurred when looking up a connection from connection pool. Check IS log for details. Parameter 0– the error message. BATCH-REC-EWAY-CONN-INIT-FAILED Batch Record Adapter connection initialization failed, message=[{0}]. An error occurred when initializing connection. Check IS log for details. Note, a connection object for batch record is only an object pooled in the connection pool, it does not physically connect to any host. Parameter 0– the error message. BATCH-REC-EWAY-ERROR Batch Record Adapter error, message=[{0}]. A general error occurred. Check IS log for details. Parameter 0– the error message. BATCH-REC-EWAY-OPERATION-ERROR Batch Record Adapter error when doing record operation in [{0}], message=[{1}]. An error occurred when doing a record operation, such as put/get, etc. Parameter 0– the method in which the error occurred. Parameter 1– the error message. Check IS log for details. FTP-SSL-EWAY-CONFIG-FAILED Batch FTP Over SSL Adapter configuration error, message=[{0}]. An error occurred related to configuration. Check IS log for details. Parameter 0– the error message. FTP-SSL-EWAY-CONN-ACQUIRE-FAILED Batch FTP Over SSL Adapter error when acquiring connection from connection pool, message=[{0}]. Error when looking up a connection from connection pool. Check IS log for details. Parameter 0– the error message. FTP-SSL-EWAY-CONN-INIT-FAILED Batch FTP Over SSL Adapter connection initialization error, message=[{0}]. Error when initializing a connection. Check IS log for details. Parameter 0– the error message. FTP-SSL-EWAY-CONNECTION-FAILED Batch FTP Over SSL Adapter connection failed, method=[{0}], message=[{1}]. An error occurred when connecting to remote. Check IS log for details. Parameter 0– the method in which the error occurred. Parameter 1– the error message. FTP-SSL-EWAY-ERROR Batch FTP Over SSL Adapter error, message=[{0}]. General error occurred. Check IS log for details. Parameter 0– the error message. FTP-SSL-EWAY-OPERATION-ERROR Batch FTP Over SSL Adapter error when doing data transfer operation in [{0}], message=[{1}]. An error occurred when doing a data operation, such as put/get, etc. Parameter 0– the method in which the error occurred. Parameter 1– the error message. Check IS log for details. SCP-EWAY-CONFIG-FAILED Batch SCP Adapter configuration error, message=[{0}]. Error occurred related to configuration. Check IS log for details. Parameter 0– the error message. SCP-EWAY-CONN-ACQUIRE-FAILED Batch SCP Adapter error when acquiring connection from connection pool, message=[{0}]. Error when looking up a connection from connection pool. Check IS log for details. Parameter 0– the error message. SCP-EWAY-CONN-INIT-FAILED Batch SCP Adapter connection initialization error, message=[{0}]. Error when initializing a connection. Check IS log for details. Parameter 0– the error message. SCP-EWAY-CONNECTION-FAILED Batch SCP Adapter connection failed, method=[{0}], message=[{1}]. Error when connecting to remote. Check IS log for details. Parameter 0– the method in which the error occurred. Parameter 1– the error message. SCP-EWAY-ERROR Batch SCP Adapter error, message=[{0}]. General error occurred. Check IS log for details. Parameter 0– the error message. SCP-EWAY-OPERATION-ERROR Batch SCP Adapter error when doing data transfer operation in [{0}], message=[{1}]. An error occurred when doing a data operation, such as put/get, etc. Parameter 0– the method in which the error occurred. Parameter 1– the error message. Check IS log for details. SFTP-EWAY-CONFIG-FAILED Batch SFTP Adapter configuration error, message=[{0}]. An error occurred related to configuration. Check IS log for details. Parameter 0– the error message. SFTP-EWAY-CONN-ACQUIRE-FAILED Batch SFTP Adapter error when acquiring connection from connection pool, message=[{0}]. An error occurred when looking up a connection from connection pool. Check IS log for details. Parameter 0– the error message. SFTP-EWAY-CONN-INIT-FAILED Batch SFTP Adapter connection initialization error, message=[{0}]. An error occurred when initializing a connection. Check IS log for details. Parameter 0– the error message. SFTP-EWAY-CONNECTION-FAILED Batch SFTP Adapter connection failed, method=[{0}], message=[{1}]. An error occurred when connecting to remote. Check IS log for details. Parameter 0– the method in which the error occurred. Parameter 1– the error message. SFTP-EWAY-ERROR Batch SFTP Adapter error, message=[{0}]. A general error occurred. Check IS log for details. Parameter 0– the error message. SFTP-EWAY-OPERATION-ERROR Batch SFTP Adapter error when doing data transfer operation in [{0}], message=[{1}]. An error occurred when doing a data operation, such as put/get, etc. Parameter 0– the method in which the error occurred. Parameter 1– the error message. Check IS log for details.

      An alert code is a warning that an error has occurred. It is not a diagnostic. The user actions noted above are just some possible corrective measures you may take. Refer to the log files for more information. For information on managing and monitoring alert codes and logs, see the Alert Codes for Java CAPS Adapters.