Caché Programming Orientation Guide
Server Configuration Options
[Back] [Next]
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

There are a few configuration options for the server that can affect how you write your code. This chapter discusses the following topics:

Most of the configuration details are saved in a file called cache.cpf (the CPF file).
Support for Long String Operations
As noted earlier, Caché allocates a fixed amount of memory to hold the results of string operations. If a string expression exceeds the amount of memory allocated, a <MAXSTRING> error results.
If long string operations are enabled:
Enabling Long String Operations
To enable long strings:
  1. Access the Management Portal.
  2. Check the value of the Enable Long Strings field. If this field is not checked, select it.
  3. If you make any change, select Save.
System-Wide String Collation
By default, the %Library.String datatype uses SQLUPPER collation.
To find the current collation for strings, call the DefaultCollation^%occStorageCompiler() procedure. The argument is the fully qualified class name. For example:
 WRITE "Default collation: "
 WRITE $$DefaultCollation^%occStorageCompiler("%Library.String")
 
To set the collation for this datatype:
  1. Use the SetEnvironment^%apiOBJ() procedure as follows:
     WRITE $$SetEnvironment^%apiOBJ("collation","%Library.String","SQLSTRING")
    For the third argument, specify an allowed collation setting, for example EXACT, SQLUPPER, or SQLSTRING.
  2. Recompile all classes.
  3. Rebuild all indices.
Unlike other options in this chapter, there is no CPF file parameter for this option.
Settings for Caché SQL
To view and modify the settings that affect the behavior of Caché SQL:
  1. Access the Management Portal.
  2. This page lists many settings. The most important ones are typically these:
  3. If you make any change, select Save.
Use of IPv6 Addressing
Caché always accepts IPv4 addresses and DNS forms of addressing (host names, with or without domain qualifiers). You can configure Caché to also accept IPv6 addresses; see IPv6 Support in the chapter “Configuring Caché” in the Caché System Administration Guide.
Configuring a Server Programmatically
You can programmatically change some of the operational parameters of Caché by invoking specific utilities; this is how you would likely change the configuration for your customers. For example:
For details, see the InterSystems Class Reference for these classes.
For More Information
For more information on the topics covered in this chapter, see the following: