Jenkins : IBM zOS Connector

IBM z/OS Connector is a plugin which lets you connect your Jenkins to z/OS.

Plugin Information

View IBM z/OS Connector on the plugin site for more information.

Older versions of this plugin may not be safe to use. Please review the following warnings before using an older version:

Build Status


This plugin provides its functions via FTP connection to IBM z/OS LPAR. You can configure your SCLM project on z/OS and then check for the changes via Jenkins.

Features include:

  • Submission of user JCL job (with optional log collected upon finish)
  • Introduction of SCLM as SCM for your projects allowing to checkout SCLM changes
    • The ability to build SCLM projects currently can be performed only via 'Submit zOS Job' build action

Version differences

Kindly back up your JCL texts before upgrading to version 2.0.0.
The 2.0 release uses text files instead of plaintext input, so old jobs will become obsolete.



Job Name must be configured accordingly to your FTP server configuration:

  • If JESINTERFACELEVEL=1 is configured, only a job named USERIDx (USERID - your z/OS user ID, x - strictly 1 character) can be processed correctly (when you are waiting for the job to end).
  • If JESINTERFACELEVEL=2 is configured, no additional considerations are required.

Change log

Version 2.3.2
  • (error) Fix NPE if FTP failed to list files (closed socket, etc.)
Version 2.3.1
  • (error) Regression from 2.3.0: JESINTERFACELEVEL=2 had problems with job listing and didn't check for RC (JENKINS-57549)
Version 2.3.0
  • (error) Fix JESINTERFACELEVEL=1 inconsistencies (JENKINS-56976)
  • (warning) Don't do too many reconnects (regression from 2.2.0)
  • (lightbulb) Plugin can now handle RC in JESINTERFACELEVEL=1 (but you need to check that correct level is used in Jenkins job config)
Version 2.2.0
  • (warning) Logout of the FTP server as soon as single request is performed.
    This will result in increased number of connect → login → logout → disconnect sequences, but should also make plugin more stable.
Version 2.1.0
  • (warning) Environment variables are once again expanded before job submission (JENKINS-55609)
Version 2.0.1
  • (error) Fix false positive error message if not waiting on job completion (JENKINS-54574)
Version 2.0.0
  • (lightbulb) Use credentials instead of username-password pair
  • (lightbulb) Use text file with JCL code instead of plaintext field (if you need to track SCLM in the same job - consider using Multiple SCMs plugin)
  • (lightbulb) Option to print JES job log
Version 1.2.6
  • (lightbulb) Update failure logic for slow JES initiators
Version 1.2.5
  • (warning) Use Jenkins 2+
  • (warning) Add notification about incompatibility since 1.2.4.
Version 1.2.4
  • (lightbulb) Provide different messages into the build log based on the job completion code (JENKINS-31837)
Version 1.2.3
  • (error)   JESINTERFACELEVEL=1 output changes and configuration corrections.
Version 1.2.2
  • (plus)   JESINTERFACELEVEL=1 support.
Version 1.2.1
  • Dummy release
  • (error)   Add error message if job is not listed while waiting for its execution to end (possible problem with JESINTERFACELEVEL=1).
Version 1.2.0
  • (plus)   Add JobName to output log file name. Change log file naming convention.
Version 1.1.1
  • (plus)   Add environment variables expansion for "Submit z/OS job" build step. Add loggers.
Version 1.1.0
  • (plus)   Add MaxCC papameter to 'Submit z/OS job' build step (JENKINS-29214)
Version 1.0.4
  • (plus)   Add support for 'RC unknown'.
Version 1.0.3