background image

Connecting to Sybase 11.5, 11.9, 12.0, and 12.5

47

Connecting to Sybase 11.5, 11.9, 12.0, and 12.5

Use the settings in the following table to connect ColdFusion to Sybase 11.5, 11.9, 12.0, 
and 12.5 data sources:

Setting

Description

CF Data Source 
Name

The data source name (DSN) used by ColdFusion to connect to the 
data source.

Database

The database to which this data source connects.

Server

The name of the server that hosts the database that you want to use. 
If the database is local, enclose the word local in parentheses.

Port

The number of the TCP/IP port that the server monitors for 
connections.

Username

The user name that ColdFusion passes to the JDBC driver to 
connect to the data source if a ColdFusion application does not 
supply a user name—for example, in a 

cfquery

 tag.

Password

The password that ColdFusion passes to the JDBC driver to 
connect to the data source if a ColdFusion application does not 
supply a password—for example, in a 

cfquery

 tag.

Description

(Optional) A description for this connection.

Select Method

Determines whether server cursors are used for SQL queries.

The Direct method provides more efficient retrieval of data when 
you retrieve record sets in a forward-only direction and you limit your 
Sybase connection to a single open SQL statement at a time.  This 
is typical for ColdFusion applications.

The Cursor method lets you have multiple open SQL statements on 
a connection.  This is not typical for ColdFusion applications, unless 
you use pooled statements.

Maintain 
Connections

ColdFusion establishes a connection to a data source for every 
operation that requires one. Enable this option to improve 
performance by caching the data source connection. 

Timeout (min)

The maximum number of minutes after the data source connection 
is made that you want ColdFusion to cache a connection after it is 
used.

Interval (sec)

The time (in seconds) that the server waits between cycles to check 
for expired data source connections to close.

Disable Connections

If selected, suspends all client connections.

Login Timeout (sec)

The number of seconds before ColdFusion times out the data 
source connection login attempt.

CLOB

Select to return the entire contents of any CLOB/Text columns in 
the database for this data source. If unchecked, ColdFusion 
retrieves the amount specified in the Long Text Buffer setting.

Summary of Contents for 38000827 - Macromedia ColdFusion MX Standard Edition

Page 1: ...Administering ColdFusion MX...

Page 2: ...mes of Macromedia Inc or other entities and may be registered in certain jurisdictions including internationally This product includes code licensed from RSA Data Security This guide contains links to...

Page 3: ...tings section 4 Data Services section 4 Debugging Logging section 5 Extensions section 5 Security section 5 CHAPTER 2 Basic ColdFusion MX Administration 7 Initial administration tasks 8 Server Setting...

Page 4: ...ivers 31 Adding data sources 32 Adding data sources in the Administrator 32 Connecting to DB2 UDB for OS 390 36 Connecting to DB2 Universal Database 6 2 7 2 37 Connecting to Informix 9 x 38 Connecting...

Page 5: ...Fusion MX is intended for anyone who needs to configure and manage their ColdFusion development environment Contents Developer resources vi About Macromedia ColdFusion MX documentation vii Getting ans...

Page 6: ...s through participation in the Online Forums where you can post messages and read replies on many subjects relating to ColdFusion http webforums macromedia com coldfusion Installation Support Support...

Page 7: ...features and application development procedures Includes a tutorial that guides you through the process of developing an example ColdFusion application Using Server Side ActionScript in ColdFusion MX...

Page 8: ...y can also help you search messages from the previous 12 months allowing you to learn how others have solved a problem that you might be facing The Forums is a great resource for learning ColdFusion b...

Page 9: ...ts an overview of the ColdFusion Administrator and how you can use it to manage your development environment For procedures see the Administrator s online Help Contents About the ColdFusion Administra...

Page 10: ...tor is on a remote computer use the DNS name or IP address of the remote host To access the ColdFusion Administrator enter the username and password that you used when you installed ColdFusion Accessi...

Page 11: ...figure mail logging Configure your JVM the ColdFusion charting and graphing engine and create and manage archives Data Services Configure data sources Verity collections and the Verity K2 Server Defin...

Page 12: ...r Configure the mail server that ColdFusion uses to send dynamic mail messages using SMTP Simple Mail Transfer Protocol Charting Specify caching and thread settings for the ColdFusion charting and gra...

Page 13: ...a potential problem is detected a system probe can send an alert e mail message and execute a recovery script Code Analyzer Evaluate application code for potential incompatibilities between ColdFusio...

Page 14: ...6 Chapter 1 Administering ColdFusion...

Page 15: ...ldFusion MX administration tasks following the sturcture of the ColdFusion Administrator sections Contents Initial administration tasks 8 Server Settings section 9 Data Services section 17 Debugging L...

Page 16: ...formation use the Debugging Logging section of the Administrator For more information see Debugging Settings page on page 19 Set up e mail E mail lets ColdFusion MX and ColdFusion applications send au...

Page 17: ...n seconds Enable this option to prevent unusually lengthy requests from using up server resources Enter a limit to the time that ColdFusion MX waits before terminating a request Requests that take lon...

Page 18: ...n the registry because it can critically degrade performance of the server If you do use the registry to store client variables you must allocate sufficient memory and disk space You can override sett...

Page 19: ...sallow cookies ColdFusion MX limits a cookie s data to 4 KB Netscape Navigator allows only 20 cookies from one host ColdFusion MX uses three cookies to store read only data leaving only 17 cookies ava...

Page 20: ...osoft Access databases cfquery name data1 datasource DSN CREATE TABLE CDATA cfid char 20 app char 64 data memo cfquery cfquery name data2 datasource DSN CREATE UNIQUE INDEX id1 ON CDATA cfid app cfque...

Page 21: ...ldFusion header pages reside in c 2002 newpages headers In order for ColdFusion MX to find your header pages you must add a mapping in the ColdFusion Administrator that points to c 2002 newpages heade...

Page 22: ...tor if you are unsure of the appropriate port number Connection Timeout seconds Enter the number of seconds that ColdFusion should wait for a response from the mail server Spool Interval seconds Enter...

Page 23: ...ore memory intensive Maximum number of images in cache Specify the maximum number of charts to store in the cache After the cache is full if you generate a new chart ColdFusion discards the oldest cha...

Page 24: ...tags Archive to do lists After you archive the information you can use the Administrator to deploy your web applications to the same ColdFusion MX server or to a ColdFusion MX server running on a dif...

Page 25: ...mation and logical pointers to the document files For more information about building search interfaces see the chapters about the cfindex cfsearch and cfcollection tags in Developing ColdFusion MX Ap...

Page 26: ...ication functionality over the Internet The ColdFusion Administrator lets you register web services so that you do not have to specify the entire Web Services Description Language WSDL URL when you re...

Page 27: ...It provides a basic view and few browser restrictions dockable cfm A dockable tree based debugging panel For details about the panel and browser restrictions see the online Help Report stack trace to...

Page 28: ...ng static content to HTML pages DB Sec Database accesses per second The number of database accesses per second made by ColdFusion Any difference in complexity and resource load between calls is ignore...

Page 29: ...AvgDB Time Average database transaction time A running average of the time ColdFusion spends on database related processing of ColdFusion requests Bytes In Sec Bytes incoming per second The number of...

Page 30: ...ich error log files are written Maximum file size kb Set the maximum file size for log files Once a file hits this size it will be automatically archived Maximum number of archives Set the maximum num...

Page 31: ...This service provides remote HTTP based access to files and databases application log Records every ColdFusion MX error reported to a user Application page errors including ColdFusion MX syntax ODBC a...

Page 32: ...f your ColdFusion applications Like scheduled tasks they access a URL at a specified interval but they can also check for the presence or absence of a string in the URL If the URL contents are unexpec...

Page 33: ...s built with C and Java You can build CFX tags in the following two ways Using C as a dynamic link library DLL in Windows as shared objects so sl on Solaris Linux and HP UX Using Java interfaces defin...

Page 34: ...untime corba VisibrokerConnector ORB Property File c neo cfusion lib vbjorb properties Classpath blank ColdFusion includes the vbjorb properties file which contains the following properties that confi...

Page 35: ...ColdFusion security Once enabled you can secure ColdFusion in the following ways Administrative access Protects access to Administrator pages with a password Application development Protects access t...

Page 36: ...wed by a BR with a separate line for each link Do not include other HTML code such as head or body tags Save this file as extensionscustom cfm in the Administrator root directory CFIDE Administrator F...

Page 37: ...CFML Contents About JDBC 30 Adding data sources 32 Connecting to DB2 UDB for OS 390 36 Connecting to DB2 Universal Database 6 2 7 2 37 Connecting to Informix 9 x 38 Connecting to Microsoft Access 39...

Page 38: ...less your application requires specific features of these drivers 2 Native API partly Java driver Converts JDBC calls into database specific calls Advantages Better performance than Type 1 Driver Disa...

Page 39: ...age 37 Informix 9 x 4 Connecting to Informix 9 x on page 38 Microsoft Access 3 Connecting to Microsoft Access on page 39 Microsoft SQL Server 7 x 2000 4 Connecting to Microsoft SQL Server 7 x 2000 on...

Page 40: ...w data sources you can use the ColdFusion Administrator to correct for changes to your database such as relocation renaming or changes in security permissions Adding data sources in the Administrator...

Page 41: ...er the name of the database for example Northwind 6 In the Server field enter the network name or IP address of the server that hosts the database and enter any required Port value for example the bul...

Page 42: ...Advanced Settings to specify any ColdFusion specific settings for example to configure which SQL commands will interact with this data source 10 Create Submit to create the data source ColdFusion auto...

Page 43: ...inistrator configures the following ODBC connection string DSN odbcdsnname APP RaiseGenerator WSID TWriter01 In the preceding string odbcdsnname is the name of the ODBC DSN This is the string that the...

Page 44: ...ource for every operation that requires one Enable this option to improve performance by caching the data source connection Timeout min The maximum number of minutes after the data source connection i...

Page 45: ...ion establishes a connection to a data source for every operation that requires one Enable this option to improve performance by caching the data source connection Timeout min The maximum number of mi...

Page 46: ...on to a data source for every operation that requires one Enable this option to improve performance by caching the data source connection Timeout min The maximum number of minutes after the data sourc...

Page 47: ...ldFusion passes to the JDBC driver to connect to the data source if a ColdFusion application does not supply a user name for example in a cfquery tag Password The password that ColdFusion passes to th...

Page 48: ...n the Long Text Buffer setting BLOB Select to return the entire contents of any BLOB Image columns in the database for this data source If unchecked ColdFusion retrieves the amount specified in the Bl...

Page 49: ...used for SQL queries The Direct method provides more efficient retrieval of data when you retrieve record sets in a forward only direction and you limit your SQL Server connection to a single open SQL...

Page 50: ...pecified in the Blob Buffer setting LongText Buffer chr The default buffer size used if Enable Long Text Retrieval CLOB is not selected Default is 65000 bytes BLOB Buffer bytes The default buffer size...

Page 51: ...on to a data source for every operation that requires one Enable this option to improve performance by caching the data source connection Timeout min The maximum number of minutes after the data sourc...

Page 52: ...performance by caching the data source connection Timeout min The maximum number of minutes after the data source connection is made that you want ColdFusion to cache a connection after it is used Int...

Page 53: ...shes a connection to a data source for every operation that requires one Enable this option to improve performance by caching the data source connection Timeout min The maximum number of minutes after...

Page 54: ...rove performance by caching the data source connection Timeout min The maximum number of minutes after the data source connection is made that you want ColdFusion to cache a connection after it is use...

Page 55: ...re used for SQL queries The Direct method provides more efficient retrieval of data when you retrieve record sets in a forward only direction and you limit your Sybase connection to a single open SQL...

Page 56: ...pecified in the Blob Buffer setting LongText Buffer chr The default buffer size used if Enable Long Text Retrieval CLOB is not selected Default is 65000 bytes BLOB Buffer bytes The default buffer size...

Page 57: ...n security lets you secure a number of ColdFusion MX resources with password access and perform sandbox security This chapter describes configuration options for ColdFusion security Contents About Col...

Page 58: ...ldFusion MX Applications with CFML The Security area in the ColdFusion Administrator lets you do the following tasks Enable or disable ColdFusion security on the Security Sandbox Security page Configu...

Page 59: ...er during installation is saved as the default When you open the Administrator for the first time you are prompted to enter the password If you configured password protection for RDS accesswhen you in...

Page 60: ...curity CF Admin Password page You can also change the password on that page by entering a new password twice RDS password protection You can enable file and data source security for RDS access from th...

Page 61: ...r example if you are a web hosting administrator who hosts several clients on a ColdFusion shared server you can configure a sandbox for each customer This prevents one customer from accessing the dat...

Page 62: ...rmission on C pat lets you do the following tasks List all files in the C pat riots directory List all files in the C pat riots2 Read the C pat a txt file File path Affected files or directories C foo...

Page 63: ...nistrator The Root Security Context appears in the list of Defined Directory Permissions as the following figure shows 2 In the Add Security Sandbox box enter the name of the new sandbox This name can...

Page 64: ...to edit As in the following figure several tabs appear which subsequent steps discuss 3 To disable a data source in the left column of the Data Sources tab highlight the data source and click the righ...

Page 65: ...cured Files and Directories list verify that the file path is correct The character after the backslash is important A dash indicates all files in the present directory and any child directories inclu...

Page 66: ...rowse sites they affect access to a ColdFusion page with certain tags If a ColdFusion page does not use for example cfhttp any sandbox restriction on cfhttp has no effect 14 To prevent these ColdFusio...

Page 67: ...word 51 RDS Password page 27 Sandbox Security page 27 Security section 27 50 Server Settings section 9 Settings Summary page 16 user assistance types of 2 Verity Collections page 17 Verity K2 Server p...

Page 68: ...RDS 52 Post Office Protocol POP Mail Server 13 R RDS Password page ColdFusion Administrator 27 RDS password security 52 root security content 55 S sandbox adding 55 configuring 56 security using 53 S...

Reviews: