PI91302: LINK TO LIBERTY PROGRAM DEFINTION CREATED WITH INVALID CHARACTERWHEN LOCALCCSID IS NOT 037

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are creating a Java program which will be invoked using the
  Link to Liberty facility. You have added an annotation to the
  program which will be used to create a CICS program definition.
  
  for example:
  
      @CICSProgram("HELLOWLP")
      public void printMessage()
  
  This will cause  program definition to be created for program
  HELLOWLP
  
  In the program definition the JVMCLass should be in the form
  
  wlp:<package name><class name>#<method name>
  
  so for the supplied example class HelloLiberty the JVMClass
  should be as follows:
  
  wlp:com.ibm.cics.server.examples.wlp.link.HelloLiberty#printMess
  age
  
  
  If the LOCALSSID of the system is NOT 037 then the # (x'7B')
  will be something different and therefore invalid. For example
  on a system with LOCALCCSID of 1147 it will appear as £ (x'B1'
  in code page 037)
  
  If you try to EXEC CICS LINK to the installed program an INVREQ
  will be returned
  

Local fix

• Edit the £ symbol, change it to a # symbol
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When Link to Liberty dynamically        *
  *                      creates the program definition,         *
  *                      JVMCLASS is incorrectly set using       *
  *                      the default CCSID 037.                  *
  ****************************************************************
  An application which contains @CICSProgram annotation is
  installed into Liberty.  When CICS dynamically creates the
  program definition, the Java service name which becomes
  JVMCLASS is converted from a Java string into a byte array in
  CCSID 037.  When the request is made to run the program, the
  service name is converted back to a Java string using the
  LOCALCCSID which may get some symbols corrupted.
  

Problem conclusion

• CICS has been changed to set JVMCLASS using LOCALCCSID.
  

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:

  UI53210

Modules/Macros

• DFJ@H467
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R10D PSY UI53210

     UP18/02/01 P F801

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.