Release Notes

Last updated: May 15, 2002 11:00 PM

• Ensure that you have the latest HP-UX 11.0 patch bundle installed. To download the latest patch bundle, go to http://www.hp.com
• Configure your minimum kernel parameter settings as follows:
  
  To indirectly boost the NKTHREAD, use the following settings:

  Parameter	Value
  maxdsize	0x79000000
  maxssize	0x8000000
  maxfiles	1024
  maxusers	64
  max_thread_proc	(NKTHREAD-10)

  
  To directly set the NKTHREAD, use the following settings:

  Parameter	Value
  maxdsize/td>	0x79000000
  maxssize	0x8000000
  maxfiles	1024
  maxusers	64
  max_htread_proc	1024
  nkthread	10240

cf_root/jre/bin/java -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar 
  -ws zeus -dir /usr/local/zeus/ns-config/https-<your site>/config -v

/opt/coldfusionmx/jre/bin/java -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar 
  -ws zeus -dir /usr/local/zeus/ns-config/https-surf/config -v

 
cf_root/jre/bin/java -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar 
  -ws zeus -dir /usr/local/zeus/ns-config/https-<your site>/config -v -r

 
/opt/coldfusionmx/jre/bin/java -jar /opt/coldfusionmx/runtime/lib/wsconfig.jar 
  -ws zeus -dir /usr/local/zeus/ns-config/https-surf/config -v -r

1. Make a backup copy of cf_root\wwwroot\WEB-INF\jrun-web.xml, and then open the original version of the jrun-web.xml file.
2. Edit the existing virtual mapping to point to the new web document root directory, as shown in the following example:

   <virtual-mapping>
      <resource-path>/*</resource-path>
      <system-path>C:/cfusionmx/wwwroot/</system-path> 
   </virtual-mapping>
   

3. You can now move the CFIDE and CFDOCS directory to the new web document root.
   Caution: Do not move the WEB-INF directory. It must stay under the cf_root/wwwroot directory.

1. Make a backup copy of cf_root/wwwroot/WEB-INF/jrun-web.xml, and then open the original version of the jrun-web.xml file.
2. Add a virtual mapping that points to the new web document root, as in the following example. This will override the default web document root cf_root/wwwroot.

   <virtual-mapping>
      <resource-path>/*</resource-path>
      <system-path>/opt/docroot/</system-path> 
   </virtual-mapping>
   

3. You can now move the CFIDE and CFDOCS directories to the new docroot.
   Caution: Do not move the WEB-INF directory. It must remain under the cf_root/wwwroot directory.

<cfhttp url="..." method="POST">
<cfhttpparam name="param1" value="<xml string>" type="XML">
</cfhttp>

<cfset var variableName="value">

<cffunction name="myFunct">
   <cfset var myVar = "This is a test">
   <cfreturn myVar & " message.">
</cffunction>
<cfoutput>#myFunct()#</cfoutput>

<cfset queryAddRow(q1,3)> 
<cfset q1['col1'][1] = 1> 
<cfset q1['col2'][1] = "4/24/02"> 
<cfset q1['col1'][2] = 2> 
<cfset q1['col2'][2] = "3/26/04"> 
<cfset q1['col1'][3] = 3> 
<cfset q1['col2'][3] = "2/28/03"> 



<cfquery name="qoq" dbtype="query"> 
  select * from q1 
</cfquery> 

• In Windows, delete the cf_root directory (Neo or CFusionMX) and restart your computer.
• On UNIX, delete the cf_root directory (neo or coldfusionmx) and stop any active ColdFusion MX processes.
  To do so, enter ps -eaf | grep cfusion  or   ps -eaf | grep neo to see if there are any active process IDs (PIDS), and then run kill -9 <PID> for each active ColdFusion MX process.

[warn] Loaded DSO c:/cfusionmx/runtime/lib/wsconfig/1/mod_jrun.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI)

<!-- set this to false for multi-hosted sites -->
<attribute name="cacheRealPath">true</attribute>

• co-exist – This option is selected by default. If you select it, you can run both versions of ColdFusion on the same computer. The earlier version is left in place, and by default, ColdFusion MX runs on the built-in web server on port 8500. To configure ColdFusion MX to run on a different web server after the installation, see the Configuring your System chapter of Installing ColdFusion MX.
• upgrade – This option removes the earlier version of ColdFusion and installs ColdFusion MX.

Unable to set value hkey_local_machine\software\macromedia\coldfusion\currentversion\
Clients\141363-76934365\\HITCOUNT: Windows error number 0 occurred. Insufficient system resources exist to complete the requested service.

cf_root\runtime\jre\bin\java -cp cf_root\runtime\lib 
  -jar cf_root\runtime\lib\wsconfig.jar 
  -ws IIS -site "0" -filter-prefix-only -map .cfm,.cfc,.cfml,.jsp -v

c:\cfusionmx\runtime\jre\bin\java -cp c:\cfusionmx\runtime\lib 
  -jar c:\cfusionmx\runtime\lib\wsconfig.jar 
  -ws IIS -site "0" -filter-prefix-only -map .cfm,.cfc,.cfml,.jsp -v 

1. Run cf_root/bin/Remove_all_connectors.bat
2. Run cf_root/bin/IIS_connector.bat

Is there already a version of ColdFusion installed on this computer?

Would you like to upgrade the existing ColdFusion installation?

mkdir /home/tmp
IATEMPDIR=/home/tmp
export IATEMPDIR
echo $IATEMPDIR

<cfset a.b.c.d.e = "foo">
<cfoutput>
  "#a.b.c.d.e#"
</cfoutput>

Element B.C.D.E is undefined in A

<isolation-level>READ_UNCOMMITTED</isolation-level>

• For best performance, the object should be multi-threaded. Otherwise, only one request can access the object at a time.
• Whenever your code accesses common data, for example, if all application sessions access the same Excel spreadsheet, you must lock the code that accesses the data. In general, you do not have to lock code that uses a shared object if data is not shared by multiple requests.

1. Start the ColdFusion MX ODBC Server and ColdFusion MX ODBC Agent services, if they are not already running.
2. In a command prompt, enter the following command:

cf_root\db\slserver52\admin\setcp.bat OS

3. Stop the ColdFusion MX ODBC Server and ColdFusion MX ODBC Agent services.
4. Start The ColdFusion MX ODBC Server and ColdFusion MX ODBC Agent service.

cf_root/db/slserver32/admin/setcp.bat OS

c:/cfusionmx/db/slserver32/admin/setcp.bat Default

The SQL statement [ select 1 ] caused an database query exception.

java.sql.SQLException: [Microsoft SQL Server] Login failed.
RAW_TRACE at coldfusion.tagext.lang.IncludeTag.doStartTag(Unknown Source)
PROBLEM java.lang.NumberFormatException: at coldfusion.tagext.lang.IncludeTag.doStartTag(Unknown Source)

CollectionID=default;packageName=<pkgname>;CreateDefaultPackage=false

Connection verification failed for data source: exampleapps [MERANT][SequeLink JDBC Driver] [ODBC Socket][Microsoft][ODBC Microsoft Access 97 Driver] Can't open database '(unknown)'. It may not be a database that your application recognizes, or the file may be corrupt. The root cause was that: null

• Microsoft Jet 4 SP3
  http://www.microsoft.com/data/download_Jet4SP3.htm
• MDAC 2.7
  http://www.microsoft.com/data/download_270RTM.htm

<cfquery>
  insert into tblEmp (employee_id, firstname, lastname, 
    department) values (#empid#,'#fname#','#lname#','#dept#')
</cfquery>

<cfquery>
  update tblEmp
    set firstname = '#fname#',
        lastname = '#lname#'
    where employee_id = #empid#
</cfquery>

• Use RPC as the SOAP binding style and use encoding as the encodingStyle
• Use document as the SOAP binding style and use literal as the encodingStyle

<binding name="BabelFishBinding" type="tns:BabelFishPortType">
  <soap:binding style="rpc" 
     transport="http://schemas.xmlsoap.org/soap/http"/>
  <operation name="BabelFish">
    <soap:operation soapAction="urn:xmethodsBabelFish#BabelFish" />
    <input>
      <soap:body use="encoded" namespace="urn:xmethodsBabelFish"
      encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
    </input>
    <output>
      <soap:body use="encoded" namespace="urn:xmethodsBabelFish"
      encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />
    </output>
  </operation>
</binding>

<cfinclude template="/myvirtual/index.cfm">

• Access DSN – Select the Use Default Username option; OR show the Advanced Settings section and enter a username in the ColdFusion Username field.
• ODBC Socket DSN – Select the Use Trusted Connection option; OR show the Advanced Settings section and, in the Username field, accept the default username (system) or enter a username.

• Collections on another server
• Collections created with mkvdk

<cfset newTC = createObject( "component", testComponent ) /> 
<cfset foo = newTC.foo.moo />

<cfset a1[1] = structNew()>
<cfset a1[1]["moo"][1] = 12>

...to display a page in your application, you must append :8500 to the host name or IP address in the URL; for example, http://localhost:8500/YourApp1/index.cfm.

ColdFusion MX includes JDBC Type 4 database drivers from Merant and MySQL, and JDBC Type 3 database drivers from Merant and SQL Link.

To check for the existence of an array element, copy the element to a simple variable and use IsDefined to test whether the simple variable exists.

Note: The cfquery tag automatically puts the query result in the Variables scope, so you cannot limit its result to the This scope.

Note: The IsDefined function does not test the existence of array elements. To test whether an array index contains data, copy the array element to a simple variable and use the IsDefined function to test the existence of the copy.

If the function can take unnamed optional arguments, use an index number as the key to reference the argument in the structure. For example, if the function declaration includes two named arguments and you call the function with three arguments, refer to the third argument as Arguments.3.

Note: The IsDefined function always returns false when you reference an unnamed optional arguments using structure notation. For example, IsDefined(Arguments.3) for the function described in the preceding paragraph always returns false.

If the function can take unnamed optional arguments, use array notation to reference these arguments. For example, if the function declaration includes two named arguments and you call the function with three arguments, refer to the third argument as Arguments[3]. To determine if an unnamed optional argument exists, use the StructKeyExists function; for example, structKeyExists(arguments,"3").

<cfcomponent hint="This component returns the future and the past.">
  <cfset currentTime = Now()>
  <cffunction name="future" access="remote" hint="one hour from now">
    <cfset futureHour = dateAdd("h",1,currentTime)>
    <cfreturn futureHour>
  </cffunction>
  <cffunction name="past" access="remote" hint="one hour ago">
    <cfset pastHour = dateAdd("h",-1,currentTime)>
    <cfreturn pastHour>
  </cffunction>
</cfcomponent>

<cfcomponent hint="This component returns the directory contents for the supplied path."
displayName="Directory Explorer Component">
  <cffunction name="getDirectory" returnType="query"
  hint="This method returns a query object that contains the directory contents"
  displayName="Get Directory Method">
    <cfargument name="dirPath" type="string" required="true">
    <cfdirectory action="LIST" directory="#arguments.dirPath#" name="dirQuery">
    <cfreturn dirQuery>
  </cffunction>
</cfcomponent>

<cfcomponent hint="This component returns the directory contents for the supplied path."
displayName="Directory Explorer Component"
privateMessage="Beta 3 of Directory Explorer Component.">
  <cffunction name="getDirectory" returnType="query"
  hint="This method returns a query object that contains the directory contents"
  displayName="Get Directory Method"
  usageGuidelines="Pass the fully-qualified path as an argument. Returns a query object.">
    <cfargument name="dirPath" type="string" required="true">
    <cfdirectory action="LIST" directory="#arguments.dirPath#" name="dirQuery">
    <cfdump var=#getMetadata(this)#>
    <cfreturn dirQuery>
  </cffunction>
</cfcomponent>

mydoc.employee.XmlChildren[1].EmpType
mydoc.XmlRoot.XmlChildren[1].EmpType

mydoc.employee.XmlChildren[1].XmlAttributes.EmpType
mydoc.XmlRoot.XmlChildren[1].XmlAttributes.EmpType

Instead, you use CFML include and import tags to include pages and import tag libraries.