Tools and Preferences

The following topics describe some of the configuration controls available on the Tools menu in Administrator.

Windows

• Change Password Window

• Remove Record Locks Window

• Preferences General Tab

• Preferences Ports Tab

• Preferences Outbound SMTP Tab

• Preferences Monitoring Tab

For other functions on the Tools menu, see the following topics:

• API—>Authentication. See API Authentication

• API—>JMS. See JMS Global Integration for Documents and JMS Integration for Events

• Certificates—>Trusted Roots. See Trusted Roots

• Certificates—>Cert Revocation List. See Using Certificate Revocation Lists

• Configure Schedule—>Send Schedule. See Changing the Send Schedule.

• Configure Schedule—>Achrive Schedule. See Changing the Archive Schedule.

• Launch Server Monitor. See Monitoring the Server with a Browser

 

---

Change Password Window

Use the Change Password window to set or change an optional primary password for the default Administrator user to open the Administrator and Tracker applications. You also can set or change an optional secondary password to require two passwords to open Administrator and Tracker.

By default there is no password for Administrator and Tracker.

Select Tools—>Change Administrator Password in Administrator to open the Change Password window.

Figure 10-1 Change Password Window

 

Field Descriptions

The following describes the fields on the Change Password window.

Primary password

Type the new or changed user password to be used at the login dialog box. The password length is from 1 to 50 characters and can be any combination of numbers and letters. This password is case-sensitive. Setting a password is optional.

Type the password carefully because the characters you type are masked.

WebLogic Integration - Business Connect does not provide a way for you to recover a forgotten password.

Confirm password

Type the same password you typed in the primary password field.

Optional 2nd password

Type the new or changed optional second user password to be used at the login dialog box. The password length is from 1 to 50 characters and can be any combination of numbers and letters. This password is case-sensitive.

If you require a second password, WebLogic Integration - Business Connect at login prompts the user to enter the second password after the first password is entered.

Confirm 2nd password

Type the same password you typed in the Optional 2nd password field.

 

---

Remove Record Locks Window

Use the Remove Record Locks window to unlock a record in use by another user. This enables you to make changes to the record even though another user already has accessed it.

When a user opens a record (for example, a company profile), WebLogic Integration - Business Connect locks it to prevent other users from changing it. If another user tries to open the record after the first user has accessed it, WebLogic Integration - Business Connect displays a message that another user has accessed the record and that you can only view but not change it. The remove record locks feature allows you to override this lock on open records.

When the second user, who removed the lock, opens the record, both users can edit it. The first user, who opened the record before the second user unlocked and opened it, does not know that another user has opened the same record. Both users can save changes by clicking OK. If both users change the same field in the record, the change made by the last user to click OK prevails.

Select Tools—>Remove Records Lock in Administrator to open the Remove Record Locks window. The window shows information for records in use by other users. If no records are in use, the window is blank. Select the record you want to unlock and click Remove. If you want to unlock all records, click Remove All. Click Close to exit.

Figure 10-2 Remove Record Locks Window

 

Field Descriptions

The following describes the fields on the Remove Record Locks window.

Date

The date the record was locked by another user.

Time

The time the record was locked by another user.

Type

The type of record.

ID

The name of the record.

User

The user who is accessing the record.

Host

The name of the computer running the Server application.

 

---

Preferences General Tab

Use the Preferences window General tab to set the name of the computer running the Server application, the event logging level, alert message interval, connection time-out interval and certificate expiration notification period.

Select Tools—>Preferences in Administrator to open the Preferences window General tab.

Figure 10-3 Preferences Window General Tab (Windows)

 

Field Descriptions

The following describes the fields on the Preferences window General tab.

Host name

The fully qualified domain name, registered with the domain name system (DNS), or IP address of the computer where the Server application is running.

Event logging level

Select from the drop-down list the message group corresponding to the minimum event levels you want to record in the server log. The following table describes the levels you can set. The number of messages increases the lower you set the level. The lowest level is Alert, Notify, Transaction, Debug.

Table 10-1 Event Logging Levels  

Message level	Description
Alert, Notify, Transaction, Debug
	Select Alert, Notify, Transaction, Debug to log and display all events that occur in WebLogic Integration - Business Connect, including all normal milestones. As the name implies, this level is intended for providing information useful in performing debugging or troubleshooting. If you select this option, application performance decreases.
0	Debug event
Alert, Notify, Transaction
	Select Alert, Notify, Transaction to log and display all events level 1 and greater. Events at this level are normal transactions. This is the default. Examples of events at this level include: Receiving a certificate in pending status from an S/MIME client Receiving an unmatched MDN Placing an inbound document in the Other directory
1	Normal event
Alert, Notify
	Select Alert, Notify to list all events levels 2, 3 and greater. Level 2 and 3 events are errors that cause WebLogic Integration - Business Connect to send notifications.
2	Document rejected Examples of level 2 events include when WebLogic Integration - Business Connect rejects a document because there is no active partner or when the application cannot decrypt a document.
3	General error Examples of level 3 events include when: WebLogic Integration - Business Connect receives an MDN that indicates that a partner could not process a document from you You try to start WebLogic Integration - Business Connect when it is already running
Alert
	Select Alert to list all events levels 4-8. Level 4-8 events are errors that cause WebLogic Integration - Business Connect to send alerts.
4	Connection exception Level 4 events cause WebLogic Integration - Business Connect to send alerts for expected activity. Contact your network administrator for assistance. An example of an event at this level is when WebLogic Integration - Business Connect cannot connect to the network or to a server.
5	Transport error Level 5 events are problems with the transport configuration in WebLogic Integration - Business Connect. Contact your WebLogic Integration - Business Connect administrator for assistance. An example of such an event is incorrect settings for a transport, such as an incorrect password or mail server.
6	No transport selected Level 6 events are problems with transport configuration. An example of a such an event is when the partner has not selected a transport method.
7	Unexpected error Level 7 events are errors not accounted for under other levels. Examples of such events are: A document could not be packaged (error building the MIME message). Configuration data from the database could not be read.
8	Duplicate server error A level 8 event is a duplicate server error. An example of such an event is when the server is unable to run because the server already is running.

 

Alert repeat interval (mins)

The interval in minutes WebLogic Integration - Business Connect waits before it sends you the next alert message about the same alert condition. For example, if WebLogic Integration - Business Connect cannot connect to the mail server, it sends you only one alert e-mail about this failure per interval that you specify. The default interval is 60 minutes.

Connection timeout (secs)

This is the time-out value in seconds for any TCP/IP connection.

Cert. expiration notification (days)

This is the number of days before an active company certificate expires that the system will issue an alert message warning of the upcoming expiration date. This warning is intended to provide time to replace the certificate before an expired certificate can interrupt trading. The system issues only one alert for a certificate about to expire.

Alerts for certificates about to expire are issued only for active certificates for active company profiles and for active certificates for the WebLogic Integration - Business Connect API  HTTPS server and SOAP-RPC HTTPS server. Alerts are not issued for partner certificates. Alert messages are reported on the Alerts information viewer in Tracker. Alert messages also are sent by e-mail if a notify e-mail address is specified on the Company Profile window Preferences tab.

The Server application must be running for certificate expiration date checking to take place. The Server checks upon start-up and once every 24 hours thereafter.

Display server window (Windows only)

Select this check box to display the Server Display window while the Server application is running. This is the default and recommended setting.

If you change the selection, you must restart the Server for the change to take effect.

Browser path (UNIX only)

If you previously specified a browser, this field shows the path to your Internet browser. You use a browser to view the online help and to obtain certificates from third-party certificate authorities.

To set or change the browser path, click Browse to open the Browse dialog box. Type the path of the executable file for the browser and click OK to return to the General tab.

 

---

Preferences Ports Tab

Use the Preferences window Ports tab to view or change ports WebLogic Integration - Business Connect uses.

Select Tools—>Preferences in Administrator to open the Preferences window General tab. Click Ports to open the Ports tab.

Figure 10-4 Preferences Window Ports Tab

 

Field Descriptions

The following describes the fields on the Preferences window Ports tab.

Transports

The following port fields are for document transports.

HTTP port

The port where the WebLogic Integration - Business Connect HTTP server is listening for inbound documents from the remote trading partner's HTTP client. The default is 4080.

SMTP port

The number of the port that the WebLogic Integration - Business Connect internal SMTP server listens to for inbound documents that are sent via the SMTP transport. The default is 4025.

SMTP SSL server port

The number of the port that the WebLogic Integration - Business Connect internal SMTP server listens to for inbound documents that are sent via the SMTP transport with SSL engaged. The default is 4026.

API

The following fields are for communications with a remote application program interface (API) client. To communicate with an API client via HTTPS you must also complete a number of other configuration tasks. See API HTTPS Security.

HTTP port

The port for a remote API client communicating by way of an HTTP server.

HTTPS port

The port for a remote API client communicating by way of an HTTPS server.

If you use the API HTTPS port for integration, you must generate or load a certificate for the HTTPS server using the certloader tool. See Certificate Tool (certloader).

Client/Server

The following fields are for communication between WebLogic Integration - Business Connect Server and the client applications Administrator and Tracker.

Administrator/Tracker SOAP HTTPS port

The number of the port for the SOAP HTTPS server that is built into WebLogic Integration - Business Connect. Administrator and Tracker use this port to securely send updates to the Server application. For details see SOAP-RPC HTTPS Security.

If you change this value, you must close Administrator and Tracker and restart the Server application for the change to become effective.

Authenticate

Select this check box only if you want the Server application to authenticate a certificate for Administrator and Tracker. For details see SOAP-RPC HTTPS Security.

If you change this value, you must close Administrator and Tracker and restart the Server application for the change to become effective.

 

---

Preferences Outbound SMTP Tab

Use the Preferences window Outbound SMTP tab to designate one SMTP server for sending documents to all partners via the POP transport (SMTP/POP). The information on this tab is used on the Partner Profile window Outbound Protocols tab for the POP transport for the partner profiles you import or create. You must first complete the Preferences window Outbound SMTP tab before importing or creating partner profiles for the information on this tab to become part of the POP transport configuration.

If you want to use different SMTP servers for sending documents to different partners, you have two options. You can complete the Outbound SMTP tab, create or import the partner profile, and then type new values in the SMTP server field on the POP Transport Options window, which is accessed from the Partner Profile window Outbound Protocol tab. Or, you can leave the Outbound SMTP tab blank and add the SMTP server information in the POP configuration for the partner profile.

Select Tools—>Preferences in Administrator to open the Preferences window General tab. Click Outbound SMTP to open the Outbound SMTP tab.

Figure 10-5 Preferences Window Outbound SMTP Tab

 

Field Descriptions

The following describes the fields on the Preferences window Outbound SMTP tab.

SMTP server

Type the fully qualified domain name or IP address of the server used for sending documents to partners by POP (SMTP/POP).

User name

Type the user name for the server.

Password

Type the password for the user.

Confirm password

Type the password again.

Use SSL

Select this check box to use Secure Sockets Layer protocol.

 

---

Preferences Monitoring Tab

Use the Preferences window Monitoring tab to set a user name and password that authorizes a user to open the WebLogic Integration - Business Connect server monitor page.

Select Tools—>Preferences in Administrator to open the Preferences window General tab. Click Monitoring to open the Monitoring tab.

The server monitor page is opened in an Internet browser by selecting Tools—>Launch Server Monitor in Administrator or Tracker. The page displays information about Server activities, including document trading data and events. For more information about the page see Monitoring the Server with a Browser.

You can set a user name and password that can be used by a single user or that can be shared by two or more users, depending on your organization's security practices. If you do not set a user name and password, any user can access the server monitor page.

Figure 10-6 Preferences Window Monitoring Tab

 

Field Descriptions

Note: The Agent Configuration fields are associated with an unsupported feature. Ignore these fields.

The following describes the fields on the Preferences window Monitoring tab.

Browser monitor authentication

The following fields are for setting an optional user name and password for using the Launch Server Monitor option on the Tools menu for monitoring Server application activity on a browser.

User name

Type the name of the user who is authorized to access the server monitor page.

Password

Type a password for the user.

Confirm password

Type the password again.