-ALL
Specifies a display of all current LOCKs in all regions and information about the state of processes owning these LOCKs. The -ALL qualifier is compatible with all other qualifiers. When -ALL is combined with -PID or -REGION the other qualifier prevails. SHOW -ALL and -WAIT displays both -ALL and -WAIT information.
-LOCK=resource_name
Allows you to specify a single lock. This provides a precise way to examine specific locks. The resource_name is enclosed in double quotations. Because M resource_names are formatted the same as global nodes with punctuation characters, in this context they are usually enclosed in sets of double quotations with string subscripts enclosed in sets of two double quotations.
show -lock="^a"(""b"")"
This command shows lock ^a("b") in the default region.
-[NO]C[RIT]
Allows LKE SHOW to work even if another process is holding a critical section. Use this qualifier only when normal operation is unsuccessful, as NOCRIT may cause LKE to report incomplete or inconsistent information.
-O[UTPUT]="file-name"
Directs the reporting of the current LOCKs. When you specify an existing file, LKE overwrites that file.
The -OUTPUT qualifier is compatible with all other qualifiers.
By default, SHOW directs all messages to stdout.
-P[ID]=process-identification
Displays all LOCKs owned by the specified process identification number (PID).
The -PID qualifier is compatible with all other qualifiers.
By default, SHOW displays the LOCKs for all PIDs.
-R[EGION]=region-name
Displays LOCKs for the specified region.
The emphasis>-REGION qualifier is compatible with all other qualifiers.
By default, SHOW displays the LOCKs for all regions.
-W[AIT]
Displays the LOCK resource name and the process state information of all processes waiting for the LOCK to be granted. SHOW -WAIT does not display the owner of the LOCK. SHOW -ALL -WAIT displays both -ALL and -WAIT information.
When a process abandons a "wait" request, that request may continue to appear in LKE SHOW -WAIT displays. This appearance is harmless, and is automatically eliminated if the GT.M lock management requires the space which it occupies.
Use the following procedure to display all LOCKs active in the database(s) defined by the current Global Directory. For information on displaying specific LOCKs, refer to the section on the SHOW command and its qualifiers.
LKE> SHOW -ALL -WAIT
Information similar to the following displays:
No locks were found in DEFAULT
AREG
^a Owned by PID= 2080 which is an existing process
BREG
^b(2) Owned by PID= 2089 a nonexistent process
Request PID= 20400630 which is HIB
No locks were found in CREG
SHOW displays the region and resource name of the LOCK as well as the process identification number (PID) and status of the process that holds the LOCK. LKE examines all REGIONs listed in the Global Directory.
If there are no LOCKs in a particular REGION, LKE displays an informational message.