Use this window to set up a new user-defined signal or edit the
details of an existing user-defined signal.
Complete this window as follows:
- Signal Name
- Type a unique name for the signal. If you are editing a signal, you cannot
change the name.
Tip: When creating
ObjectServer objects, their names must begin with an uppercase or
lowercase letter, followed by uppercase or lowercase letters, numbers,
or underscore (_) characters, up to 40 characters in length. User,
group, and role names can be any text string up to 64 characters in
length and can include spaces. Names of ObjectServer objects are
case-sensitive.
- Comment
- Type a text comment for the signal. For example, you can add a comment
to state which trigger fires when this signal is raised.
- Parameters
- This area displays the parameters that comprise the user-defined signal.
- The order in which the parameters appear must match the order that they
appear in the RAISE SIGNAL command for the trigger. You can use the up and
down arrows to the right of the list box to change the order of any selected
parameter. You can also click Remove parameter to the
right of the list box to remove any selected parameter from the list.
- To create a parameter, use the Name and Data
Type fields, and the Add parameter to the list button.
- Name
- Type a name for the parameter being created. Parameter names must be unique
within the signal.
- Data Type
- Select the type of data the parameter can pass into the signal. The data
type can be any valid ObjectServer data type except VARCHAR or INCR.
- Data Length
- For Char data types only, type the parameter length.
- Add parameter to the list
- After completing the Name, Data Type,
and, where necessary, Data Length fields, click this
button to add the parameter to the parameter list.
Saving
your user-defined signals
After creating or editing a user-defined
signal, you can save or cancel the changes made by clicking the relevant button
as follows:
- OK
- Click this button to save the user-defined signal and close the window.
New user-defined signals are added to the User Defined Signals pane.
- Cancel
- Click this button to close the window without saving your changes.