Add-On Instruction Definition Editor Dialog - Local Tags Tab Overview
Use this tab to configure the Local Tags of an Add-On Instruction. Add-On Instruction Local Tags are not viewable as members of the data type structure for instances of the instruction. Local Tags are hidden when the Add-On Instruction is source-protected.
Attributes
Name
Enter a name following the
Logix Designer
application IEC-61131 Name Standard.IEC-61131 Name Standard
(The names are composed per IEC-61131, section 2.1.2.)
An identifier is a string of letters, digits, and underline characters that begin with a letter or underline character. Underlines are significant in identifiers (for example, A_BCD is interpreted differently than AB_CD). Multiple leading or multiple (consecutive) embedded underlines are not allowed, trailing underlines are not allowed, and letter case is not considered significant.
TIP:
In Logix Designer, most component names are limited in length to 40 characters or less.
The Local Tag must not be the same name of a Parameter in the same Add-On Instruction.
The Name field appears dimmed for members of a Local Tag.
Tags are sorted alphabetically either ascending or descending; this may be toggled at the column header. Note that you are not able to order the rows and, therefore, you cannot drag the rows as you can on the Parameters tab.
TIP:
You can quickly expand all members of the row by right-clicking the row and choosing Expand All <tagname> Members from the popup menu.
Data Type
Choose the Local Tag data type from the pull-down menu.
The data type for a Local Tag may not be a multi-dimensional array or an object type, which includes all Motion types, MSG, ALARM_ANALOG, and ALARM_DIGITAL.
The Data Type field appears dimmed for members of a Local Tag.
Default
The default value for the Local Tag.
These are the default values that are set when an Add-On Instruction of this type is instantiated. This defines the default values that initially come from the data type.
Style
Set the display style for Local Tag.
The Style field appears dimmed for members of a Local Tag.
Description
Enter a description for the parameter following standard
Logix Designer
application description rules of no more than 512 characters.If a Local Tag does not have a description, then pass-through occurs (if turned on). The description of the data type is passed-through. A member of an expanded Local Tag shows its description if it has one on that member in the definition itself. If not, it shows a passed-through description.
Hiding and Showing Columns
You can hide individual columns in the dialog box by choosing Hide Column from the Column Header popup menu. Once a column is hidden, you can show it again by choosing the Toggle Column submenu of the Column Header popup menu.
Sorting
The Column Header popup menu lets you sort tags. You can also do this by double-clicking on the column header cell, to alternate between ascending and descending.
Include Tag Members in Sorting
You can include the tag members in your sort by choosing Include Tag Members in Sorting from the Column Header popup menu. You can also click the Tag Member Sort button (
) to toggle between including and excluding tag members in the sort. When you are excluding the tag members in the sort, the tag members are sorted in memory layout order.
) to toggle between including and excluding tag members in the sort. When you are excluding the tag members in the sort, the tag members are sorted in memory layout order.
IMPORTANT:
The tag member sort does not apply to bit members of DINT, INT, SINT, and Array tags. These tag members are always displayed in memory layout order.
Editing Modes
The first column in the dialog box displays a state indicator. An asterisk appears in this column to indicate that changes have been made to a Local Tag that have not yet been applied.
Popup Menu
Right-click on a parameter to display a context-sensitive popup menu that lists operations you can perform on the specified parameter. Available operations are described below.
Edit Data Type or Edit Definition
Enabled if the Local Tag on the selected line is either a user-defined data type (UDT) or an Add-On Instruction type. If it is a UDT, choosing this menu item navigates to the Data Type Editor. If it is an Add-On Instruction type, choosing this menu item takes you to the Add-On Instruction Definition Editor.
Go to Cross Reference
Goes to the cross reference for the selected tag.
This brings up Cross Reference on the tag object. If you have modified the name of the tag in the Add-On Instruction Definition Editor and have not applied this change, then the name you see is not the name that cross reference will act upon.
Go To
Navigates to Go To dialog box.
If you have modified the name of the tag (or anything else on the tag so that it has an asterisk on its row), then the name in the Go To dialog box is pre-pended with an asterisk. The asterisk is a hint to you that the name may be different than the actual name on the tag object that will be acted upon.
If you are on the Go To... Tag item, it is just a search for the given string, so it is initially populated with the tag name as it appears in the Add-On Instruction Definition Editor.
The Go To... item appears dimmed if the tag is a new tag in the Add-On Instruction Definition Editor because there is no real underlying tag to act upon yet.
Disabled if the Add-On Instruction is source-protected and not viewable.
Cut
Cuts the selected Local Tag.
Copy
Duplicates the selected Local Tag. Disabled if the Add-On Instruction is source-protected, even if it is viewable.
Paste
Places the cut or copied Local Tag where the cursor resides.
Delete
Deletes the selected Local Tag.
Disabled if the current line is a member of an expanded Local Tag, or if the selection is on the last (empty) row, or if it is an EnableIn or EnableOut Local Tag.
Logic
Click to open the Logic routine. This Logic button is not visible if the Add-On Instruction is source-protected.
Data Type Size
Displays the size of the Add-On Instruction data type – this does include the size of any Local Tags (even though Local Tags are not visible when an instance tag of this data type is expanded in the Tag Editor or Data Monitor), but it does not include logic size. The size is automatically updated when you apply the instruction, not as you create the Parameters and Local Tags.
Copy all default values of parameters and local tags whose values were modified to all tags of this instruction type
Copies all the default values of the parameters/local tags, or members' default values, that you have changed, to all instance tags of this instruction type.
OK
Click this button to accept your edits and close the Add-Instruction Editor dialog box.
Cancel
Click this button to cancel your edits and close the Add-On Instruction Definition Editor dialog box.
Apply
Click this button to apply your edits and continue editing in the Add-On Instruction Definition Editor dialog box.
Help
Click this button for help on this tab.
Provide Feedback