DBSession Attribute
Data Type: DBSessionObject
4GL Access: RW
The DBSession attribute specifies the current database session of a frame, procedure, or method.
For an application's starting component, this attribute is set to the session opened by the application. If the application does not open a session, then the value of DBSession is null. For subsequent frames and procedures in the application, the initial value for DBSession defaults to the value of the calling frame, procedure, or method.
You can set the DBSession attribute for a frame or procedure at any time. To set the initial value of DBSession for a frame, use the with clause in a callframe, openframe, or gotoframe statement, or set it in the frame's initialize statement. For 4GL procedures, set it in the procedure. OpenROAD also sets the database session to that of the parent frame, even if you also specify that database session in the with clause.
For more information about using this attribute, see the Programming Guide.
Note: If a called frame or procedure changes the value for DBSession, this change does not affect the value of DBSession in the calling frame, procedure, or method.