Struct Session 

pub struct Session<'w> {
    pub database: &'w mut dyn Database,
    pub pending: bool,
    /* private fields */
}

A run unit’s connection to its database, and the state the runtime keeps rather than asking the backend, so every backend answers alike.

Fields

database: &'w mut dyn Database

pending: bool

Whether any statement has reached the database since the last COMMIT or ROLLBACK.

Implementations

impl<'w> Session<'w>

pub fn new(database: &'w mut (dyn Database + '_)) -> Self

pub fn cursor(&mut self, program: &str, name: &str) -> Option<&mut OpenCursor>

pub fn opened( &mut self, program: &str, name: &str, with_hold: bool, statement: Option<&str>, )

pub fn prepared(&self, program: &str, name: &str) -> Option<&Prepared>

pub fn prepare( &mut self, program: &str, name: &str, statement: Option<Prepared>, )

pub fn running(&self, program: &str, name: &str) -> bool

Whether an open cursor of program runs the statement name, which PREPARE may not replace.

pub fn closed(&mut self, program: &str, name: &str)

pub fn committed(&mut self)

COMMIT closes every cursor not declared WITH HOLD, and leaves a held one before its next row. It destroys the unit of work’s prepared statements but those held cursors run, as KEEPDYNAMIC(NO) does.

pub fn rolled_back(&mut self)

pub fn settle(&mut self, program: &str, commit: bool) -> Answer

Ends a unit of work that no EXEC SQL statement ends: at SYNCPOINT, or at the end of a run unit or task. The database is asked only while it holds work or an open cursor, and the call names program with ordinal 0.

pub fn end_task(&mut self, program: &str, commit: bool) -> Answer

Ends a CICS task: settles its unit of work, then closes the held cursors a commit leaves open, as the end of a task closes every cursor.