Release 10.1A: OpenEdge Getting Started:
New and Revised Features

> ## Progress 4GL reference

> This section provides a summary of new and modified Progress 4GL reference entries for Release 10.1A organized within the following categories:

> - Auditing

> - Database

> - Diagnostics

> - DOM and SAX

> - Miscellaneous

> - Object-oriented extensions

> - ProDataSet (general enhancements)

> - ProDataSet and temporary table (reading from and writing to XML)

> - ProDataSet and temporary table parameters

> - Web Services Out

> The following section provides a list of deprecated Progress 4GL language elements:

> - Deprecated language elements

> ##### Auditing

> The following new and modified reference entries provide support for application auditing and user authorization auditing:

> - Statements:

> - CREATE CLIENT-PRINCIPAL statement
> - Functions:

> - AUDIT-ENABLED function
> - GENERATE-UUID function
> - GUID function
> - HEX-DECODE function
> - HEX-ENCODE function
> - SET-DB-CLIENT function
> - SETUSERID function
> - Handles:

> - AUDIT-CONTROL system handle
> - AUDIT-POLICY system handle
> - Client-principal object handle
> - SECURITY-POLICY system handle
> - Attributes:

> - APPL-CONTEXT-ID attribute
> - AUDIT-EVENT-CONTEXT attribute
> - CLIENT-TTY attribute
> - CLIENT-WORKSTATION attribute
> - DOMAIN-DESCRIPTION attribute
> - DOMAIN-NAME attribute
> - DOMAIN-TYPE attribute
> - EVENT-GROUP-ID attribute
> - LOGIN-EXPIRATION-TIMESTAMP attribute
> - LOGIN-HOST attribute
> - LOGIN-STATE attribute
> - ROLES attribute
> - SEAL-TIMESTAMP attribute
> - SESSION-ID attribute
> - STATE-DETAIL attribute
> - USER-ID attribute
> - Methods:

> - AUTHENTICATION-FAILED( ) method
> - BEGIN-EVENT-GROUP( ) method
> - CLEAR-APPL-CONTEXT( ) method
> - ENCRYPT-AUDIT-MAC-KEY( ) method
> - END-EVENT-GROUP( ) method
> - EXPORT-PRINCIPAL( ) method
> - GET-PROPERTY( ) method
> - IMPORT-PRINCIPAL( ) method
> - LIST-PROPERTY-NAMES( ) method
> - LOAD-DOMAINS( ) method
> - LOCK-REGISTRATION( ) method
> - LOG-AUDIT-EVENT( ) method
> - LOGOUT( ) method
> - REFRESH-AUDIT-POLICY( ) method
> - REGISTER-DOMAIN( ) method
> - SEAL( ) method
> - SET-APPL-CONTEXT( ) method
> - SET-CLIENT( ) method
> - SET-PROPERTY( ) method
> - VALIDATE-SEAL( ) method
> - Other:

> - &IF, &THEN, &ELSEIF, &ELSE, and &ENDIF preprocessor directives

> ##### Database

> The following modified reference entries provide enhanced database support:

> - New option to create a new instance of a database with a unique database identifier:

> - CREATE DATABASE statement (NEW-INSTANCE option)
> - Updated attribute on the SESSION system handle that allows you to add inactive indexes and new fields to an existing table online:

> - SCHEMA-CHANGE attribute
> - Update that allows the DBTYPE function to be evaluated at preprocessor time:

> - DBTYPE function
> - &IF, &THEN, &ELSEIF, &ELSE, and &ENDIF preprocessor directives

> ##### Diagnostics

> The following new and modified reference entries provide enhanced logging support:

> - New log entry type for classes:

> - LOG-ENTRY-TYPES attribute
> - New methods on the LOG-MANAGER system handle:

> - CLEAR-LOG( ) method
> - CLOSE-LOG( ) method
> - WRITE-MESSAGE( ) method

> ##### DOM and SAX

> The following new and modified reference entries provide enhanced DOM and SAX support:

> - Statements:

> - CREATE SAX-READER statement
> - CREATE SAX-WRITER statement
> - CREATE X-DOCUMENT statement
> - CREATE X-NODEREF statement
> - Handles:

> - SAX-attributes object handle
> - SAX-reader object handle
> - SAX-writer object handle
> - X-document object handle
> - X-noderef object handle
> - Attributes:

> - ENCODING attribute
> - FORMATTED attribute
> - FRAGMENT attribute
> - NONAMESPACE-SCHEMA-LOCATION attribute
> - SCHEMA-LOCATION attribute
> - STANDALONE attribute
> - STRICT attribute
> - VERSION attribute
> - WRITE-STATUS attribute
> - Methods:

> - ADD-SCHEMA-LOCATION( ) method
> - DECLARE-NAMESPACE( ) method
> - END-DOCUMENT( ) method
> - END-ELEMENT( ) method
> - INSERT-ATTRIBUTE( ) method
> - LOAD( ) method
> - RESET( ) method
> - SAVE( ) method
> - SET-OUTPUT-DESTINATION( ) method
> - START-DOCUMENT( ) method
> - START-ELEMENT( ) method
> - WRITE-CDATA( ) method
> - WRITE-CHARACTERS( ) method
> - WRITE-COMMENT( ) method
> - WRITE-DATA-ELEMENT( ) method
> - WRITE-EMPTY-ELEMENT( ) method
> - WRITE-ENTITY-REF( ) method
> - WRITE-EXTERNAL-DTD( ) method
> - WRITE-FRAGMENT( ) method
> - WRITE-PROCESSING-INSTRUCTION( ) method

> ##### Miscellaneous

> The following reference entries were also created or modified:

> - New WEB-CONTEXT system handle method for BLOB support in WebSpeed:

> - GET-BINARY-DATA( ) method
> - New WIDGET-ID attribute provides support for 3rd party GUI testing tools within the OpenEdge GUI client:

> - CREATE BROWSE statement
> - CREATE widget statement
> - DEFINE BROWSE statement
> - DEFINE BUTTON statement
> - DEFINE FRAME statement
> - DEFINE IMAGE statement
> - DEFINE RECTANGLE statement
> - FORM statement
> - Format phrase
> - Frame phrase
> - WIDGET-ID attribute (Windows GUI only)

> This new attribute applies to the following widgets:

> - BROWSE widget
> - BUTTON widget
> - COMBO-BOX widget
> - CONTROL-FRAME widget
> - DIALOG-BOX widget
> - EDITOR widget
> - FILL-IN widget
> - FRAME widget
> - IMAGE widget
> - RADIO-SET widget
> - RECTANGLE widget
> - SELECTION-LIST widget
> - SLIDER widget
> - TEXT widget
> - TOGGLE-BOX widget
> Note: To enable application-defined widget IDs in your OpenEdge GUI application, you must specify the Use Widget ID (`-usewidgetid`) startup parameter. For more information about this startup parameter, see OpenEdge Deployment: Startup Command and Parameter Reference .

> - Modified attribute that lets you specify how Progress interprets a quoted character value during assignment into the BUFFER-VALUE attribute for a character BUFFER-FIELD object:

> - LITERAL-QUESTION attribute
> Note: You can use the Literal Question (`-literalquestion`) startup parameter to change the default value of the LITERAL-QUESTION attribute to TRUE (which would otherwise be FALSE). For more information about this startup parameter, see OpenEdge Deployment: Startup Command and Parameter Reference .

> ##### Object-oriented extensions

> The following new and modified reference entries provide object-oriented programming support:

> - Statements:

> - CLASS statement
> - COMPILE statement
> - CONSTRUCTOR statement
> - DEFINE statements for defining instance data for a class:

> For defining variables:

> - DEFINE VARIABLE statement

> For defining objects:

> - DEFINE BUFFER statement
> - DEFINE DATASET statement
> - DEFINE DATA-SOURCE statement
> - DEFINE QUERY statement
> - DEFINE TEMP-TABLE statement

> For defining static GUI widgets:

> - DEFINE BROWSE statement
> - DEFINE BUTTON statement
> - DEFINE FRAME statement
> - DEFINE IMAGE statement
> - DEFINE MENU statement
> - DEFINE RECTANGLE statement
> - DEFINE STREAM statement
> - DEFINE SUB-MENU statement
> - DEFINE WORK-TABLE statement
> - DELETE OBJECT statement
> - DESTRUCTOR statement
> - DISPLAY statement
> - FUNCTION statement
> - INTERFACE statement
> - MESSAGE statement
> - METHOD statement
> - NEW statement
> - PUT statement
> - Functions:

> - CAST function
> - PROGRAM-NAME function
> - QUOTER function
> - STRING function
> - TYPE-OF function
> - VALID-OBJECT function
> - Handles:

> - Buffer object handle
> - COMPILER system handle
> - ProDataSet object handle
> - Query object handle
> - SESSION system handle
> - Attributes:

> - CLASS-TYPE attribute
> - FIRST-OBJECT attribute
> - LAST-OBJECT attribute
> - MULTI-COMPILE attribute
> - Methods:

> - SUPER( ) method
> - SET-CALLBACK( ) method
> - Built-in Progress classes:

> - Progress.Lang.Class class
> - Progress.Lang.Object class
> - Other:

> - Data types (includes new CLASS data type)
> - SUPER system reference
> - THIS-OBJECT system reference

> For more information about object-oriented programming with the Progress 4GL, see OpenEdge Getting Started: Object-oriented Programming .

> ##### ProDataSet (general enhancements)

> The following new and modified reference entries provide enhanced ProDataSet support:

> - Statements:

> - DEFINE DATA-SOURCE statement
> - Handles:

> - Buffer object handle
> - Data-source object handle
> - ProDataSet object handle
> - Query object handle
> - Temp-table object handle
> - Attributes:

> - ATTACHED-PAIRLIST attribute
> - DATA-SOURCE-COMPLETE-MAP attribute
> - FILL-MODE attribute (new REPLACE mode option)
> - FILL-WHERE-STRING attribute
> - KEYS attribute
> - NEXT-ROWID attribute
> - NUM-REFERENCES attribute
> - QUERY attribute
> - RESTART-ROWID attribute
> - Methods:

> - APPLY-CALLBACK( ) method
> - ATTACH-DATA-SOURCE( ) method
> - COPY-DATASET method
> - COPY-TEMP-TABLE method
> - FILL() method
> - GET-CALLBACK-PROC-CONTEXT( ) method
> - GET-CALLBACK-PROC-NAME( ) method
> - GET-CHANGES( ) method
> - MERGE-CHANGES( ) method
> - MERGE-ROW-CHANGES( ) method
> - SAVE-ROW-CHANGES( ) method
> - SET-CALLBACK-PROCEDURE( ) method
> - Events:

> - ROW-UPDATE event

> ##### ProDataSet and temporary table (reading from and writing to XML)

> The following new and modified reference entries provide information about reading and writing ProDataSet and temporary table data and schema to and from XML:

> - Statements:

> - DEFINE BUFFER statement
> - DEFINE DATASET statement
> - DEFINE TEMP-TABLE statement
> - Handles:

> - Buffer object handle
> - Data-relation object handle
> - ProDataSet object handle
> - Temp-table object handle
> - Attributes:

> - ENCODING attribute
> - NAMESPACE-PREFIX attribute
> - NAMESPACE-URI attribute
> - NESTED attribute
> - XML-DATA-TYPE attribute
> - XML-NODE-TYPE attribute
> - Methods:

> - ADD-RELATION( ) method
> - READ-XML( ) method
> - READ-XMLSCHEMA( ) method
> - SAVE( ) method
> - WRITE-XML( ) method
> - WRITE-XMLSCHEMA( ) method

> ##### ProDataSet and temporary table parameters

> The following new and modified reference entries provide information about passing ProDataSet and temporary table parameters to procedures, user-defined functions, and methods within classes by reference and by binding:

> - Statements:

> - DEFINE DATASET statement
> - DEFINE PARAMETER statement
> - DEFINE TEMP-TABLE statement
> - FUNCTION statement
> - RUN statement
> - Other:

> - Parameter definition syntax (Describes the syntax for defining parameters of a user-defined function or a method within a class.)
> - Parameter passing syntax (Describes the syntax for passing parameters to a procedure, a user-defined function, or a method within a class.)

> The following new and modified reference entries provide information about specifying the amount of schema information to marshal for temporary table parameters (as independent temporary tables or members of a ProDataSet object):

> - Attributes:

> - MIN-SCHEMA-MARSHAL attribute
> - NO-SCHEMA-MARSHAL attribute
> - SCHEMA-MARSHAL attribute
> Note: See also the new Temp-table Schema Marshal (`-ttmarshal`) startup parameter in OpenEdge Deployment: Startup Command and Parameter Reference .

> ##### Web Services Out

> The following modified reference entries provide enhanced Web Services support:

> - Updated method for true asynchronous networking support:

> - CONNECT( ) method (Web Service)

> ##### Deprecated language elements

> The following language elements are supported only for backward compatibility:

> - Statements:

> - CHOOSE statement
> - PUT SCREEN statement
> - SCROLL statement
> - Functions:

> - GATEWAYS function
> - GO-PENDING function
> - IS-ATTR-SPACE function
> - Other:

> - EDITING phrase in the PROMPT-FOR, SET, and UPDATE statements

> For more information, see:

> Manual: | OpenEdge Development: Progress 4GL Reference
> HTML online help: | 4GL Reference

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095