Repository Editor windows contain entry fields, scrollable displays, command buttons, status, and radio buttons. The figure “Sample Repository Editor Window” on page 4‑3 illustrates the parts of the window. The table “Repository Editor Window Parts” on page 4‑4 contains details about each part.Figure 4‑1 Sample Repository Editor WindowTable 4‑1 details the parts of the Repository Editor window shown in the previous figure.
Table 4‑1 Repository Editor Window Parts 1 Text boxes 2 Drop-down arrow 3 Display list 4 Command buttons 5 Radio buttons You can start the Repository Editor from either the JavaSoft appletviewer or from your Web browser. Both of these methods are detailed in the following sections.
Note:
1. Set the CLASSPATH to include the Jolt class directory.
3. Press Enter.The window is displayed as shown in the figure “Oracle Jolt Repository Editor Logon Window” on page 4‑7.
1. Set the CLASSPATH to include the Jolt class directory.
3.
1. Ensure that the CLASSPATH does not include the Jolt class directory.
2. Unset the CLASSPATH.
Note: Before opening the file, modify the applet codebase parameter in RE.html to match your Jolt Java classes directory.
4. The “Oracle Jolt Repository Editor Logon Window” on page 4‑7 must be displayed before you continue with step 2. Refer to this figure as you perform the following procedure.
3.
Note: Unless you are logging on through the Jolt Relay, the same port number is used to configure the Jolt Listener. Refer to your UBBCONFIG file for additional information.
Note: See the JoltSessionClass for additional information.Figure 4‑2 Oracle Jolt Repository Editor Logon WindowThe following table, “Repository Editor Logon Window Description,” describes Repository Editor logon window elements.
Exit the Repository Editor when you finish adding, editing, testing, or deleting packages, services, and parameters. Prior to exit, the window is displayed as shown in the figure “Oracle Jolt Repository Editor Logon Window Prior to Exit” on page 4‑9.Note that only the Packages, Services, and Log Off command buttons are enabled. All of the text entry fields are disabled.
1. Click Back to return to the Repository Editor Logon window.
2. Click Log Off to terminate the connection with the server.
3. Select Close from your browser menu to close the window.
•
• Figure 4‑4 illustrates the Repository Editor flow to help you determine which of these two buttons to select.Figure 4‑4 Repository Editor Flow Diagram
• Refer to “What Is a Package?” on page 4‑12 for complete details.Refer to “What Is a Service?” on page 4‑15 for complete details.You use the Packages window to perform the following:Click the Packages button in the Jolt Repository Editor logon window to display the available packages. When you select a specific package from the display list, its services within that package are displayed.Figure 4‑5 contains a sample Packages window. The BANKAPP package is selected, and the services within the BANKAPP package is displayed.Figure 4‑5 Sample Packages WindowTable 4‑3 shows the packages window description.
Table 4‑3 Packages Window Description
1. Click Packages in the Repository Editor Logon window.In the figure “Sample Packages Window” on page 4‑13, BANKAPP, BULKPKG, and SIMPSERV are the available packages.
2. Refer to “Instructions for Viewing a Parameter” on page 4‑17 for additional information.Figure 4‑6 is an example of a Services window with the BANKAPP package selected, and the display list of services and parameters available for this package (parameters are detailed later).Figure 4‑6 Sample Services WindowTable 4‑4 shows the services window description.
Table 4‑4 Services Window Description
1. Select Services from the Repository Editor Logon window.In the figure “Sample Services Window” on page 4‑15, BANKAPP is the selected package. DEPOSIT, INQUIRY, TRANSFER, and WITHDRAWAL are the available services for BANKAPP.
3. Refer to “Instructions for Viewing a Parameter” on page 4‑17 for additional information.A service contains parameters, which may be a pin number, account number, payment, rate, term, age, or Social Security number. Figure 4‑7 shows a Services window displaying a selected service and its parameters.Figure 4‑7 Sample Services Window with Parameters List
1. Select Services from the Repository Editor Logon window.In the preceding figure, BANKAPP is the selected package.In the preceding figure, INQUIRY is the selected service.In the preceding figure, ACCOUNT_ID, FORMNAM, SBALANCE, and STATLIN are the available parameters for the INQUIRY service.
5. Refer to “Adding a Parameter” on page 4‑24 for additional information.As you create and edit services and parameters, it is important to regularly save information to avoid losing input. Clicking Save Service in the Edit Services window can prevent the need to re-enter information in the event of a system failure.
Caution: When you add or edit the parameters of a service, you must select Add before choosing Back from the Edit Parameters window and returning to the Edit Services window.If adding a new service or modifying an existing service in the Edit Services window, be sure to select Save Service before choosing Back. If you select Back before you save the modified information, a warning is briefly displayed on the status line at the bottom of the window.When you need to add a new group of services, you create a new package before adding the services. The “Package Organizer Window” on page 4‑19 and the following procedure show how to add a new package, BALANCE, to the Packages listing.Figure 4‑8 Package Organizer Window
1. Click Packages in the Repository Editor Logon window to display the Packages window.
2. Select Package Organizer to display the Package Organizer window, similar to that shown in the figure “Package Organizer Window” on page 4‑19.For a description of contents of this window, see “Package Organizer Window Description” on page 4‑30.
3. Click the New Package button in the Package Organizer window.The new name (shown in the preceding figure as BALANCE) is displayed on the Packages list in random order.Figure 4‑9 shows the Edit New Services window for adding a service.Table 4‑5 describes the options for adding services to a package in a package window.
1. Select Services from the Repository Editor Logon window.If you later decide that another package should contain the new service, use the Package Organizer to move the service to a different package. (See “Grouping Services Using the Package Organizer” on page 4‑29 for additional information.)
3. From the Services window, select New to display the Edit Services window, as shown in “Edit Services Window: Add a New Service to a Package” on page 4‑21.
4. Select the Service Name text field to activate it.
• If VIEW or VIEW32 is selected, you must type the Input View Name and Output View Name in the associated text fields.
• If CARRAY or STRING is selected, refer to “Selecting CARRAY or STRING as a Service Buffer Type” on page 4‑24 for additional instructions.
7. If CARRAY or STRING is selected as the buffer type for a new service, only CARRAY or STRING can be added as the data type for the accompanying parameters. See also “Adding a Parameter” on page 4‑24 and “Selecting CARRAY or STRING as a Parameter Data Type” on page 4‑27. For additional information, refer to Chapter 5, “Using the Jolt Class Library.”.Figure 4‑10 shows an example Edit Services window with STRING selected as the buffer type for the service SIMPAPP.Figure 4‑10 Edit Services Window: Select STRING Buffer TypeClicking New under the label Parameter level actions in the Edit Services window is displayed in the Edit Parameters window. Review the features in Figure 4‑11. Use this window to enter the parameter and screen information for a service.Figure 4‑11 Edit Parameters Window: Add a Parameter
1. Select Field Name to activate the field, and type the field name.
3.
4. Select the Occurrences text field to activate it, and then enter the number of occurrences.
5.
6. In the Edit Services window, click Save Service to save the parameter as a part of the service.
WARNING: If you do not click Save Service before you click Back, the parameters are not saved as part of the service.
7. See also “Instructions for Adding a Service” on page 4‑23 and “Selecting CARRAY or STRING as a Service Buffer Type” on page 4‑24. For additional information, refer to Chapter 5, “Using the Jolt Class Library.”.Figure 4‑12 is an example of the Edit Parameters window with string as the selected data type for the parameter. The Data Type defaults to string and does not allow you to modify that particular data type. The Field Name can be any name.Figure 4‑12 Edit Parameters Window: string Data TypeFigure 4‑13 is an example of a Package Organizer window with a service selected for transfer to another package.Figure 4‑13 Package Organizer Window
The previous figure shows the selected service, INQUIRY, and the selected package, BANK, to which the INQUIRY service will be moved.Figure 4‑14 Example of a Moved Service
5. These keys are activated only when both packages (left and right are displayed) and a service are selected. The keys are only active in the direction of the package where the service is to be moved. The previous figure, “Example of a Moved Service,” shows that the INQUIRY service has been moved to the BANK package on the right.You can edit an existing service name or service information, or access the window to add new parameters to an existing service. For a description of the Edit Services window, see “Adding a Service Window Description” on page 4‑21. Figure 4‑15 is an example of the Edit Services window.Figure 4‑15 Edit Services Window
3. Click Edit to display the Edit Services window, as shown in the previous figure.
4. Type or select the new information, and click Save Service.
WARNING: Figure 4‑16 is an example of the Edit Parameters window.Figure 4‑16 Edit Parameters Window
1. In the Services window (see “Sample Services Window with Parameters List”), select the package and service that contain the parameter you want to change.The Edit Parameters Window is displayed as shown in the previous figure.
4.
5. Click Back to return to the previous window.This section describe how to delete a package. Before deleting a package, all the services must be deleted from the package. The Delete option is not enabled until all components of the package or service are deleted.
3. Click Edit to display the Edit Services window.
5.
Note: Delete is enabled.
3. Click Delete. The service is deleted.
1.
3. Click Delete.To make a service available to a Jolt client, you export it. All services in a package must be exported or unexported as a group. A service is made available by using the Export and Unexport radio buttons.Figure 4‑17 Packages Window: Export and Unexport Buttons
1. From the Repository Editor Logon window, select Packages to display the Packages window.The Export and Unexport buttons are enabled.
Caution: Figure 4‑18 displays the Export radio button as active, for Export Status; therefore, the current status for the service TRANSFER is exported.Figure 4‑18 Export Status
1. From the Repository Editor Logon window, select Services to display the Services window shown in the “Sample Services Window” on page 4‑15.
4. Click Edit.One of the radio buttons (Unexport or Export) next to the Export Status label will be active, indicating the current status of the service.Although the Test button in the Edit Services window is enabled when parameters are not added to the service, the Service Test window displays unused in the parameter fields, and they are disabled. Refer to “Sample Service Test Window” on page 4‑40 for an example of unused parameter fields.Figure 4‑19 is an example of a Service Test window with both writable and read-only text fields.Figure 4‑19 Sample Service Test Window
Figure 4‑20 shows a typical Repository Editor service flow test.Figure 4‑20 Test Service FlowFollow these steps to test a service. For troubleshooting information, see the first two entries in the Repository Editor Troubleshooting table.
1. Select Services from the Repository Editor Logon window.
3. Click Edit to access the Edit Services window.
4. Click Test to access the Service Test window.
6. Click RUN.
• If the test passed: “Run Completed OK”
• If the test failed: “Call Failed”See “Repository Editor Troubleshooting” on page 4‑43 for additional Repository Editor troubleshooting information.
3. Click Unexport.
4. Click Back to return to the Repository Editor Logon window.
5. Click Services to display the Services window.
8.
Table 4‑6 Repository Editor Troubleshooting
• For Netscape browsers, make sure that Enable Java and Enable JavaScript are checked under Edit→Preferences→Advanced. Then select Communicator→Tools→Java Console. If the Java Console does not exist on the menu, the browser probably does not support Java.
• If running appletviewer, check the system console (or the window where you started the appletviewer).
• The RE.html file is available to the Web server.
• The RE.html file contains the correct <codebase> parameter. Codebase identifies where the Jolt class files are located.If running the editor in a browser (or appletviewer) and loading the applet from disk, make sure that:
• The RE.html file exists and is readable.
• The RE.html file is Java-enabled.
• The RE.html file contains the correct <codebase> parameter (this is where the Jolt class files are installed on the local disk).
• Make sure that the configuration of JREPSVR: verify CLOPT parameters and verify that jrep.f16 (FML definition file) is installed and accessible (follow installation documentation).