PK49149: THE JVM PROCESS ID IS NOT EXTERNALISED

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• There is no simple CICS supplied method of inquiring of the
  Unix System Services (USS) JVM Process ID for JVMs started
  by CICS.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: There is no CICS supplied method        *
  *                      of inquiring on the Process ID of       *
  *                      a JVM                                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The JVM Process ID is not externalised by CICS and so is not
  easy to find by customers who wish to obtain diagnostic dumps
  from particular CICS JVMs.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• CICS has been changed to return the Process ID as the JVM
  number for EXEC CICS INQUIRE JVM and CEMT INQUIRE JVM.
  
  The CICS Transaction Server for z/OS System Programming
  Reference, Version 3 Release 1 (SC34-6435-05) will be updated
  as follows:
  
  In Chapter 2 (System Commands), the documentation for
  INQUIRE JVM will be updated: The following will be added to
  the description for the 'JVM' parameter:
  
  The JVM token used in CICS is the same number that is used
  to identify the JVM in the z/OS UNIX environment, where it is
  known as the process id (PID) for the JVM.
  
  The CICS Transaction Server for z/OS CICS Supplied Transactions,
  Version 3 Release 1 (SC34-6432-03) will be updated as follows:
  
  In Chapter 14 (CEMT) - in the documentation for the CEMT INQUIRE
  JVM command, the following has been added to the description for
  the JVM '(value)' parameter:
  
  The JVM token used in CICS is the same number that is used to
  identify the JVM in the z/OS UNIX environment, where it is known
  as the process id (PID) for the JVM.
  
  In the CICS Data Areas manual for CICS TS Version 3 Release 1
  (SRL LY33-6107-01); update the 'SJCON - Java VM Domain Control
  Blocks' section as follows:
  
  At offset x'90' change 'SJA_JVM_INDEX' to '*' and remove the
  'Next available JVM index' comment after it.
  
  In the CICS Supplementary Data Areas manual for CICS TS
  Version 3 Release 1 (SRL: LY33-6108-01); update the 'SJTCB -
  SJ Open TCB Related Data' section as follows:
  
  Immediately after offset x'510' (SJTCB_MAX_RESETS) add:
  
  (514) FULLWORD 4 SJTCB_JVM_PID JVM Process ID
  

APAR Information

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

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

  UK29206 UK29207

Modules/Macros

•    DESSJCON DESSJCS  DESSJDM  DESSJDUF DESSJIN
  DESSJIS  DFHSJCL  DFHSJCON DFHSJCS  DFHSJCSH DFHSJDCD DFHSJDM
  DFHSJDUF DFHSJIN  DFHSJINA DFHSJINM DFHSJINT DFHSJIS  DFHSJISA
  DFHSJISM DFHSJIST DFHSJJMC DFHSJJMD DFHSJJMH DFHSJOTC DFHSJOTD
  DFHSJOTH DFHSJPJP DFHSJPTC DFHSJPTD DFHSJPTH DFHSJTRC DFHSJTRH
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK29206

     UP07/09/21 P F709

• R403 PSY UK29207

     UP07/09/21 P F709

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.