PK28151: EYUAPI PERFORM OBJECT(TRANDEF) RECEIVES 1028 (INVALIDPARM) 1315 (PARM) ERROR CODE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When trying to run a Rexx program that issues an EYUAPI PERFORM
  OBJECT(TRANDEF) ACTION(INSTALL) with the PARM option specified
  using commas as the delimiter, the customer receives a 1028
  (INVALIDPARM) 1315 (PARM) error code.  The PARM field is set as
  follows:
  .
   W_PARM='USAGE(LOCAL),MODE(N/A),TARGET(CPLXTAOR),FORCEINS(YES).'
  

Local fix

• Replace commas with spaces as :
   W_PARM='USAGE(LOCAL) MODE(N/A) TARGET(CPLXTAOR) FORCEINS(YES).'
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R1M0 Users.                *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICSPlex SM API programs that use       *
  *                      commas (,) as delimiters in parameter   *
  *                      expressions in the following EXEC CPSM  *
  *                      commands:                               *
  *                                                              *
  *                        CREATE                                *
  *                        GET                                   *
  *                        PERFORM OBJECT                        *
  *                        PERFORM SET                           *
  *                        REMOVE                                *
  *                        UPDATE                                *
  *                                                              *
  *                      may fail with an INVALIDPARM (1028)     *
  *                      response and PARM (1315) reason.        *
  *                                                              *
  *                      Storage overlay related errors may also *
  *                      occur.                                  *
  ****************************************************************
  * 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.     *
  ****************************************************************
  EYU0MOSS (MOSS - Managed Object Services String Service) is
  called to validate PARM (parameter) expressions for CICSPlex SM
  API programs using the CREATE, GET, PERFORM OBJECT, PERFORM SET,
  REMOVE and UPDATE commands.
  
  MOSS uses a MOMP control block to hold the parsed parameter
  string.  In order to determine how much storage to allocate for
  the MOMP, MOSS determines the number of parameters, by counting
  the number of parameter delimiters (spaces) in the parameter
  expression.
  
  If commas are used to delimit the parameter expressions in the
  PARM buffer, the MOMP control block may be too small. This
  typically results in the API command failing with an
  INVALIDPARM response and PARM reason as the storage beyond the
  end of the MOMP may be subsequently used by other tasks.
  
  Other storage overlay related errors may also occur.
  

Problem conclusion

• MOSS has been changed to tolerate commas in addition to spaces
  as parameter delimiters.
  
  Sample API program EYU#API3 has been changed to use the
  preferred parameter delimiter of spaces.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• CICSPlex SM API programs that use
  commas (,) as delimiters in parameter
  expressions in the following EXEC CPSM
  commands:
  
    CREATE
    GET
    PERFORM OBJECT
    PEFROM SET
    REMOVE
    UPDATE
  
  may fail with an INVALIDPARM response
  and PARM reason. Other storage overlay
  related errors may also occur.
  
  EYU0MOSS (MOSS - Managed Object Services String Service) is
  called to validate PARM (parameter) expressions for CICSPlex SM
  API programs using the CREATE, GET, PERFORM OBJECT, PERFORM SET,
  REMOVE and UPDATE commands.
  
  MOSS uses a MOMP control block to hold the parsed parameter
  string.  In order to determine how much storage to allocate for
  the MOMP, MOSS determines the number of parameters, by counting
  the number of parameter delimiters (spaces) in the parameter
  expression.
  
  If commas are used to delimit the parameter expressions in the
  PARM buffer, the MOMP control block may be too small. This
  typically results in the API command to failing with an
  INVALIDPARM response and PARM reason as the storage beyond the
  end of the MOMP may be subsequently used by other tasks.
  
  Other storage overlay related errors may also occur.
  
  MOSS has been changed to tolerate commas in addition to spaces
  as parameter delimiters.
  
  Sample API program EYU#API3 has been changed to use the
  preferred parameter delimiter of spaces.
  

APAR Information

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

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

  UK17592

Modules/Macros

•    DYU0MOSS EYU#API3 EYU0MOSS
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK17592

     UP06/09/02 P F609

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.