MCIX DataStage Unit Test Execute GitHub Action

Run DataStage unit tests managed by MCIX as part of CI/CD.

Namespace: unit-test Action: execute Usage: DataMigrators/mcix/unit-test/execute@v1

🚀 Usage

- uses: DataMigrators/mcix/unit-test/execute@v1
  with:
    api-key: ${{ secrets.MCIX_API_KEY }}
    url: https://your-mcix-server/api
    user: dm-automation
    report: unit-tests
    project: GitHub_CP4D_DevOps

🔧 Inputs

Name	Required	Description
api-key	Yes	MCIX API key
url	Yes	MCIX URL
user	Yes	Logical user
report	Yes	Report/mode
project	Conditional	Project name
project-id	Conditional	Project ID
max-concurrency	Optional	Concurrency level
include-tags	Optional	Include tags
exclude-tags	Optional	Exclude tags
test-suite	Optional	Suite name
ignore-test-failures	Optional	Bool

📤 Outputs

Name	Description
return-code	Exit code

📚 More information

See https://nextgen.mettleci.io/mettleci-cli/unit-test-namespace/#unit-test-execute

MCIX Unit-Test Execute

Caution

This action is provided as a technology preview which may change, break, or disappear at any point and without warning.

Execute MettleCI unit tests in an IBM DataStage project on IBM Software Hub (Cloud Pak) using the MettleCI MCIX CLI

Namespace: unit-test
Action: execute
Usage: ${{ github.repository }}/unit-test/execute@v1

... where v1 is the version of the action you wish to use.

---

🚀 Usage

Minimal example:

jobs:
  unit-test-execute:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v6

      - name: Run MCIX Unit-Test Execute
        id: unit-test-execute
        uses: ${{ github.repository }}/unit-test/execute@v1
        with:
          api-key: <required>
          url: <required>
          user: <required>
          # project: <optional>
          # project-id: <optional>
          # report: reports/unit-test-report.xml
          # ignore-test-failures: false
          # max-concurrency: 8
          # test-suite: mcix tests
          # run-all: true
          # additional-args: <optional>

---

Project selection rules

• Provide exactly one of project or project-id.
• If both are supplied, the action should fail fast (ambiguous).

---

🔧 Inputs

Name	Required	Default	Description
api-key	✅		API key for authentication
url	✅		URL of the DataStage server
user	✅		Username for authentication
project	❌		DataStage project name
project-id	❌		DataStage project id
report	❌	reports/unit-test-report.xml	Path to output the compile report
ignore-test-failures	❌	false (if omitted)	Ignore test failures (always return 0)? (true/false)
max-concurrency	❌	8	Maximum number of concurrently executing test case jobs to run
test-suite	❌	mcix tests	The test suite name for this invocation of unit testing
run-all	❌	true	Skips incremental behavior and runs all unit tests (true/false)
additional-args	❌		Additional raw arguments to append to the mcix command

---

📤 Outputs

Name	Description
return-code	Exit code from mcix unit-test execute
junit-path	Path to the JUnit XML report generated by mcix unit-test execute

---

🧱 Implementation details

• runs.using: docker
• runs.image: Dockerfile

---

🧩 Notes

• The sections above are auto-generated from action.yml.
• To edit this documentation, update action.yml (name/description/inputs/outputs).