Visit our Home Pages on the Internet: Communications Server for Windows NT http://www.software.ibm.com/network/commserver/support/ +----------------------------------------------------------------------+ DATE: 02/22/99 DESCRIPTION: JR12496 - Trace Facility Enhancements README FILE FOR IBM Communications Server for Windows NT version 6.01 APAR: JR12496 This package contains APAR fixes to the product above. This package can be distributed to any one who has a license for this product. +----------------------------------------------------------------------+ PREREQUISITES : IBM Communications Server for Windows NT version 6.01 PROBLEMS FIXED: APAR Number Description JR12496 __ Trace facility enhancements :WRITE key The key WRITE can be put in the Service Key field. This will give the customer the ability to have CSNT automatically save traces files under a different name rather than wrapping the trace file automatically. Each trace file can get to a size between 4-9M. It is essential that if you intend to use this fix you make sure that you have plenty of disk space. In addition, choose set up from the trace facility and increase the buffer size to 8M... This can be done by increasing the block size to 256 and the number of blocks to 32. JR12490 :Larger trace buffer The trace buffer can be increased by increasing the number of blocks in the set up of the trace facility. To format traces after using the write key, choose format and enter the name and number of the file you wish to format. For example, if I use the write key and let the server run for 15 minutes, I can end up with 3 files - nstrc.trc, nstrc001.trc, nstrc002.trc. The information I need is in trace nstrc002.trc, therefore I will put c:\ibmcs\private\nstrc002.tlg in the format box. Output from this will be nstrc002.tlg and ips002.trc (if IPS tracing was turned on). INSTALLATION INSTRUCTIONS: JR12496.exe (*.exe in the steps below) is a self-extracting file containing the shipped executables. The PARTS LIST is as follows: SHIPPED (fn ft) REPLACES TRCGUI.EXE TRCGUI.EXE FMTENG.DLL FMTENG.DLL Installing the fix on the system: 1) Be SURE you have downloaded the *.exe file in BINARY format. 2) Create a Temp directory and copy *.exe into the temporary directory and run the file to uncompress it. 3) Stop Communications Server for Windows NT (including your node, Node Operations, Node Configuration, Log Viewer, and any other CS/NT components you have started). Note that there may still be CS/NT-related services running on the machine after stopping these applications, but this is normal and will not affect the installation of this fix package. IMPORTANT! If this is an APAR fix, carefully compare the dates of the parts supplied with this APAR fix with the dates of the parts you are replacing. If ANY of the parts being replaced are more recent than the parts shipped with this APAR discontinue the installation of this fix and contact Customer Support for clarification. 4) Backup your existing versions of the parts listed in the above parts list. 5) Copy the new versions of the files from the temporary directory to the directory where CS/NT is installed. 6) Shutdown and Restart the CS/NT server machine. 7) Restart your CS/NT node. CONTACT FOR SUPPORT: If you have any questions, please call the IBM SUPPORT CENTER for your Country. For example in the USA call: 1-800-237-5511 IBM COPYRIGHT INFORMATION: IBM Communications Server for Windows NT version 5.0 Copyright International Business Machines Corporation 1997. All rights reserved. Note to U.S. Government Users - Documentation related to restricted rights - Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. LIMIT OF LIABILITY: License to the contained APAR fixes is conditioned upon the recipient holding a license to the prerequisite product. The license terms and conditions of the APAR fixes are the same as those for the prerequisite product. Please see the product license for specifics.