guides:programming:programmers_reference_manual:unlock_method

UNLOCK Method

Method for unlocking an entity. The lock is associated with the workstation that issued the LOCK on the entity.

retval = Repository('UNLOCK', entID)

The UNLOCK method has the following parameters.

ParameterDescription
Message'UNLOCK'
entIDentID consists of four elements, which are '*' (asterisk) delimited:

* Application name
* Type ID
* Class ID
* Entity name

Methods are executed as follows: if class specific, execute at the class level; if type specific, execute at the type level; otherwise, execute the method.

Null, whether or not the UNLOCK is successful. If the entity is already unlocked, Get_Status() will return an error code.

Note: Always call the Get_Status function after calling Repository.

Repository() function, LOCK Method, Get_Repos_Entities(). Also, Stored Procedures chapter in the Guide to Application Development.

/* Unlock the CENTERWINDOW stored procedure in the repository. */

Declare Function Get_Repos_Entities, Repository, Get_Status

AppID = @APPID<1>  ;* current application

TypeID = "STPROC"  ;* OpenInsight stored procedures

ClassID = ""  ;* Not Applicable

Stored_Proc_Name = 'CENTERWINDOW'

entid = AppID : '*' : TypeID : '*' : ClassID : '*' : Stored_Proc_Name

result = Repository("UNLOCK", entid)

/*  CENTERWINDOW is now unlocked. The result field is null. */

If Get_Status(ErrCode) then

  call msg(@window, 'Error Message returned: ' : ErrCode)

end
  • guides/programming/programmers_reference_manual/unlock_method.txt
  • Last modified: 2024/06/19 20:20
  • by 127.0.0.1