UNLOCK (Unlock a Data Area)

The UNLOCK function allows you to reverse the LOCK function, therefore allowing any updates waiting to process to complete. See LOCK (Lock a Data Area) for information about this function.
datacom
The UNLOCK function allows you to reverse the LOCK function, therefore allowing any updates waiting to process to complete. See LOCK (Lock a Data Area) for information about this function.
When to Use UNLOCK
Use the UNLOCK function to reverse a LOCK function.
This function communicates with one MUF. Be aware of the following:
  • Ensure that DBUTLTY is communicating with the desired MUF by executing DBUTLTY with the same System Identifier module (DBSIDPR) that is being used by the MUF
  • Ensure proper load library concatenation by keeping the System Identifier modules (DBSIDPR) in separate load libraries
If the z/OS Cross-System Coupling Facility (XCF) is being used, ensure that the TOGROUP DBSIDPR parameter is correctly defined.
How to Use UNLOCK
The MUF must be active when you execute this command. Use the following command format to issue an UNLOCK function:
►►─ UNLOCK OPTION=MOVER,DBID=
n
,AREA=
a
────────────────────────────────────────►◄
 
Command
 
  •  
    UNLOCK
    Invokes the function to reverse the LOCK function, therefore allowing any updates waiting to process to complete.
 
Required Keywords
 
  •  
    OPTION=MOVER
    Requests the option that inhibits movement of data records due to an update of a compressed data area.
  •  
    DBID=
    Identifies the database you want to unlock.
    •  
      Valid Entries:
      DATACOM-ID of the database
    •  
      Default Value:
      (No default)
  •  
    AREA=
    Identifies the area you want to unlock.
    •  
      Valid Entries:
      DATACOM-NAME of the area in the database specified
    •  
      Default Value:
      (No default)
Example JCL (UNLOCK)
The following shows the command to unlock a data area.
 Use the following as a guide to prepare your JCL. The JCL statements are for example only. Lowercase letters in a statement indicate a value you must supply. Code all statements to your site and installation standards.
//jobname
See the previous note and
.
// EXEC PGM=DBUTLTY,REGION=2M //STEPLIB
See the previous note and
.
//SYSIN DD * Command Input UNLOCK OPTION=MOVER,DBID=1,AREA=DEM /*
Sample Report
Following is a sample report page. For an example report header, see Sample Report Headers.
CONTROL CARD(S) .........1.........2.........3.........4.........5.........6.........7.........8 UNLOCK OPTION=MOVER,DBID=1,AREA=DEM FUNCTION=UNLOCK OPTION=MOVER DBID=1 AREA=DEM
This page of the report shows the following:
  • The command exactly as entered.
  • An analysis of keywords encountered and expected. Any errors found are flagged with a note in the left margin.
  • If there are any messages related to syntax processing, they are displayed following the analysis of keywords.
* REQUEST COMPLETE
This page of the report displays a message indicating that the UNLOCK completed successfully.