Contents
Chapter 1: 
The Caché Parameter File
 
  • 1.1 Filename and Location
  • 1.2 Caché Configurations
  • 1.3 Caché Instances
  • 1.4 Configuration Export
  • 1.5 Configuration Security
  • 1.6 Parameter File Format
  • 1.6.1 Spaces
  • 1.6.2 Sections
  • 1.6.3 Parameters
  • 1.7 Parameter Descriptions
  • 1.8 New or Obsolete Parameters
  • 1.9 List of Sections and Parameters
    •  
    Reference A: 
    [ConfigFile]
     
  • Version —  Caché parameter file version.
    • Reference B: 
    [Com]
     
  • COMn — Default settings for COM ports.
    • Reference C: 
    [config]
     
  • overview — Caché platform and version summary.
  • globals — Size of shared memory for global cache.
  • routines — Size of shared memory for caching routine buffers.
  • memlock — (UNIX and Linux) Enable/disable locking shared memory or the text segment into memory.
  • rbufsiz — Size of one routine buffer.
  • locksiz — Maximum size of shared memory for locks.
  • ijcbuff — Size of an InterJob Communication buffer.
  • ijcnum — Number of InterJob Communication devices.
  • netcliconmax — Maximum incoming client connections, per port and per server.
  • gmheap — Size of the generic memory heap.
  • netjob — Enable/disable remote job requests.
  • vtabsiz — Size of the DSM translation table.
  • zfheap —  Size and configuration of the $ZF heap.
  • gnetfrac — Percentage of the global buffer pool to use as client-side network cache.
  • gmaxcache —  Maximum size of the global blocks cache for jobs doing client-side networking.
  • bbsiz —  Maximum memory per process.
  • history — Command line recall.
  • vectors —  Number of global vectors for each process.
  • wijdir —  Write Image Journal directory.
  • pijdir —  (OpenVMS, Tru64) Pre-Image Journal directory.
  • nlstab — Number of NLS collation tables.
  • udevtabsiz —  Maximum size of the device table.
  • errlog —  Maximum entries in the error log.
  • console — Console log file.
  • useresidentmem — (OpenVMS) Name of a reserved resident memory section.
  • MaxServers —  Maximum connections to ECP servers.
  • MaxServerConn —  Maximum connections from ECP clients.
  • LegacyNetConn — Legacy network connections.
    • Reference D: 
    [Startup]
     
  • stu — System startup.
  • zstu — User-defined startup.
  • start_0=System — System startup and shutdown.
  • start_1=Process — Foreground process startup and shutdown.
  • start_2=Job — Background process (job) startup and shutdown.
  • start_3=Callin — Callin initialization and close.
  • LicenseServer — IP address and port number for License Servers.
  • JobServers —  Number of job servers.
  • maxconsolelogsize — Maximum size of the console log file.
  • DefaultPort — Port number for the Caché SuperServer.
  • DomainSpaceMaster — Domainspace master and alternate master.
  • ShutdownTimeout —  Number of seconds Caché should wait for shutdown to complete.
  • ErrorPurge —  Number of days to keep error globals.
  • TempDirectory —  Subdirectory for temporary files.
  • WebServer —  Enable/disable the Web server.
  • WebServerURLPrefix — Identify the Caché instance name so that a remote Web server can access it.
    •
    Reference E: 
    [Journal]
     
  • CurrentDirectory —  Primary location of the journal file.
  • AlternateDirectory —  Alternate location of the journal file.
  • FileSizeLimit —  Maximum size of a journal file.
  • JournalHalt — Enable/disable suspending Caché when an error occurs in writing to the journal.
  • JournalPurge —  Number of days (or backups) before Caché purges finished journal files.
  • TransNumKillJrn —  Maximum number of nodes to journal during a kill within a transaction.
    • Reference F: 
    [Shadowing]
     
  • errmax — Maximum shadowing errors to keep.
  • intv —  Number of seconds between shadowing probes.
  • KeepCliProp — Preserve/discard properties of shadow servers from previous Caché sessions.
  • CLI_n — Shadow server destinations.
    • Reference G: 
    [IO]
     
  • Mnemonic_MT —  Default mnemonic for WRITE commands to magnetic tape.
  • Mnemonic_OTH — Default mnemonic for WRITE commands to device types other than magnetic tape, terminal, or sequential file.
  • Mnemonic_SEQ —  Default mnemonic for WRITE commands to a sequential file.
  • Mnemonic_TTY —  Default mnemonic for WRITE commands to a terminal device.
  • OpenMode —  Read/write mode to use when opening sequential files.
  • FileMode —  Enable/disable writing to a non-existent file.
  • JobDevice — (UNIX, Linux, OpenVMS) Default device for jobbed processes.
    • Reference H: 
    [Language]
     
  • Undefined — ObjectScript response to undefined variables.
  • NullSubscripts — Enable/disable null subscripts on global references.
  • GlobalKillEnabled —  Enable/disable KILL of an unsubscripted global.
  • BreakMode — Programmer mode response to the BREAK command.
  • PhysicalCursor —  Backspace conventions.
  • RefInKind — Result of $NAME and $QUERY when an extended global reference is the argument.
  • ZaMode — ZALLOCATE (ZA) and ZDEALLOCATE (ZD) behavior.
  • LineRecall — Enable/disable command line recall for READ commands.
    • Reference I: 
    [Telnet]
     
  • DNSLookup — (Windows) Enable/disable DNS lookup of the Telnet client address.
  • Port — (Windows) Telnet port number.
    • Reference J: 
    [LAT]
     
  • NodeName — Node name for LAT service advertisements.
  • MessageRetransmitLimit — Number of times an unacknowledged message will be retransmitted.
  • HostMulticastTimer —  Number of seconds between LAT service advertisement broadcasts.
  • NodeGroups — Group codes for LAT announcement packets.
  • UserGroups — LAT user group.
  • ServiceName_n —  LAT service names.
  • ServiceDescription_n —  LAT description strings.
  • ServiceRating_n —  LAT service ratings.
    •
    Reference K: 
    [Device Sub-Types]
     
  • SubType_n —  Device subtypes.
    •
    Reference L: 
    [Devices]
     
  • Device_n — Device types.
    •
    Reference M: 
    [MagTape]
     
  • Drive_n —  Magnetic tape drives.
    • Reference N: 
    [Cluster]
     
  • NetworkType — (OpenVMS, Tru64) Cluster network type.
  • ClusterCommAddr — (OpenVMS, Tru64) Cluster address.
  • JoinCluster — (OpenVMS, Tru64) Join/decline cluster.
    •
    Reference O: 
    [ECP]
     
  • ServerTroubleDuration —  Number of seconds an ECP connection will stay troubled.
  • ClientReconnectInterval —  Number of seconds to wait between ECP reconnection attempts.
  • ClientReconnectDuration —  Total seconds to keep making ECP reconnection attempts.
    •
    Reference P: 
    [DSM-DDP]
     
  • DdpHost — DDP host name.
  • DDPGroups — DSM-DDP groups in which this system may participate.
  • DDPMaster —  (OpenVMS) Enable/disable this system as the DDP Master.
  • numddpdmn —  Number of DDP daemons.
  • NetIsDDP_n —  Ethernet device mappings.
  • DDPVolumeAndUci_n —  Mappings from incoming VolSet/UCIs to local directories.
  • DDPVolSet_n —  Remote Volume Sets.
    •
    Reference Q: 
    [Net]
     
  • Timeout —  Number of seconds before timing out Legacy Network connections.
  • CliSysName —  Node name for the local system.
  • maxnode — Number of remote nodes.
  • maxdsmport —  Number of active DDP ports.
  • maxdsmhostperport —  Maximum connections to remote hosts per DDP port.
  • renotify — Enable/disable notification to remote systems at startup.
  • mnetjob — Enable/disable monitoring of ^NETQUEUE.
  • numdcpdmn — Maximum DCP client processes.
  • maxnpdmn — Maximum DCP server processes.
  • udprcvbufsiz —  Size of the receive buffer for incoming DCP traffic.
  • udpsndbufsiz — Size of the send buffer for outgoing DCP traffic.
  • requestbuf —  Number of buffers for user jobs, per port.
  • maxudppktsiz — Maximum block size for UDP.
  • nodereqb — Maximum simultaneous request buffers per remote server.
  • baserexmit —  Initial number of seconds to wait before retrying a DCP or DDP connection.
  • maxrexmit — Maximum seconds to wait before retrying a DCP or DDP connection.
  • numhwbuf — (OpenVMS) Number of hardware buffers used for Ethernet.
    •
    Reference R: 
    [Data Servers]
     
  • NetIsUDP_n —  Remote servers for DCP networking.
  • NetIsEther_n —  Outgoing Ethernet ECP connections.
    •
    Reference S: 
    [Datasets]
     
  • DataSet_n — Define Caché datasets.
    •
    Reference T: 
    [Namespaces]
     
  • Nsp_n — Define Caché namespaces.
    •
    Reference U: 
    [NspMap]
     
  • ClsLibMap_n — Map a package to all local namespaces.
  • ClsPkgMap_n — Map a package to a specific namespace.
  • GloMap_n —  Map globals to namespaces.
  • GloSLM_x_n — Provide subscript-level mapping (SLM) of globals to namespaces.
  • RouMap_n —  Map routines to namespaces.
    •
    Reference V: 
    [SQL]
     
  • ddlNo30 —  Suppress/return error upon DDL DROP of a nonexistent table.
  • ddlNo201 — Suppress/return error upon DDL CREATE of a previously existing table.
  • ddlNo307 — Suppress/return error upon DDL CREATE of a primary key constraint when one exists.
  • ddlNo315 — Suppress/return error upon DDL DROP of a nonexistent constraint.
  • ddlNo324 — Suppress/return error upon DDL CREATE of a previously existing index.
  • ddlNo333 —  Suppress/return error upon DDL DROP of a nonexistent index.
  • dropDelete — DDL DROP TABLE behavior.
  • idKey — Primary key constraint behavior.
  • lockTimeout — SQL lock timeout.
  • comments —  Enable/disable retaining embedded SQL statements as comments in source code.
  • delimitedIds —  Enable/disable interpreting double-quoted strings as delimited identifiers.
  • dbmsSecurity — Enable/disable SQL security.
  • prefix — Routine prefix name for cached query routines.
  • saveMAC —  Enable/disable saving the source code for cached query routines.
  • idTrxFrom —  The “From” list of characters for DDL Identifier Translation.
  • idTrxTo —  The “To” list of characters for DDL Identifier Translation.
  • referentialChecks — Enable/disable validating the foreign key constraint.
  • ddlNo311 — Suppress/return error upon DDL ADD a foreign key, when a key of that name already exists.
  • DefaultSchema — Default SQL schema name.
  • ExtrinsicFunctions —  Enable/disable extrinsic functions in SQL statements.
  • TimePrecision —  Default time precision for SQL scalar time functions.
  • JDBCGatewayPort — Port number for the JDBC Gateway.
  • JDBCGatewayLog —  Name of the JDBC Gateway log file.
  • LockThreshold —  SQL lock threshold.
  • TODATEDefaultFormat —  Default date format for the SQL TO_DATE() function.
  • ODBCVarcharMaxlen —  Define the MaxLen for ODBC fields of type VarChar.
  • AllowRowIDUpdate —  Enable/disable SQL row ID update.
  • DDLSQLOnlyCompile —  Enable/disable a DDL SQL-only compile.
    •
    Reference W: 
    [SqlSysDatatypes]
     
  • System-Defined SQL Datatypes —  Map SQL datatypes to their Caché equivalents.
    • Reference X: 
    [SqlUserDatatypes]
     
  • User-Defined SQL Datatypes —  Map SQL datatypes to their Caché equivalents.
    •
    Reference Y: 
    [Monitoring]
     
  • BMCPatrol — Behavior of the PATROL utility.
  • SNMP —  Enable/disable automatic SNMP startup.
  • WMI — Enable/disable Windows Management Instrumentation (WMI) monitoring.
    •
    Reference Z: 
    [Miscellaneous]
     
  • DisconnectErr —  Enable/disable a process to receive disconnect errors.
  • AsyncDisconnectError —  Enable/disable a process to receive disconnect errors asynchronously.
  • DdpSec —  Enable/disable a password for DDP connections.
  • NetNullSubs — Enable/disable null subscripts across a DCP network connection.
  • SynchCommit —  Enable/disable synchronizing TCOMMIT with the corresponding journal write operation.
  • ClearNoDelete —  (OpenVMS) Enable/disable nodelete in $ZF functions.
  • NamespacePrompt — Enable/disable namespace name in the command line prompt.
  • PopError — When to pop error handlers off the stack.
  • DropRemLocks — Handling of network locks when the network returns after a DCP outage.
  • ZDateNull — $ZDATE response to an invalid value.
  • AsynchError —  Enable/disable processes to receive asynchronous errors.
  • NWDSRetry — Enable/disable a “silent” retry for attempts to connect to a domainspace.
  • EnableCaching —  Enable/disable caching of DCP data.
  • SetZEOF —  Behavior when Caché encounters an unexpected end-of-file when reading a sequential file.
  • NodeNameInPid — Behavior when Caché makes a reference to the special variable $JOB.
  • ShutDownLogErrors — Enable/disable ^SYSLOG errors in the console log file.
  • TruncateOverflow — Enable/disable the <MAXNUMBER> error on numeric overflow.
  • LogRollback — Enable/disable logging for transaction rollbacks.
  • SwitchOSdir — Enable/disable switching current working directories when changing namespaces.
  • UseNagleAlgorithm — Enable/disable the Nagle algorithm for Telnet.
    •
     
    Appendix A: 
    [Debug]
     
    Copyright  © 1997-2006, InterSystems Corp. Build: Caché v5.2 (320U-320U) Last updated: 2006-05-18 15:24:28 Source: RCPF.xml