Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Jolt   |   Topic List   |   Previous   |   Next   |   Contents   |   Index

   Using BEA Jolt

This section includes the necessary steps for setting up a package and its services:

• Saving Your Work

• Adding a Package

• Adding a Service

• Adding a Parameter

Saving Your Work

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 and the following procedure show how to add a new package, BALANCE, to the Packages listing.

Instructions for Adding a Package

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.

   For a description of contents of this window, see Package Organizer Window Description.

3. Click the New Package button in the Package Organizer window.

   The text field is activated.

4. Type the name of the new package (not to exceed 32 characters) and press Enter.

   The new name (shown in the preceeding figure as BALANCE) is displayed on the Packages list in random order.

Services are definitions of available BEA Tuxedo services and can only be a part of a Jolt package.You must create the service as a part of a new or existing package.

The Repository Editor accepts the new service name exactly as it is typed (that is, all uppercase letters, abbreviations, misspellings are accepted). Service names must not exceed 30 characters.

The following figure shows the Edit New Services window for adding a service.

Adding a Service Window Description

The following table describes the options for adding services to a package in a package window.

	Option	Description
Edit Services Selections	Service Name	Name of the new service to be added to the Jolt Repository.
	Input Buffer Type/Output Buffer Type	VIEW- C-structure and 16-bit integer field. Contains subtypes that have a particular structure. X_C_TYPE and X_COMMON are equivalent. X_COMMON is used for COBOL and C. VIEW32-Similar to VIEW, except 32-bit field identifiers are associated with VIEW32 structure elements. CARRAY-Array of uninterrupted binary data that is neither encoded nor decoded during transmission; it may contain null characters. X_OCTET is equivalent. FML-Type in which each field carries its own definition. FML32-Similar to FML except the ID field and length field are 32 bits long. STRING-Character array terminated by a null character that is encoded or decoded.
	Input View Name/Output View Name	Unique name assigned to the Input View Buffer and Output View Buffer types. These fields are only enabled if VIEW or VIEW32 are the selected buffer types.
Export Status	Unexport Export	Radio button with current status of the service. EXPORT or UNEXPORT status is checked. UNEXPORT is the default.
Service Level Actions	Save Service	Saves the newly created service in the Repository.
	Test	Tests the service. This command button is disabled until a new service is created or edits to an existing service are saved.
	Back	Returns you to the previous window.
Parameter	Parameters	List of service parameters to edit or delete.
Parameter Level Actions	New	Adds new parameters to the service.
	Edit	Used to edit an existing parameter. This command button is disabled until a new parameter is selected.
	Delete	Deletes a parameter. This option is disabled until a parameter is selected.

1. Select Services from the Repository Editor Logon window.

   The Services window opens, similar to the figure shown in Sample Services Window.

2. Select the package to which you will add the service.

   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 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.

4. Select the Service Name text field to activate it.

5. Type the name of the new service you want to add.

6. Select the input buffer type.

   Although the same buffer type selected for the Input Buffer is automatically selected for the Output Buffer, you can select a different Output Buffer type.

   • If VIEW or VIEW32 is selected, you must type the Input View Name and Output View Name in the associated text fields.

   • If another buffer type is selected, the Input View Name and Output View Name text fields are disabled.

   • If CARRAY or STRING is selected, refer to Selecting CARRAY or STRING as a Service Buffer Type for additional instructions.

7. Select Save Service to save the newly created service.

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 and Selecting CARRAY or STRING as a Parameter Data Type. For additional information, refer to Using the Jolt Class Library.

The following figure shows an example Edit Services window with STRING selected as the buffer type for the service SIMPAPP.

Adding a Parameter

Clicking New under the label Parameter level actions in the Edit Services window is displayed the Edit Parameters window. Review the features in the following figure. Use this window to enter the parameter and screen information for a service.

Adding a Parameter Window Description

Option	Description
Field Name	Adds the field name (for example, asset, inventory).
Data Type	Lists data type choices: byte - 8-bit short - 16-bit integer - 32-bit float - 32-bit double - 64-bit string - null-terminated character array carray - variable length 8-bit character array
Direction	Radio button choices for direction of information: Input - Information is directed from the client to the server. Output - Information is directed from the server to the client. Both - Information is directed from the client to the server, and from the server to the client.
Occurrence(s)	Number of times that an identical field name can be used. If 0, the field name can be used an unlimited number of times. Occurrences are used by Jolt to build test screens; not to limit information sent or retrieved by BEA Tuxedo.
Screen Information	This button is disabled when the window is launched.
Clear	Clears the fields of the window.
Change	Is disabled while new parameters are added.
Add	Adds new parameters to the service. The parameters are saved when the service is saved.
Back	Returns the user to the previous window.

Instructions for Adding a Parameter

1. Select Field Name to activate the field, and type the field name.

   Note: If the buffer type is FML or VIEW, the field name must match the corresponding parameter field name in FML or VIEW.

2. Select the data type.

3. Specify a direction by selecting the input, output, or both radio buttons.

4. Select the Occurrences text field to activate it, and then enter the number of occurrences.

5. Select Add to append the information. Add does not save the parameter.

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. Click Back to return to the Edit Services window.

If CARRAY or STRING is the selected buffer type for a new service, only carray or string can be added as the data type for the accompanying parameters.

In this case, only one parameter can be added. It is recommended that you use the parameter name "CARRAY" for a CARRAY buffer type, and the parameter name "STRING" for a STRING buffer type.

See also Instructions for Adding a Service and Selecting CARRAY or STRING as a Service Buffer Type. For additional information, refer to Using the Jolt Class Library.

The following figure 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.