@ibm/zapp-core 1.3.0 → 1.5.0

package/LICENSE.txt

@@ -3,7 +3,7 @@ LICENSE INFORMATION
 The Programs listed below are licensed under the following License Information terms and conditions in addition to the Program license terms previously agreed to by Client and IBM. If Client does not have previously agreed to license terms in effect for the Program, the International License Agreement for Non-Warranted Programs (i125-5589-06) applies.
 
 Program Name (Program Number):
-IBM Zapp Core Library V1.2 (Plug-in)
+IBM Zapp Core Library V1.5 (Plug-in)
 
 The following standard terms apply to Licensee's use of the Program.
 

package/NOTICES.txt

@@ -1,6 +1,6 @@
 NOTICES AND INFORMATION
 
-IBM Zapp Core Library V1.2
+IBM Zapp Core Library V1.5
 
 The IBM license agreement and any applicable information on the web
 download page for IBM products refers Licensee to this file for details
@@ -25,7 +25,7 @@ and all liability for errors and omissions or for any damages accruing
 from the use of this NOTICES file or its contents, including without
 limitation URLs or references to any third party websites.
 
-Start of Notices for IBM Zapp Core Library 1.2.1
+Start of Notices for IBM Zapp Core Library 1.5
 =====================================================================
 
 =====================================================================
@@ -663,7 +663,7 @@ For more information, please refer to <http://unlicense.org/>
 END OF UNLICENSE NOTICES AND INFORMATION
 =====================================================================
 
-End of Notices for IBM Zapp Core Library 1.2.1
+End of Notices for IBM Zapp Core Library 1.5
 
 
 L/N: L-KTSR-8RJLXL

package/lib/index.d.ts

@@ -126,7 +126,7 @@ export abstract class SchemaDocumentCache {
     protected normalizePath(inputPath: string): string;
 }
 /**
- * JSON schema for zapp.json and zapp.yaml files. Version 1.3.0 -- Licensed Materials - Property of IBM - (c) Copyright IBM Corporation 2022, 2024. All Rights Reserved.
+ * JSON schema for zapp.json and zapp.yaml files. Version 1.5.0 -- Licensed Materials - Property of IBM - (c) Copyright IBM Corporation 2022, 2025. All Rights Reserved.
  */
 export type IBMZappDocument = CoreProperties;
 /**
@@ -141,25 +141,11 @@ export type Person = {
 /**
  * Profiles are additional groups of properties that should only become valid under specific conditions such as running in a build job or as part of a debug session.
  */
-export type Profile = {
-    name: string;
-    type: 'dbb';
-    settings: DbbBuilderSettings | DbbGroovySettings;
-} | {
-    name: string;
-    type: 'rseapi';
-    settings: RseapiSettingsItem;
-} | {
-    name: string;
-    language: string;
-    type: 'preprocessor';
-    location: string;
-    settings: LocalPreprocessorSettingsItem | MvsPreprocessorSettingsItem;
-} | {
-    name: string;
-    type: 'test';
-    settings: TestSettingsItem;
-};
+export type Profile = DependencyBasedBuildProfile | RSEAPIProfile | PreprocessorProfile | TestProfile;
+/**
+ * Specify which application load modules correspond to application source files.
+ */
+export type TestSourceMaps = TestSourceMap[];
 export interface CoreProperties {
     /**
      * The name of the Z Project.
@@ -241,7 +227,7 @@ export interface LibraryItem {
      */
     name: string;
     /**
-     * The type of the property group defining where dependencies should be located. Allowed values are 'local' for using a local workspace and 'mvs' for dependencies located in MVS Datasets.
+     * The type of the property group defining where dependencies should be located. Allowed values are 'local' for using a local workspace and 'mvs' for dependencies located in MVS data sets.
      */
     type: 'mvs' | 'local';
     /**
@@ -249,6 +235,11 @@ export interface LibraryItem {
      */
     locations?: string[];
 }
+export interface DependencyBasedBuildProfile {
+    name: string;
+    type: 'dbb';
+    settings: DbbBuilderSettings | DbbGroovySettings;
+}
 /**
  * zBuilder user build properties for running user build on remote host.
  */
@@ -303,12 +294,17 @@ export interface DbbGroovySettings {
      */
     logFilePatterns?: string[];
 }
+export interface RSEAPIProfile {
+    name: string;
+    type: 'rseapi';
+    settings: RseapiSettingsItem;
+}
 /**
  * RSE API client settings for interactions with a z/OS remote host running an RSE API server.
  */
 export interface RseapiSettingsItem {
     /**
-     * A list of mapping objects that map local file extensions to transfer modes and encodings to MVS datasets that can be specified using wildcards.
+     * A list of mapping objects that map local file extensions to transfer modes and encodings to MVS data sets that can be specified using wildcards.
      */
     mappings: RseapiSettingsItemMapping[];
     /**
@@ -358,6 +354,13 @@ export interface RseapiSettingsItemMapping {
         resource?: string;
     }[];
 }
+export interface PreprocessorProfile {
+    name: string;
+    language: string;
+    type: 'preprocessor';
+    location: string;
+    settings: LocalPreprocessorSettingsItem | MvsPreprocessorSettingsItem;
+}
 /**
  * Preprocessor properties for preprocessing COBOL/PL/I files.
  */
@@ -405,66 +408,197 @@ export interface MvsPreprocessorSettingsItem {
      * Specifies the high-level qualifier used for data sets created by plug-in requests to export observation files.
      */
     tempDataHLQ: string;
+    /**
+     * Specifies the data set where local programs will be uploaded for preprocessing.
+     */
+    programDataSet?: string;
+}
+export interface TestProfile {
+    name: string;
+    type: 'test';
+    settings: TestSettingsItem;
 }
 /**
  * Test properties for a test case.
  */
 export interface TestSettingsItem {
+    recording?: TestRecordingSettings;
+    unitTest?: UnitTestSettings;
+    functionalTest?: FunctionalTestSettings;
+}
+/**
+ * Specify settings for the recording application tool.
+ */
+export interface TestRecordingSettings {
+    applicationToCapture?: TestApplicationToCapture;
+    hostRecordingSettings?: TestHostRecordingSettings;
+    sourceMaps?: TestSourceMaps;
+}
+/**
+ * Specify what to capture in an application.
+ */
+export interface TestApplicationToCapture {
     /**
-     * Properties to run a unit test case.
+     * Type of application that will be recorded.
      */
-    unitTest: {
-        /**
-         * Specifies the list of Procedure libraries.
-         */
-        procLib: string[];
-        /**
-         *  If this option is selected, the data set for the working file is allocated automatically with the allocation options.
-         */
-        allocateWorkingDs?: boolean;
-        /**
-         * Options to allocate a working file.
-         */
-        ioDataSetAllocation?: {
-            /**
-             * The unit of primary and secondary space to be allocated.
-             */
-            ioSpaceUnit?: 'TRACKS' | 'BLOCKS' | 'CYLINDERS';
-            /**
-             * The amount of DASD space to be used for primary space allocation (PRIMARY).
-             */
-            ioQuant1?: number;
-            /**
-             * The amount of DASD space to be used for secondary space allocation (SECONDARY).
-             */
-            ioQuant2?: number;
-            /**
-             * The high-level qualifier for the VSAM or QSAM data files for file I/O simulation. These files are allocated when running a Unit test case.
-             */
-            ioHLQ?: string;
-            [k: string]: unknown;
-        };
-        /**
-         * Runner configuration destination container.
-         */
-        configDS?: string;
+    recordingType?: 'CICS' | 'Batch' | 'IMS';
+    /**
+     * Provide a path to a JCL file that runs the application to be recorded.
+     */
+    jclSteps?: string;
+    /**
+     * Provide name of the program to capture.
+     */
+    programs?: string[];
+    /**
+     * Provide a transaction id to capture in the recording.
+     */
+    transactionId?: string;
+}
+/**
+ * Specify host settings for the recording tool.
+ */
+export interface TestHostRecordingSettings {
+    /**
+     * Required if recording and replaying DB2 statements.
+     */
+    applicationDbrmLibrary?: string;
+    /**
+     * If recording a CICS application, specify a CICS region where the application is running.
+     */
+    cicsRegion?: string;
+    /**
+     * If recording a batch application, specify the data set where Debug Test Engine load library is located.
+     */
+    dteEngineLocation?: string;
+    /**
+     * If recording an IMS application, specify the subsystem id.
+     */
+    imsSubsystemId?: string;
+}
+export interface TestSourceMap {
+    /**
+     * The workspace-relative path to an application source file.
+     */
+    source?: string;
+    /**
+     * The z/OS load module name that corresponds to the specified source file.
+     */
+    module?: string;
+}
+/**
+ * Properties to run a unit test case.
+ */
+export interface UnitTestSettings {
+    /**
+     * Specifies the list of Procedure libraries.
+     */
+    procLib: string[];
+    /**
+     * If this option is selected, the data set for the working file is allocated automatically with the allocation options.
+     */
+    allocateWorkingDs?: boolean;
+    /**
+     * Options to allocate a working file.
+     */
+    ioDataSetAllocation?: {
         /**
-         * Runner result destination container.
+         * The unit of primary and secondary space to be allocated.
          */
-        resultDS?: string;
+        ioSpaceUnit?: 'TRACKS' | 'BLOCKS' | 'CYLINDERS';
         /**
-         * The datat set of the application under test
+         * The amount of DASD space to be used for primary space allocation (PRIMARY).
          */
-        userLibraries?: string[];
+        ioQuant1?: number;
         /**
-         * The default local folder to create the test case artifacts.
+         * The amount of DASD space to be used for secondary space allocation (SECONDARY).
          */
-        defaultTestCaseFolder?: string;
+        ioQuant2?: number;
         /**
-         * The job card to run a unit test
+         * The high-level qualifier for the VSAM or QSAM data files for file I/O simulation. These files are allocated when running a Unit test case.
          */
-        jobcard?: string;
+        ioHLQ?: string;
+        [k: string]: unknown;
     };
+    /**
+     * Runner configuration destination container.
+     */
+    configDS?: string;
+    /**
+     * Runner result destination container.
+     */
+    resultDS?: string;
+    /**
+     * The datat set of the application under test.
+     */
+    userLibraries?: string[];
+    /**
+     * The default local folder to create the test case artifacts.
+     */
+    defaultTestCaseFolder?: string;
+    /**
+     * The job card to run a unit test.
+     */
+    jobcard?: string;
+}
+/**
+ * Specify settings for the functional test.
+ */
+export interface FunctionalTestSettings {
+    /**
+     * Specify the path to the default test case folder.
+     */
+    defaultTestCaseFolder?: string;
+    /**
+     * Specify the code pages to be used.
+     */
+    codePages?: string;
+    /**
+     * Specify an array of local BMS files.
+     */
+    localBmsMapNames?: string[];
+    /**
+     * Specify an array of local MFS files from the mfs-maps directory to be used for generating accurate test files. Ex: sample.mfs.
+     */
+    localMfsFiles?: string[];
+    /**
+     * Specify an array of local Db2 Config files.
+     */
+    localDb2Config?: string[];
+    substitutionMap?: SubstitutionMapSettings;
+}
+/**
+ * Specify settings for the functional test substitution map.
+ */
+export interface SubstitutionMapSettings {
+    /**
+     * If recording a CICS application, specify the cicsts.dse.tag from the .galasa/cps.properties file.
+     */
+    cicsTag?: string;
+    /**
+     * If recording a CICS or IMS application, specify the zos.dse.tag from the .galasa/cps.properties file.
+     */
+    imageTag?: string;
+    /**
+     * If recording a CICS application, specify the Db2 DB ID that was established when the Db2 instance was created.
+     */
+    dbPrefix?: string;
+    /**
+     * If recording a CICS application, specify the db2.dse.schema.PRIMARY.name from the .galasa/cps.properties.
+     */
+    dbSchema?: string;
+    /**
+     * If recording a CICS or IMS application, specify the zos.image.x.credentials value from the .galasa/cps.properties.
+     */
+    loginCredentialsTag?: string;
+    /**
+     * If recording an IMS application, specify the imstm.dse.tag from the .galasa/cps.properties.
+     */
+    imsTag?: string;
+    /**
+     * If recording an IMS application, specify the dli.database.tag.{imsTag}.datastore value from the .galasa/cps.properties.
+     */
+    dliTag?: string;
 }
 /**
  * A meta-data representation of a zapp file
@@ -695,6 +829,7 @@ export const zappConstants: {
     profileTypeRseApi: string;
     propertyPropertyGroups: string;
     profileTypePreprocessor: string;
+    profileTypeTest: string;
 };
 /**
  * A collection of business logic for accessing, manipulating, validating
@@ -773,7 +908,7 @@ export class PreprocessorController extends ZappProfilesController {
      */
     static getPreprocessorProfileNamesBasedOnLocation(workspacePath: string, location: string, language?: string): string[] | undefined;
     /**
-     * Requires that the ZAPP file was already cached. If in doubt call loadPreprocessorSettings()
+     * Requires that the ZAPP file was already cached.
      *
      * @param {string} workspacePath Path to a folder in which a zapp file can be found
      * @param {string} [language] optional filter by language
@@ -781,7 +916,7 @@ export class PreprocessorController extends ZappProfilesController {
      */
     static getLocalPreprocessorSettings(workspacePath: string, language?: string): LocalPreprocessorSettingsItem | undefined;
     /**
-     * Requires that the ZAPP file was already cached. If in doubt call loadPreprocessorSettings()
+     * Requires that the ZAPP file was already cached.
      *
      * @param {string} workspacePath Path to a folder in which a zapp file can be found
      * @param {string} [language] optional filter by language
@@ -789,7 +924,7 @@ export class PreprocessorController extends ZappProfilesController {
      */
     static getMvsPreprocessorSettings(workspacePath: string, language?: string): MvsPreprocessorSettingsItem | undefined;
     /**
-     * Requires that the ZAPP file was already cached. If in doubt call loadPreprocessorSettings()
+     * Requires that the ZAPP file was already cached.
      *
      * @param {string} workspacePath Path to a folder in which a zapp file can be found
      * @param {string} name Name of the preprocessor profile
@@ -798,7 +933,7 @@ export class PreprocessorController extends ZappProfilesController {
      */
     static getLocalPreprocessorProfileNamesBasedOnName(workspacePath: string, name: string, language?: string): LocalPreprocessorSettingsItem | undefined;
     /**
-     * Requires that the ZAPP file was already cached. If in doubt call loadPreprocessorSettings()
+     * Requires that the ZAPP file was already cached.
      *
      * @param {string} workspacePath Path to a folder in which a zapp file can be found
      * @param {string} name Name of the preprocessor profile
@@ -806,6 +941,19 @@ export class PreprocessorController extends ZappProfilesController {
      * @returns {(zapp.MvsPreprocessorSettingsItem | undefined)} Returns the settings specified for Remote Preprocessor
      */
     static getMvsPreprocessorProfileNamesBasedOnName(workspacePath: string, name: string, language?: string): MvsPreprocessorSettingsItem | undefined;
+    /**
+     * Requires that the ZAPP file was already cached.
+     *
+     * @param {string} workspacePath Path to a folder in which a zapp file can be found
+     * @param {string} [language] optional filter by language
+     * @param {string} [location] optional Location for which the preprocessor needs to be run
+     * @returns {(zapp.Profile | undefined)} Returns the preprocessor profile specified on the basis of filter provided
+     */
+    static getPreprocessorProfile(workspacePath: string, language?: string, location?: string): Profile[] | undefined;
+}
+export class TestController extends ZappProfilesController {
+    static getTestProfileNames(workspacePath: string): string[] | undefined;
+    static getTestSettings(workspacePath: string, profileName?: string): TestSettingsItem | undefined;
 }
 
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -1,3 +1,3 @@
-var e=require("fs"),t=require("yawn-yaml/cjs"),i=require("path"),s=require("os"),r=require("js-yaml"),a=require("ajv"),n=require("ajv-formats");function o(e,t){return Object.keys(t).forEach(function(i){"default"===i||"__esModule"===i||Object.prototype.hasOwnProperty.call(e,i)||Object.defineProperty(e,i,{enumerable:!0,get:function(){return t[i]}})}),e}function p(e){return e&&e.__esModule?e.default:e}function l(e,t,i,s){Object.defineProperty(e,t,{get:i,set:s,enumerable:!0,configurable:!0})}var c={},d={},h={};l(h,"SchemaDocumentInstance",()=>u);class u{constructor(e,i){this.isValid=!1,i&&this.prependErrorMessage(i);try{this.yawn=new(p(t))(e),this.validate()}catch(e){this.prependErrorMessage(e?.message)}}getAsYaml(){return this.yawn?.yaml}getAsJson(){return JSON.stringify(this.yawn?.json)}getAsObject(){return this.yawn?.json}static async readFileWithRetry(t){let i="";for(let s=0;s<10&&!(i=await e.promises.readFile(t,"utf8"));s++)await new Promise(e=>setTimeout(e,100));return i}write(){if(!this.isValid){this.appendErrorMessage(`Tried to write invalid document "${this.file?.path}"`);return}if(this.file?.path){let t="# Undefined "+this.type+" document.";"json"===this.file.type&&(t=JSON.stringify(this.getAsObject())),"yaml"===this.file.type&&(t=this.getAsYaml()||t),e.writeFileSync(this.file.path,t,{encoding:"utf-8"})}}writeToFile(e){this.file=e,this.write()}appendErrorMessage(e){let t=this.errorMessages?`${this.errorMessages}
+var $hsidQ$fs=require("fs"),$hsidQ$yawnyamlcjs=require("yawn-yaml/cjs"),$hsidQ$path=require("path"),$hsidQ$os=require("os"),$hsidQ$jsyaml=require("js-yaml"),$hsidQ$ajv=require("ajv"),$hsidQ$ajvformats=require("ajv-formats");function $parcel$exportWildcard(e,t){return Object.keys(t).forEach(function(r){"default"===r||"__esModule"===r||Object.prototype.hasOwnProperty.call(e,r)||Object.defineProperty(e,r,{enumerable:!0,get:function(){return t[r]}})}),e}function $parcel$interopDefault(e){return e&&e.__esModule?e.default:e}function $parcel$export(e,t,r,i){Object.defineProperty(e,t,{get:r,set:i,enumerable:!0,configurable:!0})}var $db89a39d91b9746d$exports={},$27816e9aa5a16a75$exports={},$06319fbb034d54be$exports={};$parcel$export($06319fbb034d54be$exports,"SchemaDocumentInstance",()=>$06319fbb034d54be$export$3fa3a1ffc042110d);class $06319fbb034d54be$export$3fa3a1ffc042110d{constructor(e,t){this.isValid=!1,t&&this.prependErrorMessage(t);try{this.yawn=new($parcel$interopDefault($hsidQ$yawnyamlcjs))(e),this.validate()}catch(e){this.prependErrorMessage(e?.message)}}getAsYaml(){return this.yawn?.yaml}getAsJson(){return JSON.stringify(this.yawn?.json)}getAsObject(){return this.yawn?.json}static async readFileWithRetry(e){let t="";for(let r=0;r<10&&!(t=await $hsidQ$fs.promises.readFile(e,"utf8"));r++)await new Promise(e=>setTimeout(e,100));return t}write(){if(!this.isValid)return void this.appendErrorMessage(`Tried to write invalid document "${this.file?.path}"`);if(this.file?.path){let e="# Undefined "+this.type+" document.";"json"===this.file.type&&(e=JSON.stringify(this.getAsObject())),"yaml"===this.file.type&&(e=this.getAsYaml()||e),$hsidQ$fs.writeFileSync(this.file.path,e,{encoding:"utf-8"})}}writeToFile(e){this.file=e,this.write()}appendErrorMessage(e){let t=this.errorMessages?`${this.errorMessages}
 `:"";this.errorMessages=`${t}- ${e||"Unknown Error reading "+this.type+" file."}`}prependErrorMessage(e){let t=this.errorMessages?`
-${this.errorMessages}`:"";this.errorMessages=`- ${e||"Unknown Error reading "+this.type+" file."}${t}`}}var m={};l(m,"SchemaDocumentCache",()=>f);class f{constructor(e){this.type=e,this.documentsCache=new Map,this.workspacesMap=new Map,this.numberDocsAdded=0,this.numberDocsRemoved=0,this.numberDocsFound=0}addDocument(e,t,i){let s=this.normalizePath(e),r=this.normalizePath(t);this.documentsCache.set(s,i),this.workspacesMap.set(r,s)}removeDocument(e){let t=this.normalizePath(e);this.workspacesMap.forEach((e,i)=>{e===t&&this.workspacesMap.delete(i)});let i=this.documentsCache.delete(t);return i&&this.numberDocsRemoved++,i}getCacheSize(){return this.documentsCache.size}getAllDocumentLocations(){return[...this.documentsCache.keys()]}clearSchemaDocument(e){if(!e)return;let t=this.normalizePath(e),s=i.dirname(t);this.workspacesMap.has(s)&&this.workspacesMap.delete(s),this.documentsCache.has(t)&&(this.documentsCache.delete(t),this.numberDocsRemoved++)}clearCache(){this.workspacesMap.clear(),this.documentsCache.clear()}getCacheStats(){return{documentsCacheSize:this.documentsCache.size,workspacesMapSize:this.workspacesMap.size,numberDocsAdded:this.numberDocsAdded,numberDocsRemoved:this.numberDocsRemoved,numberDocsFound:this.numberDocsFound}}normalizePath(e){if(!e)return e;let t=i.normalize(e);if("win32"===s.platform()){let e=i.basename(t);if(this.isValidFilename(e)){let s=i.dirname(t);t=i.join(s.toUpperCase(),e)}else t=t.toUpperCase()}return t}}o(d,h),o(d,m),o(c,d);var g={},y={},b={};l(b,"PropertyGroupsController",()=>j);var P={};l(P,"ZappDocumentsCache",()=>I);var w={};l(w,"ZappDocumentInstance",()=>v);var S={};S=JSON.parse('{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBM Zapp Document","description":"JSON schema for zapp.json and zapp.yaml files. Version 1.3.0 -- Licensed Materials - Property of IBM - (c) Copyright IBM Corporation 2022, 2024. All Rights Reserved.","type":"object","definitions":{"coreProperties":{"type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"description":"The name of the Z Project.","type":"string","maxLength":214,"minLength":1},"description":{"description":"This helps people understand your project as it would be used by tools.","type":"string"},"version":{"description":"Version is a string and it must be parsable for managing dependencies.","type":"string","default":"1.0.0"},"groupId":{"description":"Defines a group name that is shared for each application part in case of applications composed of multiple parts. Allows to uniquely identify the parts by concatenating with the artifact id. For example a groupId `com.ibm.wazi` with an artifactId `service` would create the unique application identifier `com.ibm.wazi.service`.","type":"string","examples":["com.ibm.wazi","payments"]},"artifactId":{"description":"Define id of the application artifact. Use it in combination with a groupId for multi-part applications.","type":"string","default":"","examples":["sam"]},"parentId":{"description":"In case of a multi-part application defines the name of the parent application part. This zapp will inherit properties such as propertyGroups defined in the parent.","type":"string","default":"","examples":["com.ibm.wazi.parent"]},"keywords":{"description":"This helps people discover your project.","type":"array","items":{"type":"string"}},"homepage":{"description":"The url to the project homepage.","type":"string","oneOf":[{"format":"uri"},{"enum":["."]}]},"license":{"type":"string","description":"You should specify a license for your package so that people know how they are permitted to use it and any restrictions you\'re placing on it."},"author":{"$ref":"#/definitions/person"},"contributors":{"description":"A list of people who contributed to this package.","type":"array","items":{"$ref":"#/definitions/person"},"minItems":1},"maintainers":{"description":"A list of people who maintain this package.","type":"array","items":{"$ref":"#/definitions/person"},"minItems":1},"propertyGroups":{"description":"A list of properties defining path names for resolving dependencies.","type":"array","items":{"$ref":"#/definitions/propertyGroupItem"},"minItems":1},"profiles":{"description":"Profiles are additional groups of properties that should only become valid under specific conditions such as running in a build job or as part of a debug session.","type":"array","items":{"$ref":"#/definitions/profile"},"minItems":1}}},"propertyGroupItem":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","description":"The name of the property group, which is used in hovers and error messages.","examples":["sample-local","sample-remote"]},"language":{"type":"string","enum":["cobol","pl1","hlasm","rexx","jcl"],"description":"Limits the property group to one specific language."},"compilerOptions":{"type":"string","description":"Global compiler options separated by a comma that impact the parsing of the programs for the editor. Requires that you specify a language. If there are multiple Property Groups for a language with compiler option then they will be concatenated."},"libraries":{"type":"array","description":"An array of potential library locations defining the search order for include files. Libraries with the name \'syslib\' will be handled as default include locations. The list can contain many entries of the type \'local\' or \'mvs\'. It can contain items of the same type twice in case, for example, you want to search in remote locations first, then some local location, and if still not found more remote locations.","items":{"$ref":"#/definitions/libraryItem"},"minItems":1}}},"libraryItem":{"type":"object","additionalProperties":false,"required":["name","type"],"properties":{"name":{"type":"string","description":"Name of the library. The default name should be `syslib` if using unnamed libraries.","default":"syslib","examples":["syslib","jcllib","maclib","currencylib"]},"type":{"type":"string","enum":["mvs","local"],"description":"The type of the property group defining where dependencies should be located. Allowed values are \'local\' for using a local workspace and \'mvs\' for dependencies located in MVS Datasets.","default":"local","examples":["local","mvs"]},"locations":{"type":"array","description":"An array of include file locations. For \'local\' libraries values can be absolute and relative filename paths using GLOB patterns. For \'mvs\' libraries value can be data set names. GLOB patterns for data sets are currently not supported.","items":{"type":"string"},"examples":["**/copybook","USER1.SAMPLE.COBCOPY"]}},"if":{"properties":{"name":{"const":"jcllib","type":"string"},"type":{"const":"mvs","type":"string"}}},"then":{"required":["name","type"]},"else":{"required":["name","type","locations"]}},"person":{"description":"A person who has been involved in creating or maintaining this package","type":["object","string"],"required":["name"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"email":{"type":"string","format":"email"}}},"profile":{"type":"object","description":"Profiles are additional groups of properties that should only become valid under specific conditions such as running in a build job or as part of a debug session.","additionalProperties":false,"required":["name","type"],"properties":{"name":{"type":"string","description":"The name of the profile.","examples":["dbb-build"]},"language":{"type":"string","enum":["cobol","pl1"],"description":"If the profile type supports it then it defines a scope for the profile to one specific programming language. For example, a profile that defines preprocessor commands for COBOL."},"type":{"type":"string","enum":["dbb","rseapi","debug","preprocessor","test"],"description":"The type of the profile.","default":"dbb"},"location":{"type":"string","enum":["mvs","local"],"description":"If the profile type supports it then it defines a scope for the profile to a specific location for resources. For example, a profile that defines preprocessor commands to be executed on MVS or local files.","default":"local"},"settings":{"description":"Settings objects specific to the type specified for the profile.","type":"object"}},"oneOf":[{"required":["name","type","settings"],"additionalProperties":false,"properties":{"name":{"type":"string"},"type":{"const":"dbb","type":"string"},"settings":{"oneOf":[{"$ref":"#/definitions/dbbBuilderSettings"},{"$ref":"#/definitions/dbbGroovySettings"}]}}},{"required":["name","type","settings"],"additionalProperties":false,"properties":{"name":{"type":"string"},"type":{"const":"rseapi","type":"string"},"settings":{"$ref":"#/definitions/rseapiSettingsItem"}}},{"required":["name","type","settings","location","language"],"additionalProperties":false,"properties":{"name":{"type":"string"},"language":{"type":"string"},"type":{"const":"preprocessor","type":"string"},"location":{"type":"string"},"settings":{"oneOf":[{"$ref":"#/definitions/localPreprocessorSettingsItem"},{"$ref":"#/definitions/mvsPreprocessorSettingsItem"}]}},"if":{"properties":{"location":{"const":"local","type":"string"}}},"then":{"properties":{"settings":{"$ref":"#/definitions/localPreprocessorSettingsItem"}}},"else":{"properties":{"settings":{"$ref":"#/definitions/mvsPreprocessorSettingsItem"}}}},{"required":["name","type","settings"],"additionalProperties":false,"properties":{"name":{"type":"string"},"type":{"const":"test","type":"string"},"settings":{"$ref":"#/definitions/testSettingsItem"}}}]},"dbbGroovySettings":{"type":"object","additionalProperties":false,"required":["application","command"],"description":"Groovyz user build script properties for running user build on remote host.","properties":{"application":{"type":"string","description":"Defines the name of the application to build. Will be used to create a folder on USS to upload all files to."},"command":{"type":"string","description":"Command that the build script is executed with such as the path to groovyz and it\'s parameters."},"buildScriptPath":{"type":"string","description":"The full path of build script on the remote host that should be used with the command."},"buildScriptArgs":{"type":"array","items":{"type":"string"},"description":"A list of strings that are the parameters for the build script. Check the documentation for built-in variables, such as the name of the program to build, that can be used here."},"additionalDependencies":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be uploaded to USS for a build. Relative path names are interpreted relative to the location of the ZAPP file that is being used for the build, which is a ZAPP file in the same workspace as the program to be build."},"logFilePatterns":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be downloaded from USS after the build. Relative path names are interpreted relative to the DBB log directory user setting. If not provided then all files of the user setting location will be downloaded."}}},"dbbBuilderSettings":{"type":"object","additionalProperties":false,"required":["command","lifecycle","lifecycleArgs"],"description":"zBuilder user build properties for running user build on remote host.","properties":{"command":{"type":"string","description":"Command that the build script is executed with such as the path to groovyz and it\'s parameters."},"lifecycle":{"type":"string","description":"Defines named build lifecycles that represent different build scenarios the customer needs to perform and can be executed from the DBB CLI."},"lifecycleArgs":{"type":"array","description":"Additional arguments and options for the lifecycle.","items":{"type":"string"}},"additionalDependencies":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be uploaded to USS for a build. Relative path names are interpreted relative to the location of the ZAPP file that is being used for the build, which is a ZAPP file in the same workspace as the program to be build."},"logFilePatterns":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be downloaded from USS after the build. Relative path names are interpreted relative to the DBB log directory user setting. If not provided then all files of the user setting location will be downloaded."}}},"rseapiSettingsItem":{"type":"object","additionalProperties":false,"description":"RSE API client settings for interactions with a z/OS remote host running an RSE API server.","required":["mappings","default.encoding"],"properties":{"mappings":{"type":"array","description":"A list of mapping objects that map local file extensions to transfer modes and encodings to MVS datasets that can be specified using wildcards.","items":{"$ref":"#/definitions/rseapiSettingsItemMapping"}},"default.encoding":{"type":"string","description":"The encoding to be used when no mapping can be found. If not provided then either the user or server default will be used."}}},"rseapiSettingsItemMapping":{"type":"object","additionalProperties":false,"description":"One mapping that contains at least transfer and resource values.","properties":{"extension":{"type":"string","description":"A local file extension such as cbl or pl1."},"transfer":{"type":"string","enum":["text","binary"],"description":"The transfer mode to be used. Can be \'text\' or \'binary\'."},"resource":{"type":"string","description":"The data set name to be mapped to. Can use a wildcard such as \'**CPY\'."},"encoding":{"type":"string","description":"The encoding to be used for text transfer. See the RSE API documentation for the values allowed."},"memberMappings":{"type":"array","items":{"type":"object","additionalProperties":false,"description":"One member mapping that contains at least transfer and resource values.","properties":{"extension":{"type":"string","description":"A local file extension such as cbl or pl1."},"transfer":{"type":"string","enum":["text","binary"],"description":"The transfer mode to be used. Can be \'text\' or \'binary\'."},"encoding":{"type":"string","description":"The encoding to be used for text transfer. See the RSE API documentation for the values allowed."},"resource":{"type":"string","description":"The data set member name to be mapped to. Can use a wildcard such as \'**CPY\'."}}},"description":"A nested mappings array with resource mappings to members of the data sets that were mapped by the parent mapping."}}},"localPreprocessorSettingsItem":{"type":"object","additionalProperties":false,"description":"Preprocessor properties for preprocessing COBOL/PL/I files.","required":["command","outputPath","fileExtension"],"properties":{"command":{"type":"string","description":"The command to run to execute the preprocessor executable."},"outputPath":{"type":"string","description":"Path where preprocessor produces its build output."},"fileExtension":{"type":"string","description":"The desired file extension for the post-processed file."},"environmentVariables":{"type":"object","additionalProperties":false,"description":"Specifies any user defined environment variables to be passed to the preprocessor.","patternProperties":{"[a-zA-Z_][a-zA-Z0-9_]*":{"anyOf":[{"type":"string"}]}}}}},"mvsPreprocessorSettingsItem":{"type":"object","additionalProperties":false,"description":"Preprocessor properties for preprocessing COBOL/PL/I files.","required":["commandDataSet","outputDataSet","tempDataHLQ"],"properties":{"commandDataSet":{"type":"string","description":"Specifies an input listing sequential data set."},"commandParameters":{"type":"string","description":"The parameters for the command being run."},"outputDataSet":{"type":"string","description":"Specifies an output listing sequential data set."},"tempDataHLQ":{"type":"string","description":"Specifies the high-level qualifier used for data sets created by plug-in requests to export observation files."}}},"testSettingsItem":{"type":"object","additionalProperties":false,"description":"Test properties for a test case.","required":["unitTest"],"properties":{"unitTest":{"type":"object","additionalProperties":false,"description":"Properties to run a unit test case.","required":["procLib"],"properties":{"procLib":{"type":"array","description":"Specifies the list of Procedure libraries.","items":{"type":"string"}},"allocateWorkingDs":{"type":"boolean","description":" If this option is selected, the data set for the working file is allocated automatically with the allocation options."},"ioDataSetAllocation":{"type":"object","description":"Options to allocate a working file.","properties":{"ioSpaceUnit":{"type":"string","enum":["TRACKS","BLOCKS","CYLINDERS"],"description":"The unit of primary and secondary space to be allocated."},"ioQuant1":{"type":"integer","description":"The amount of DASD space to be used for primary space allocation (PRIMARY)."},"ioQuant2":{"type":"integer","description":"The amount of DASD space to be used for secondary space allocation (SECONDARY)."},"ioHLQ":{"type":"string","description":"The high-level qualifier for the VSAM or QSAM data files for file I/O simulation. These files are allocated when running a Unit test case."}}},"configDS":{"type":"string","description":"Runner configuration destination container."},"resultDS":{"type":"string","description":"Runner result destination container."},"userLibraries":{"type":"array","description":"The datat set of the application under test","items":{"type":"string"}},"defaultTestCaseFolder":{"type":"string","description":"The default local folder to create the test case artifacts."},"jobcard":{"type":"string","description":"The job card to run a unit test"}}}}}},"anyOf":[{"$ref":"#/definitions/coreProperties"}]}');class v extends u{static #e=this.validationFunction=v.initAjvValidator();static initAjvValidator(){let e=new(p(a))({allErrors:!0,strictTuples:!1,allowUnionTypes:!0});return p(n)(e),e.compile(S)}static createFromYamlString(e){return new v(e)}static createFromJsonString(e){let t="";try{let i=JSON.parse(e);return t=r.dump(i),this.createFromYamlString(t)}catch(e){return new v(t,e?.message||e)}}static createFromObject(e){return this.createFromJsonString(JSON.stringify(e))}static async createFromYamlFile(e){let t="";try{t=await this.readFileWithRetry(e);let i=this.createFromYamlString(t);return i.file={path:e,type:"yaml"},i}catch(e){return new v(t,e?.message||e)}}static async createFromJsonFile(e){let t="";try{t=await this.readFileWithRetry(e);let i=this.createFromJsonString(t);return i.file={path:e,type:"json"},i}catch(e){return new v(t,e?.message||e)}}static async createFromFile(e){return e?.endsWith(".yaml")||e?.endsWith(".yml")?await this.createFromYamlFile(e):e?.endsWith(".json")?await this.createFromJsonFile(e):new v("","Invalid filename for reading a ZAPP file.")}static async loadFromWorkspace(e){let t=this.findZappFile(e);return t?.type==="yaml"?await this.createFromYamlFile(t.path):t?.type==="json"?await this.createFromJsonFile(t.path):new v("",`No ZAPP file was found in "${e}".`)}static findZappFile(t){if(!t)return;let s=i.normalize(t),r=i.join(s,"zapp.yaml");if(e.existsSync(r))return{path:r,type:"yaml"};let a=i.join(s,"zapp.yml");if(e.existsSync(a))return{path:a,type:"yaml"};let n=i.join(s,"zapp.json");if(e.existsSync(n))return{path:n,type:"json"}}static isZappFileName(e){return/^(zapp\.)(yml|yaml|json)$/.test(e)}getVariables(){let e=[],t=this.getAsYaml();if(t){let i=t.match(/\${.*?}/g);i&&(e=(e=[...new Set(i)]).map(e=>e.replace(/[${}]/g,"")))}return e}getAsDocument(){try{let e=this.yawn.json;if(e)return e}catch(e){this.prependErrorMessage(e?.message)}}validate(){if(this.yawn){if(this.isValid=v.validationFunction(this.getAsObject()),!this.isValid){let e=v.validationFunction.errors;return e?e.forEach(e=>{let t=e.message;if(e.params){let i=e.params,s=Object.keys(i).map(e=>`${e}:${i[e]}`);t=`${t}(${s})`}this.appendErrorMessage(t)}):this.appendErrorMessage("Unknown validation error."),!1}return!0}return!1}constructor(...e){super(...e),this.type="zapp"}}class I extends f{static #e=this.cacheType="zapp";static getInstance(){return this.instance||(this.instance=new I(this.cacheType)),this.instance}static resetInstance(){this.instance=void 0}static getZappDocument(e){if(!e)return;let t=this.getInstance().normalizePath(e);if(this.getInstance().documentsCache.has(t))return this.getInstance().numberDocsFound++,this.getInstance().documentsCache.get(t)}static async loadZappDocument(e,t){if(!e)return;let s=this.getInstance().normalizePath(e),r=await v.createFromFile(s),a=t;return t||(a=i.dirname(s)),this.getInstance().addDocument(e,a,r),this.getInstance().numberDocsAdded++,r}static removeZappDocument(e){return this.getInstance().removeDocument(e)}static clearZappDocument(e){this.getInstance().clearSchemaDocument(e)}static getZappDocumentInWorkspace(e){if(!e)return;let t=this.getInstance().normalizePath(e),i=this.getInstance().workspacesMap.get(t);if(i)return this.getZappDocument(i)}static async loadZappDocumentInWorkspace(e){let t=this.getInstance().normalizePath(e),i=v.findZappFile(t);if(i){let s=await this.loadZappDocument(i.path,e);return this.getInstance().workspacesMap.set(t,i.path),s}}isValidFilename(e){return v.isZappFileName(e)}static getVariablesFromAllDocs(){let e=[];for(let t of this.getInstance().documentsCache.values())t instanceof v&&e.push(...t.getVariables());return e.length>1&&(e=[...new Set(e)]),e}static getCacheSize(){return this.getInstance().getCacheSize()}static getAllDocumentLocations(){return this.getInstance().getAllDocumentLocations()}static getCacheStats(){return this.getInstance().getCacheStats()}static clearCache(){this.getInstance().clearCache(),this.resetInstance()}}var D={};l(D,"ZappUserVariablesCache",()=>A);class A{static getInstance(){return this.instance||(this.instance=new A),this.instance}static resetInstance(){this.instance=void 0}static saveZappUserVariables(e){A.getInstance().zappUserSettingsMap=e,A.getInstance().zappUserSettingsMap.forEach((e,t)=>{if(e.includes(p(i).win32.sep)){let s=e.split(p(i).win32.sep).join(p(i).posix.sep);A.getInstance().zappUserSettingsMap.set(t,s)}})}static getZappUserVariables(){return A.getInstance().zappUserSettingsMap}static clearCache(){A.getInstance().zappUserSettingsMap.clear(),this.resetInstance()}static replaceUserVariables(e){if(!e)return;let t=JSON.stringify(e),i=A.getZappUserVariables();if(!i||0===i.size)return e;let s=t.replace(/\${.*?\}/g,e=>{let t=e.slice(2,-1),s=i.get(t)??e;return t.replace(t,s)});try{return JSON.parse(s)}catch(t){return e}}constructor(){this.zappUserSettingsMap=new Map}}class j{static getPropertyGroups(e,t){let i=[],s=I.getZappDocumentInWorkspace(e);if(s&&!s.errorMessages){let e=s.getAsDocument();if(e){let s=e.propertyGroups;s&&(i=s,t&&(i=s.filter(e=>!e.language||e.language===t)))}}return A.replaceUserVariables(i)}}var C={};l(C,"UserBuildController",()=>x);var T={};l(T,"ZappProfilesController",()=>M);class M{static getZappProfiles(e){let t=I.getZappDocumentInWorkspace(e);if(!t||t.errorMessages)return;let i=t.getAsDocument();if(i&&i.profiles&&0!==i.profiles.length)return i.profiles}static async loadZappProfiles(e){if(await I.loadZappDocumentInWorkspace(e))return this.getZappProfiles(e)}}var F={};l(F,"zappConstants",()=>O);const O={profileTypeDbb:"dbb",profileTypeRseApi:"rseapi",propertyPropertyGroups:"propertyGroups",profileTypePreprocessor:"preprocessor"};class x extends M{static getUserBuildProfileNames(e){let t=this.getZappProfiles(e);if(t&&t.length>0)return t.filter(e=>e.type===O.profileTypeDbb).map(e=>e.name)}static getUserBuildSettings(e,t){let i=this.getZappProfiles(e);if(i&&i.length>0){if(t){let e=i.find(e=>e.name===t);if(e?.type===O.profileTypeDbb)return A.replaceUserVariables(e.settings)}else{let e=i.find(e=>e.type===O.profileTypeDbb);return A.replaceUserVariables(e?.settings)}}}}var z={};l(z,"RseApiController",()=>Z);class Z extends M{static getRseApiProfileNames(e){let t=this.getZappProfiles(e);if(t&&t.length>0)return t.filter(e=>e.type===O.profileTypeRseApi).map(e=>e.name)}static onlyOneMappingsEntry(e){let t=this.getRseApiProfileNames(e);return t?.length===1}static getRseApiSettings(e){let t=this.getZappProfiles(e);if(t&&t.length>0){let e=t.find(e=>e.type===O.profileTypeRseApi);return A.replaceUserVariables(e?.settings)}}static async loadRseApiSettings(e){if(await this.loadZappProfiles(e))return this.getRseApiSettings(e)}}var U={};l(U,"PreprocessorController",()=>k);class k extends M{static getPreprocessorProfileNames(e,t){let i=this.getZappProfiles(e);if(i&&i.length>0)return i.filter(e=>e.type===O.profileTypePreprocessor&&"language"in e&&(void 0===t||e.language===t)).map(e=>e.name)}static getPreprocessorProfileNamesBasedOnLocation(e,t,i){let s=this.getZappProfiles(e);if(s&&s.length>0)return s.filter(e=>e.type===O.profileTypePreprocessor&&"location"in e&&e.location===t&&(void 0===i||e.language===i)).map(e=>e.name)}static getLocalPreprocessorSettings(e,t){let i=this.getZappProfiles(e);if(i&&i.length>0){let e=i.find(e=>e.type===O.profileTypePreprocessor&&"location"in e&&"local"===e.location&&(void 0===t||e.language===t));return A.replaceUserVariables(e?.settings)}}static getMvsPreprocessorSettings(e,t){let i=this.getZappProfiles(e);if(i&&i.length>0){let e=i.find(e=>e.type===O.profileTypePreprocessor&&"location"in e&&"mvs"===e.location&&(void 0===t||e.language===t));return A.replaceUserVariables(e?.settings)}}static getLocalPreprocessorProfileNamesBasedOnName(e,t,i){let s=this.getZappProfiles(e);if(s&&s.length>0){let e=s.find(e=>e.type===O.profileTypePreprocessor&&"location"in e&&"local"===e.location&&e.name===t&&(void 0===i||e.language===i));return A.replaceUserVariables(e?.settings)}}static getMvsPreprocessorProfileNamesBasedOnName(e,t,i){let s=this.getZappProfiles(e);if(s&&s.length>0){let e=s.find(e=>e.type===O.profileTypePreprocessor&&"location"in e&&"mvs"===e.location&&e.name===t&&(void 0===i||e.language===i));return A.replaceUserVariables(e?.settings)}}}o(y,b),o(y,C),o(y,z),o(y,T),o(y,U);var L={};o(L,{}),o(L,w),o(L,P),o(L,F),o(L,D),o(g,y),o(g,L),o(module.exports,c),o(module.exports,g);
+${this.errorMessages}`:"";this.errorMessages=`- ${e||"Unknown Error reading "+this.type+" file."}${t}`}}var $b1285f501b3f0a4a$exports={};$parcel$export($b1285f501b3f0a4a$exports,"SchemaDocumentCache",()=>$b1285f501b3f0a4a$export$2941748d4d27acfc);class $b1285f501b3f0a4a$export$2941748d4d27acfc{constructor(e){this.type=e,this.documentsCache=new Map,this.workspacesMap=new Map,this.numberDocsAdded=0,this.numberDocsRemoved=0,this.numberDocsFound=0}addDocument(e,t,r){let i=this.normalizePath(e),a=this.normalizePath(t);this.documentsCache.set(i,r),this.workspacesMap.set(a,i)}removeDocument(e){let t=this.normalizePath(e);this.workspacesMap.forEach((e,r)=>{e===t&&this.workspacesMap.delete(r)});let r=this.documentsCache.delete(t);return r&&this.numberDocsRemoved++,r}getCacheSize(){return this.documentsCache.size}getAllDocumentLocations(){return[...this.documentsCache.keys()]}clearSchemaDocument(e){if(!e)return;let t=this.normalizePath(e),r=$hsidQ$path.dirname(t);this.workspacesMap.has(r)&&this.workspacesMap.delete(r),this.documentsCache.has(t)&&(this.documentsCache.delete(t),this.numberDocsRemoved++)}clearCache(){this.workspacesMap.clear(),this.documentsCache.clear()}getCacheStats(){return{documentsCacheSize:this.documentsCache.size,workspacesMapSize:this.workspacesMap.size,numberDocsAdded:this.numberDocsAdded,numberDocsRemoved:this.numberDocsRemoved,numberDocsFound:this.numberDocsFound}}normalizePath(e){if(!e)return e;let t=$hsidQ$path.normalize(e);if("win32"===$hsidQ$os.platform()){let e=$hsidQ$path.basename(t);if(this.isValidFilename(e)){let r=$hsidQ$path.dirname(t);t=$hsidQ$path.join(r.toUpperCase(),e)}else t=t.toUpperCase()}return t}}$parcel$exportWildcard($27816e9aa5a16a75$exports,$06319fbb034d54be$exports),$parcel$exportWildcard($27816e9aa5a16a75$exports,$b1285f501b3f0a4a$exports),$parcel$exportWildcard($db89a39d91b9746d$exports,$27816e9aa5a16a75$exports);var $f8f1f978d697847d$exports={},$29ee84a662b1b8fd$exports={},$fac1dbefdcd03230$exports={};$parcel$export($fac1dbefdcd03230$exports,"PropertyGroupsController",()=>$fac1dbefdcd03230$export$117dc7eeb984edf6);var $33f2606524745ccb$exports={};$parcel$export($33f2606524745ccb$exports,"ZappDocumentsCache",()=>$33f2606524745ccb$export$c06d94e9d38b8bae);var $04802ddbf77b0972$exports={};$parcel$export($04802ddbf77b0972$exports,"ZappDocumentInstance",()=>$04802ddbf77b0972$export$20a2815e8c83febb);var $67f77f420084733b$exports={};$67f77f420084733b$exports=JSON.parse('{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBM Zapp Document","description":"JSON schema for zapp.json and zapp.yaml files. Version 1.5.0 -- Licensed Materials - Property of IBM - (c) Copyright IBM Corporation 2022, 2025. All Rights Reserved.","type":"object","definitions":{"coreProperties":{"type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"description":"The name of the Z Project.","type":"string","maxLength":214,"minLength":1},"description":{"description":"This helps people understand your project as it would be used by tools.","type":"string"},"version":{"description":"Version is a string and it must be parsable for managing dependencies.","type":"string","default":"1.0.0"},"groupId":{"description":"Defines a group name that is shared for each application part in case of applications composed of multiple parts. Allows to uniquely identify the parts by concatenating with the artifact id. For example a groupId `com.ibm.wazi` with an artifactId `service` would create the unique application identifier `com.ibm.wazi.service`.","type":"string","examples":["com.ibm.wazi","payments"]},"artifactId":{"description":"Define id of the application artifact. Use it in combination with a groupId for multi-part applications.","type":"string","default":"","examples":["sam"]},"parentId":{"description":"In case of a multi-part application defines the name of the parent application part. This zapp will inherit properties such as propertyGroups defined in the parent.","type":"string","default":"","examples":["com.ibm.wazi.parent"]},"keywords":{"description":"This helps people discover your project.","type":"array","items":{"type":"string"}},"homepage":{"description":"The url to the project homepage.","type":"string","oneOf":[{"format":"uri"},{"enum":["."]}]},"license":{"type":"string","description":"You should specify a license for your package so that people know how they are permitted to use it and any restrictions you\'re placing on it."},"author":{"$ref":"#/definitions/person"},"contributors":{"description":"A list of people who contributed to this package.","type":"array","items":{"$ref":"#/definitions/person"},"minItems":1},"maintainers":{"description":"A list of people who maintain this package.","type":"array","items":{"$ref":"#/definitions/person"},"minItems":1},"propertyGroups":{"description":"A list of properties defining path names for resolving dependencies.","type":"array","items":{"$ref":"#/definitions/propertyGroupItem"},"minItems":1},"profiles":{"description":"Profiles are additional groups of properties that should only become valid under specific conditions such as running in a build job or as part of a debug session.","type":"array","items":{"$ref":"#/definitions/profile"},"minItems":1}}},"propertyGroupItem":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","description":"The name of the property group, which is used in hovers and error messages.","examples":["sample-local","sample-remote"]},"language":{"type":"string","enum":["cobol","pl1","hlasm","rexx","jcl"],"description":"Limits the property group to one specific language."},"compilerOptions":{"type":"string","description":"Global compiler options separated by a comma that impact the parsing of the programs for the editor. Requires that you specify a language. If there are multiple Property Groups for a language with compiler option then they will be concatenated."},"libraries":{"type":"array","description":"An array of potential library locations defining the search order for include files. Libraries with the name \'syslib\' will be handled as default include locations. The list can contain many entries of the type \'local\' or \'mvs\'. It can contain items of the same type twice in case, for example, you want to search in remote locations first, then some local location, and if still not found more remote locations.","items":{"$ref":"#/definitions/libraryItem"},"minItems":1}}},"libraryItem":{"type":"object","additionalProperties":false,"required":["name","type"],"properties":{"name":{"type":"string","description":"Name of the library. The default name should be `syslib` if using unnamed libraries.","default":"syslib","examples":["syslib","jcllib","proclib","maclib","currencylib"]},"type":{"type":"string","enum":["mvs","local"],"description":"The type of the property group defining where dependencies should be located. Allowed values are \'local\' for using a local workspace and \'mvs\' for dependencies located in MVS data sets.","default":"local","examples":["local","mvs"]},"locations":{"type":"array","description":"An array of include file locations. For \'local\' libraries values can be absolute and relative filename paths using GLOB patterns. For \'mvs\' libraries value can be data set names. GLOB patterns for data sets are currently not supported.","items":{"type":"string"},"examples":["**/copybook","USER1.SAMPLE.COBCOPY"]}},"if":{"properties":{"name":{"enum":["jcllib","proclib"],"type":"string"},"type":{"const":"mvs","type":"string"}}},"then":{"required":["name","type"]},"else":{"required":["name","type","locations"]}},"person":{"description":"A person who has been involved in creating or maintaining this package","type":["object","string"],"required":["name"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"email":{"type":"string","format":"email"}}},"profile":{"type":"object","description":"Profiles are additional groups of properties that should only become valid under specific conditions such as running in a build job or as part of a debug session.","additionalProperties":false,"required":["name","type"],"properties":{"name":{"type":"string","description":"The name of the profile.","examples":["dbb-build"]},"language":{"type":"string","enum":["cobol","pl1"],"description":"If the profile type supports it then it defines a scope for the profile to one specific programming language. For example, a profile that defines preprocessor commands for COBOL."},"type":{"type":"string","enum":["dbb","rseapi","debug","preprocessor","test"],"description":"The type of the profile.","default":"dbb"},"location":{"type":"string","enum":["mvs","local"],"description":"If the profile type supports it then it defines a scope for the profile to a specific location for resources. For example, a profile that defines preprocessor commands to be executed on MVS or local files.","default":"local"},"settings":{"description":"Settings objects specific to the type specified for the profile.","type":"object"}},"oneOf":[{"title":"Dependency-Based Build profile","required":["name","type","settings"],"additionalProperties":false,"properties":{"name":{"type":"string"},"type":{"const":"dbb","type":"string"},"settings":{"oneOf":[{"$ref":"#/definitions/dbbBuilderSettings"},{"$ref":"#/definitions/dbbGroovySettings"}]}}},{"title":"RSE API profile","required":["name","type","settings"],"additionalProperties":false,"properties":{"name":{"type":"string"},"type":{"const":"rseapi","type":"string"},"settings":{"$ref":"#/definitions/rseapiSettingsItem"}}},{"title":"Preprocessor profile","required":["name","type","settings","location","language"],"additionalProperties":false,"properties":{"name":{"type":"string"},"language":{"type":"string"},"type":{"const":"preprocessor","type":"string"},"location":{"type":"string"},"settings":{"oneOf":[{"$ref":"#/definitions/localPreprocessorSettingsItem"},{"$ref":"#/definitions/mvsPreprocessorSettingsItem"}]}},"if":{"properties":{"location":{"const":"local","type":"string"}}},"then":{"properties":{"settings":{"$ref":"#/definitions/localPreprocessorSettingsItem"}}},"else":{"properties":{"settings":{"$ref":"#/definitions/mvsPreprocessorSettingsItem"}}}},{"title":"Test profile","required":["name","type","settings"],"additionalProperties":false,"properties":{"name":{"type":"string"},"type":{"const":"test","type":"string"},"settings":{"$ref":"#/definitions/testSettingsItem"}}}]},"dbbGroovySettings":{"type":"object","additionalProperties":false,"required":["application","command"],"description":"Groovyz user build script properties for running user build on remote host.","properties":{"application":{"type":"string","description":"Defines the name of the application to build. Will be used to create a folder on USS to upload all files to."},"command":{"type":"string","description":"Command that the build script is executed with such as the path to groovyz and it\'s parameters."},"buildScriptPath":{"type":"string","description":"The full path of build script on the remote host that should be used with the command."},"buildScriptArgs":{"type":"array","items":{"type":"string"},"description":"A list of strings that are the parameters for the build script. Check the documentation for built-in variables, such as the name of the program to build, that can be used here."},"additionalDependencies":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be uploaded to USS for a build. Relative path names are interpreted relative to the location of the ZAPP file that is being used for the build, which is a ZAPP file in the same workspace as the program to be build."},"logFilePatterns":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be downloaded from USS after the build. Relative path names are interpreted relative to the DBB log directory user setting. If not provided then all files of the user setting location will be downloaded."}}},"dbbBuilderSettings":{"type":"object","additionalProperties":false,"required":["command","lifecycle","lifecycleArgs"],"description":"zBuilder user build properties for running user build on remote host.","properties":{"command":{"type":"string","description":"Command that the build script is executed with such as the path to groovyz and it\'s parameters."},"lifecycle":{"type":"string","description":"Defines named build lifecycles that represent different build scenarios the customer needs to perform and can be executed from the DBB CLI."},"lifecycleArgs":{"type":"array","description":"Additional arguments and options for the lifecycle.","items":{"type":"string"}},"additionalDependencies":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be uploaded to USS for a build. Relative path names are interpreted relative to the location of the ZAPP file that is being used for the build, which is a ZAPP file in the same workspace as the program to be build."},"logFilePatterns":{"type":"array","items":{"type":"string"},"description":"Lists of GLOB patterns that define the files that should be downloaded from USS after the build. Relative path names are interpreted relative to the DBB log directory user setting. If not provided then all files of the user setting location will be downloaded."}}},"rseapiSettingsItem":{"type":"object","additionalProperties":false,"description":"RSE API client settings for interactions with a z/OS remote host running an RSE API server.","required":["mappings","default.encoding"],"properties":{"mappings":{"type":"array","description":"A list of mapping objects that map local file extensions to transfer modes and encodings to MVS data sets that can be specified using wildcards.","items":{"$ref":"#/definitions/rseapiSettingsItemMapping"}},"default.encoding":{"type":"string","description":"The encoding to be used when no mapping can be found. If not provided then either the user or server default will be used."}}},"rseapiSettingsItemMapping":{"type":"object","additionalProperties":false,"description":"One mapping that contains at least transfer and resource values.","properties":{"extension":{"type":"string","description":"A local file extension such as cbl or pl1."},"transfer":{"type":"string","enum":["text","binary"],"description":"The transfer mode to be used. Can be \'text\' or \'binary\'."},"resource":{"type":"string","description":"The data set name to be mapped to. Can use a wildcard such as \'**CPY\'."},"encoding":{"type":"string","description":"The encoding to be used for text transfer. See the RSE API documentation for the values allowed."},"memberMappings":{"type":"array","items":{"type":"object","additionalProperties":false,"description":"One member mapping that contains at least transfer and resource values.","properties":{"extension":{"type":"string","description":"A local file extension such as cbl or pl1."},"transfer":{"type":"string","enum":["text","binary"],"description":"The transfer mode to be used. Can be \'text\' or \'binary\'."},"encoding":{"type":"string","description":"The encoding to be used for text transfer. See the RSE API documentation for the values allowed."},"resource":{"type":"string","description":"The data set member name to be mapped to. Can use a wildcard such as \'**CPY\'."}}},"description":"A nested mappings array with resource mappings to members of the data sets that were mapped by the parent mapping."}}},"localPreprocessorSettingsItem":{"type":"object","additionalProperties":false,"description":"Preprocessor properties for preprocessing COBOL/PL/I files.","required":["command","outputPath","fileExtension"],"properties":{"command":{"type":"string","description":"The command to run to execute the preprocessor executable."},"outputPath":{"type":"string","description":"Path where preprocessor produces its build output."},"fileExtension":{"type":"string","description":"The desired file extension for the post-processed file."},"environmentVariables":{"type":"object","additionalProperties":false,"description":"Specifies any user defined environment variables to be passed to the preprocessor.","patternProperties":{"[a-zA-Z_][a-zA-Z0-9_]*":{"anyOf":[{"type":"string"}]}}}}},"mvsPreprocessorSettingsItem":{"type":"object","additionalProperties":false,"description":"Preprocessor properties for preprocessing COBOL/PL/I files.","required":["commandDataSet","outputDataSet","tempDataHLQ"],"properties":{"commandDataSet":{"type":"string","description":"Specifies an input listing sequential data set."},"commandParameters":{"type":"string","description":"The parameters for the command being run."},"outputDataSet":{"type":"string","description":"Specifies an output listing sequential data set."},"tempDataHLQ":{"type":"string","description":"Specifies the high-level qualifier used for data sets created by plug-in requests to export observation files."},"programDataSet":{"type":"string","description":"Specifies the data set where local programs will be uploaded for preprocessing."}}},"testApplicationToCapture":{"type":"object","additionalProperties":false,"description":"Specify what to capture in an application.","properties":{"recordingType":{"type":"string","enum":["CICS","Batch","IMS"],"description":"Type of application that will be recorded."},"jclSteps":{"type":"string","description":"Provide a path to a JCL file that runs the application to be recorded."},"programs":{"type":"array","description":"Provide name of the program to capture.","items":{"type":"string"}},"transactionId":{"type":"string","description":"Provide a transaction id to capture in the recording."}},"if":{"properties":{"recordingType":{"enum":["CICS","IMS"]}}},"then":{"required":["transactionId"],"not":{"required":["jclSteps"]}},"else":{"not":{"required":["transactionId"]},"required":["jclSteps"]}},"testSourceMap":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","description":"The workspace-relative path to an application source file."},"module":{"type":"string","description":"The z/OS load module name that corresponds to the specified source file."}}},"testSourceMaps":{"type":"array","description":"Specify which application load modules correspond to application source files.","items":{"$ref":"#/definitions/testSourceMap"}},"testHostRecordingSettings":{"type":"object","additionalProperties":false,"description":"Specify host settings for the recording tool.","properties":{"applicationDbrmLibrary":{"type":"string","description":"Required if recording and replaying DB2 statements."},"cicsRegion":{"type":"string","description":"If recording a CICS application, specify a CICS region where the application is running."},"dteEngineLocation":{"type":"string","description":"If recording a batch application, specify the data set where Debug Test Engine load library is located."},"imsSubsystemId":{"type":"string","description":"If recording an IMS application, specify the subsystem id."}}},"testRecordingSettings":{"type":"object","additionalProperties":false,"description":"Specify settings for the recording application tool.","properties":{"applicationToCapture":{"$ref":"#/definitions/testApplicationToCapture"},"hostRecordingSettings":{"$ref":"#/definitions/testHostRecordingSettings"},"sourceMaps":{"$ref":"#/definitions/testSourceMaps"}}},"testSettingsItem":{"type":"object","additionalProperties":false,"description":"Test properties for a test case.","properties":{"recording":{"$ref":"#/definitions/testRecordingSettings"},"unitTest":{"$ref":"#/definitions/unitTestSettings"},"functionalTest":{"$ref":"#/definitions/functionalTestSettings"}}},"unitTestSettings":{"type":"object","additionalProperties":false,"description":"Properties to run a unit test case.","required":["procLib"],"properties":{"procLib":{"type":"array","description":"Specifies the list of Procedure libraries.","items":{"type":"string"}},"allocateWorkingDs":{"type":"boolean","description":"If this option is selected, the data set for the working file is allocated automatically with the allocation options."},"ioDataSetAllocation":{"type":"object","description":"Options to allocate a working file.","properties":{"ioSpaceUnit":{"type":"string","enum":["TRACKS","BLOCKS","CYLINDERS"],"description":"The unit of primary and secondary space to be allocated."},"ioQuant1":{"type":"integer","description":"The amount of DASD space to be used for primary space allocation (PRIMARY)."},"ioQuant2":{"type":"integer","description":"The amount of DASD space to be used for secondary space allocation (SECONDARY)."},"ioHLQ":{"type":"string","description":"The high-level qualifier for the VSAM or QSAM data files for file I/O simulation. These files are allocated when running a Unit test case."}}},"configDS":{"type":"string","description":"Runner configuration destination container."},"resultDS":{"type":"string","description":"Runner result destination container."},"userLibraries":{"type":"array","description":"The datat set of the application under test.","items":{"type":"string"}},"defaultTestCaseFolder":{"type":"string","description":"The default local folder to create the test case artifacts."},"jobcard":{"type":"string","description":"The job card to run a unit test."}}},"substitutionMapSettings":{"type":"object","additionalProperties":false,"description":"Specify settings for the functional test substitution map.","properties":{"cicsTag":{"type":"string","description":"If recording a CICS application, specify the cicsts.dse.tag from the .galasa/cps.properties file."},"imageTag":{"type":"string","description":"If recording a CICS or IMS application, specify the zos.dse.tag from the .galasa/cps.properties file."},"dbPrefix":{"type":"string","description":"If recording a CICS application, specify the Db2 DB ID that was established when the Db2 instance was created."},"dbSchema":{"type":"string","description":"If recording a CICS application, specify the db2.dse.schema.PRIMARY.name from the .galasa/cps.properties."},"loginCredentialsTag":{"type":"string","description":"If recording a CICS or IMS application, specify the zos.image.x.credentials value from the .galasa/cps.properties."},"imsTag":{"type":"string","description":"If recording an IMS application, specify the imstm.dse.tag from the .galasa/cps.properties."},"dliTag":{"type":"string","description":"If recording an IMS application, specify the dli.database.tag.{imsTag}.datastore value from the .galasa/cps.properties."}}},"functionalTestSettings":{"type":"object","additionalProperties":false,"description":"Specify settings for the functional test.","properties":{"defaultTestCaseFolder":{"type":"string","description":"Specify the path to the default test case folder."},"codePages":{"type":"string","description":"Specify the code pages to be used."},"localBmsMapNames":{"type":"array","description":"Specify an array of local BMS files.","items":{"type":"string"}},"localMfsFiles":{"type":"array","description":"Specify an array of local MFS files from the mfs-maps directory to be used for generating accurate test files. Ex: sample.mfs.","items":{"type":"string"}},"localDb2Config":{"type":"array","description":"Specify an array of local Db2 Config files.","items":{"type":"string"}},"substitutionMap":{"$ref":"#/definitions/substitutionMapSettings"}}}},"anyOf":[{"$ref":"#/definitions/coreProperties"}]}');class $04802ddbf77b0972$export$20a2815e8c83febb extends $06319fbb034d54be$export$3fa3a1ffc042110d{static{this.validationFunction=$04802ddbf77b0972$export$20a2815e8c83febb.initAjvValidator()}static initAjvValidator(){let e=new($parcel$interopDefault($hsidQ$ajv))({allErrors:!0,strictTuples:!1,allowUnionTypes:!0});return $parcel$interopDefault($hsidQ$ajvformats)(e),e.compile($67f77f420084733b$exports)}static createFromYamlString(e){return new $04802ddbf77b0972$export$20a2815e8c83febb(e)}static createFromJsonString(e){let t="";try{let r=JSON.parse(e);return t=$hsidQ$jsyaml.dump(r),this.createFromYamlString(t)}catch(e){return new $04802ddbf77b0972$export$20a2815e8c83febb(t,e?.message||e)}}static createFromObject(e){return this.createFromJsonString(JSON.stringify(e))}static async createFromYamlFile(e){let t="";try{t=await this.readFileWithRetry(e);let r=this.createFromYamlString(t);return r.file={path:e,type:"yaml"},r}catch(e){return new $04802ddbf77b0972$export$20a2815e8c83febb(t,e?.message||e)}}static async createFromJsonFile(e){let t="";try{t=await this.readFileWithRetry(e);let r=this.createFromJsonString(t);return r.file={path:e,type:"json"},r}catch(e){return new $04802ddbf77b0972$export$20a2815e8c83febb(t,e?.message||e)}}static async createFromFile(e){return e?.endsWith(".yaml")||e?.endsWith(".yml")?await this.createFromYamlFile(e):e?.endsWith(".json")?await this.createFromJsonFile(e):new $04802ddbf77b0972$export$20a2815e8c83febb("","Invalid filename for reading a ZAPP file.")}static async loadFromWorkspace(e){let t=this.findZappFile(e);return t?.type==="yaml"?await this.createFromYamlFile(t.path):t?.type==="json"?await this.createFromJsonFile(t.path):new $04802ddbf77b0972$export$20a2815e8c83febb("",`No ZAPP file was found in "${e}".`)}static findZappFile(e){if(!e)return;let t=$hsidQ$path.normalize(e),r=$hsidQ$path.join(t,"zapp.yaml");if($hsidQ$fs.existsSync(r))return{path:r,type:"yaml"};let i=$hsidQ$path.join(t,"zapp.yml");if($hsidQ$fs.existsSync(i))return{path:i,type:"yaml"};let a=$hsidQ$path.join(t,"zapp.json");if($hsidQ$fs.existsSync(a))return{path:a,type:"json"}}static isZappFileName(e){return/^(zapp\.)(yml|yaml|json)$/.test(e)}getVariables(){let e=[],t=this.getAsYaml();if(t){let r=t.match(/\${.*?}/g);r&&(e=(e=[...new Set(r)]).map(e=>e.replace(/[${}]/g,"")))}return e}getAsDocument(){try{let e=this.yawn.json;if(e)return e}catch(e){this.prependErrorMessage(e?.message)}}validate(){if(this.yawn){if(this.isValid=$04802ddbf77b0972$export$20a2815e8c83febb.validationFunction(this.getAsObject()),!this.isValid){let e=$04802ddbf77b0972$export$20a2815e8c83febb.validationFunction.errors;return e?e.forEach(e=>{let t=e.message;if(e.params){let r=e.params,i=Object.keys(r).map(e=>`${e}:${r[e]}`);t=`${t}(${i})`}this.appendErrorMessage(t)}):this.appendErrorMessage("Unknown validation error."),!1}return!0}return!1}constructor(...e){super(...e),this.type="zapp"}}class $33f2606524745ccb$export$c06d94e9d38b8bae extends $b1285f501b3f0a4a$export$2941748d4d27acfc{static{this.cacheType="zapp"}static getInstance(){return this.instance||(this.instance=new $33f2606524745ccb$export$c06d94e9d38b8bae(this.cacheType)),this.instance}static resetInstance(){this.instance=void 0}static getZappDocument(e){if(!e)return;let t=this.getInstance().normalizePath(e);if(this.getInstance().documentsCache.has(t))return this.getInstance().numberDocsFound++,this.getInstance().documentsCache.get(t)}static async loadZappDocument(e,t){if(!e)return;let r=this.getInstance().normalizePath(e),i=await $04802ddbf77b0972$export$20a2815e8c83febb.createFromFile(r),a=t;return t||(a=$hsidQ$path.dirname(r)),this.getInstance().addDocument(e,a,i),this.getInstance().numberDocsAdded++,i}static removeZappDocument(e){return this.getInstance().removeDocument(e)}static clearZappDocument(e){this.getInstance().clearSchemaDocument(e)}static getZappDocumentInWorkspace(e){if(!e)return;let t=this.getInstance().normalizePath(e),r=this.getInstance().workspacesMap.get(t);if(r)return this.getZappDocument(r)}static async loadZappDocumentInWorkspace(e){let t=this.getInstance().normalizePath(e),r=$04802ddbf77b0972$export$20a2815e8c83febb.findZappFile(t);if(r){let i=await this.loadZappDocument(r.path,e);return this.getInstance().workspacesMap.set(t,r.path),i}}isValidFilename(e){return $04802ddbf77b0972$export$20a2815e8c83febb.isZappFileName(e)}static getVariablesFromAllDocs(){let e=[];for(let t of this.getInstance().documentsCache.values())t instanceof $04802ddbf77b0972$export$20a2815e8c83febb&&e.push(...t.getVariables());return e.length>1&&(e=[...new Set(e)]),e}static getCacheSize(){return this.getInstance().getCacheSize()}static getAllDocumentLocations(){return this.getInstance().getAllDocumentLocations()}static getCacheStats(){return this.getInstance().getCacheStats()}static clearCache(){this.getInstance().clearCache(),this.resetInstance()}}var $ca913c503ff973ee$exports={};$parcel$export($ca913c503ff973ee$exports,"ZappUserVariablesCache",()=>$ca913c503ff973ee$export$99d400c8aa397dfe);class $ca913c503ff973ee$export$99d400c8aa397dfe{static getInstance(){return this.instance||(this.instance=new $ca913c503ff973ee$export$99d400c8aa397dfe),this.instance}static resetInstance(){this.instance=void 0}static saveZappUserVariables(e){$ca913c503ff973ee$export$99d400c8aa397dfe.getInstance().zappUserSettingsMap=e,$ca913c503ff973ee$export$99d400c8aa397dfe.getInstance().zappUserSettingsMap.forEach((e,t)=>{if(e.includes($parcel$interopDefault($hsidQ$path).win32.sep)){let r=e.split($parcel$interopDefault($hsidQ$path).win32.sep).join($parcel$interopDefault($hsidQ$path).posix.sep);$ca913c503ff973ee$export$99d400c8aa397dfe.getInstance().zappUserSettingsMap.set(t,r)}})}static getZappUserVariables(){return $ca913c503ff973ee$export$99d400c8aa397dfe.getInstance().zappUserSettingsMap}static clearCache(){$ca913c503ff973ee$export$99d400c8aa397dfe.getInstance().zappUserSettingsMap.clear(),this.resetInstance()}static replaceUserVariables(e){if(!e)return;let t=JSON.stringify(e),r=$ca913c503ff973ee$export$99d400c8aa397dfe.getZappUserVariables();if(!r||0===r.size)return e;let i=t.replace(/\${.*?\}/g,e=>{let t=e.slice(2,-1),i=r.get(t)??e;return t.replace(t,i)});try{return JSON.parse(i)}catch(t){return e}}constructor(){this.zappUserSettingsMap=new Map}}class $fac1dbefdcd03230$export$117dc7eeb984edf6{static getPropertyGroups(e,t){let r=[],i=$33f2606524745ccb$export$c06d94e9d38b8bae.getZappDocumentInWorkspace(e);if(i&&!i.errorMessages){let e=i.getAsDocument();if(e){let i=e.propertyGroups;i&&(r=i,t&&(r=i.filter(e=>!e.language||e.language===t)))}}return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(r)}}var $7000f33b169d3c58$exports={};$parcel$export($7000f33b169d3c58$exports,"UserBuildController",()=>$7000f33b169d3c58$export$b43c0013e41642ea);var $32042bc06eedcf31$exports={};$parcel$export($32042bc06eedcf31$exports,"ZappProfilesController",()=>$32042bc06eedcf31$export$4d46d6e73f3dbcd7);class $32042bc06eedcf31$export$4d46d6e73f3dbcd7{static getZappProfiles(e){let t=$33f2606524745ccb$export$c06d94e9d38b8bae.getZappDocumentInWorkspace(e);if(!t||t.errorMessages)return;let r=t.getAsDocument();if(r&&r.profiles&&0!==r.profiles.length)return r.profiles}static async loadZappProfiles(e){if(await $33f2606524745ccb$export$c06d94e9d38b8bae.loadZappDocumentInWorkspace(e))return this.getZappProfiles(e)}}var $42ac5850af2f6ebc$exports={};$parcel$export($42ac5850af2f6ebc$exports,"zappConstants",()=>$42ac5850af2f6ebc$export$5b17e1594a60a665);let $42ac5850af2f6ebc$export$5b17e1594a60a665={profileTypeDbb:"dbb",profileTypeRseApi:"rseapi",propertyPropertyGroups:"propertyGroups",profileTypePreprocessor:"preprocessor",profileTypeTest:"test"};class $7000f33b169d3c58$export$b43c0013e41642ea extends $32042bc06eedcf31$export$4d46d6e73f3dbcd7{static getUserBuildProfileNames(e){let t=this.getZappProfiles(e);if(t&&t.length>0)return t.filter(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeDbb).map(e=>e.name)}static getUserBuildSettings(e,t){let r=this.getZappProfiles(e);if(r&&r.length>0)if(t){let e=r.find(e=>e.name===t);if(e?.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeDbb)return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e.settings)}else{let e=r.find(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeDbb);return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e?.settings)}}}var $ea473087bd4a8ebb$exports={};$parcel$export($ea473087bd4a8ebb$exports,"RseApiController",()=>$ea473087bd4a8ebb$export$3646e96376a215d6);class $ea473087bd4a8ebb$export$3646e96376a215d6 extends $32042bc06eedcf31$export$4d46d6e73f3dbcd7{static getRseApiProfileNames(e){let t=this.getZappProfiles(e);if(t&&t.length>0)return t.filter(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeRseApi).map(e=>e.name)}static onlyOneMappingsEntry(e){let t=this.getRseApiProfileNames(e);return t?.length===1}static getRseApiSettings(e){let t=this.getZappProfiles(e);if(t&&t.length>0){let e=t.find(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeRseApi);return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e?.settings)}}static async loadRseApiSettings(e){if(await this.loadZappProfiles(e))return this.getRseApiSettings(e)}}var $619321c7228d4c17$exports={};$parcel$export($619321c7228d4c17$exports,"PreprocessorController",()=>$619321c7228d4c17$export$9dae19ebbff35912);class $619321c7228d4c17$export$9dae19ebbff35912 extends $32042bc06eedcf31$export$4d46d6e73f3dbcd7{static getPreprocessorProfileNames(e,t){let r=this.getZappProfiles(e);if(r&&r.length>0)return r.filter(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypePreprocessor&&"language"in e&&(void 0===t||e.language===t)).map(e=>e.name)}static getPreprocessorProfileNamesBasedOnLocation(e,t,r){let i=this.getZappProfiles(e);if(i&&i.length>0)return i.filter(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypePreprocessor&&"location"in e&&e.location===t&&(void 0===r||e.language===r)).map(e=>e.name)}static getLocalPreprocessorSettings(e,t){let r=this.getZappProfiles(e);if(r&&r.length>0){let e=r.find(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypePreprocessor&&"location"in e&&"local"===e.location&&(void 0===t||e.language===t));return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e?.settings)}}static getMvsPreprocessorSettings(e,t){let r=this.getZappProfiles(e);if(r&&r.length>0){let e=r.find(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypePreprocessor&&"location"in e&&"mvs"===e.location&&(void 0===t||e.language===t));return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e?.settings)}}static getLocalPreprocessorProfileNamesBasedOnName(e,t,r){let i=this.getZappProfiles(e);if(i&&i.length>0){let e=i.find(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypePreprocessor&&"location"in e&&"local"===e.location&&e.name===t&&(void 0===r||e.language===r));return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e?.settings)}}static getMvsPreprocessorProfileNamesBasedOnName(e,t,r){let i=this.getZappProfiles(e);if(i&&i.length>0){let e=i.find(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypePreprocessor&&"location"in e&&"mvs"===e.location&&e.name===t&&(void 0===r||e.language===r));return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e?.settings)}}static getPreprocessorProfile(e,t,r){let i=this.getZappProfiles(e);if(i&&i.length>0){let e=i.filter(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypePreprocessor&&"location"in e&&(void 0===r||e.location===r)&&(void 0===t||e.language===t));return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e)}}}var $161ed02e8a1bf000$exports={};$parcel$export($161ed02e8a1bf000$exports,"TestController",()=>$161ed02e8a1bf000$export$eddf153237ef6277);class $161ed02e8a1bf000$export$eddf153237ef6277 extends $32042bc06eedcf31$export$4d46d6e73f3dbcd7{static getTestProfileNames(e){let t=this.getZappProfiles(e);if(t&&t.length>0)return t.filter(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeTest).map(e=>e.name)}static getTestSettings(e,t){let r=this.getZappProfiles(e);if(r&&r.length>0)if(t){let e=r.find(e=>e.name===t);if(e?.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeTest)return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e.settings)}else{let e=r.find(e=>e.type===$42ac5850af2f6ebc$export$5b17e1594a60a665.profileTypeTest);return $ca913c503ff973ee$export$99d400c8aa397dfe.replaceUserVariables(e?.settings)}}}$parcel$exportWildcard($29ee84a662b1b8fd$exports,$fac1dbefdcd03230$exports),$parcel$exportWildcard($29ee84a662b1b8fd$exports,$7000f33b169d3c58$exports),$parcel$exportWildcard($29ee84a662b1b8fd$exports,$ea473087bd4a8ebb$exports),$parcel$exportWildcard($29ee84a662b1b8fd$exports,$32042bc06eedcf31$exports),$parcel$exportWildcard($29ee84a662b1b8fd$exports,$619321c7228d4c17$exports),$parcel$exportWildcard($29ee84a662b1b8fd$exports,$161ed02e8a1bf000$exports);var $4d56b609164198fa$exports={},$9e2faf2482a47e58$exports={};$parcel$exportWildcard($4d56b609164198fa$exports,$9e2faf2482a47e58$exports),$parcel$exportWildcard($4d56b609164198fa$exports,$04802ddbf77b0972$exports),$parcel$exportWildcard($4d56b609164198fa$exports,$33f2606524745ccb$exports),$parcel$exportWildcard($4d56b609164198fa$exports,$42ac5850af2f6ebc$exports),$parcel$exportWildcard($4d56b609164198fa$exports,$ca913c503ff973ee$exports),$parcel$exportWildcard($f8f1f978d697847d$exports,$29ee84a662b1b8fd$exports),$parcel$exportWildcard($f8f1f978d697847d$exports,$4d56b609164198fa$exports),$parcel$exportWildcard(module.exports,$db89a39d91b9746d$exports),$parcel$exportWildcard(module.exports,$f8f1f978d697847d$exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibm/zapp-core",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "IBM ZAPP parser and core utilities",
   "publisher": "IBM",
   "license": "SEE LICENSE IN LICENSE.txt",
@@ -20,8 +20,8 @@
     "yawn-yaml": "1.5.0"
   },
   "devDependencies": {
-    "@parcel/packager-ts": "^2.11.0",
-    "@parcel/transformer-typescript-types": "^2.11.0",
+    "@parcel/packager-ts": "^2.15.4",
+    "@parcel/transformer-typescript-types": "^2.15.4",
     "@types/jest": "^29.5.10",
     "@types/js-yaml": "4.0.5",
     "@types/node": "20.x",
@@ -41,13 +41,16 @@
     "jest-stare": "^2.5.1",
     "json-schema-to-typescript": "10.1.0",
     "madge": "^8.0.0",
-    "parcel": "^2.11.0",
+    "parcel": "^2.15.4",
     "prettier": "3.1.0",
     "rimraf": "^4.1.2",
-    "tmp": "0.2.1",
+    "tmp": "0.2.5",
     "ts-jest": "^29.1.1",
     "typescript": "^5.3.2"
   },
+  "optionalDependencies": {
+    "@parcel/watcher-linux-x64-glibc": "^2.5.1"
+  },
   "overrides": {
     "semver": "^7.5.3",
     "word-wrap": "^1.2.4"
@@ -68,7 +71,7 @@
   "scripts": {
     "prebuild": "npm run build:resources",
     "build": "tsc --pretty && npm run checkDeps && npm run lintErrors",
-    "build:resources": "rimraf resources/* && copyfiles -f ../../schema/*-schema-1.3.0.json ./resources",
+    "build:resources": "rimraf resources/* ../../schema/zapp-schema-*.json && node ../../scripts/schema-version.js && copyfiles -f ../../schema/zapp-schema-*.json ./resources",
     "build:version": "npm version --new-version $npm_package_version-`date '+%Y%m%d%H%M'`-`git rev-parse --short HEAD` --no-git-tag-version",
     "build:package": "npm run clean &&  parcel build",
     "build:test": "npm run clean && npm run build && npm run test",
@@ -82,7 +85,7 @@
     "plotDeps": "madge --extensions ts --image ./docs/dependency-graph.svg ./src",
     "pretty": "prettier --write .",
     "get-version": "echo $npm_package_version",
-    "generate-schema": "node ./scripts/generate-zapp-interface.js",
+    "generate-schema": "node ../../scripts/schema-version.js && node ./scripts/generate-zapp-interface.js",
     "test": "jest --coverage"
   },
   "jest": {

package/resources/{zapp-schema-1.3.0.json → zapp-schema-1.5.0.json}

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "IBM Zapp Document",
-  "description": "JSON schema for zapp.json and zapp.yaml files. Version 1.3.0 -- Licensed Materials - Property of IBM - (c) Copyright IBM Corporation 2022, 2024. All Rights Reserved.",
+  "description": "JSON schema for zapp.json and zapp.yaml files. Version 1.5.0 -- Licensed Materials - Property of IBM - (c) Copyright IBM Corporation 2022, 2025. All Rights Reserved.",
   "type": "object",
   "definitions": {
     "coreProperties": {
@@ -139,12 +139,12 @@
           "type": "string",
           "description": "Name of the library. The default name should be `syslib` if using unnamed libraries.",
           "default": "syslib",
-          "examples": ["syslib", "jcllib", "maclib", "currencylib"]
+          "examples": ["syslib", "jcllib", "proclib", "maclib", "currencylib"]
         },
         "type": {
           "type": "string",
           "enum": ["mvs", "local"],
-          "description": "The type of the property group defining where dependencies should be located. Allowed values are 'local' for using a local workspace and 'mvs' for dependencies located in MVS Datasets.",
+          "description": "The type of the property group defining where dependencies should be located. Allowed values are 'local' for using a local workspace and 'mvs' for dependencies located in MVS data sets.",
           "default": "local",
           "examples": ["local", "mvs"]
         },
@@ -158,10 +158,23 @@
         }
       },
       "if": {
-        "properties": { "name": { "const": "jcllib", "type": "string" }, "type": { "const": "mvs", "type": "string" } }
+        "properties": {
+          "name": {
+            "enum": ["jcllib", "proclib"],
+            "type": "string"
+          },
+          "type": {
+            "const": "mvs",
+            "type": "string"
+          }
+        }
+      },
+      "then": {
+        "required": ["name", "type"]
       },
-      "then": { "required": ["name", "type"] },
-      "else": { "required": ["name", "type", "locations"] }
+      "else": {
+        "required": ["name", "type", "locations"]
+      }
     },
     "person": {
       "description": "A person who has been involved in creating or maintaining this package",
@@ -216,52 +229,110 @@
       },
       "oneOf": [
         {
+          "title": "Dependency-Based Build profile",
           "required": ["name", "type", "settings"],
           "additionalProperties": false,
           "properties": {
-            "name": { "type": "string" },
-            "type": { "const": "dbb", "type": "string" },
+            "name": {
+              "type": "string"
+            },
+            "type": {
+              "const": "dbb",
+              "type": "string"
+            },
             "settings": {
-              "oneOf": [{ "$ref": "#/definitions/dbbBuilderSettings" }, { "$ref": "#/definitions/dbbGroovySettings" }]
+              "oneOf": [
+                {
+                  "$ref": "#/definitions/dbbBuilderSettings"
+                },
+                {
+                  "$ref": "#/definitions/dbbGroovySettings"
+                }
+              ]
             }
           }
         },
         {
+          "title": "RSE API profile",
           "required": ["name", "type", "settings"],
           "additionalProperties": false,
           "properties": {
-            "name": { "type": "string" },
-            "type": { "const": "rseapi", "type": "string" },
+            "name": {
+              "type": "string"
+            },
+            "type": {
+              "const": "rseapi",
+              "type": "string"
+            },
             "settings": {
               "$ref": "#/definitions/rseapiSettingsItem"
             }
           }
         },
         {
+          "title": "Preprocessor profile",
           "required": ["name", "type", "settings", "location", "language"],
           "additionalProperties": false,
           "properties": {
-            "name": { "type": "string" },
-            "language": { "type": "string" },
-            "type": { "const": "preprocessor", "type": "string" },
-            "location": { "type": "string" },
+            "name": {
+              "type": "string"
+            },
+            "language": {
+              "type": "string"
+            },
+            "type": {
+              "const": "preprocessor",
+              "type": "string"
+            },
+            "location": {
+              "type": "string"
+            },
             "settings": {
               "oneOf": [
-                { "$ref": "#/definitions/localPreprocessorSettingsItem" },
-                { "$ref": "#/definitions/mvsPreprocessorSettingsItem" }
+                {
+                  "$ref": "#/definitions/localPreprocessorSettingsItem"
+                },
+                {
+                  "$ref": "#/definitions/mvsPreprocessorSettingsItem"
+                }
               ]
             }
           },
-          "if": { "properties": { "location": { "const": "local", "type": "string" } } },
-          "then": { "properties": { "settings": { "$ref": "#/definitions/localPreprocessorSettingsItem" } } },
-          "else": { "properties": { "settings": { "$ref": "#/definitions/mvsPreprocessorSettingsItem" } } }
+          "if": {
+            "properties": {
+              "location": {
+                "const": "local",
+                "type": "string"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "settings": {
+                "$ref": "#/definitions/localPreprocessorSettingsItem"
+              }
+            }
+          },
+          "else": {
+            "properties": {
+              "settings": {
+                "$ref": "#/definitions/mvsPreprocessorSettingsItem"
+              }
+            }
+          }
         },
         {
+          "title": "Test profile",
           "required": ["name", "type", "settings"],
           "additionalProperties": false,
           "properties": {
-            "name": { "type": "string" },
-            "type": { "const": "test", "type": "string" },
+            "name": {
+              "type": "string"
+            },
+            "type": {
+              "const": "test",
+              "type": "string"
+            },
             "settings": {
               "$ref": "#/definitions/testSettingsItem"
             }
@@ -355,8 +426,10 @@
       "properties": {
         "mappings": {
           "type": "array",
-          "description": "A list of mapping objects that map local file extensions to transfer modes and encodings to MVS datasets that can be specified using wildcards.",
-          "items": { "$ref": "#/definitions/rseapiSettingsItemMapping" }
+          "description": "A list of mapping objects that map local file extensions to transfer modes and encodings to MVS data sets that can be specified using wildcards.",
+          "items": {
+            "$ref": "#/definitions/rseapiSettingsItemMapping"
+          }
         },
         "default.encoding": {
           "type": "string",
@@ -440,7 +513,11 @@
           "description": "Specifies any user defined environment variables to be passed to the preprocessor.",
           "patternProperties": {
             "[a-zA-Z_][a-zA-Z0-9_]*": {
-              "anyOf": [{ "type": "string" }]
+              "anyOf": [
+                {
+                  "type": "string"
+                }
+              ]
             }
           }
         }
@@ -467,6 +544,116 @@
         "tempDataHLQ": {
           "type": "string",
           "description": "Specifies the high-level qualifier used for data sets created by plug-in requests to export observation files."
+        },
+        "programDataSet": {
+          "type": "string",
+          "description": "Specifies the data set where local programs will be uploaded for preprocessing."
+        }
+      }
+    },
+    "testApplicationToCapture": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Specify what to capture in an application.",
+      "properties": {
+        "recordingType": {
+          "type": "string",
+          "enum": ["CICS", "Batch", "IMS"],
+          "description": "Type of application that will be recorded."
+        },
+        "jclSteps": {
+          "type": "string",
+          "description": "Provide a path to a JCL file that runs the application to be recorded."
+        },
+        "programs": {
+          "type": "array",
+          "description": "Provide name of the program to capture.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "transactionId": {
+          "type": "string",
+          "description": "Provide a transaction id to capture in the recording."
+        }
+      },
+      "if": {
+        "properties": {
+          "recordingType": {
+            "enum": ["CICS", "IMS"]
+          }
+        }
+      },
+      "then": {
+        "required": ["transactionId"],
+        "not": {
+          "required": ["jclSteps"]
+        }
+      },
+      "else": {
+        "not": {
+          "required": ["transactionId"]
+        },
+        "required": ["jclSteps"]
+      }
+    },
+    "testSourceMap": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "source": {
+          "type": "string",
+          "description": "The workspace-relative path to an application source file."
+        },
+        "module": {
+          "type": "string",
+          "description": "The z/OS load module name that corresponds to the specified source file."
+        }
+      }
+    },
+    "testSourceMaps": {
+      "type": "array",
+      "description": "Specify which application load modules correspond to application source files.",
+      "items": {
+        "$ref": "#/definitions/testSourceMap"
+      }
+    },
+    "testHostRecordingSettings": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Specify host settings for the recording tool.",
+      "properties": {
+        "applicationDbrmLibrary": {
+          "type": "string",
+          "description": "Required if recording and replaying DB2 statements."
+        },
+        "cicsRegion": {
+          "type": "string",
+          "description": "If recording a CICS application, specify a CICS region where the application is running."
+        },
+        "dteEngineLocation": {
+          "type": "string",
+          "description": "If recording a batch application, specify the data set where Debug Test Engine load library is located."
+        },
+        "imsSubsystemId": {
+          "type": "string",
+          "description": "If recording an IMS application, specify the subsystem id."
+        }
+      }
+    },
+    "testRecordingSettings": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Specify settings for the recording application tool.",
+      "properties": {
+        "applicationToCapture": {
+          "$ref": "#/definitions/testApplicationToCapture"
+        },
+        "hostRecordingSettings": {
+          "$ref": "#/definitions/testHostRecordingSettings"
+        },
+        "sourceMaps": {
+          "$ref": "#/definitions/testSourceMaps"
         }
       }
     },
@@ -474,72 +661,154 @@
       "type": "object",
       "additionalProperties": false,
       "description": "Test properties for a test case.",
-      "required": ["unitTest"],
       "properties": {
+        "recording": {
+          "$ref": "#/definitions/testRecordingSettings"
+        },
         "unitTest": {
+          "$ref": "#/definitions/unitTestSettings"
+        },
+        "functionalTest": {
+          "$ref": "#/definitions/functionalTestSettings"
+        }
+      }
+    },
+    "unitTestSettings": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Properties to run a unit test case.",
+      "required": ["procLib"],
+      "properties": {
+        "procLib": {
+          "type": "array",
+          "description": "Specifies the list of Procedure libraries.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "allocateWorkingDs": {
+          "type": "boolean",
+          "description": "If this option is selected, the data set for the working file is allocated automatically with the allocation options."
+        },
+        "ioDataSetAllocation": {
           "type": "object",
-          "additionalProperties": false,
-          "description": "Properties to run a unit test case.",
-          "required": ["procLib"],
+          "description": "Options to allocate a working file.",
           "properties": {
-            "procLib": {
-              "type": "array",
-              "description": "Specifies the list of Procedure libraries.",
-              "items": {
-                "type": "string"
-              }
-            },
-            "allocateWorkingDs": {
-              "type": "boolean",
-              "description": " If this option is selected, the data set for the working file is allocated automatically with the allocation options."
-            },
-            "ioDataSetAllocation": {
-              "type": "object",
-              "description": "Options to allocate a working file.",
-              "properties": {
-                "ioSpaceUnit": {
-                  "type": "string",
-                  "enum": ["TRACKS", "BLOCKS", "CYLINDERS"],
-                  "description": "The unit of primary and secondary space to be allocated."
-                },
-                "ioQuant1": {
-                  "type": "integer",
-                  "description": "The amount of DASD space to be used for primary space allocation (PRIMARY)."
-                },
-                "ioQuant2": {
-                  "type": "integer",
-                  "description": "The amount of DASD space to be used for secondary space allocation (SECONDARY)."
-                },
-                "ioHLQ": {
-                  "type": "string",
-                  "description": "The high-level qualifier for the VSAM or QSAM data files for file I/O simulation. These files are allocated when running a Unit test case."
-                }
-              }
-            },
-            "configDS": {
-              "type": "string",
-              "description": "Runner configuration destination container."
-            },
-            "resultDS": {
+            "ioSpaceUnit": {
               "type": "string",
-              "description": "Runner result destination container."
+              "enum": ["TRACKS", "BLOCKS", "CYLINDERS"],
+              "description": "The unit of primary and secondary space to be allocated."
             },
-            "userLibraries": {
-              "type": "array",
-              "description": "The datat set of the application under test",
-              "items": {
-                "type": "string"
-              }
+            "ioQuant1": {
+              "type": "integer",
+              "description": "The amount of DASD space to be used for primary space allocation (PRIMARY)."
             },
-            "defaultTestCaseFolder": {
-              "type": "string",
-              "description": "The default local folder to create the test case artifacts."
+            "ioQuant2": {
+              "type": "integer",
+              "description": "The amount of DASD space to be used for secondary space allocation (SECONDARY)."
             },
-            "jobcard": {
+            "ioHLQ": {
               "type": "string",
-              "description": "The job card to run a unit test"
+              "description": "The high-level qualifier for the VSAM or QSAM data files for file I/O simulation. These files are allocated when running a Unit test case."
             }
           }
+        },
+        "configDS": {
+          "type": "string",
+          "description": "Runner configuration destination container."
+        },
+        "resultDS": {
+          "type": "string",
+          "description": "Runner result destination container."
+        },
+        "userLibraries": {
+          "type": "array",
+          "description": "The datat set of the application under test.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "defaultTestCaseFolder": {
+          "type": "string",
+          "description": "The default local folder to create the test case artifacts."
+        },
+        "jobcard": {
+          "type": "string",
+          "description": "The job card to run a unit test."
+        }
+      }
+    },
+    "substitutionMapSettings": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Specify settings for the functional test substitution map.",
+      "properties": {
+        "cicsTag": {
+          "type": "string",
+          "description": "If recording a CICS application, specify the cicsts.dse.tag from the .galasa/cps.properties file."
+        },
+        "imageTag": {
+          "type": "string",
+          "description": "If recording a CICS or IMS application, specify the zos.dse.tag from the .galasa/cps.properties file."
+        },
+        "dbPrefix": {
+          "type": "string",
+          "description": "If recording a CICS application, specify the Db2 DB ID that was established when the Db2 instance was created."
+        },
+        "dbSchema": {
+          "type": "string",
+          "description": "If recording a CICS application, specify the db2.dse.schema.PRIMARY.name from the .galasa/cps.properties."
+        },
+        "loginCredentialsTag": {
+          "type": "string",
+          "description": "If recording a CICS or IMS application, specify the zos.image.x.credentials value from the .galasa/cps.properties."
+        },
+        "imsTag": {
+          "type": "string",
+          "description": "If recording an IMS application, specify the imstm.dse.tag from the .galasa/cps.properties."
+        },
+        "dliTag": {
+          "type": "string",
+          "description": "If recording an IMS application, specify the dli.database.tag.{imsTag}.datastore value from the .galasa/cps.properties."
+        }
+      }
+    },
+    "functionalTestSettings": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Specify settings for the functional test.",
+      "properties": {
+        "defaultTestCaseFolder": {
+          "type": "string",
+          "description": "Specify the path to the default test case folder."
+        },
+        "codePages": {
+          "type": "string",
+          "description": "Specify the code pages to be used."
+        },
+        "localBmsMapNames": {
+          "type": "array",
+          "description": "Specify an array of local BMS files.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "localMfsFiles": {
+          "type": "array",
+          "description": "Specify an array of local MFS files from the mfs-maps directory to be used for generating accurate test files. Ex: sample.mfs.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "localDb2Config": {
+          "type": "array",
+          "description": "Specify an array of local Db2 Config files.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "substitutionMap": {
+          "$ref": "#/definitions/substitutionMapSettings"
         }
       }
     }