The Acquire completion lock (CMPLCK) parameter determines whether to obtain an exclusive read (*EXCLRD) lock at the end of the copy process. This parameter is useful when the CPYACTF command is called from a program by allowing the calling program to take over processing at a point when it is guaranteed that there is no update activity on the file being copied
The default value *NO indicates that the CPYACTF processing will exit when all of the records of a file have been copied without obtaining any locks on the copied members. If a program called the command, the exit will occur even if the application that called the command is still active and still producing transactions. Any further transactions will be missed.
If *YES is specified, the CPYACTF process will attempt to gain an exclusive, allow-read lock on all members that were copied. If this is successful, the CPYACTF process will continue. Otherwise, the CPYACTF process enters a processing loop, attempting to gain the lock every 10 seconds. This will continue indefinitely until the lock is obtained. During this loop, the Work with Copy Status display shows *LOCKWT in the Process Action column.