Documentation Center

Contenta environment variables

This topic describes environment variables used with Contenta.

SDL sets default values for most Contenta environment variables. The variables are defined in the registry on Windows systems, and in the pdm.cshrc file on Linux systems.

The values are defined during installation or through the Contenta Tools > Options menu settings. You can also set them within your environment by entering a command from the system prompt or by editing the pdm.cshrc file (Linux) or the Windows' registry. While most Contenta environment variables are used on Windows, some variables apply only to Linux.

Do not make any changes in the Windows Registry unless you are thoroughly familiar with the registry, keys, and referenced files or paths. Incorrect modifications can adversely affect your system performance.

Cross-Platform Variables

The cross-platform variables are defined for Linux and Windows systems.
  • Linux Variables are defined in: Contenta_home/bin/pdm.cshrc
  • Windows Variables are defined in the registry under: HKEY_LOCAL_MACHINE\SOFTWARE\Contenta_home\3.0

The Contenta_home directory is the Contenta software’s home (top level) directory path.

VariableDescription
$NLSPATHThe path for PDM message file location.

This value usually does not need to be defined.

$XYE_API_REGISTRY_FILEThis environment variable helps you configure the path to API registry used by the Contenta Explorer.

The default value is configured automatically.

$ORACLE_HOMEThe directory in which Oracle products are installed.
$SYSTYPEDefines the system type.

This must be defined for the appropriate system type.

$XAPPLRESDIRDefines the path to the Contenta resource file location.

You only need to define this value if a private Contenta file is to be used.

$XYE_PRTL_DATABASE_SIDOracle only

Oracle database SID used by Contenta portal.

$XYE_PRTL_LOG_DIRThe path to directory where Contenta log files are stored.
$XYE_PRTL_SOCKETThe socket for Contenta portal communication (the PdmPortal number).
$XYV_PDM_DATA_DIRThe directory to which Contenta information is exported for use by encapsulators.

Default: $HOME, the user’s home directory.

$XYE_PDM_DATABASE_SIDOracle only

The Oracle database SID for Contenta administration and tools.

$XYV_PDM_DBASEThe name of the Contenta database.

The variable is used if the -dbase switch is not specified.

$XYV_PDM_DBTYPEThe type of database: Oracle or MSSQL
$XYV_PDM_ENCAPS_DIRThe directory containing Contenta application interfaces.

Default: $XYV_PDM_ROOT\encaps

$XYV_PDM_HELPThe path to Contenta help files.
$XYV_PDM_INDXTBLSPACEOracle only

The default for the Contenta database index tablespace.

$XYV_PDM_LANGUAGEEnglish
$XYV_PDM_LOGFILEThe name of Contenta log file.

Default: $XYV_PDM_ROOT\logs\dbname.log

$XYV_PDM_MOD_LBREAKOptional

Set this variable to prevent removal of line endings and white space in Module objects. To use, set variable to ASCII.

For example, in Linux: setenv XYV_PDM_MOD_LBREAK ASCII

$XYV_PDM_NOCOREOptional

When set, Contenta does not create a core file in the event of a crash.

$XYV_PDM_ROOTThe path for the Contenta home directory (top level directory path of Contenta).
$XYV_PDM_PERL_BINDIR Location of the Perl executables directory.

Default: Perl_home\perl\bin

$XYV_PDM_PERL_DLLPATH Location of the Perl DLL directory.

Default: Perl_home\c\bin

$XYV_PDM_TBLSPACEThe default for the Contenta database tablespace.
$XYV_PDM_TMPTBLSPACEThe default for the Contenta database temporary tablespace.

Windows Variables

Pcmadmin and other Contenta command utilities use values that are stored in the Registry under the path:

HKEY_LOCAL_MACHINE > Contenta > 3.0

These values are established during the installation of Contenta software. The following table describes the registry settings for configurations using an Oracle database server on Windows systems.

VariableDescription
ORACLE_HOMEOracle Installation Directory
MSSQL_HOMEThe directory in which Microsoft SQL Server products are installed.
SYSTYPESystem Type (WINNT)
XYV_PDM_DATABASEdatabase name
XYV_PDM_DBTYPEDatabase Type (Oracle)
XYV_PDM_ENCAPS_DIRDirectory containing Application Interface (AI) Programs (Contenta /encaps directory)
XYV_PDM_HELPDirectory containing on-line help files
XYV_PDM_INDXTBLSPACEOracle table space for indexes.
XYV_PDM_LANGUAGESystem Language (English)
XYV_PDM_LOGFILEName of the log file
XYV_PDM_ROOTContenta installation directory
XYV_PDM_TABLESPACEOracle table space for application data
XYV_PDM_TMPTBLSPACEOracle temporary table space