JCL and DevOps

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# Jenkins pipeline example for JCL
pipeline {
    agent any
    
    stages {
        stage('Checkout') {
            steps {
                // Get JCL from source control
                checkout scm
            }
        }
        stage('Syntax Check') {
            steps {
                // Run syntax validation using Zowe CLI
                sh 'zowe jobs submit lf "./jcl/syntax-check.jcl" --wait'
            }
        }
        stage('Generate Test JCL') {
            steps {
                // Apply test environment parameters
                sh 'node ./scripts/apply-test-params.js'
            }
        }
        stage('Execute Test Jobs') {
            steps {
                // Submit test job and capture output
                sh 'zowe jobs submit lf "./jcl/test-job.jcl" --wait --output-file ./results.txt'
            }
        }
        stage('Analyze Results') {
            steps {
                // Check job results
                sh 'node ./scripts/validate-job-results.js'
            }
        }
        stage('Deploy to QA') {
            when {
                branch 'main'
            }
            steps {
                // Prepare JCL for QA
                sh 'node ./scripts/prepare-qa-deployment.js'
            }
        }
    }
    post {
        always {
            // Store results
            archiveArtifacts artifacts: 'results.txt', fingerprint: true
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
// Example Node.js script for automated JCL testing using Zowe CLI
const { execSync } = require('child_process');
const fs = require('fs');
 
// 1. Submit JCL for testing
console.log('Submitting test job...');
const jobOutput = execSync('zowe jobs submit lf "./test-jobs/PAYROLL.jcl" --wait').toString();
 
// 2. Extract job ID
const jobIdMatch = jobOutput.match(/job id is (\w+)/i);
const jobId = jobIdMatch ? jobIdMatch[1] : null;
 
if (!jobId) {
  console.error('Failed to submit job');
  process.exit(1);
}
 
// 3. Get job output
console.log('Retrieving job output...');
execSync('zowe jobs view spool-file-by-id ' + jobId + ' --spisploc *');
 
// 4. Check return code
const jobDetailsRaw = execSync('zowe jobs view job-status-by-jobid ' + jobId).toString();
const jobDetails = JSON.parse(jobDetailsRaw);
 
// 5. Validate results
if (jobDetails.retcode.endsWith('CC 0000')) {
  console.log('Job completed successfully');
  
  // 6. Validate output datasets
  console.log('Validating output datasets...');
  const outputCheck = execSync('zowe files list ds "PAYROLL.TEST.OUTPUT*"').toString();
  
  if (outputCheck.includes('PAYROLL.TEST.OUTPUT.REPORT')) {
    console.log('Output dataset created successfully');
    // 7. Further validation of content could be done here
  } else {
    console.error('Expected output dataset not found');
    process.exit(1);
  }
} else {
  console.error('Job failed with return code ' + jobDetails.retcode);
  process.exit(1);
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
mainframe-jcl/
├── README.md                    # Documentation
├── .gitattributes               # Git settings for proper line endings
├── applications/                # Application-specific JCL
│   ├── payroll/
│   │   ├── daily/               # Daily job streams
│   │   ├── monthly/             # Monthly processing
│   │   └── quarterly/           # Quarterly processing
│   └── accounting/
│       ├── ...
├── utilities/                   # Shared utility JCL
│   ├── backups/
│   ├── maintenance/
│   └── reports/
├── procedures/                  # Cataloged procedures
│   ├── standard/
│   └── specialized/
├── templates/                   # JCL templates with parameters
│   ├── batch-jobs/
│   ├── reports/
│   └── data-processing/
└── config/                      # Environment configuration
    ├── dev/
    ├── test/
    ├── qa/
    └── prod/

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Treat JCL files as text with specific line ending handling
*.jcl text eol=lf
*.JCL text eol=lf
*.cntl text eol=lf
*.CNTL text eol=lf
 
# Treat REXX files as text
*.rexx text eol=lf
*.REXX text eol=lf
 
# Binary files that should not be modified
*.load binary
*.LOAD binary
*.objlib binary

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
# JCL Change Request
 
## Description
[Describe the purpose and scope of this JCL change]
 
## Related Ticket
[Link to the ticket/issue in your tracking system]
 
## Type of Change
- [ ] Bug fix
- [ ] New feature
- [ ] Performance improvement
- [ ] Maintenance update
 
## JCL Files Modified
- [List modified JCL files]
 
## Datasets/Resources Affected
- [List datasets, databases, or other resources affected]
 
## Testing Performed
- [ ] Syntax validation
- [ ] Dev environment testing
- [ ] Test environment validation
- [ ] Performance impact assessment
 
## Test Results
[Summarize test results, include job logs if relevant]
 
## Risk Assessment
- Impact Level: [Low/Medium/High]
- Rollback Plan: [Describe how to rollback if needed]
 
## Approvals Required
- [ ] Technical Lead
- [ ] Operations
- [ ] Security (if applicable)
- [ ] Business Owner (if applicable)
 
## Deployment Window
[Specify when this should be deployed]
 
## Additional Notes
[Any other relevant information]