This table contains information about the current contents of the value lock table. One row exists for each value lock in existence. A list of specific value locks is provided with the DBUTLTY function COMM OPTION=STATUS. Value locks are utilized by a MUF to protect a process that needs protection.
|
Column Name |
SQL Data Type |
Nullable |
Description |
|---|---|---|---|
|
DURATION
|
CHAR(6) |
No |
Contains the time the lock has been held in the format mmm:ss where mmm is minutes and ss is seconds. If the lock is a share, then the time is for the first task getting the share. The formatting is the same as the ACTIVE_TASKS and STATUS in that a value of less than one second is reflected as all blanks and a value of greater than 999:59 is reflected as +++:++. |
|
JOBNAME
|
CHAR(8) |
No |
Contains the job name owning this task. If a job name begins with three asterisks (***), it means that the value lock is owned by a system task. |
|
LOCK_LENGTH
|
SMALLINT |
No |
Contains the length of the lock in its internal form. A length of over 50 indicates the value has been truncated. This condition allows duplicates to not be provided. |
|
LOCK_TYPE
|
CHAR(9) |
No |
Contains the type of lock. It can be EXCLUSIVE or SHARE. |
|
LOCK_VALUE
|
CHAR(64) |
No |
Contains the value lock with limited formatting. Known values locked, that have binary or hexadecimal fields, are formatted in a useful way. Unknown values are formatted in another way with character and hexadecimal values provided. This formatted format is how the table must be queried, if all values are being acquired. Because of the truncation of the value, actual unique entries that are duplicated within the first externalized 64 bytes have only the first occurrence externalized (this condition is very unlikely). The formatting sets the first 6 bytes to be the first 6 bytes of the value lock, followed by a blank, and then match that done for the ACTIVE_TASKS conditions of waiting for a value lock. It is also the same format as that used for the console STATUS command and the DBUTLTY FUNCTION=COMM,OPTION=STATUS. |
|
MUF_NAME
|
CHAR(8) |
No |
Name of the MUF specified in the MUF Multi-User startup option or the MUF job name. |
|
TASK_NUMBER
|
SMALLINT |
No |
Contains the task number owning this value lock. Some internal locks are acquired and assigned to system tasks or are assigned to the primary task of the job. |
|
Copyright © 2014 CA.
All rights reserved.
|
|