Editing the project configuration file

Edit online

You can update the project configuration file to add or change the source code location or to modify other project details. The project configuration file, cuaz.config.json, can be edited directly in VS Code.

Some of the scenarios where you might need to update the project configuration file include:
  • You want to resolve compilation or runtime errors for programs on your local workstation and must add the mainframe to local source mapping.
  • You need to update location settings, such as copybook location, source code location, or listing location.
  • You entered incorrect information during the initial setup and must correct the values.
Note: If you make changes to the project configuration file after opening a load library, application, or invalid data detection scan, you must reopen the scan for the changes to take effect.
To open the project configuration file:
  1. Open the Command Palette in VS Code.
  2. Search for Edit project config file.
  3. Select to open the cuaz.config.json file for editing.

Project file schema overview

Global configuration
selectedProject
Name of the project currently open in the side panel.
zoweProfileType
Default Zowe profile used for mainframe connectivity.
sharedReportInputs
Shared input parameters required to run a CUAZ inventory or invalid data detection scan.
projects
Collection of all configured projects. Each project entry contains the settings listed under Project Configuration.
Project configuration
projectName
Name of the project.
cobolInstalledLoc
The data set location on the mainframe where COBOL compiler is installed.
listingMVSLoc
The data set location on the mainframe where listing outputs are stored.
sourceCodeMVSLoc
A list of mainframe data sets that contain the source code for the project.
copybookMVSLoc
A list of mainframe data sets that contain the copybook for the project.
localSourceMap
A mapping between mainframe source data set locations and local folder. The local directory path must be an absolute path. When defined, every time CUAZ opens a source code file, it will by default open the one in the local folder.
localCopybookMap
A mapping between mainframe copybook data set location andlocal folder. The local folder path must be an absolute path. When defined, every time CUAZ opens a source copybook, it will by default open the one in the local folder.
ProjectScanInputs
Additional input parameters for running the CUAZ inventory or invalid data detection scan for this project. When combined with sharedReportInputs, these parameters provide the complete set of required inputs.
sourceCompiledStandard
Indicates the COBOL standard used when the source code was originally compiled. Supported values: Unknown (default), COBOL_74, COBOL_85.

Sample project configuration file

{
    "selectedProject": "AMORT",
    "zoweProfileType": "zosmf",
    "projects": [
        {
            "projectName": "AMORT",
            "cobolInstalledLoc": "TSCTEST.G.COBOL.IGY.V6R5M0.WEEKLY.SIGYCOMP",
            "listingMVSLoc": "USERID.AMORT4.LIST",
            "sourceCodeMVSLoc": [
                "USERID.AMORT4.COBOL"
            ],
            "copybookMVSLoc": [
                "USERID.AMORT4.COPY"
            ],
            "localSourceMap": {
                "USERID.AMORT4.COBOL": "c:\\workspace\\mort_demo\\cobol"
            },
            "sourceCompiledStandard": "Unknown",
            "localCopybookMap": {
                "USERID.AMORT4.COPY": "C:\\workspace\\mort_demo\\copybook"
            },
            "ProjectScanInputs": {
                "LoadModulePaths": [
                    "USERID.AMORT4.LOAD",
                    "USERID.AMORT4.LOAD2"
                ],
                "RunJCLPath": "USERID.AMORT4.JCL(RUNCOB6)",
                "RunProgName": "MORTGAGE",
                "RunProcName": "N",
                "MinUpgradeVersion": "minimal_version5.2later",
                "UpgradeTargetVersion": "target_version6.5",
                "OutputReportName": "NEW"
            }
        },
        {
            "projectName": "APP02",
            "cobolInstalledLoc": "TSCTEST.IGY.V6R4M0.SIGYCOMP",
            "listingMVSLoc": "USERID.TEST.DEMO.OUTPUT.LIST",
            "sourceCodeMVSLoc": [
                "USERID.TEST.DEMO.CBLSRC"
            ],
            "copybookMVSLoc": [
                "USERID.TEST.DEMO.COPY"
            ],
            "localSourceMap": {
                ".TEST.DEMO.CBLSRC": "c:\\workspace\\tmp\\demo\\cblsrc"
            },
            "sourceCompiledStandard": "Unknown",
            "localCopybookMap": {},
            "ProjectScanInputs": {
                "LoadModulePaths": [
                    "USERID.TEST.DEMO.LOAD",
                    "USERID.TEST.DEMO.LOAD2",
                    "USERID.TEST.DEMO.PDS.LOAD"
                ],
                "RunJCLPath": "USERID.TEST.DEMO.JCL(RUN64J)",
                "RunProgName": "ATMCF000",
                "RunProcName": "N",
                "MinUpgradeVersion": "minimal_version5.2later",
                "UpgradeTargetVersion": "target_version6.5",
                "OutputReportName": "NEW"
            }
        }
    ],
    "sharedReportInputs": {
        "CUAPath": "TSCTEST.G.CUADEV.B64.LOAD.GOOD",
        "OutputPath": "USERID.AMORT4.OUTPUT.JSON",
        "PythonBinPath": "/var/lpp/IBM/cyp/v3r14/pyz/bin/python3",
        "PythonProgPath": "/u/isabell/CUAZReportGenerator.py",
        "LauncherPath": "USERID.TEST.DEMO.JCL",
        "SysprofdPath": "USERID.TEST.DEMO.SYSPROFD",
        "RuntimeMsgPath": "USERID.AMORT4.OUTPUT.RUNMSG",
        "HLQ": "USERID",
        "JobName": "USERID"
    }
}