Automating CICS NEWCOPY and PHASEIN in Git CI/CD Pipelines with Zowe CLI

Mainframe application teams deploying COBOL/CICS changes manually log into 3270 green screens, navigate to CICS regions, and issue:

CEMT SET PROGRAM(ORDR01) NEWCOPY

In multi-region CICS configurations (AOR/TOR/DOR Sysplex), engineers frequently forget secondary regions, leading to version skew where users encounter stale code or AEIS abends. Furthermore, if the program is actively executing, NEWCOPY fails with INVREQ, disrupting deployments.

NEWCOPY cannot refresh a program in storage if the current use count (USECOUNT) is greater than zero, or if tasks are suspended inside the module. In contrast, PHASEIN allows active tasks to finish executing the old copy while routing new transactions to the freshly loaded module in the DFHRPL concatenation. Manual execution across dozens of regions lacks concurrency control, audit logging, and automated rollback upon failure.

# 1. Configure Zowe CICS Profile via Zowe CLI

Create a dedicated z/OSMF or CICS Management Client Interface (CMCI) profile:

zowe profiles create cics-profile cics_prod \
  --host zos.production.corp \
  --port 4443 \
  --user PRODDEPLOY \
  --password "$DEPLOY_TOKEN" \
  --region-name CICS* \
  --protocol https

# 2. Issue CICS PHASEIN Across All Target Regions

Execute cics refresh program using PHASEIN to guarantee zero transaction downtime:

# Refresh ORDR01 across all Application Owning Regions (AORs)
zowe cics refresh program ORDR01 \
  --region-name "AOR*" \
  --cics-profile cics_prod

The CLI returns JSON metadata confirming the load point, length, and timestamp of the new binary:

{
  "response": "OK",
  "program": "ORDR01",
  "action": "PHASEIN",
  "regions_updated": ["AOR01", "AOR02", "AOR03"],
  "useCount": 0
}

# 3. Integrate into GitHub Actions / GitLab CI Pipeline

name: Deploy COBOL to CICS
on:
  push:
    branches: [ main ]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Zowe CLI
        run: npm install -g @zowe/cli @zowe/cics-for-zowe-cli
      - name: Deploy Binary & Refresh CICS
        env:
          ZOWE_OPT_USER: ${{ secrets.ZOS_DEPLOY_USER }}
          ZOWE_OPT_PASSWORD: ${{ secrets.ZOS_DEPLOY_PWD }}
        run: |
          zowe zos-files upload file-to-data-set dist/ORDR01.load "PROD.CICS.LOADLIB(ORDR01)"
          zowe cics refresh program ORDR01 --region-name "AOR*"