Modifying Objects

You can modify objects at any time. You may choose to modify an object to incorporate a name change or any other change to the object. This section describes:

• Modifying Modules

• Modifying Interfaces

• Modifying Operations

• Modifying Parameters

• Modifying Structs

• Modifying Elements

Modifying Modules

Modify a module by selecting the object from the directory tree shown in Figure 3-13. See Adding Modules for a description of the module window.

Figure 3-13 Modules Selection Window

Modifying Modules Instructions

To modify a module:

1. Select the module to modify.

2. Choose Edit -> Modify from the menu bar

   Or

   Click on the Modify toolbar button.

3. The Modify Module window in Figure 3-14 displays.

   Figure 3-14 Modify Module Window

   

4. Use << or >> keys to move the interfaces between the Current Interfaces and Available Interfaces display lists.

5. Click OK to make the changes. When the changes have been made to the module, the update status changes to reflect the most recent modification.

   (Or click Cancel to close the window without saving your changes.)

You can make changes to an interface by selecting the interface from the directory tree struct shown in Figure 3-15. See Adding Interfaces for a description of the interface window.

Figure 3-15 Interface Selection Window

Modifying Interfaces Instructions

To modify an interface:

1. Select the interface to modify.

2. Choose Edit -> Modify from the menu bar

   Or

   Click on the Modify toolbar button.

3. The Modify Interface window in Figure 3-16 displays.

   Figure 3-16 Modify Interface Window

   

4. Use the << or >> keys to move the operations.

5. Click OK to make the changes. When the changes have been made to the module, the update status changes to reflect the most recent modification.

   (Or click Cancel to close the window without saving your changes.)

You can modify an operation by selecting the operation node from the directory tree struct shown in Figure 3-17. See Adding Operations for a description of the operation window.

Note: You can modify the components of an exported operation. You do not have to unexport the operation in order to modify its components. If you modify an exported operation, it does not automatically change to unexported status. A modified exported operation remains exported until you unexport it with the unexport toolbar button or menu option.

Figure 3-17 Operation Selection Window

Modifying Operations Instructions

To modify an operation:

1. Select the operation to modify.

2. Choose Edit -> Modify from the menu bar

   Or

   Click on the Modify toolbar button.

3. The Modify Operation window in Figure 3-18 displays.

   Figure 3-18 Modify Operation Windows

   

4. Type the new operation name, move the parameters, edit parameters, or modify the Server Implementation details.

5. Click OK to activate the changes and close the window.

   (Or click Cancel to close the window without saving your changes.)

You can modify a parameter from the main window (by selecting it in the tree and clicking Modify as shown in Figure 3-19).

Note: You can also modify a parameter as a part of adding or modifying operations. When you select a "current parameter" in the Add Operation or Modify Operation window and click Edit, you get the Edit Parameter window, which functions in the exact same way as the Modify Parameter window. (See Adding Operations or Modifying Operations.)

For complete instructions see Modifying Parameter Instructions. (The Modify Parameter window is shown in Figure 3-20.)

A parameter may be modified to enable or disable the return value, or change the passing mode by selecting IN, IN/OUT, OUT, or NO ACCESS. In addition, the BEA TUXEDO server information can be modified to reflect a display name change, a change in the exception mode return status, and enable or disable the mandatory status.

Figure 3-19 Parameter Selection Window

Modifying Parameter Instructions

To modify a parameter from the main window:

1. Select the parameter to modify.

2. Choose Edit -> Modify from the menu bar

   Or

   Click on the Modify toolbar button.

   This brings up the Modify Parameter window shown in Figure 3-20.

   Figure 3-20 Modify Parameter Window

   

3. Fill in the fields as described in the following table.

   Table 3-7 Modifying Parameters

   Field	Description
   Parameter Name	Indicates the same name of the element name used to create the parameter. To modify the parameter name, modify the element name first.
   Occurrence	Indicates the number of occurrences of this element. If 0, the element can have an unlimited number of occurrences. To modify the parameter occurrence, modify the element occurrence first.
   Type	Type of element; either a primary element type FML (char, string, short, long, float, double, carray) or VIEW (int, short, long, char, float double, string carray) or a struct type. To modify the parameter type, modify the element type first.
   Return Value	Select the checkbox if the element is used as a return value. Only one parameter from the Current Parameters list of an operation can have a return value.
   Passing Mode	Indicate the direction of movement for the data: in out in/out noaccess You can have only one parameter from the Current Parameters list for an operation that is listed as the return value. The passing mode of this parameter must be "out."
   Display Name	Type a unique 32 character parameter name within one operation. This name is used for generating element names.
   Exception Mode	For out or in/out parameters, this mode indicates how the parameter is returned on exceptions. Enabled only for out and in/out passing modes and the operation return exception is enabled.
   Mandatory	Indicates if the parameter is required or optional. An occurrence of "1" is mandatory (if you selected the checkbox). An occurrence of "0" is not mandatory (if you did not select the checkbox).

4. Make changes to the Return Value, Passing Mode, or Display Name.

5. Click OK to activate the changes and close the window. When the changes have been made to the module, the update status changes to reflect the most recent modification.

   (Or click Cancel to close the window without saving your changes.)

You can modify a struct from the Struct main window shown in Figure 3-21. To modify a struct, the current elements display in the left window and the available elements display in the right window as shown in Figure 3-22. The arrow buttons in the middle can be used to move elements in or out of the struct. See Adding Structs for a description of the struct window.

Figure 3-21 struct Selection Window

Modifying Structs Instructions

To modify a struct:

1. Select the struct to modify.

2. Choose Edit -> Modify from the menu bar

   Or

   Click on the Modify toolbar button.

3. The Modify Struct window shown in Figure 3-22 displays.

   Figure 3-22 Modify Struct Window

   

4. Type the new struct name or move the members.

5. Click OK to activate the changes and close the window.

   (Or click Cancel to close the window without saving your changes.)

You can modify an element at any time, including when you are creating new modules or after testing an operation. The Modify Element window in Figure 3-24 is used to modify elements. An element may be altered to incorporate occurrences, disable or enable the fixed-field length, add comments, and change server implementation information. See Adding Elements for a description of the element window.

Note: The element length can be altered only if the element type is string or carray.

Figure 3-23 Element Selection Window

Modifying Elements Instructions

To modify an element:

1. Select the element to modify.

2. Choose Edit -> Modify from the menu bar

   Or

   Click on the Modify toolbar button.

3. The Modify Element window shown in Figure 3-24 displays.

   Figure 3-24 Modify Element Window

   

4. Make the changes to the element.

5. Click OK to activate the changes and close the window.

   (Or click Cancel to close the window without saving your changes.)