PI11944: USING A GUR CALL WITH A SSA COMMAND CODE RESULTS IN AN ABEND

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The failed call is:
  L        GUR   HEADER  (RHDRSEQ EQDBD     CUSTDB1 )
                 DBD     *L
  ABEND S0C4 results when parsing command code.
  

Local fix

• Do not used SSA COMMAND CODEs
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS V13 who make GUR DL/I calls *
  *                 against the IMS Catalog database.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: ABEND0C4 in DFS3GUR0 while processing a *
  *                      GUR DL/I that has a command code '*' in *
  *                      the Segment Search Argument (SSA).      *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  An ABEND0C4 was received in DFS3GUR0 while the user was testing
  the GUR DL/I call with an SSA that contained a command code *L
  with the expectation it would retrieve the latest occurrence of
  a DBD, which has multiple versions registered in the IMS
  Catalog.
  
  Following is an example of the failing call as coded for use
  in the DFSDDLT0 application:
  
  L        GUR   HEADER  (RHDRSEQ EQDBD     CUSTDB1 )            X
                 DBD     *L
  
  The failing instruction in DFS3GUR0 was a CLI that was checking
  for the left parenthesis within the SSA and the value in the
  register that was used to keep track of the position in the SSA,
  register 2 in this case, had been incremented to the point it
  caused a page translation exception or pic 11.
  
  Additional Keywords: IMSCATALOG R2 REG2 PIC11
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
  The use of a command code with the GUR DL/I call is not allowed
  and the code in DFS3GUR0 has been changed to detect the use of a
  command code and to return a STATUSAC and AIB return code of 900
  to the application.
  
  The following manuals will be updated as follows:
  
  * Messages and Codes, Volume 4: IMS Component Codes
  In the 'DL/I status code explanations' section under 'AC' the
  following will be added: The GUR call specifies an SSA that
  contains a command code.
  
  * Application Programming APIs
  The following will be added to the 'Restrictions' section of the
  'GUR call' section: SSA command codes are not allowed.
  
  * Application Programming
  Under 'Special DL/I situations for IMS DB programming' and the
  'GUR call' section, the following will be added: Note: The use
  of SSA command codes is not allowed.
  
  Under the 'Application programming with the IMS catalog' and the
  'GUR call' section, the following will be added: Note: The use
  of SSA command codes is not allowed.
  

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:

  UI18694

Modules/Macros

•    DFS3GUR0
  

Fix information

• Fixed component name

  IMS V13

• Fixed component ID

  5635A0400

Applicable component levels

• R300 PSY UI18694

     UP14/06/10 P F406

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.