Unused Processor Symbolic Overrides Utility

The BC1PSDEL utility lets you list and remove unused processor symbolic overrides. Symbolic overrides are identified as unused when the corresponding symbolic no longer exists in a processor.
ce17
The BC1PSDEL utility lets you list and remove unused processor symbolic overrides. Symbolic overrides are identified as unused when the corresponding symbolic no longer exists in a processor.
If you updated a processor and removed some symbolics from its PROC statement, the corresponding symbolic overrides that are defined for that processor would remain in the Master Control File. These are considered to be unused symbolic overrides, because the corresponding symbolic is removed from the processor for which the override existed.
If you later modify the processor to include the same symbolic, then the override becomes active again without the user awareness. This can cause unexpected behavior of the changed processor. Also, the API and the CSV utility report unused symbolic overrides, without identifying them as unused. To avoid these situations, use the BC1PSDEL utility to identify and remove any unused symbolic overrides. The utility cannot prevent symbolics from becoming unused; it can identify and remove them for you.
The BC1PSDEL utility scans all Master Control Files searching for unused symbolic overrides. It does not directly remove them, but does produce output with "DELETE PROCESSOR SYMBOL" SCL statements, which can be reviewed and passed to the Batch Environment Administration facility (ENBE1000) to be processed.
The utility identifies and classifies unused processor symbolic overrides as follows:
  • Regular unused symbolic overrides, which originate from a source change of the corresponding processor.
  • Irregular unused symbolic overrides, which are identified if the corresponding processor load module or load library does not exist or cannot be accessed. In this case, the utility treats all respective symbolic overrides as unused, because it cannot be determined if the corresponding symbolics exist in the processor load module.
List and Remove Unused Processor Symbolic Overrides
Run the JCL in member BC1JSDEL found in your iprfx.iqual.CSIQJCL library to list and remove any unused processor symbolic overrides. The JCL executes the BC1PSDEL utility to list the unused symbolic overrides, build SCL statements to remove them, and optionally execute the Batch Environment Administration facility (ENBE1000) to delete the unused overrides. The utility can be run on a scheduled basis or as necessary.
Follow these steps:
  1. Modify the BC1JSDEL JCL member as follows:
    1. Add a valid job card.
    2. Set the execution mode parameter. Choose one of the following:
    3. MODE =1
      • If the utility has been run before, this mode deletes previously created SCL data sets, before building new SCL data sets.
      • Executes the BC1PSDEL utility to build SCL data sets, but does
        not
        process them.
    4. MODE=2
      • If the utility has been run before, this mode deletes previously created SCL data sets, before building new SCL data sets.
      • Executes the BC1PSDEL utility to build SCL data sets.
      • Executes the Batch Environment Administration facility (ENBE1000) to process the SCL statements.
    5. MODE=3
      • Executes the Batch Environment Administration facility (ENBE1000) to process the SCL statements built in the previous execution of this job.
    6. Make sure that the DD statements refer to the correct SCL1 and SCL2 data sets.
  2. Run the BC1JSDEL JCL.
    The results depend on the mode you selected. Modes 1 and 2 identify the unused symbolic overrides and create SCL to delete them, but only Modes 2 and 3 delete the unused symbolic overrides.
    • MODE 1 or MODE 2
    If the job runs in MODE 1 or 2, the BC1PSDEL utility scans all Master Control Files for unused processor symbolic overrides and generates the following output.
    MODE 2 also executes the SCL statements, for details see section "MODE 2 or MODE 3".
    If the job runs in MODE 2 or 3, the Batch Environment Administration facility (ENBE1000) processes the "DELETE PROCESSOR SYMBOL" SCL statements generated by the BC1PSDEL utility and deletes the unused processor symbolic overrides from Master Control Files. By default, only SCL1 statements are executed. However, if you uncommented the SCL2 data set in the ENESCLIN DD statement, the SCL2 statements are executed also.
    If any regular unused symbolic overrides are deleted, the Batch Environment Administration facility (ENBE1000) finishes with RC=4 and the action log contains ENBE144W messages (ENBE144W Processor Symbol X has not been overridden or is not defined for Generate/Delete/Move processor ).  This outcome is correct because the Batch Environment Administration facility cannot see regular unused symbolic overrides; however, it does remove them.