PM60122: DOCUMENTATION STEPS REGARDING .NET SETTINGS NEED TO BE MODIFIED MICROSOFT DEFAULT SETTINGS HAVE CHANGED

APAR status

• Closed as fixed if next.

Error description

• The "Changing thread configuration settings for the .NET
  framework", "Increase the size of appRequestQueueLimit in the
  .NET framework" and "Increasing the Speed of Telephone
  Interviews" topics in the DDL need to be modified. Per the
  documenation from Microsoft the httpRuntime element is no longer
  included by default within the machine.config of .net.
  
  http://msdn.microsoft.com/en-us/library/e1f13641(v=vs.80).aspx
  
  Specifically where that site states this:
  -------------------------
  "The httpRuntime element is not explicitly defined in the
  Machine.config file or in the root Web.config file. However, the
  following settings are the default values as initialized by the
  system. If you need to customize this section you must create it
  in your configuration file and define only those attributes that
  need customization."
  -------------------------
  
  The second issue is the appRequestQueueLimit in .NET Framework
  2.0 and above, which now defaults to 5000. Per the same MSDN
  documentation link above, the default values, which are not
  explicitly defined in the machine.config, are as follows:
  
  <httpRuntime
    executionTimeout="110"
    maxRequestLength="4096"
    requestLengthDiskThreshold="256"
    useFullyQualifiedRedirectUrl="false"
    minFreeThreads="8"
    minLocalRequestFreeThreads="4"
    appRequestQueueLimit="5000"
    enableKernelOutputCache="true"
    enableVersionHeader="true"
    requireRootedSaveAsPath="true"
    enable="true"
    shutdownTimeout="90"
    delayNotificationTimeout="5"
    waitChangeNotification="0"
    maxWaitChangeNotification="0"
    requestPriority="Normal"
    enableHeaderChecking="true"
    sendCacheControlHeader="true"
    apartmentThreading="false"
  />
  
  This means that the current post install documentation steps are
  actually lowering the appRequestQueueLimit to 1000 rather than
  the new default of 5000.
  
  The third issue is only in the "Changing thread configuration
  settings for the .NET framework" topic where the <system.net>
  section is referenced. The system.net section is not within the
  machine.config by default.  Rather it needs to be added manually
  in order to make the post installation adjustments. The
  documentation should state that the <system.net> section will
  not be there by default and will need to be added manually.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of IBM SPSS Data Collection Interviewer Server         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The "Changing thread configuration settings for the .NET     *
  * framework", "Increase the size of appRequestQueueLimit in    *
  * the                                                          *
  * .NET framework" and "Increasing the Speed of Telephone       *
  * Interviews" topics in the DDL need to be modified. Per the   *
  * documenation from Microsoft the httpRuntime element is no    *
  * longer                                                       *
  * included by default within the machine.config of .net.       *
  *                                                              *
  * http://msdn.microsoft.com/en-us/library/e1f13641(v=vs.80).as *
  * px                                                           *
  *                                                              *
  * Specifically where that site states this:                    *
  * -------------------------                                    *
  * "The httpRuntime element is not explicitly defined in the    *
  * Machine.config file or in the root Web.config file. However, *
  * the                                                          *
  * following settings are the default values as initialized by  *
  * the                                                          *
  * system. If you need to customize this section you must       *
  * create it                                                    *
  * in your configuration file and define only those attributes  *
  * that                                                         *
  * need customization."                                         *
  * -------------------------                                    *
  *                                                              *
  * The second issue is the appRequestQueueLimit in .NET         *
  * Framework                                                    *
  * 2.0 and above, which now defaults to 5000. Per the same MSDN *
  * documentation link above, the default values, which are not  *
  * explicitly defined in the machine.config, are as follows:    *
  *                                                              *
  * <httpRuntime                                                 *
  *   executionTimeout="110"                                     *
  *   maxRequestLength="4096"                                    *
  *   requestLengthDiskThreshold="256"                           *
  *   useFullyQualifiedRedirectUrl="false"                       *
  *   minFreeThreads="8"                                         *
  *   minLocalRequestFreeThreads="4"                             *
  *   appRequestQueueLimit="5000"                                *
  *   enableKernelOutputCache="true"                             *
  *   enableVersionHeader="true"                                 *
  *   requireRootedSaveAsPath="true"                             *
  *   enable="true"                                              *
  *   shutdownTimeout="90"                                       *
  *   delayNotificationTimeout="5"                               *
  *   waitChangeNotification="0"                                 *
  *   maxWaitChangeNotification="0"                              *
  *   requestPriority="Normal"                                   *
  *   enableHeaderChecking="true"                                *
  *   sendCacheControlHeader="true"                              *
  *   apartmentThreading="false"                                 *
  * />                                                           *
  *                                                              *
  * This means that the current post install documentation steps *
  * are                                                          *
  * actually lowering the appRequestQueueLimit to 1000 rather    *
  * than                                                         *
  * the new default of 5000.                                     *
  *                                                              *
  * The third issue is only in the "Changing thread              *
  * configuration                                                *
  * settings for the .NET framework" topic where the             *
  * <system.net>                                                 *
  * section is referenced. The system.net section is not within  *
  * the                                                          *
  * machine.config by default.  Rather it needs to be added      *
  * manually                                                     *
  * in order to make the post installation adjustments. The      *
  * documentation should state that the <system.net> section     *
  * will                                                         *
  * not be there by default and will need to be added manually.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Upgrade to IBM SPSS Data Collection 7.0 in which the         *
  * documentation has been corrected.                            *
  ****************************************************************
  

Problem conclusion

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:

Fix information

Applicable component levels

• R700 PSN

     UP

• R700 PSY

     UP