PK29844: THE TERMNL TRANCNT FIELD WILL RETURN INVALIDPARM WHEN USING SOME RANGES AS THE FILTER CRITERIA

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You have an CPSM API program that access the TERMNL (terminal)
  resource table that receives INVALIDPARM (1028) CRITERIA (1299)
  when using:
  GET TERMNL
  CRITERIA TERMID=T* AND TRANCNT>20000.
  This problem does not occur if the TRANCNT field is less than
  19968, or greater than 23807.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You write an API program which       *
  *                      executes a GET command for TERMNL       *
  *                      resources selected by a CRITERIA        *
  *                      string based on the value of the        *
  *                      TRANCNT attribute.  A CRITERIA          *
  *                      string with a generic value for a       *
  *                      numeric attribute, for example          *
  *                      TRANCNT=*, fails with:                  *
  *                                                              *
  *                           RESPONSE=1041 (INVALIDATA),        *
  *                           REASON=1299 (CRITERIA)             *
  *                                                              *
  *                      For selected specific values, for       *
  *                      example TRANCNT>20000, the GET fails    *
  *                      with:                                   *
  *                                                              *
  *                           RESPONSE=1028 (INVALIDPARM),       *
  *                           REASON=1299 (CRITERIA)             *
  *                                                              *
  *                         Creating or updating CPSM resources  *
  *                      which contain filter criteria (for ex-  *
  *                      ample, EVALDEFs or RASGNDEFs) will also *
  *                      fail if a generic mask is entered for a *
  *                      numeric attribute, or if the internal   *
  *                      (binary) value of a numeric attribute   *
  *                      value falls in certain ranges.  An API  *
  *                      or WUI request will fail with           *
  *                                                              *
  *                           RESPONSE=1038 (TABLEERROR),        *
  *                           REASON=1361 (DATAERROR)            *
  *                                                              *
  *                      Feedback will identify the filter as    *
  *                      the failing attribute.  An EUI request  *
  *                      will produce various messages depending *
  *                      on the type of resource being created   *
  *                      or updated.                             *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick    *
  *                 up the new code.  Note that the restarts     *
  *                 do not need to be done at the same time.     *
  ****************************************************************
     During the parsing of a CRITERIA expression, comparison
  values are converted from external to internal form.  Module
  EYU0MOFS (MOFS - MOS Convert Data Values) is called to con-
  vert attribute values from external to internal form.  If a
  generic "*" is specified for a numeric attribute, MOFS will
  return INVALID_DATA because "*" is not a valid character in
  a numeric value.
     Module EYU0XDOP (XDOP - CRITERIA String Parser) then checks
  the converted value to see if it contains generic mask char-
  acters ("+", "*").  For hexadecimal strings, the generic test
  is performed on the external form;  for all other types the
  internal form is checked.  If the internal (binary) form of a
  numeric attribute contains X'4E' ("+") or X'5C' ("*") it will
  be processed as a generic, and will probably result in failure
  of the command.
  

Problem conclusion

•    Module EYU0MOFS was modified to check for a single asterisk
  "*" passed for a numeric attribute, and if found to set the
  output value to "*" and the output length to 1.
     Module EYU0XDOP was modified to check the external form of
  comparison values for numeric attributes, rather than the in-
  ternal form, for generic mask characters.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

•    You write an API program which
  executes a GET command for TERMNL
  resources selected by a CRITERIA
  string based on the value of the
  TRANCNT attribute.  A CRITERIA
  string with a generic value for a
  numeric attribute, for example
  TRANCNT=*, fails with:
  
       RESPONSE=1041 (INVALIDATA),
       REASON=1299 (CRITERIA)
  
  For selected specific values, for
  example TRANCNT>20000, the GET fails
  with:
  
       RESPONSE=1028 (INVALIDPARM),
       REASON=1299 (CRITERIA)
  
     During the parsing of a CRITERIA expression, comparison
  values are converted from external to internal form.  Module
  EYU0MOFS (MOFS - MOS Convert Data Values) is called to con-
  vert attribute values from external to internal form.  If a
  generic "*" is specified for a numeric attribute, MOFS will
  return INVALID_DATA because "*" is not a valid character in
  a numeric value.
     Module EYU0XDOP then checks the converted value to see if
  it contains generic mask characters ("+", "*").  For hexadeci-
  mal strings, the generic test is performed on the external
  form;  for all other types the internal form is checked.  If
  the internal (binary) form of a numeric attribute contains
  X'4E' ("+") or X'5C' ("*") it will be processed as a generic,
  and will probably result in failure of the command.
  
     Module EYU0MOFS was modified to check for a single asterisk
  "*" passed for a numeric attribute, and to set the output value
  to "*" and the output length to 1.
     Module EYU0XDOP (XDOP - CRITERIA String Parser) was modified
  to check the external form of comparison values for numeric
  attributes, rather than the internal form, for generic mask
  characters.
  

APAR Information

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

  PK29915

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

  UK17415

Modules/Macros

•    DYU0MOFS EYU0MOFS EYU0XDOP
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK17415

     UP06/08/25 P F608

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.