Skip to Content

Overview of the AR/CTL-Smart/RESTART API Bridge

You can use the AR/CTL-Smart/RESTART API Bridge to transparently run the Smart/RESTART application programs in an AR/CTL environment. No application program code changes are required because Smart/RESTART application programs are restartable and designed around the unit-of-work concept. This API Bridge is a permanent addition to AR/CTL, so you do not need to modify the existing programs enabled by Smart/RESTART to remove the embedded Smart/RESTART code from the application programs.


Related topics

AR-CTL-Smart-RESTART-API-Bridge

We recommend that you direct future application development efforts to exploit the native AR/CTL program interface rather than continuing the proliferation of Smart/RESTART coding techniques.

Prerequisites

You must install version 4.2 of the BMC AMI Application Restart Control for Db2, IMS and VSAM product with the latest maintenance of RSL2207. The initial verification program (IVP) jobs must run successfully.

Additional support in the AR/CTL-Smart/RESTART API Bridge environment 

The AR/CTL-Smart/RESTART API Bridge environment supports the following features:

  • Smart/RESTART FILE_INFO service
  • File Communications Area Status (FCA-STAT) of ERAS when using the Smart/RESTART INITIALIZE service. This is equivalent to the AR/CTL FORCECOLD=YES option
  • AR/CTL-Smart/RESTART API Bridge Precompiler generates a File Control Specification (FCS) following the generated Function Communications Area (FCA) in the WORKING-STORAGE SECTION of the COBOL application program
  • Wildcard characters in DDNames or AR/CTL-Smart/RESTART API Bridge keywords such as REPOSITION, REPOSITION_REFRESH, and REPO_STYLE
  • Reporting of unsupported AR/CTL-Smart/RESTART API Bridge keywords as NOT SUPPORTED rather than UNKNOWN KEYWORD and then issuing an ABEND - CKPT_HLQ_LONG, REPOSITION_REFRESH_AUTO, ACCTINT, IEXIT, ABEND_CLOSE_FILES, ABEND_DELTA_SQL_TRAP
  • RAINPUT REPOSITION(EXCEPT,(DDNAME)) activates the bypass open intercept for the DDName
  • DDName RAIINPUT equivalent of RAINPUT
  • RAINPUT keywords CKPT_HLQ and CKPT_HLQ_LONG
  • RAINPUT keywords SYSTEM(ssnm) and PLAN(planname) when a blank Db2 ssnm and a blank Db2 plan name are provided in the AR/CTL Non-IMS Program Registration Record
  • API function CKPT_IMMED using the RAI_PROFILE function code
  • Implicit open for physical sequential files
  • Physical sequential files defined as DD DUMMY
  • Displaying the logical record count in ARCPRINT after checkpoint processing is completed for every checkpoint.
  • RAINPUT Global options

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Application Restart Control for Db2, IMS and VSAM master