BnnCLSYN: Cleaning the SYNC file

Overview

Program BST05SYC clears information from the SYNC file.

The program is called by the batch utility BnnCLSYN. JCL for BnnCLSYN can be found in the BETAnn.CNTL (replace nn with the number of the Beta product).

When to run BnnCLSYN

Run batch utility BnnCLSYN in the following situations:

  • If you are instructed to do so by Beta Systems support
  • If the following error message prevents the restart of a subsystem:

    xxx9545E MASTER SUBSYSTEM IN USE

    For a description of this message, see BSA Messages and Codes.

Before you run BnnCLSYN

The MASTER SUBSYSTEM IN USE message is normal if another active started task or batch job has currently control of the BQL database. Before running BnnCLSYN, you must make absolutely sure that the message is not caused by an active started task or an active batch utility.

If no active STC or batch job is using the database, the MASTER SUBSYSTEM IN USE is likely to be caused by an obsolete entry in the SYNC file, left behind by an STC or batch job that was not terminated properly.

Note on sharing databases

The SYNC file contains an entry identifying the master subsystem. This entry is deleted by BnnCLSYN.

If you are sharing the BQL database (LST parameter BQL_SHARE_OPTION = ALL | SPOOL), the master subsystem must be the first subsystem to be started after BnnCLSYN has finished.

Please see the notes on keyword BQL_SHARE_OPTION.

Sample JCL

The JCL must specify DISP=OLD for DD SYNCFILE.

All started tasks and batch jobs using this database must be down when you run BnnCLSYN.

+-----------------------------------------------------------------------+
|jobcard |
|//CLSYN EXEC PGM=BST05SYC |
|//STEPLIB DD DISP=SHR, |
|// DSN=BSA.LOAD |
|//SYNCFILE DD DISP=OLD, |
|// DSN=hlq.SYNC |
|//SYSUDUMP DD SYSOUT=* |
+-----------------------------------------------------------------------+

Return codes

0

The program ended normally. The SYNC file has been cleared.

16

The program ended normally. The SYNC file was empty or the specified file is not a SYNC file.

20

Read error

25

Write error

32

DD card missing or open error

36

Wrong disposition (DISP=OLD required for DD SYNCFILE)