PH48320: RESOURCE OVERRIDE SCHEMA DISALLOWS VALID CHARACTERS FOR SOME ATTRIBUTES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Resource override schema disallows valid characters for some
  attributes
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS initialisation fails with          *
  *                      DFHCA5519 and DFHRV1004 issued.         *
  ****************************************************************
  When using a resource overrides file that contains the + wild
  card character correctly, this can cause CICS initialisation to
  fail with messages DFHCA5519 and DFHRV1004 issued.
  
  Additionally, when using the resourceoverrides-1.100.0.json
  schema to validate a resource overrides file the following may
  be seen:
  
  1) Valid characters may be flagged as invalid when defining
     overrides for resources: DB2TRAN, DBENTRY, DUMPCODE,
     ENQMODEL, FILE, JOURNALMODEL, LIBRARY, SESSIONS,
     TCPIPSERVICE, TDQUEUE, TSMODEL and URIMAP.
  
  2) The length of prefix and suffix override values may be
     validated incorrectly.
  
  3) A floating point provided when an integer is required may not
     be flagged as an error.
  
  4) A null string supplied for "find" values in a find/replace
     override may not be flagged as an error.
  
  5) Errors may not be flagged when hyphens are omitted when
     specifying resource selector operators (IS, NOT, LITERAL,
     LITERALNOT) and override actions (PREFIX, SUFFIX, SET,
     FIND/REPLACE).
  
  6) An error is not flagged when schemaVersion is omitted.
  
  7) SET operator is flagged as an error when defining override
     values for integer and enumerated types attributes despite
     being used as documented.
  
  8) Spaces around symbol names when defining an override value
     are not tolerated and flagged as invalid.
  
  9) Enumerated attributes BLOCKFORMAT / PRINTCONTROL /
     RECORDFORMAT for TDQUEUE, and AUTHTYPE / COMAUTHTYPE for
     DB2CONN, do not allow a null string.
  

Problem conclusion

• CICS has been updated to correctly handle valid usage of the +
  wild card character.
  
  The resourceoverrides-1.100.0.json schema has been replaced with
  an updated schema, resourceoverrides-1.100.1.json, which
  resolves the validation problems.  Additional changes have been
  made to improve the guidance provided for integer attributes,
  and allow the expanded character set for DUMPCODE resource names
  as per PH43604.
  

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:

  UI83811

Modules/Macros

• DFHAMAO  DFHAMBA  DFHAMCSD DFHAMD2  DFHAMDH  DFHAMDU  DFHAMER
  DFHAMFC  DFHAMGL  DFHAMIO  DFHAMIS  DFHAMLD  DFHAMLM  DFHAMMQ
  DFHAMNQ  DFHAMP00 DFHAMPAB DFHAMPAD DFHAMPAP DFHAMPCH DFHAMPCO
  DFHAMPDF DFHAMPDI DFHAMPDL DFHAMPEN DFHAMPEX DFHAMPFI DFHAMPG
  DFHAMPI  DFHAMPIL DFHAMPLO DFHAMPN  DFHAMPVW DFHAMRDI DFHAMRL
  DFHAMSJ  DFHAMSN  DFHAMSO  DFHAMST  DFHAMTD  DFHAMTP  DFHAMTS
  DFHAMW2  DFHAMWB  DFHAMXM  DFHAPRL  DFHCAPB  DFHCAPC  DFHCUADD
  DFHCUALG DFHCUALT DFHCUAPP DFHCUCAB DFHCUCAC DFHCUCOG DFHCUCOM
  DFHCUCOP DFHCUCP  DFHCUCV  DFHCUDEF DFHCUERA DFHCUINI DFHCULIS
  DFHCULOC DFHCUPRC DFHCUPRO DFHCUREM DFHCURUG DFHCUS1  DFHCUSIG
  DFHCUUSR DFHEICRE DFHEIQCS DFHEITCU DFHEITSP DFHESP01 DFHESP02
  DFHESP21 DFHESP22 DFHESP23 DFHESP26 DFHESP55 DFHKCQ   DFHPUPDB
  DFHPUPDC DFHRDTRI DFHSPBAB DFHSPBAC DFHSPBAE DFHSPDBB DFHSPDBC
  DFHSPDBE DFHSPDHB DFHSPDHC DFHSPDHE DFHSPDUB DFHSPDUC DFHSPDUE
  DFHSPEJB DFHSPEJC DFHSPEJE DFHSPFIB DFHSPFIC DFHSPFIE DFHSPISB
  DFHSPISC DFHSPISE DFHSPKCB DFHSPKCC DFHSPKCE DFHSPLDB DFHSPLDC
  DFHSPLDE DFHSPLMB DFHSPLMC DFHSPLME DFHSPLSB DFHSPLSC DFHSPLSE
  DFHSPMQB DFHSPMQC DFHSPMQE DFHSPNQB DFHSPNQC DFHSPNQE DFHSPOPB
  DFHSPOPC DFHSPOPE DFHSPPCB DFHSPPCC DFHSPPCE DFHSPPIB DFHSPPIC
  DFHSPPIE DFHSPPNB DFHSPPNC DFHSPPNE DFHSPRLB DFHSPRLC DFHSPRLE
  DFHSPSJB DFHSPSJC DFHSPSJE DFHSPSOB DFHSPSOC DFHSPSOE DFHSPTCB
  DFHSPTCC DFHSPTCE DFHSPTDB DFHSPTDC DFHSPTDE DFHSPTIB DFHSPTIC
  DFHSPTIE DFHSPTNB DFHSPTNC DFHSPTNE DFHSPTSB DFHSPTSC DFHSPTSE
  DFHSPTYB DFHSPTYC DFHSPTYE DFHSPW2B DFHSPW2C DFHSPW2E DFHSPWBB
  DFHSPWBC DFHSPWBE DFHSPXMB DFHSPXMC DFHSPXME DFHTOACN DFHTOAPT
  DFHTOASE DFHTOATM DFHTOATY DFHTOBPS DFHTOCAN DFHTOCMT DFHTOLCR
  DFHTOLUI DFHTOR00 DFHTRZCP DFHTRZIP DFHTRZXP DFHTRZYP DFJ@H607
  DFJ@H999
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UI83811

     UP22/12/21 P F212

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.