Add-On Instruction Parameter Changes - Confirmation Dialog Overview

This confirmation dialog box shows you the impact of parameter changes when you edit an Add-On Instruction (by adding, deleting, renaming, reordering or changing the status or usage type of one or more parameters). You can review pending changes before confirming or rejecting them.
TIP: Safety icons indicate if the container is a safety Add-On Instruction:
bitmap_SafetyProgramFolderOpen - Program
bitmap_MainSafetyLadderRoutine (2) - Routine
ATTENTION: Changes that you make to instruction definitions require updates to the logic where the instruction is used.
ATTENTION: Calls to this instruction may verify with changes and cause unintended execution changes.
ATTENTION: Add-On Instruction references in source-protected routines and routines in source-protected Add-On Instructions will not be automatically updated to realign arguments if the source key is unavailable. The Add-On Instruction or routine may still verify, but the resulting operation may not be as intended.
ATTENTION: If you choose to apply the edits, check each routine where your Add-On Instruction is used to confirm that the instruction will execute properly with the changes.
ATTENTION: When you make edits to existing Add-On Instructions, it is your responsibility to know where Add-On Instructions are used in the logic.
Attributes
Locations where instruction is called
The location in each routine where the Add-On Instruction is called. If you don't have permission to edit routines or Add-On Instruction invocations, location argument information is not displayed.
Selected call's arguments
The parameters' corresponding arguments. An asterisk identifies parameters with pending changes.
  • Existing arguments are reset to the originally associated parameters.
  • Newly added parameters are inserted without arguments. A question mark appears in the argument field (except in Structured Text, where the field is blank).
  • Unknown parameters are created for arguments with deleted associated parameters.
  • Parameters that cannot be assigned with arguments are not included in this list.
  • Arguments used by existing invocation that cannot be matched to appropriate parameters in the new parameter definition (due to parameter deletion, usage change, etc.) appear at the bottom of the list and are assigned to an Unknown parameter.
    TIP:
    If you cannot edit the selected call, the message "Arguments will not be edited for this call. It is possible that the call will verify though arguments are not what was intended" will appear and the parameters' corresponding arguments will not appear.
Show Changed Parameters Only
Select this box to filter the selected call’s parameter/argument list to show only changed parameters. If the selected call’s parameter/argument information is not available, this check box is disabled.
Yes
Apply the changes to the instruction definition. If the Open Cross Reference check box is selected, navigates to the cross reference by logic for the instruction.
No
Cancel changes to the instruction definition. Note that to fully cancel any changes, you must click cancel on the dialog box where you modified the Add-On Instruction.
Help
Display help for this dialog box.
Open Cross Reference
Open the Add-On Instruction Cross Reference dialog box when you apply the edits. You can navigate to exact locations of invocations from this dialog box.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.