Functionality
INCLUDE NBAPI_ISH
It locks a specific case to prevent further processing. This lockremains active until explicit unlocking. This prevents a case frombeing processed by several users at the same time.
This is only necessary if you call several BAPIs that write (change orcreate) data in direct succession for the object PatientCase or forother case-related objects (CaseService, CaseDiagnosis, for example).Only such a lock prevents another user from accessing the data inbetween. If you set set a lock using BAPI_PATCASE_ENQUEUE, youmust cancel this lock using BAPI_PATCASE_DEQUEUE after youractions have been executed.
If you use internal number assignment when creating a new case, it isnot necessary to call BAPI_PATCASE_ENQUEUE (since thePATCASEID to be locked is not known). However, calling theseobjects in this situation has no negative consequences. If aPATCASEID is not included in the data passed to the method, nodata is locked.

Example
You want to create a case using exrternal number assignment. Thecorrect call sequence is as follows:
RESET N1
BAPI_PATCASE_ENQUEUE
BAPI_PATCASE_ADDINPATADMISS
BAPI_TRANSACTION_COMMIT (with parameter WAIT = ' ')
BAPI_PATCASE_DEQUEUE

Notes
INCLUDE NBAPI_PRECOND_AUTHORITY
N_FALL_FNR.
INCLUDE BAPI_RET
INCLUDE NBAPI_WORST_RETURNED_MSGTY
INCLUDE NBAPI_INSTITUTION OBJECT DOKU ID TX
INCLUDE NBAPI_PATCASEID OBJECT DOKU ID TX

Description
Errors that occur are returned in this table.

Value range
The following error messages can occur:

• N1016:,,Patient locked by
(re-try later).

• N1017:,,Patient could not be
locked

• MC600:,,System error occurred during lock management


• MC603:,,Lock table overflow