OD Create context dialog

version 1.5

OD Create context dialog (login_ID{; tableName{; 4DTableNum}}) Longint

Parameter	Type		Description
login_ID	Longint		Connection identifier
tableName	String		Name of the default Oracle Table
4DTableNum	Integer		Table number of the default 4D Table
Function result	Longint		Context Identifier or -1 if an error occurs

The OD Create context dialog function displays the Edit a Context dialog box. Using this dialog box, you can associate 4th Dimension fields, variables, or arrays with the columns in an Oracle table.

For information on using the Edit a Context dialog box to define a context, refer to the section Creating and Activating a Context.

login_ID must be a valid connection identifier. The connection identifier is used to determine which Oracle tables to display in the Table pop-up menu based on the tables you are authorized to use.

tableName specifies the Oracle table that should appear in the Oracle Table pop-up menu by default. This table is used as the default table for the OD ADD TO CONTEXT command if you do not explicitly name a table for that command. tableName must be in the user.table or table form.

4DTableNum specifies the table number of the 4th Dimension table that should appear in the 4th Dimension Table pop-up menu by default.

If the user clicks OK in the dialog box, OD Create context dialog returns a context identifier that you will use when you activate the context by calling OD Activate context. In addition, the OK system variable is set to 1. If the user clicks Cancel in the dialog box, OD Create context dialog returns 0. In addition, the OK system variable is set to 0.

If an error occurs, OD Create context dialog returns -1.

The following statement displays the Edit a Context dialog box:

   Context_ID:= OD Create context dialog (Login_ID)

OD Activate context, OD ADD TO CONTEXT, OD Create context, OD Get options.

If the user clicks OK in the dialog box, the OK system variable is set to 1. If the user clicks Cancel, the OK system variable is set to 0.