Progress
Debugger Guide
ASSIGN Command
Modifies the value of a specified variable, field, parameter, or attribute in the current procedure.
SYNTAX
PARAMETERS
[
VARIABLE
|FIELD
|PARAMETER
]Specifies the type of data object you want to modify. If you do not specify this option, the Debugger attempts to resolve name for all object types and reports any ambiguity in the data panel.
name
The name of a variable, field, or parameter defined in the current procedure. If name specifies a field, it must also specify any necessary buffer qualifier that you need to uniquely identify the field.
constant
A literal value that conforms to the data type of the specified data object.
handle
The name of a variable, field, parameter, or system handle in the current procedure that contains a valid HANDLE, WIDGET-HANDLE, or COM-HANDLE value.
attribute
The name of an attribute of the specified widget or the name of a property of a specified com object.
widget-name
The name of a static widget defined in the current procedure.
[
IN FRAME
frame-name ]Specifies the name of the frame (frame-name) that contains the specified field-level widget. If you do not specify this option, the widget in the most recently defined frame is used.
{
FRAME
|MENU
|SUB-MENU
|MENU-ITEM
}widget-name
Specifies the type of widget for a frame, menu, submenu, or menu item widget (respectively) whose attribute you want to assign. If you do not specify a widget type for these widgets, the Debugger reports an error in the data panel. Note that you do not use a widget type to specify a field-level widget.
[
IN
{MENU
|SUB-MENU
} menu-name]
Specifies the name of the menu or submenu (menu-name) that contains the specified submenu or menu item widget. If you do not specify this option, the widget from the most recently defined menu or from the first submenu of the menu tree is used.
NOTES
- If no prior transaction is active, an ASSIGN command starts and ends a custom transaction for itself exactly like the following transaction block:
- If you are assigning to a database field, name can specify any field in an accessible record buffer, whether or not the current procedure references the field.
- If name is a database field that has ASSIGN triggers defined for it, those ASSIGN triggers execute; if the table to which this field belongs has WRITE triggers, the WRITE triggers execute according to the current transaction.
- If any database trigger fires with breakpoints set in it, the Debugger receives control first at each breakpoint and once more after all triggers have completed.
- You cannot assign values to schema fields.
- To modify data objects accessible to a particular active procedure, use the UP or DOWN command to give it focus as the current procedure in the Debugger context.
- You can assign a value to an attribute at any stopping point in the current procedure as long as the attribute is writable from the 4GL at that point.
- You cannot reference more than one com object property name or COM-HANDLE value in a single ASSIGN command.
SEE ALSO
DISPLAY Command, LIST BUFFERS Command, LIST PARAMETERS Command,LIST VARIABLES Command, SHOW TRANSACTION Command
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |