PM19800: Backslash in trace filename prevents memory mapped wrapping trace from starting

CICS Transaction Gateway Desktop Edition V8.0 Fix Pack 6
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - AIX
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - Linux on zSeries
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - Solaris
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - HP-UX on Itanium
IBM CICS Transaction Gateway for Multiplatforms - Version 8.1 - Windows
CICS Transaction Gateway for Multiplatforms V8.0 Fix Pack 6

APAR status

• Closed as program error.

Error description

• When a backslash is specified in the TRACEFILE parameter in
  the configuration file memory mapped wrapping trace does
  not start. An example of an invalid parameter is:
  TRACEFILE=C:\CICSCLI.BIN
  
  On start, the Client daemon will produce the following log
  message:
  
   CCL1205E Invalid system return code
    (Function = 'OpenFileMapping', Error Code = '3')
  

Local fix

• To work around this problem use forward slashes:
  TRACEFILE=C:/CICSCLI.BIN
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS Transaction Gateway on     *
  *                 Windows.                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: A backslash character in the tracefile  *
  *                      name prevents trace startup.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Attempting to start a memory-mapped, wrapping trace with a
  backslash character in the file name fails.  The trace file is
  not produced and the following message is written to the Client
  daemon log file:
    1176  TRC:CCL1205E Invalid system return code (Function =
  'OpenFileMapping', Error Code = '3')
  

Problem conclusion

• The Client daemon has been modified to allow a backslash
  characters in the tracefile path.
  

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:

  PM19801

Modules/Macros

• CTGV8DUM
  

Fix information

• Fixed component name

  CICS TRNS GATE

• Fixed component ID

  5724I8102

Applicable component levels

• R800 PSY

     UP