PH56014: CICS CM IS ENHANCED TO OPTIONALLY DISPLAY PREVIOUSLY PROCESSED CHANGE PACKAGE EXIT PARAMETERS ON THE TSO ISPF CHG PKG PANELS.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• APAR PH42125(Feb 2022) as PTFs UI79367,UI79368,UI79369 enhanced
  CICS Configuration Manager to collect&pass additional date/time
  and txt information to aid customizations by change package exit
  programs.  For example, the change package exit program may use
  the exit parameter date/time setting for scheduling purposes.
  
  This enhancement saves the previously processed exit parameter
  values onto the change package record, and makes those values
  available for display on the ISPF change package processing
  panels.  Users will be able to see the previous exit parameter
  (date/time and text) values processed for the change package.
  
  The enhancement works like this:
  1.  If the Server API request includes change package exit
      parameter values (date/time or text), the values are
      saved onto the change package record if the following
      conditions are met:
      - the Systems Option for exit processing is active
      - the change package API pre or post exit point is active
      - the API command completes with return code 4 or less
      - the exit parameters have a specified (non default) value.
  
      The saved previous exit parameter fields include:
  
      - the API command processed (e.g. READY, APPROVE)
      - the Migration Scheme processed
      - the exit parameter setting for date/time
      - the exit parameter setting for the free form text.
  
  2.  The INQUIRE of a change package will return the values of
      the saved previous exit parameter fields.  The change
      package XML elements are:
      - <E1_API>
      - <E1_SCHEME>
      - <E1_DATETIME>
      - <E1_TEXT>
  
  3.  The TSO ISPF online change package panels can optionally
      display the previous exit parameters.
  
      The display is controlled by option variables in the
      invocation Rexx procedure provided by SCCVSAMP sample
      CCVDEFLT. If the option variables are not set, the previous
      exit parameters are not displayed and the TSO ISPF panels
      appears unchanged. The option variables are:
      - EXITPxxx  (xxx is a panel mnemonic, e.g. APP for APPROVE).
                  Variable value Y will display the previous
                  exit parameters if the corresponding exit
                  parameter input fields are also displayed on the
                  panel.
      - EXITPMNU  This variable controls the display of previous
                  exit parameters on the change package processing
                  menu panel.
  
  4.  SCCVSAMP sample CCVXREXI introduces a Rexx procedure that
      can be executed as a change package processing panel exit.
      On entry into a panel, you can customize this Rexx procedure
      to set the initial values for the exit date/time and text
      input parameters on the panel.
  
  5.  The change package pre and post exit processing program
      parameter lists are enhanced to include the change package's
      previously saved exit parameter values.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Configuration Manager.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS Configuration Manager is enhanced  *
  *                      to optionally display previously        *
  *                      processed change package exit           *
  *                      parameters on the TSO ISPF change       *
  *                      package panels.                         *
  ****************************************************************
  APAR PH42125 (Feb 2022) as PTFs UI79367, UI79368, UI79369
  enhanced CICS Configuration Manager to collect and pass
  additional date/time and text information to aid customizations
  by change package exit programs.  For example, the change
  package exit program may use the exit parameter date/time
  setting for scheduling purposes.
  
  This enhancement saves the previously processed exit parameter
  values onto the change package record, and makes those values
  available for display on the ISPF change package processing
  panels.  Users will be able to see the previous exit parameter
  (date/time and text) values processed for the change package.
  
  The enhancement works like this:
  
  1. If the Server API request includes change package exit
     parameter values (date/time or text), the values are
     saved onto the change package record if the following
     conditions are met:
  
       - the Systems Option for exit processing is active
       - the change package API pre or post exit point is active
       - the API command completes with return code 4 or less
       - the exit parameters have a specified (non default) value.
  
     The saved previous exit parameter fields include:
  
       - the API command processed (e.g. READY, APPROVE)
       - the Migration Scheme processed
       - the exit parameter setting for date/time
       - the exit parameter setting for the free form text.
  
  2. The INQUIRE of a change package will return the values of the
     saved previous exit parameter fields.  The change package XML
     elements are:
  
       - <E1_API>
       - <E1_SCHEME>
       - <E1_DATETIME>
       - <E1_TEXT>
  
  3. The TSO ISPF online change package panels can optionally
     display the previous exit parameters.
  
     The display is controlled by option variables in the
     invocation Rexx procedure provided by SCCVSAMP sample
     CCVDEFLT.  If the option variables are not set, the previous
     exit parameters are not displayed and the TSO ISPF panels
     appear unchanged.  The option variables are:
  
      - EXITPxxx  (xxx is a panel mnemonic, e.g. APP for APPROVE).
                  Variable value Y will display the previous exit
                  parameters if the corresponding exit parameter
                  input fields are also displayed on the panel.
  
      - EXITPMNU  This variable controls the display of previous
                  exit parameters on the change package
                  processing menu panel.
  
  4. SCCVSAMP sample CCVXREXI introduces a Rexx procedure that
     can be executed as a change package processing panel exit.
     On entry into a panel, you can customize this Rexx procedure
     to set the initial values for the exit date/time and text
     input parameters on the panel.
  
  5. The change package pre and post exit processing program
     parameter lists are enhanced to include the change package's
     previously saved exit parameter values.
  

Problem conclusion

• CICS Configuration Manager is enhanced.  The change package last
  processed exit parameters (date/time and text) are saved onto
  the change package record, and these values can be presented
  onto the TSO/ISPF online dialog panels as determined by site
  customizable option settings.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI93618 UI93619 UI93620

Modules/Macros

• CCVAAPP  CCVABACK CCVACRE  CCVADISA CCVADISC CCVADLET CCVAIMP
  CCVAINST CCVAMG10 CCVAMG20 CCVAMG30 CCVAMG40 CCVAMG50 CCVAMG60
  CCVAMG70 CCVAMG80 CCVAMIGR CCVANCPY CCVARDY  CCVAUPD  CCVAURDY
  CCVDEFLT CCVE52   CCVE53   CCVH0053 CCVH0203 CCVHPKA1 CCVHPKB1
  CCVHPKE2 CCVHPKED CCVHPKGE CCVHPKI1 CCVHPKM1 CCVHPKR1 CCVI10
  CCVOCCVA CCVOPKGE CCVP0005 CCVPPKA1 CCVPPKB1 CCVPPKD1 CCVPPKGE
  CCVPPKI1 CCVPPKM1 CCVPPKR1 CCVTD540 CCVXCP3  CCVXCPA  CCVXCPC
  CCVXCPP  CCVXCPRA CCVXCR3  CCVXCRA  CCVXCRC  CCVXCRP  CCVXREXI
  CCVXXCCV
  

Fix information

• Fixed component name

  CICS CONFIG MGR

• Fixed component ID

  5697CIC00

Applicable component levels

• R540 PSY UI93618

     UP23/09/21 P F309  

• R54E PSY UI93619

     UP23/09/21 P F309  

• R54K PSY UI93620

     UP23/09/21 P F309  

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.