ObjectLockListEntry (JTOpen 20.0.7 API)

java.lang.Object
- com.ibm.as400.access.ObjectLockListEntry

```
public class ObjectLockListEntry
extends Object
```
Represents a single IBM i lock placed on an ObjectDescription.
Each entry corresponds to an entry from the List Object Locks (QWCLOBJL) API.
Instances of this class are created by the ObjectDescription.getObjectLockList() method.

Field Summary

Fields
Modifier and Type	Field	Description
`static String`	`JOB_NAME_LOCK_SPACE`	Job name lock space.
`static String`	`JOB_NAME_MACHINE`	Job name machine process.
`static int`	`LOCK_SCOPE_JOB`	Lock scope - indicates lock has job scope.
`static int`	`LOCK_SCOPE_LOCK_SPACE`	Lock scope - indicates lock has lock space scope.
`static int`	`LOCK_SCOPE_THREAD`	Lock scope - indicates lock has thread scope.
`static int`	`LOCK_SHARE_FILE_NOT_SHARED`	Lock share - the file is not shared, the file is a physical file, or the field is not applicable to object type.
`static int`	`LOCK_SHARE_FILE_SHARED`	Lock share - the file is shared.
`static String`	`LOCK_STATE_EXCLUSIVE_ALLOW_READ`	Lock state for the lock request.
`static String`	`LOCK_STATE_EXCLUSIVE_NO_READ`	Lock state for the lock request.
`static String`	`LOCK_STATE_NONE`	Lock state for the lock request.
`static String`	`LOCK_STATE_SHARED_NO_UPDATE`	Lock state for the lock request.
`static String`	`LOCK_STATE_SHARED_READ`	Lock state for the lock request.
`static String`	`LOCK_STATE_SHARED_UPDATE`	Lock state for the lock request.
`static int`	`LOCK_STATUS_JOB_THREAD_WAITING_SYNC`	Lock status - the job or thread is waiting for the lock (synchronous).
`static int`	`LOCK_STATUS_LOCK_HELD`	Lock status - the lock is currently held by the job or thread.
`static int`	`LOCK_STATUS_LOCK_REQUEST_OUTSTANDING_ASYNC`	Lock status - the job or thread has a lock request outstanding for the object (asynchronous).
`static int`	`LOCK_TYPE_ACCESS_PATH`	Lock type - lock on the access path used to access a member's data
`static int`	`LOCK_TYPE_DATA_WITHIN_MEMBER`	Lock type - lock on the actual data within the member.
`static int`	`LOCK_TYPE_MEMBER_CONTROL_BLOCK`	Lock type - lock on the member control block.
`static int`	`LOCK_TYPE_OBJECT`	Lock type - lock on the object
`static String`	`VALUE_CANNOT_BE_DETERMINED`	Special value indicating that the system was unable to determine a value.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`String`	`getJobName()`	Returns the simple job name of the job that issued the lock request.
`String`	`getJobNumber()`	The system-assigned job number of the job that issued the lock request.
`String`	`getJobUserName()`	The user name under which the job that issued the lock request is run.
`int`	`getLockScope()`	Returns the value indicating the lock scope.
`String`	`getLockState()`	Returns the value indicating the lock state.
`int`	`getLockStatus()`	Returns the value indicating the lock status.
`int`	`getLockType()`	Returns the value indicating the lock type.
`int`	`getShare()`	Share.
`long`	`getThreadID()`	The identifier of the thread that is holding a thread-scoped lock or waiting for a lock.
`String`	`toString()`	Returns a string representation of this object lock

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - LOCK_SCOPE_JOB
```
public static final int LOCK_SCOPE_JOB
```
    Lock scope - indicates lock has job scope.
    
    See Also:
    
    Constant Field Values
  - LOCK_SCOPE_THREAD
```
public static final int LOCK_SCOPE_THREAD
```
    Lock scope - indicates lock has thread scope.
    
    See Also:
    
    Constant Field Values
  - LOCK_SCOPE_LOCK_SPACE
```
public static final int LOCK_SCOPE_LOCK_SPACE
```
    Lock scope - indicates lock has lock space scope.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATE_NONE
```
public static final String LOCK_STATE_NONE
```
    Lock state for the lock request. Indicates no locks exist.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATE_SHARED_READ
```
public static final String LOCK_STATE_SHARED_READ
```
    Lock state for the lock request. Indicates lock is shared for read.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATE_SHARED_UPDATE
```
public static final String LOCK_STATE_SHARED_UPDATE
```
    Lock state for the lock request. Indicates lock is shared for update.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATE_SHARED_NO_UPDATE
```
public static final String LOCK_STATE_SHARED_NO_UPDATE
```
    Lock state for the lock request. Indicates lock is shared for no update.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATE_EXCLUSIVE_ALLOW_READ
```
public static final String LOCK_STATE_EXCLUSIVE_ALLOW_READ
```
    Lock state for the lock request. Indicates exclusive lock which allows read.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATE_EXCLUSIVE_NO_READ
```
public static final String LOCK_STATE_EXCLUSIVE_NO_READ
```
    Lock state for the lock request. Indicates exclusive lock with no read.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATUS_LOCK_HELD
```
public static final int LOCK_STATUS_LOCK_HELD
```
    Lock status - the lock is currently held by the job or thread.
    
    See Also:
    
    Constant Field Values
  - LOCK_STATUS_JOB_THREAD_WAITING_SYNC
```
public static final int LOCK_STATUS_JOB_THREAD_WAITING_SYNC
```
    Lock status - the job or thread is waiting for the lock (synchronous).
    
    See Also:
    
    Constant Field Values
  - LOCK_STATUS_LOCK_REQUEST_OUTSTANDING_ASYNC
```
public static final int LOCK_STATUS_LOCK_REQUEST_OUTSTANDING_ASYNC
```
    Lock status - the job or thread has a lock request outstanding for the object (asynchronous).
    
    See Also:
    
    Constant Field Values
  - LOCK_TYPE_OBJECT
```
public static final int LOCK_TYPE_OBJECT
```
    Lock type - lock on the object
    
    See Also:
    
    Constant Field Values
  - LOCK_TYPE_MEMBER_CONTROL_BLOCK
```
public static final int LOCK_TYPE_MEMBER_CONTROL_BLOCK
```
    Lock type - lock on the member control block.
    
    See Also:
    
    Constant Field Values
  - LOCK_TYPE_ACCESS_PATH
```
public static final int LOCK_TYPE_ACCESS_PATH
```
    Lock type - lock on the access path used to access a member's data
    
    See Also:
    
    Constant Field Values
  - LOCK_TYPE_DATA_WITHIN_MEMBER
```
public static final int LOCK_TYPE_DATA_WITHIN_MEMBER
```
    Lock type - lock on the actual data within the member.
    
    See Also:
    
    Constant Field Values
  - LOCK_SHARE_FILE_NOT_SHARED
```
public static final int LOCK_SHARE_FILE_NOT_SHARED
```
    Lock share - the file is not shared, the file is a physical file, or the field is not applicable to object type.
    
    See Also:
    
    Constant Field Values
  - LOCK_SHARE_FILE_SHARED
```
public static final int LOCK_SHARE_FILE_SHARED
```
    Lock share - the file is shared.
    
    See Also:
    
    Constant Field Values
  - JOB_NAME_MACHINE
```
public static final String JOB_NAME_MACHINE
```
    Job name machine process. The job holding the lock is an internal machine process.
    
    See Also:
    
    Constant Field Values
  - JOB_NAME_LOCK_SPACE
```
public static final String JOB_NAME_LOCK_SPACE
```
    Job name lock space. The lock is attached to a lock space.
    
    See Also:
    
    Constant Field Values
  - VALUE_CANNOT_BE_DETERMINED
```
public static final String VALUE_CANNOT_BE_DETERMINED
```
    Special value indicating that the system was unable to determine a value.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getJobName
```
public String getJobName()
```
    Returns the simple job name of the job that issued the lock request.
    Returns:
    the job name. The following special values may be returned:
    
    JOB_NAME_MACHINE - The lock is held by an internal machine process. If this value is returned, the job number and job user name will be blank.
    JOB_NAME_LOCK_SPACE - The lock is attached to a lock space. If this value is returned, the job number and job user name will be blank.
    VALUE_CANNOT_BE_DETERMINED - The job name cannot be determined.
  - getJobUserName
```
public String getJobUserName()
```
    The user name under which the job that issued the lock request is run. The user name is the same as the user profile name and can come from several different sources depending on the type of job.
    Returns:
    the job user name. The following special value may be returned:
    
    VALUE_CANNOT_BE_DETERMINED - The job user name cannot be determined.
  - getJobNumber
```
public String getJobNumber()
```
    The system-assigned job number of the job that issued the lock request.
    Returns:
    the job number. The following special value may be returned:
    
    VALUE_CANNOT_BE_DETERMINED - The job number cannot be determined.
  - getLockState
```
public String getLockState()
```
    Returns the value indicating the lock state.
    Returns:
    lock state. Possible values:
    
    LOCK_STATE_NONE - Indicates no locks exist.
    LOCK_STATE_SHARED_READ - Indicates lock is shared for read.
    LOCK_STATE_SHARED_UPDATE - Indicates lock is shared for update.
    LOCK_STATE_SHARED_NO_UPDATE - Indicates lock is shared for no update.
    LOCK_STATE_EXCLUSIVE_ALLOW_READ - Indicates exclusive lock which allows read.
    LOCK_STATE_EXCLUSIVE_NO_READ - Indicates exclusive lock with no read.
  - getLockStatus
```
public int getLockStatus()
```
    Returns the value indicating the lock status.
    Returns:
    lock status. Possible values:
    
    LOCK_STATUS_LOCK_HELD - The lock is currently held by the job or thread.
    LOCK_STATUS_JOB_THREAD_WAITING_SYNC - The job or thread is waiting for the lock (synchronous).
    LOCK_STATUS_LOCK_REQUEST_OUTSTANDING_ASYNC - The job or thread has a lock request outstanding for the object (asynchronous).
  - getLockType
```
public int getLockType()
```
    Returns the value indicating the lock type.
    Returns:
    lock type. Possible values:
    
    LOCK_TYPE_OBJECT - Lock on the object
    LOCK_TYPE_MEMBER_CONTROL_BLOCK - Lock on the member control block.
    LOCK_TYPE_ACCESS_PATH - Lock on the access path used to access a member's data
    LOCK_TYPE_DATA_WITHIN_MEMBER - Lock on the actual data within the member.
  - getShare
```
public int getShare()
```
    Share. Whether shared file member locks are associated with the file member.
    Returns:
    lock share. Possible values:
    
    LOCK_SHARE_FILE_NOT_SHARED - The file is not shared, the file is a physical file, or the field is not applicable to object type.
    LOCK_SHARE_FILE_SHARED - The file is shared.
  - getLockScope
```
public int getLockScope()
```
    Returns the value indicating the lock scope.
    Returns:
    lock scope. Possible values:
    
    LOCK_SCOPE_JOB - Lock has job scope.
    LOCK_SCOPE_THREAD - Lock has thread scope.
    LOCK_SCOPE_LOCK_SPACE - Lock has lock space scope
  - getThreadID
```
public long getThreadID()
```
    The identifier of the thread that is holding a thread-scoped lock or waiting for a lock.
    
    Returns:
    
    a long representing the thread identifier. For locks that do not have a lock scope of LOCK_SCOPE_THREAD, this value is not meaningful and will likely be zero.
  - toString
```
public String toString()
```
    Returns a string representation of this object lock
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    a string representing the lock by [job name/job user name/job number/thread ID]

Class ObjectLockListEntry

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LOCK_SCOPE_JOB

LOCK_SCOPE_THREAD

LOCK_SCOPE_LOCK_SPACE

LOCK_STATE_NONE

LOCK_STATE_SHARED_READ

LOCK_STATE_SHARED_UPDATE

LOCK_STATE_SHARED_NO_UPDATE

LOCK_STATE_EXCLUSIVE_ALLOW_READ

LOCK_STATE_EXCLUSIVE_NO_READ

LOCK_STATUS_LOCK_HELD

LOCK_STATUS_JOB_THREAD_WAITING_SYNC

LOCK_STATUS_LOCK_REQUEST_OUTSTANDING_ASYNC

LOCK_TYPE_OBJECT

LOCK_TYPE_MEMBER_CONTROL_BLOCK

LOCK_TYPE_ACCESS_PATH

LOCK_TYPE_DATA_WITHIN_MEMBER

LOCK_SHARE_FILE_NOT_SHARED

LOCK_SHARE_FILE_SHARED

JOB_NAME_MACHINE

JOB_NAME_LOCK_SPACE

VALUE_CANNOT_BE_DETERMINED

Method Detail

getJobName

getJobUserName

getJobNumber

getLockState

getLockStatus

getLockType

getShare

getLockScope

getThreadID

toString