This Manager is at Alpha level. You can view the Javadoc documentation for the Manager here.

Overview
Configuring
Provided annotation
Code snippets and examples

Overview

This Manager allows Galasa tests to compile and link z/OS programs.

The @ZosProgram annotation defines the program to the Galasa test. Program attributes, for example, program name, programming language and source location are specified by using the annotation elements.

The source for the program is stored as a resource, along with the test. The z/OS Program Manager processes each @ZosProgram annotation before any of the test methods are executed.

The Manager retrieves the source from the test bundle, builds and submits the relevant compile and link JCL based on the programs attributes and CPS properties. The batch job is saved with the test run archive. The program can be executed in the test by retrieving the library containing the load module by using the getLoadLibrary() method.

You can view the Javadoc documentation for the Manager here.

Including the Manager in a test

To use the z/OS program Manager in a test you must import the @ZosProgram annotation into the test, as shown in the following example:

@ZosProgram
public IZosProgram zosProgramA;

You also need to add the Manager dependency into the pom.xml file if you are using Maven, or into the build.gradle file if you are using Gradle.

If you are using Maven, add the following dependencies into the pom.xml in the dependencies section:

<dependency>
<groupId>dev.galasa</groupId>
<artifactId>dev.galasa.zosprogram.manager</artifactId>
</dependency>

If you are using Gradle, add the following dependencies into build.gradle in the dependencies closure:

dependencies {
compileOnly 'dev.galasa:dev.galasa.zosprogram.manager'
}

Configuring

The following properties are used to configure the z/OS Program Manager.

Annotations provided by the Manager

The following annotations are available with the z/OS Program Manager

Code snippets and examples

Use the following code snippets to help you get started with the z/OS Program Manager.

@ZosProgram(name = "MYPROG",
        location = "source",
        language = Language.COBOL,
        imageTag = "A")
public IZosProgram myprog;

@ZosImage(imageTag = "A")
public IZosImage image;

@ZosBatch(imageTag = "A")
public IZosBatch zosBatch;

...

StringBuilder jcl = new StringBuilder();
jcl.append("//STEP1   EXEC PGM=");
jcl.append(myprog.getName());
jcl.append("\n");
jcl.append("//STEPLIB DD DSN=");
jcl.append(myprog.getLoadlib().getName());
jcl.append(",DISP=SHR\n");
jcl.append("//SYSOUT  DD SYSOUT=*");
IZosBatchJob job = zosBatch.submitJob(jcl.toString(), null);
...