TMF Application Programmer's Guide (G06.26+)

TMF Programming Environment
HP NonStop TMF Application Programmer’s Guide—522419-005
1-16
Enscribe Capabilities
an error 73 (file/record is locked). If a record with the same primary-key value already
exists, the WRITE request is rejected with a condition code of CCL and an error 10
(file/record already exists).
The Inserted Record Problem
The use of REPEATABLE ACCESS with NonStop SQL/MP objects prevents other
transactions from updating, deleting, or inserting anything within the entire range of
rows accessed by a transaction.
Because this protection applies to a range of rows rather than to specific existing rows,
NonStop SQL/MP has in effect also locked the available (but not yet used) slots
Table 1-1. Enscribe Locking Modes
Mode param1 Description
Normal mode 0 Any attempt to lock a file, or to read or lock a record, that is
already locked through a different transaction identifier is
suspended until the existing lock is released. This is the default
locking mode.
Reject mode 1 Any attempt to lock a file, or to read or lock a record, that is
already locked through a different transaction identifier is
rejected with a file system error 73 (file/record is locked); no data
is returned.
Read-through/
normal mode
2 READ and READUPDATE requests ignore existing record and
file locks; encountering a lock does not delay or prevent reading
the record.
LOCKFILE, LOCKREC, READLOCK, and READUPDATELOCK
are treated as in normal mode.
Read-through/
reject mode
3 READ and READUPDATE requests ignore existing record and
file locks; encountering a lock does not delay or prevent reading
the record.
LOCKFILE, LOCKREC, READLOCK, and READUPDATELOCK
are treated as in reject mode.
Read-warn/
normal mode
6 READ and READUPDATE requests ignore existing record and
file locks; although an existing lock will not delay or prevent
reading the record, it will cause a CCG completion code with a
warning code of 9.
LOCKFILE, LOCKREC, READLOCK, and READUPDATELOCK
are treated as in normal mode.
Read-warn/
reject mode
7 READ and READUPDATE requests ignore existing record and
file locks; although an existing lock will not delay or prevent
reading the record, it will cause a CCG completion code with a
warning code of 9.
LOCKFILE, LOCKREC, READLOCK, and READUPDATELOCK
are treated as in reject mode.