- Requirements
- Overview
- Authenticating the SSL Certificate
- Screenshots
- Job logs
- Commit Frequency Report for DB2
- Commit Frequency Report for IMS
- Checkpoint/Commit Distribution Action
- Required information for diagnosing problems
Required software | Version |
---|---|
Jenkins | 2.387.2 |
BMC AMI Log Analyzer for IMS | 1.7.00 |
z/OSMF |
BMC 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.
Use case: The plugin can be integrated as part of the development life cycle for application development team, where one of the steps does checkpoint/commit analysis.
It uses z/OSMF REST API to submit the following job to run on z/OS.
//CFRDEVOP JOB (${ACCTNO}),'CFA REPORT',NOTIFY=&SYSUID,
// CLASS=A,MSGCLASS=X,REGION=0M
//CFRMAIN EXEC PGM=CFRMAIN,REGION=4M
//STEPLIB DD DISP=SHR,DSN=${CFA_LOAD0}
//SYSOUT DD SYSOUT=*
//SYSIN DD *
* comment
ANALYZE keywords
INTERVAL keywords
REPORTS keywords
END
/*
//
Notes!
-
Notice that the values for the different keywords are not explicitly displayed in the generated JCL. Instead placeholders (which are marked with ${}) are used. The placeholders are being internally resolved into variables by Jenkins during the build process. Therefore, it’s not recommended to modify the JCL, but it’s possible.
-
Script Security Plugin is used, thus an administrator will have to approve the scripts. Otherwise a security exception is thrown: ERROR: Failed to evaluate groovy script. org.jenkinsci.plugins.scriptsecurity.scripts.UnapprovedUsageException: script not yet approved for use
An administrator will have to approve via Manage Jenkins -> In-process Script Approval
- Distribute the z/OS certificate to the appropriate workstation, and import it into Java KeyStore using keytool.
- Issue the following command from the command line:
keytool -import -alias <alias_name> -keystore <keystore_name > -file <file_name>
where:
- alias_name - alias name of the entry to process
- keystore_name - the location of the cacerts file , By default it is in jre/lib/security/cacerts
- file_name- file.cer You will be asked for password (which is by default : changeit). Enter the password. Restart your Java Virtual Machine or your computer.
For details of the dialog box fields, click the question mark icon next to each field.
For further information regarding a specific field please refer to BMC AMI Log Analyzer for IMS documentation:
The contents of the job spool files are available in Jenkins job workspace under the respective build number folder.
For further information regarding a specific report please refer to:
- Identify plugin version: Jenkins->Manage Jenkins->Manage Plugins->Installed
- Jenkins Job logs
- Navigate to C:\Users\user_name\AppData\Local\Jenkins.jenkins
- Select jobs directory
- Select the relevant job
- Select builds directory
- Select the relevant build number
- log
- System log: Jenkins->Manage Jenkins->System Log
- config.xml in C:\Users\user_name\AppData\Local\Jenkins.jenkins\jobs\job_name