Modify Operation

You get the Modify Operation window when you select the operation from the tree and choose Edit->Modify from the menu bar. To modify an operation, verify or change the operation name in the text field and move the parameters that you want to use into the Current Parameters display area. Type the TUXEDO service name, input/output buffer types, and select exported or return exceptions checkboxes, if applicable.

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.

Fields

The following table explains the fields on this window.

Table 7-10 Modify Operation

Field Description

Operation Name

Identifies the name of the operation. You must enter the name of the operation you wish to create. This field cannot be left blank or contain spaces. The name must not exceed 32 characters.

Current Parameters

Lists the current parameter names for the operation.
Note: If the Current Parameters list contains a parameter that is a struct type, it is not allowed to have another parameter that is a member of the struct type parameter. In addition, if the Current Parameters list contains a basic parameter, it is not allowed to have another struct type parameter that contains a member of the basic parameter.

Available Parameters

Lists available parameter names for the operation.

Arrow keys (<< or >>)

Moves selected item between Current Parameters and Available Parameters.

Edit

Enables editing of a selected current parameter. This option is disabled if you have not selected a current parameter.
When you select a "current parameter" and click Edit, you get the Edit Parameter window, which functions exactly the same as the Modify Parameter window.
For information about how to edit the parameter, see Modifying Parameters and Modify Parameter window.

TUXEDO Service Name

Identifies the BEA TUXEDO service that implements the operation. The TUXEDO Service Name must not be left blank and must obey the BEA TUXEDO service naming conventions.

Input Buffer Type and Output Buffer Type

VIEW - a C-structure and 16-bit integer field. Contains subtypes that have a particular structure.
VIEW32 - similar to VIEW, except 32-bit FML field identifiers are associated with VIEW32 structure elements.
CARRAY - an array of interpreted binary data that is neither encoded nor decoded during transmission; it may contain null characters. X_OCTET is equivalent.
FML - a type in which each field carries its own definition.
FML32 - similar to FML, except 32-bit field identifiers are associated with FML32.
STRING - a character array terminated by a null character that is encoded or decoded.
NONE - placeholder indicating that no input or output is required.
You cannot have an input parameter in the Current Parameters list that is a member of your Input VIEW Buffer type. If so, either choose a new input parameter or choose a new input VIEW buffer. In addition, you cannot have an output parameter in the Current Parameters list that is a member of your Output VIEW Buffer type. If so, either choose a new output parameter or choose a new output VIEW buffer.
Only FML and FML32 buffer types allow for use of the input or in/out parameter. For all other buffer types (STRING, CARRAY, VIEW, VIEW32, and NONE), input and in/out parameters are not allowed.

Length
Length of the buffer type. You can only edit the buffer length when the buffer type is string and carray.

Input View Name and Output View Name
These fields are only enabled if you select VIEW or VIEW32 as the buffer types (in Input Buffer Type and Output Buffer Type fields). Click on the Select button to get the list of available VIEWs, which is a list of all elements that contain structs. (For information on selecting input and output view names, refer to Selecting Input and Output VIEW Names.)
The input and output VIEW names appear in the form Add Operation (ElementType).
If you are using a VIEW parameter, do not list the same parameter in the Current Parameters field. VIEW parameters should be specified only in the Input View Name or Output View Name fields.

Exported

Exported operations are made available to the client. Select the checkbox to export the operation. If you do not select the checkbox, the operation remains unexported.

Return Exception

Enabled if exceptions are returned.

Last Updated

Displays the date and time of the most recent update and the name of the person who made the update. This area is empty until the operation is created.

OK

Saves your addition.

Cancel

Returns to the previous window.

Help

Accesses online help.

**Table 7-10 Modify Operation**
Field	Description
Operation Name	Identifies the name of the operation. You must enter the name of the operation you wish to create. This field cannot be left blank or contain spaces. The name must not exceed 32 characters.
Current Parameters	Lists the current parameter names for the operation. Note: If the Current Parameters list contains a parameter that is a struct type, it is not allowed to have another parameter that is a member of the struct type parameter. In addition, if the Current Parameters list contains a basic parameter, it is not allowed to have another struct type parameter that contains a member of the basic parameter.
Available Parameters	Lists available parameter names for the operation.
Arrow keys (<< or >>)	Moves selected item between Current Parameters and Available Parameters.
Edit	Enables editing of a selected current parameter. This option is disabled if you have not selected a current parameter. When you select a "current parameter" and click Edit, you get the Edit Parameter window, which functions exactly the same as the Modify Parameter window. For information about how to edit the parameter, see Modifying Parameters and Modify Parameter window.
TUXEDO Service Name	Identifies the BEA TUXEDO service that implements the operation. The TUXEDO Service Name must not be left blank and must obey the BEA TUXEDO service naming conventions.
Input Buffer Type and Output Buffer Type	VIEW - a C-structure and 16-bit integer field. Contains subtypes that have a particular structure. VIEW32 - similar to VIEW, except 32-bit FML field identifiers are associated with VIEW32 structure elements. CARRAY - an array of interpreted binary data that is neither encoded nor decoded during transmission; it may contain null characters. X_OCTET is equivalent. FML - a type in which each field carries its own definition. FML32 - similar to FML, except 32-bit field identifiers are associated with FML32. STRING - a character array terminated by a null character that is encoded or decoded. NONE - placeholder indicating that no input or output is required. You cannot have an input parameter in the Current Parameters list that is a member of your Input VIEW Buffer type. If so, either choose a new input parameter or choose a new input VIEW buffer. In addition, you cannot have an output parameter in the Current Parameters list that is a member of your Output VIEW Buffer type. If so, either choose a new output parameter or choose a new output VIEW buffer. Only FML and FML32 buffer types allow for use of the input or in/out parameter. For all other buffer types (STRING, CARRAY, VIEW, VIEW32, and NONE), input and in/out parameters are not allowed.
Length	Length of the buffer type. You can only edit the buffer length when the buffer type is string and carray.
Input View Name and Output View Name	These fields are only enabled if you select VIEW or VIEW32 as the buffer types (in Input Buffer Type and Output Buffer Type fields). Click on the Select button to get the list of available VIEWs, which is a list of all elements that contain structs. (For information on selecting input and output view names, refer to Selecting Input and Output VIEW Names.) The input and output VIEW names appear in the form Add Operation `(``ElementType``)`. If you are using a VIEW parameter, do not list the same parameter in the Current Parameters field. VIEW parameters should be specified only in the Input View Name or Output View Name fields.
Exported	Exported operations are made available to the client. Select the checkbox to export the operation. If you do not select the checkbox, the operation remains unexported.
Return Exception	Enabled if exceptions are returned.
Last Updated	Displays the date and time of the most recent update and the name of the person who made the update. This area is empty until the operation is created.
OK	Saves your addition.
Cancel	Returns to the previous window.
Help	Accesses online help.

Buttons

When you have modified the fields, click OK to save your changes and close the window. (Or click Cancel to close the window without saving your changes).

Modify Operation

Fields

Buttons

See Also