{"id":51120775,"url":"https://github.com/jenkinsci/bmc-cfa-plugin","last_synced_at":"2026-06-25T02:01:01.772Z","repository":{"id":37860361,"uuid":"434432824","full_name":"jenkinsci/bmc-cfa-plugin","owner":"jenkinsci","description":"BMC AMI DevOps for Application Checkpoint Analysis automates the process of reporting application checkpoints/commit information from IMS and DB2 logs. ","archived":false,"fork":false,"pushed_at":"2025-11-18T17:47:28.000Z","size":2598,"stargazers_count":0,"open_issues_count":1,"forks_count":8,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-19T08:41:51.688Z","etag":null,"topics":["database","devops"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/bmc-cfa/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-12-03T01:48:17.000Z","updated_at":"2025-11-18T17:37:59.000Z","dependencies_parsed_at":"2023-01-31T10:45:23.858Z","dependency_job_id":null,"html_url":"https://github.com/jenkinsci/bmc-cfa-plugin","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/jenkinsci/bmc-cfa-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fbmc-cfa-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fbmc-cfa-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fbmc-cfa-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fbmc-cfa-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/bmc-cfa-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fbmc-cfa-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34756206,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-25T02:00:05.521Z","response_time":101,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","devops"],"created_at":"2026-06-25T02:01:00.998Z","updated_at":"2026-06-25T02:01:01.743Z","avatar_url":"https://github.com/jenkinsci.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BMC AMI DevOps for Application Checkpoint Analysis  \n[![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/bmc-cfa.svg)](https://plugins.jenkins.io/bmc-cfa) \n# Table of contents\n1. [Requirements](#req)\n2. [Overview](#overview)\n3. [Authenticating the SSL Certificate](#cert)  \n4. [Screenshots](#screenshots)\n5. [Job logs](#joblogs)\n6. [Commit Frequency Report for DB2](#db2rpt)\n7. [Commit Frequency Report for IMS](#imsrpt)\n8. [Checkpoint/Commit Distribution Action](#imsrpt) \n9. [Required information for diagnosing problems](#diag)\n\n## Requirements \u003ca name=\"req\"\u003e\u003c/a\u003e\n| Required software                        | Version |\n|------------------------------------------|---------|\n| Jenkins                                  | 2.516.3 |\n| BMC AMI Log Analyzer for IMS             | 1.7.00  |\n| z/OSMF                                   |         |\n\n\n## Overview \u003ca name=\"overview\"\u003e\u003c/a\u003e\nBMC AMI DevOps for Application Checkpoint Analysis plugin can be invoked as a Jenkins job's **build step**, and trigger the process of reporting application checkpoints/commit information from IMS and DB2 logs. It can be used to illustrate the impact of changes made by application programs on IMS databases, by comparing checkpoint reports before and after the implemented changes.\n\n![BMC build step](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/bmc_build_step.jpg)\n\n**Use case:** \nThe plugin can be integrated as part of the development life cycle for application development team, where one of the steps does checkpoint/commit analysis.\n\n\nIt uses z/OSMF REST API to submit the following job to run on z/OS.\n```\n//CFRDEVOP JOB (${ACCTNO}),'CFA REPORT',NOTIFY=\u0026SYSUID,\n//         CLASS=A,MSGCLASS=X,REGION=0M\n//CFRMAIN   EXEC PGM=CFRMAIN,REGION=4M                       \n//STEPLIB   DD DISP=SHR,DSN=${CFA_LOAD0} \n//SYSOUT   DD SYSOUT=*                \n//SYSIN    DD *                       \n* comment\nANALYZE   keywords\nINTERVAL  keywords\nREPORTS   keywords\nEND\n/*\n//\n```\n\n**Notes!**\n\n- Notice that the values for the different keywords are not explicitly displayed in the generated JCL.\nInstead placeholders (which are marked with ${}) are used.\nThe placeholders are being internally resolved into variables by Jenkins during the build process.\nTherefore, it’s not recommended to modify the JCL, but it’s possible.\n\n- **Script Security Plugin** is used, thus an administrator will have to approve the scripts.\nOtherwise a security exception is thrown:\nERROR: Failed to evaluate groovy script.\norg.jenkinsci.plugins.scriptsecurity.scripts.UnapprovedUsageException: script not yet approved for use\n\n  An administrator will have to approve via Manage Jenkins -\u003e In-process Script Approval\n\n![ In-process Script Approval](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/In_process_script_approv.JPG)\n![ Script Approval](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/ScriptApproval.JPG)\n\n\n## Authenticating the SSL Certificate \u003ca name=\"cert\"\u003e\u003c/a\u003e\n1. Distribute the z/OS certificate to the appropriate workstation, and import it into Java KeyStore using keytool.\n2. Issue the following command from the command line:\n```\nkeytool -import -alias \u003calias_name\u003e -keystore \u003ckeystore_name \u003e -file \u003cfile_name\u003e\n```\nwhere:\n- **alias_name** - alias name of the entry to process\n- **keystore_name** - the location of the cacerts file , By default it is in jre/lib/security/cacerts\n- **file_name**- file.cer\nYou will be asked for password (which is by default : changeit). Enter the password.\nRestart your Java Virtual Machine or your computer.\n\n## Screenshots: \u003ca name=\"screenshots\"\u003e\u003c/a\u003e\n![BMC CFA Plugin](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/cfa_plugin.jpg) \n\nFor details of the dialog box fields, click the question mark icon next to each field.\n\nFor further information regarding a specific field please refer to BMC AMI Log Analyzer for IMS documentation:\n- [Specifying ANALYZE control statements](https://docs.bmc.com/docs/loganalyzer17/specifying-analyze-control-statements-958587173.html)\n- [Specifying INTERVAL control statements](https://docs.bmc.com/docs/loganalyzer17/specifying-interval-control-statements-958587198.html)\n- [APPCHECK keyword](https://docs.bmc.com/docs/loganalyzer17/appcheck-keyword-958587247.html)\n\n## Job logs \u003ca name=\"joblogs\"\u003e\u003c/a\u003e\nThe contents of the job spool files are available in Jenkins job **workspace** under the respective build number folder.\n\n![job logs](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/workspace.jpg)\n\nFor further information regarding a specific report please refer to:\n- [SUMMARY](https://docs.bmc.com/docs/loganalyzer17/using-the-analysis-summary-report-958587322.html)\n- [REPRTIMS](https://docs.bmc.com/docs/loganalyzer17/using-the-application-checkpoint-report-958587359.html)\n- [SYSOUT](https://docs.bmc.com/docs/loganalyzer17/sysout-dd-statement-958587165.html)\n\n## REPRTDB2 - Commit Frequency Report for DB2 \u003ca name=\"db2rpt\"\u003e\u003c/a\u003e\n ![Commit Frequency Report for DB2](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/reprtdb2.JPG)\n\n## REPRTIMS - Commit Frequency Report for IMS \u003ca name=\"imsrpt\"\u003e\u003c/a\u003e \n![Commit Frequency Report for IMS](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/reprtims.JPG)\n\n## Checkpoint/Commit Distribution Action \u003ca name=\"comAction\"\u003e\u003c/a\u003e \n![BMC build action](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/build_action.jpg)\n## Required information for diagnosing problems \u003ca name=\"diag\"\u003e\u003c/a\u003e \n1.\tIdentify **plugin version**:\n**Jenkins**-\u003e**Manage Jenkins**-\u003e**Manage Plugins**-\u003e**Installed**\n![BMC plugin version](https://github.com/jenkinsci/bmc-cfa-plugin/blob/main/src/main/webapp/images/plugin_version.JPG)\n2.\t**Jenkins Job logs**  \n\t* Navigate to  **C:\\Users\\\\*user_name*\\\\AppData\\Local\\Jenkins\\.jenkins**\n\t* Select **jobs** directory\n\t* Select the relevant job\n    * Select **builds** directory\n \t* Select the relevant build number\n\t* log\n3. System log: **Jenkins**-\u003e**Manage Jenkins**-\u003e**System Log**\n4. **config.xml** in C:\\Users\\\\*user_name*\\\\AppData\\Local\\Jenkins\\.jenkins\\jobs\\\\*job_name*\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fbmc-cfa-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Fbmc-cfa-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fbmc-cfa-plugin/lists"}