PK29310: CICS PIPELINE CONFIGFILE, SHELF, AND WSDIR PARAMETERS DO NOT ACCEPT SPECIAL CHARACTERS IN PARM VALUE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When defining a CICS PIPELINE RDO entity, CICS is currently
  restricting the Configfile name, shelf name, and Wsdir file name
  (all Unix HFS file names) to include only POSIX portable
  characters in the file name.  Unix will however accept other
  characters in the file name, and the customer may not need
  portablity, so CICS should accept any character in the file name
  as long as it is acceptable in a UNIX file name.
  When these special characters are used, CEDA will report a
  severe level message indicating that the value is invalid.
    S SHELF VALUE '/#ar/cicsts/' IS INVALID.
  In testing, Unix did accept all the following characters ! @ # $
  % ﾽ & * ( ) in a file name, though some may have significance as
  wildcard characters.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Special characters @ and # are not      *
  *                      acceptable in SHELF attribute names     *
  *                      for PIPELINE definitions.               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CEDA is being used to define a PIPELINE RDO resource with the
  SHELF attribute name containing @ or # characters.
  It will fail and message 'S SHELF VALUE '/USR/LPP/CICSTS/@#'
  IS INVALID' is issued.
  This is because the SHELF attribute name is being validated
  against a restricted character set that does not include the
  characters # ( x'7B' ) or @ ( x'7C' ).
  The same problem exists for the CONFIGFILE and WSDIR attributes
  of a PIPELINE resource; for the WSBIND and WSDLFILE attributes
  of a WEBSERVICE resource; for the JNDIPREFIX, SHELF, and DJARDIR
  attributes of a CORBASERVER resource; for the HFSFILE attribute
  of a DJAR resource and for the HFSFILE and TEMPLATENAME
  attributes of a URIMAP resource.
  The problem also occurs if any of these attributes are altered
  to include @ or # characters in the name.
  
  Additional Keywords: DFHCSDUP DFHEDAD HFS zFS PK32417 LOCATION
                       16758
  

Problem conclusion

• DFHSPPIV has been changed to validate the SHELF, CONFIGFILE,
  WSDIR, WSBIND and WSDLFILE attributes against an extended
  character set that includes @ and #.
  
  The CICS Transaction Server for z/OS CICS Resource Definition
  Guide manual Version 3, Release 1 ( SC34-6430-04 ) will be
  updated as follows:
  
  Change the 'PIPELINE attributes' section to update the list
  of acceptable characters for the attributes :
  CONFIGFILE(name), SHELF({/var/cicsts/|directory}) and
  WSDIR(directory) as follows:
  
  Change the list from :
  
  A-Z a-z 0-9 . / _
  
  To:
  
  A-Z a-z 0-9 . / _ # @
  
  Change the 'WEBSERVICE attributes' section to update the list
  of acceptable characters for the attributes :
  WSBIND(hfsfile) and WSDLFILE(hfsfile) as follows:
  
  Change the list from :
  
  A-Z a-z 0-9 . / _
  
  To:
  
  A-Z a-z 0-9 . / _ # @
  
  Change the 'CORBASERVER attributes' section to update the list
  of acceptable characters for the attributes :
  SHELF({/var/cicsts/|directory}), and JNDIPREFIX(prefix) as
  follows.
  
  Change the list from :
  
  A-Z a-z 0-9 . / _
  
  To:
  
  A-Z a-z 0-9 . / _ # @
  
  For attribute DJARDIR(directory)
  
  Change the list from :
  
  A-Z a-z 0-9
  
  To:
  
  A-Z a-z 0-9 . / _ # @
  
  Change the 'DJAR attribute' section to update the list of
  acceptable characters for the attribute :  HFSFILE(hfsfile)
  as follows.
  
  Change the list from :
  
  A-Z a-z 0-9 . / _
  
  To:
  
  A-Z a-z 0-9 . / _ # @
  
  Change the 'URIMAP attributes' section to update the list of
  acceptable characters for the attributes :HFSFILE(name) as
  follows.
  
  From :
  
  A-Z a-z 0-9 . / _
  
  To:
  
  A-Z a-z 0-9 . / _ # @
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK19551

Modules/Macros

•    DFHSPEJB DFHSPEJC DFHSPEJE DFHSPEJV DFHSPPIB
  DFHSPPIC DFHSPPIE DFHSPPIV DFHSPWBB DFHSPWBC DFHSPWBE DFHSPWBV
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK19551

     UP06/11/21 P F611

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.