Kontakt

Ansicht
Dokumentation

HRHAP_ENQUEUE_OBJECT - Lock HR Objects

HRHAP_ENQUEUE_OBJECT - Lock HR Objects

Vendor Master (General Section)   CPI1466 during Backup  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This module realizes lock management in HR. It enables you to lock entire objects.

Objects that do not belong to Personnel Planning directly can only be locked using this module if the key is an eight-digit numeric key. If the object does not fulfill this prerequisite, the exception ILLEGAL_OTYPE is generated.

Such objects are first locked in Personnel Planning and then in the application to which this object belongs.

The parameter ENQUEUE_ONCE allows you to control whether locks accumulate for a particular object (is cumulatively locked) or whether despite several lock requests the object is only locked and unlocked once.

Example

Locking a Personnel Planning object:

call function 'HR_ENQUEUE_OBJECT'

EXPORTING

plvar = object-plvar otype = object-otype objid = object-objid ENQUEUE_ONCE = ' '

IMPORTING

LOCK_USER = user_owning_the_object

EXCEPTIONS

ENQUEUE_FAILED = 1 OBJID_IS_INITIAL = 2 ILLEGAL_OTYPE = 3 INTERNAL_ERROR = 4 OTHERS = 5.

Locking a person:

call function 'HR_ENQUEUE_OBJECT'

EXPORTING

plvar = ' ' otype = 'P ' objid = act_pernr ENQUEUE_ONCE = ' '

IMPORTING

LOCK_USER = user_owning_the_object

EXCEPTIONS

ENQUEUE_FAILED = 1 OBJID_IS_INITIAL = 2 ILLEGAL_OTYPE = 3 INTERNAL_ERROR = 4 OTHERS = 5.

Notes

If the object is already locked, the exception ENQUEUE_FAILED is generated and the name of the user who has locked the object is returned in parameter LOCK_USER.

Further information

The module performs checks as follows:

  1. If ENQUEUE_ONCE = 'X', the module checks whether the object is already locked. If this is the case, the module is exited.
  2. Validity check for OBJID
  3. Check external object types for NUMC8 key, check whether relationship can be inversed
  4. Lock object in Personnel Planning
  5. If necessary, lock object in external application. If this is not possible, unlock object in Personnel Planning and generate an exception.




Parameters

ENQUEUE_ONCE
ENQ_COLLECT
ENQ_SCOPE
ENQ_WAIT
LOCK_USER
OBJID
OTYPE
PLVAR

Exceptions

ENQUEUE_FAILED
ILLEGAL_OTYPE
INTERNAL_ERROR
OBJID_IS_INITIAL

Function Group

HRHAP_C_A_GLOBAL

BAL_S_LOG - Application Log: Log header data   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Length: 2898 Date: 20240523 Time: 085631     sap01-206 ( 43 ms )