`Task: ScanLoadModule`

Description

This task matches source files to load modules and scans them to be able to refresh dependency metadata by using an already compiled version of an application.

Task dependency list

At least one of the following tasks need to be executed before a language task can execute.

FileAnalysis
FullAnalysis
ImpactAnalysis

Actions

Iterates through the SOURCE_LIST prepared by the analysis tasks and scans the load module constructed through the PDS file variable and the file name truncated to 8 characters.

Syntax

- task: ScanLoadModule
  comment: String # Message printed to stdout when the task begins executing.
  variables:
    - name: skipScan
      value: Boolean # A file variable that tells the task to skip files for load module scanning.
    - name: pds
      value: String # A file variable that tells the task which PDS to look for a load module in.
    - name: printScannedItems
      value: Boolean # True if scanned items should be printed to stdout.

Task variables

Required variables

Must be defined for the task to execute.

None

Optional variables

Only need to be defined to change default values.

`skipScan`

Type: Boolean
Default: false
A file variable that, when true, makes the ScanLoadModule task skip the load module scanning of files.

`pds`

Type: String
Default: null
A file variable that defines the PDS dataset that is searched to find a load module. The member name that is searched for is the name of the file truncated to 8 characters.

`printScannedItems`

Type: Boolean
Default: false
A basic variable that controls whether to print out the scanned files and PDS members. When it is set to true this data is output to stdout.

Build Context (advanced)

In addition to the task variables provided by users in the DBB YAML configuration files, some tasks require inputs and generate outputs to the zBuilder Build Context. The Build Context is a dynamic storage area passed into each task that is being executed by the zBuilder and is used for task-to-task communication.

Build Context inputs

Keyword	Type	Source	Description
`WORKSPACE`	String	zBuilder	Construction of file paths.
`SOURCE_LIST`	Set<String>	Analysis Tasks	Unfiltered list of source files to scan.
`LINK_EDIT_EXCLUDE_FILTER`	String	ScannerInit	List of program object patterns to exclude when scanning a load module for static link dependencies.

Build Context outputs

Keyword	Type	Description
`BUILD_LIST`	Set<String>	List of source files scanned by this task and the `Analysis` tasks.