CLEAR Qualifiers

CLEAR Qualifiers
Prev	Clear	Next

/ALL

Specifies the removal of all current LOCKs. If used with the /REGION qualifier, / ALL removes all LOCKs in the region. Issue a CLEAR / ALL only when there are no active GT.M processes using LOCKs, or when you can predict the effect on the application.

The /ALL qualifier is incompatible with the /INTERACTIVE qualifier.

/I[NTERACTIVE]

Clears one LOCK at a time interactively. LKE displays each current LOCK with the PID of the owner process and prompts for verification that the LOCK should be cleared. LKE retains the LOCK for any response other than Y[ES].

The /INTERACTIVE qualifier is incompatible with the /ALL qualifier.

By default, CLEAR operates interactively (/INTERACTIVE).

/L[OCK]=PID and region

Allows you to specify a single lock. The resource_name is enclosed in double quotation marks ("" ""). 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 quotation marks with string subscripts enclosed in sets of two double quotations.

            clear /lock="^a"(""b"")"

This command clears lock ^a("b") in the default region.

            clear /lock="^a" /nointeractive

This command clears lock ^a in the default region. The addition of the NOINTERACTIVE qualifier instructs LKE to clear the lock without further user intervention.

/[NO]C[RIT]

Allows LKE CLEAR to work even if another process is holding a critical section. This can damage current LOCKs and the LOCK mechanism. It is intended for use only under the direction of Fidelity.

/[NO]I[NTERACTIVE]

Forces the action to take place without user confirmation of each change. Using /NOINTERACTIVE prevents the LKE operator from controlling the LOCK subsystem for potentially long periods of time when many locks are held.

/O[UTPUT]=file-spec

Directs the reporting of all cleared LOCKs to a file. If you specify an existing file, LKE creates a new version of overwrites that file.

The /OUTPUT qualifier is compatible with all other qualifiers.

By default, CLEAR sends its messages to SYS$OUTPUT.

/P[ID]=process-id

Clears all LOCKs held by the process with the specified process identification number. LKE interprets the PID as a hexadecimal number. This command provides a means for directing CLEAR to LOCKs held by a process that is behaving abnormally. The /PID qualifier is compatible with all other qualifiers.

/R[EGION]=region-name

Clears LOCKs mapped by the current Global Directory to a region specified by the region-name.

The /REGION qualifier is compatible with all other qualifiers.

By default, CLEAR /REGION= operates interactively (/INTERACTIVE).

CLEAR Example

Use one of the following procedures to CLEAR (release or unlock) all LOCKs or a specific LOCK on the system.

To clear all LOCKs:

Invoke the M LOCK Utility (LKE).

        
                           $ LKE

Enter the CLEAR command with the /ALL option at the LKE> prompt.

            
                           LKE> CELAR /ALL

	Note
	Use CLEAR /ALL with caution.

To clear individual LOCKs in a specific region:

Invoke the M Lock Utility (LKE)

        
                           $ LKE

Enter the CLEAR command with the /REGION and /INTERACTIVE options at the LKE> prompt.

        
                        LKE> CLEAR/REG=AREG/INTERACTIVE

Information similar to the following displays:

            AREG
            ^a Owned by PID= 208350E3 which is CUR
            
            Clear lock ?

Type Yes or Y in response to the prompt.

LKE responds with an informational message:
```
        %GTM-S-LCKGONE, Lock removed : ^a
        
```
Repeat Step 3 until all LOCKs are displayed and acted upon.