BST05LAU: Locking and unlocking a BQL database

Overview

Program BST05LAU is used to lock and to unlock a BQL database.

Lock the BQL database when you want to stop all access to the database, but do not want to stop the started task. Unlock the database to make it available again.

This feature is useful, for example, when backing up a database using the concurrent copy function. Locking the database while the concurrent copy environment is initialized ensures the consistency of the database copy.

Caution

Depending on the product, locking the database may not be enough to ensure the consistency of the database backup. Special conditions may apply and additional steps may be necessary. Always refer to the product documentation first before using the concurrent copy function.

Syntax Parm parameter

SSID=ssid,STAT=LOCK | UNLOCK

where ssid is the subsystem ID that the LOCK or UNLOCK applies to.

Sample JCL

+---------------------------------------------------------------------+
|//BST05LAU JOB BETA,MSGCLASS=P,CLASS=A,NOTIFY=&SYSUID |
|//BST05LAU EXEC PGM=BST05LAU,REGION=0M, |
|// PARM='SSID=ssid,STAT=LOCK' |
|//* |
|//STEPLIB DD DISP=SHR, |
|// DSN=BETA.APFLOAD <=== BSA APF LIBRARY |
|// DD DISP=SHR, |
|// DSN=BSA.LOAD <=== BSA LOAD LIBRARY |
|// |
+---------------------------------------------------------------------+

Note

BST05LAU requires SIGNON = YES, which is the default.