Add Operation

You get the Add Operation window when you select the root of the Operation tree and choose Edit->Add from the menu bar. To create an operation, type the operation name in the text field and move the parameters that you want to use into the Current Parameters display area.

Fields

The following table explains the fields on this window.

Table 7-5 Add 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. 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 ElementName (ElementType).
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 filled in the fields, click OK to save your changes and close the window. (Or click Cancel to close the window without saving your changes).

See Also

Selecting Input and Output VIEW Names, Input and Output VIEW Names, Adding Operations

Input and Output VIEW Names

If you select an input buffer type or an output buffer type of VIEW or VIEW32, the Input VIEW Name and Output VIEW Name are populated from the list of available elements that have been defined as structs.

If both input views and output views are used, no additional parameters may be used. If only an input view is used, any parameters taken from Available Parameters must have a passing mode of "out." If only an output view is used, any parameters taken from Available Parameters must have a passing mode of "in."

Warning: When moving items from Available Parameters to Current Parameters, an edit check is made to ensure that an FML field identification conflict does not exist.