Environment Variables |
|
PxPlus maintains a set of operating system-level environment variables that can be used to define and control various aspects of its current working environment. If your application requires changes from the default values, you can initialize the required environment variables (using operating system-specific mechanisms) prior to launching PxPlus.
The following environment variables can be manipulated and accessed for use in your PxPlus applications:
Description | |||||||
Default language code. The PxPlus default is en (English). Note: | |||||||
(Applicable to Client Connections Only) Defines the default setting (IGNORE | VALIDATE | TRUSTREQD) for certificate validation.
(PVX_CERTIFICATES functionality was added in PxPlus 2017.) | |||||||
Defines the default certificate store. The default certificate store is the ca-bundle.crt file in the PxPlus install directory. The latest version of this file is downloaded from the following location: https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt. (PVX_CERTSTORE functionality was added in PxPlus 2017.) | |||||||
During system start_up, the system checks to determine if this environment variable is defined. If it is defined, PxPlus will internally perform a SYSTEM_JRNL OPEN on the value in the environment variable and enable journalization on all files. If the environment variable includes the ;LOCK suffix, journalization is enabled but the user is not allowed to close the journal file or to disable journalization either system wide or on specific files. (PVX_JOURNAL functionality was added in PxPlus 2017.) | |||||||
Can be set to establish whether PxPlus will run in UTF-8 compatibility mode or not. When set to "1", it will enable the 'U8' system parameter during system initialization. (PVX_UTF8 functionality was added in PxPlus 2023.) | |||||||
Name of editor used to maintain online program help information. (Defaults to vi for UNIX.) | |||||||
Value for FID(0). Many PxPlus applications use the logical device name of the terminal; i.e. file 0 (zero) as a unique identifier. Under Windows, the value for FID(0) defaults to T0 (T-zero) unless you override it by setting this environment variable. Example: Note: | |||||||
PVXFLMAP |
File name change map. Use this when migrating files from one host environment to another, to translate invalid filename characters to valid ones for the new environment. To create a map, use one or more two-character codes as values. The first is the filename character as it appears in your program; the second is the character PxPlus will pass to the operating system as a substitute. For example, in UNIX, the file name \\AB\\ is valid, but to Windows, the backslash is a directory delimiter. To translate the file name to a valid Windows file name: SET PVXFLMAP=\_ | ||||||
PVXINI |
(Windows Only) Location of the PxPlus INI file. | ||||||
PVXKEY |
Location of the PxPlus KEYS directory. | ||||||
Similar to the LANG environment variable except that the PVXLANG environment variable takes precedence over the LANG environment variable and is less likely to be used by the operating system or other applications. | |||||||
PVXLIB |
Location of PVX Plus library directory. By default, PxPlus searches for its libraries in the directory where the PXPLUS.EXE program is located. Note:
| ||||||
PVXLS |
(UNIX/Linux Only) ls command. To read a directory under UNIX/Linux, PxPlus internally uses an ls -a command. Output from this operating system command is parsed, and a file name list is built from this output. Only set if your operating system does not have an ls -a command — in this case, set it to whatever command the operating system has that matches the output of an ls -a command on a typical UNIX/Linux system. | ||||||
PVXPDFFONTDIR |
Path location of the font directory for use with *PDF* in UNIX/Linux versions of PxPlus. This variable is not required for Windows; however, it may be used to resolve some situations where PxPlus is unable to find the default font directory. | ||||||
Path and file name of initialization file to be used in place of the default START_UP. See START_UP Initialization Program. | |||||||
PVXTMP |
Name of the directory where temporary files will be placed. (Default is the current directory.) | ||||||
Path and file name of an OpenSSL crypto dynamic library (libcrypto-1.1.dll/libcrypto.so). OpenSSL provides SSL and encryption support to PxPlus. Setting this overrides the default operating system library search rules and explicitly sets which library to load. (PXP_CRYPTO_LIB functionality was added in PxPlus 2020.) | |||||||
This environment variable can be set on the host to define any number of semi-colon separated options that will be added to the option specified on the host Command line. See PxPlus Simple Client-Server Interface. (PXP_CS_OPT functionality was added in PxPlus 2016.) | |||||||
This environment variable can be set on the workstation (client) to define any number of semi-colon separated options that will be added to the option specified on the client Command line. See PxPlus Simple Client-Server Interface. (PXP_CS_OPT_CLIENT functionality was added in PxPlus 2016.) | |||||||
PXP_ID_PFX |
The PXP_ID_PFX value is a prefix associated with the *NEXTSEQ utility. To avoid generating duplicate sequence numbers that may be used as key values in data files, a prefix may be assigned for each programmer/workstation. | ||||||
This environment variable can be set on the workstation (client) to define the path of the log file that will be used by the NOMADS Run-Time Events Logging tool. When defining the log file, you can specify the maximum file size (in megabytes) that you want the log file to grow. See PxPlus Log File. (PXP_LOGFILE functionality was added in PxPlus 2017.) | |||||||
Path and file name of an OpenSSL SSL dynamic library (libssl-1.1.dll/libssl.so). OpenSSL provides SSL and encryption support to PxPlus. Setting this overrides the default operating system library search rules and explicitly sets which library to load. (PXP_SSL_LIB functionality was added in PxPlus 2020.) | |||||||
Can be set to either NOHUP or SETSID to force its use when spawning a UNIX/Linux version of PxPlus. (PXPSPAWN_CMD functionality was added in PxPlus 2017.) | |||||||
This environment variable is used to set the full path name (directory and file name) for the user-defined reserved words data file. See User Reserved Words Maintenance. (PXP_USER_RESERVED_WORDS functionality was added in PxPlus 2017.) | |||||||
This environment variable is used to set a larger TCP block size (BSZ) value in kilobytes for the PxPlus Web Server. The default value is 80 kilobytes. If you want the PxPlus Web Server to handle larger responses, set this to a value greater than 80 kilobytes; however, increasing this value will cause the PxPlus Web Server to use more memory. Note:
| |||||||
TERM |
(UNIX Only) Terminal type. This environment variable is normally set automatically by your UNIX/Linux operating system and matches the type of terminal you are using such as ANSI, WYSE60, Linux, etc. PxPlus uses the current value of the TERM environment variable to determine which PxPlus device driver is in the *dev directory and which keyboard map to LOAD/RUN during initialization. | ||||||
USER |
(Only if No Operating System User ID Set) User ID. To establish a user name to make applications work properly, create and/or modify a .BAT file to include the directive: SET USER=userID | ||||||
(WindX Only) This environment variable can be set on the workstation (client) to define any number of trusted servers (semi-colon separated) to which WindX Security will allow full access to the workstation files and programs without requesting user authorization. The server name or IP address defined in this variable must match the server name or address used in the WindX Connection Manager. Entries in this variable are case insensitive. If this variable is set and WindX connects to a server not in the list of trusted servers, WindX security will deny that server all access to the workstation files and programs. Example: WDXTRUST=server1;192.168.1.34 In this example, when WindX connects to either "server1" or "192.168.1.34", WindX security will allow only these servers full access to the workstation files and programs. (WDXTRUST functionality was added in PxPlus 2017.) |