The Test4z sample project contains client-side installation of Test4z as well as a series of sample tests that use the Test4z API to run tests on data sets on your z/OS system.

Test4z leverages z/OSMF and Zowe to facilitate batch application testing for files on the z/OS platform. Test4z lets you perform certain operations on your data sets from a client machine. Currently, the following operations are supported:

• Compare records contained in two different data sets.
• Search through records in a data set.
• Update records in a dataset
• Copy data set with filter, skip, limit possibilities

Follow these instructions to set up the Test4z Sample project on your local machine.

Before you attempt to install the Test4z Sample project, ensure you meet the following prerequisites:

• Test4z is deployed, configured and running on your z/OS system.
• Visual Studio Code (VS Code) is installed.
• Node.js is installed.
• If you use Windows, ensure VS Code uses bash to execute shell (.sh) scripts. Follow these steps:
  1. Download and install Git BASH.
  2. In VS Code, select "Git Bash" as your default shell. Check here for guidance.
• If you have VS Code running, restart it.

Once you have met the prerequisites,

1. Clone the repository to your local machine. In VS Code:

   1. Open the command palette (Ctrl+Shift+P).
   2. Type and select "Git Clone".
   3. Enter the URL of this repository.
   4. Use your GitHub access token. (How to create a personal access token)

2. Open the Test4z Project in VS Code:

   1. Go to File > Open Folder.
   2. Open the cloned git repository.

3. To continue with the installation, refer to the Readme of the specific location:

   • Samples (Test case samples that demonstrate the features and functions of Test4z using different languages and test frameworks.)
   • Supportive Cases: (Handy test case samples that demonstrate various techniques, integrations, and subsystems)
     • DB2
     • Job Cascade
     • Ca-View

1. Exclude feature of the Compare endpoint requires a certain File Master Plus version 12.0 and the required PTF installation. Make sure you have the required PTF to be able to use the field exclusion.

See the LICENSE.md file.