Wednesday December 3, 2003 dynamicXport 2.1.7 Release All Rights Reserved. Copyright (c) 2001 - 2003 by: Dynamic Concepts, Inc. Aliso Viejo, CA 92656 USA Email address: techsupport@dynamic.com Information: www.dynamic.com Downloads: ftp.dynamic.com Product Description =================== dynamicXport is a portal and RAD (Rapid Application Development) toolkit, consisting of customizable web templates and a software API (Application Program Interface) which enables the creation of a web based presentation layer to existing software and database. dynamicXport requires both an Application server and a Web server. Although both the Application and the Web servers may reside on a single physical system, Dynamic Concepts strongly recommends the usage of two separate systems and that the Application server is secured behind a Firewall. The Web server may be either a Unix server or a Windows IIS server. The Application server may be either a Unix server or a Windows server. Any combination of Unix and Windows servers may be used with dynamicXport. Pre-installation instructions ============================= o This release requires dL4 version 5.1.1 or higher for application services. Users running with a dL4 license prior to version 5 must also acquire a dL4 version 5 SSN. o Problem reports should be emailed to techsupport@dynamic.com. All problem reports should contain a description of the problem, the operating system name/revision, and, if at all possible, a reproducible sequence o To improve performance and to add additional features, the dynamicXport platform has been changed from the universal platform FF to machine specific platforms, e.g. 99 (SCO), 6D (Linux), 1B (Windows), etc. If the application server and web server are on different systems, the appropriate machine specific distribution file must be downloaded for each system. o For dynamicXport application services, users should download the latest Passport revision for the appropriate platform. Highlights of revision 2.1 ========================== o To improve performance and to add additional features, the dynamicXport platform has been changed from FF to the appropriate platform, e.g. 99 (SCO), 6D (Linux), 1B (Windows), etc. The product must be downloaded for the correct platform. o The dynamicXport Web services no longer require dL4 run. o For ease of installation, a copy of dL4 run is now distributed with this product for dynamicXport application services. o dynamicXport now offers an unlimited or a lite licensing option. The lite option allows adding a finite number of dynamicXport users. o dynamicXport users may upload files from their local system to the application server. o dynamicXport users may download files to their local system from the application server. o dl4o(include, "filename") option allows HTML pages to include other HTML pages. Upgrade Instructions ==================== 1. Make a current backup of the directory where DynamicXport is currently installed on the Application server. 2. This version requires dL4 5.1.1 or greater. 3. Both the Application and the Web servers must be upgraded with files from the same version. If the Application and Web servers are on different platforms (such as Unix and Windows or two different Unix platforms), then be certain to download the platform specific copy of dynamicXport for each platform. 4. If upgrading from a previous version, simply follow the regular installation procedure for product upgrade. 5. The upgrade procedure keeps a backup copy of the dynamicXport support files in the oldfiles directory. 6. If you wish to retain your older files, then rename oldfiles directory to files. 7. If you want to retain files from revision 1.2.2 or older, please run the dxrebuild.dl4 utility to convert your files. Login as 'dxport' and type the following: run dxrebuild.dl4 Type 'run dxrebuild.dl4 help' for help. Installation instructions ========================= 1. Install the application and/or web server as described in the sections below. Please select the section that is appropriate for your platform (Unix or Windows) and for your server types (application or web server). The Unix web server installation instructions are generic and may need to be adapted to the particular web server or web server directory structure used on the system. The Windows installation is described for Windows 2000 Server. If you are installing on Windows 2000 Professional, Windows XP, or Windows NT, the Windows 2000 instructions can be used, but different utility names may be needed. 2. After the installation is completed, the login page for dynamicXport may be accessed from a JavaScript enabled browser by opening: domain_name/dx/login/dxstd/login.html Unix Application Server Configuration ===================================== 1. Login as 'root'. 2. Ensure that you have the latest Passport version installed on your application system. For common platforms, the latest Passport software can be obtained from either www.dynamic.com or ftp.dynamic.com. Older versions of ssnmaint list dynamicXport as product 6. 3. Install dL4 version 5.1.1 or greater for Unix, along with your dynamicXport SSN. 4. Create a new Unix account named 'dxport'. 5. Create a home directory for the account created in the previous step, e.g. '/home/dxport'. 6. Configure a Unix Application server by adding new lines in /etc/services and /etc/inetd.conf files. The new entry in /etc/services should look something like the following: dxport 9632/tcp # dynamicXport tcp/ip port 9632 in /etc/services file The new entry in /etc/inetd.conf should look like: # the entry below in /etc/inetd.conf file is for dynamicXport dxport stream tcp nowait dxport /home/dxport/run run -XB /home/dxport/dxlistener.dl4 Some Linux and Unix systems use "xinetd" instead of "inetd". Such systems will probably have a file named /etc/xinetd.conf and a directory named /etc/xinetd.d. For systems using xinetd, the /etc/services entry will be the same as above, but there is no inetd.conf file. Instead of modifying inetd.conf, add a new file in the /etc/xinetd.d directory with contents similar to: # default: on # description: dynamicXport application server connections service dxport { flags= REUSE socket_type= stream wait= no user= dxport server= /home/dxport/run server_args= -XB /home/dxport/dxlistener.dl4 disable= no } 7. Login as 'dxport'. 8. Copy the distribution file to any temporary directory on your system, e.g. "/tmp". 9. If the distribution file has a ".Z" extension, uncompress the file using the command "uncompress filename.Z". If the file has an extension of ".z", then rename the file with an uppercase "Z" before uncompressing the file. 10. Create a temporary installation directory, e.g. /tmp/dxport. 11. cd to the temporary installation directory. 12. Unpack the distribution file using the command "cpio -imcdu <../filename". If an error message occurs, try using the command "cpio -imdu <../filename" or "cpio -imduHodc <../filename". 13. Type "./dxinstall". 15. Enter the Web server's IP address. 16. Reboot the Unix Application server. 17. Delete the distribution file or move it to a backup directory. Unix Web Server Configuration ============================= 1. Login as the user of the Web site. 2. Copy the distribution file to any temporary directory on your system, e.g. "/tmp". 3. If the distribution file has a ".Z" extension, uncompress the file using the command "uncompress filename.Z". If the file has an extension of ".z", then rename the file with an uppercase "Z" before uncompressing the file. 4. Create a temporary installation directory, e.g. /tmp/dxport. 5. cd to the temporary installation directory. 6. Unpack the distribution file using the command "cpio -imcdu <../filename". If an error message occurs, try using the command "cpio -imdu <../filename" or "cpio -imduHodc <../filename". 7. cd to the WebServer subdirectory using the command "cd WebServer". 8. Type "find * -print | cpio -pmdu DOCUMENT_ROOT_DIRECTORY". The DOCUMENT_ROOT_DIRECTORY is typically named "htdocs" in the web site home directory. 9. Set permission of the DOCUMENT_ROOT_DIRECTORY file cgi-bin/dxserver.cgi to 755. 10. Edit the cgi-bin/dxserver.txt file using your favorite editor. Set the DXIP value to the IP address of the Application server. Set the DXPORT value to the Application server's tcp/ip port number as set in /etc/services file. You should not have to change anything else in the cgi-bin/dxserver.txt file. Application Server Installation on Microsoft Windows 2000 Server ================================================================ 1. Login as Administrator. 2. Run the dynamicXport installation program 1B_dxport_2.1.7.exe and follow the displayed instructions. This will extract dynamicXport web and application services modules into the C:\temp\dx folder (or a folder of your choice). Please note that the dynamicXport application services require Passport and hence Passport software with an SSN must be installed in conjunction with dynamicXport application services. 3. Make certain that dynamicXport is enabled in your SSN. The installation process will not work without a dynamicXport SSN. 4. Open a DOS command prompt and type the following commands: cd \temp\dx\ApplicationServer instlapp C:\dxapp If dynamicXport is being installed in a non-default directory, change the value of "C:\dxapp" to the actual directory. 5. The installation process starts Notepad so that you can edit the WebServer1IP=LOCALHOST entry in the dxsystem.txt file. Change the LOCALHOST value to the IP address of the web server. If dynamicXport is not being installed in "C:\dxapp", change all instances of "C:\dxapp" to the actual directory. If dL4 has been installed somewhere other than "C:\Program Files\dl4", change the value of "dL4Processor" to use the correct path. When finished, save the changes and exit Notepad. 6. If the standard TCP port number (9632) and standard installation directory ("C:\dxapp") are being used, type the following command in the DOS command window: instsrvr To use a TCP port number other than 9632 or if dynamicXport is being installed somewhere other than "C:\dxapp", use the command instsrvr 7. Type "instdemo C:\dxapp" from C:\dxapp directory to install the optional dynamicXport demo options. If dynamicXport is being installed in a non-default directory, change the value of "C:\dxapp" to the actual directory. Web Server Configuration on Microsoft Windows 2000 Server ========================================================= 1. Login as Administrator. 2. Run the dynamicXport installation program 1B_dxport_2.1.7.exe and follow the displayed instructions. This will extract dynamicXport web and application services modules into the C:\temp\dx folder (or a folder of your choice). You can skip this step if you have already extracted dynamicXport. 3. Create a directory, e.g. dx, in your DOCUMENT_ROOT_DIRECTORY. For example, this directory may be called D:\InetPub\wwwcust\domainname. Do NOT create an IIS Virtual Directory. 4. Copy all files from the temporary Installation WebServer directory to the directory created in the above step. 5. Edit the cgi-bin\dxserver.txt file using your favorite editor such as Notepad or Word. Set the DXIP value to the IP address of the Application server. Set the DXPORT value to the Application server's tcp/ip port number as set in the instsrvr.bat file for Windows, or in the /etc/services file for UNIX. You may need to change the S_ROOT value in the cgi-bin\dxserver.txt file to /dx/ or ../../dx/. 6. Open Microsoft Management Console from: Start ==> Programs ==> Administrative Tools ==> Internet Services Manager 7. Select the domain site. 8. Select "Properties" with a right mouse click. 9. Select the "Home Directory" tab. 10. Press the "Configuration" button on "Application Settings". 11. Select the "App Mappings" tab. 12. Press the "Add" button. 13. Type the following as a single line in the box labeled "Executable" with a space between each of the values: "C:\InetPub\wwwcust\domain_name\dx\cgi-bin\dxserver.exe" "C:\InetPub\wwwcust\domain_name\dx\cgi-bin\dxserver.txt" 14. Type ".cgi" in the box labeled "Extension". 15. Select the "OK" button. 16. Select the "Apply" button. 17. Select the "OK" button. 18. Select the "OK" button. 19. Make certain that the dx\cgi-bin Directory has "Scripts and Executables" permissions. New in This Release =================== Dev 3, 2003 (Release 2.1.7) o Bug fixed: if a session user defined field ("U_name") was a list value, the value of the field and other fields could be corrupted on a Windows application server. o Bug fixed: low security options could not be used with a Windows application server unless the user was logged in. o Bug fixed: if the audit file type was set to text ("AuditFileType=T" in the dxsystem.txt file), dynamicXport would not work on a Windows application server. Nov 10, 2003 (Release 2.1.6) o Bug fixed: if an application output to standard output after calling DXCLOSE, a "NO DATA FROM APPLICATION PROGRAM" error occurred. Oct 22, 2003 (Release 2.1.5) o Changes in the client (browser) IP address are now ignored for low security options unless an SSL (https:) connection is used. This change improves compatibility with some ISPs, such as AOL, that provide a different client IP address for each browser transaction. o Optional TCP port number and application directory parameters have been added to instsrvr.bat. The command line syntax for instsrvr.bat is now: instsrvr [ [ ] "filename_macro[!]" AS "destination_file_type" option := [CASE = U | L | A] [, ACCEPT_EXT = ALL | space separated list of extensions, e.g. .gif, .txt] [, APPEND = Y | N][, EXTENSION = add this extension if the source file lacks this extension] CASE = U convert destination filename to uppercase CASE = L convert destination filename to lowercase CASE = A accept destination filename as is ACCEPT_EXT = ALL allow files with any extension to be uploaded ACCEPT_EXT = .gif .exe .txt a list of space separated file extensions that may be uploaded. Files without these extensions may not be uploaded. Please note that file uploading capability is disabled if ACCEPT_EXT is undefined. APPEND = Y append to destination file APPEND = N do not append to destination file EXTENSION = xxx add the extension, xxx to the destination filename if the destination filename lacks such an extension destination file protection, e.g. <666> filename_macro := must begin with an absolute path and may contain one or more of the following %NAME% use source filename %MMDDYY% current date %MMDDYYYY% current date %DDMMYY% current date %DDMMYYYY% current date %YYDDMM% current date %YYYYDDMM% current date %YYMMDD% current date %YYYYMMDD% current date %DDDYY% current date %DDDYYYY% current date %TIME24% current time (24 hour format) %TIME12% current time (12 hour format) %TIMEPM% current time (am or pm) %FIELDNAME% dynamicXport field name %% percent sign (%) %# ... #% use a sequence number using # as a mask value %& ... &% use a sequence number using & as a mask value destination_file_type := RAW | TEXT | DOS TEXT | ANSI TEXT | UNIBASIC TEXT | UNIX TEXT | MACINTOSH TEXT The S_UPLOADFILE global setting may be overwritten by setting the S_FILEUPLOAD_form_field_name field. The S_FILEUPLOAD_form_field_name contains the name of the destination filename. o dynamicXport users may now download files directly from the application server to their client system. Both binary and text files may be downloaded. Only a single file at a time may be downloaded. o A file download HTML page must contain S_DOWNLOAD=1 in its parameter list. The S_CONTENTTYPE and S_CONTENTDISPOSITION settings in the dxsystem.txt file controls filedownload. dynamicXport appends a newline to S_CONTENTTYPE and S_CONTENTDISPOSITION. The default values are: Content-Type: application/octet-stream Content-Disposition: attachment; filename=filename_to_download o An application program must provide the name of the file to download, including path, in the S_DOWNLOAD name/value pair variable. If an application program includes S_DOWNLOAD, then S_CONTENTDISPOSITION is sent. Othewise, S_CONTENTTYPE is sent. o A new dl4o option allows one HTML page to include another HTML page. If the included filename is not in the current directory, dynamicXport will traverse its parent directory, up to the document root directory, to locate the included filename. The dl4o option appears in an HTML page. Here are two examples. o For ease of installation, a copy of Passport for Windows is also included in the Windows platform product file. Dec 16, 2002 (Release 1.5.2) o A logged on user can now run a low security option, even when the option is not in the user's option list. o dynamicXport now reports "Output page not specified" if an application does not provide the name of an output page and the option does not have a default output page. This message text may be customized in the dxmsg.txt file. o Bug fix: version 1.5.1 did not allow adding a new user with a specific user id. o Bug fix: multiple copies of dxpurge were invoked if the dxpurge lock file lacked proper permissions. Nov 25, 2002 (Release 1.5.1) o dynamicXport will generate a new user ID starting with 00000001 and incrementing it by one if a user ID is not specified during the add a new user option. o dynamicXport now uses the recipient's name as the sender's name if email is sent on error. o It is now possible to search for a user using the user's email and the user's userdef1 value. o The optiondir/msg.html page is used to return the password change message. o A new error message, "I/O Error" was added to the dxmsg.txt file. o A new error message, "No Data from Application Program" was added to the dxmsg.txt file. o A new option, SMTPServer in the dxsystem.txt has been added for SMTP email server name. o "Record has changed since last access" is now displayed instead of "Record is locked" to reflect the true nature of the error. o An "Application died unexpectedly" message is now stored in the dxaudit file. o Bug fix: The validation page now works with Netscape Navigator versions 6 and 7. o Bug fix: "Device not accessible" was reported on Linux if the email error option was enabled and login failed. Jul 18, 2002 (Release 1.5) o dynamicXport version 1.5, which requires dL4 version 5.1.1, now supports the dynamicXport Application server on a Windows NT/2000 server. o See the section, "NT Application Server Installation " in this document. The application server runs on TCP/IP port 9632 in C:\dxapp directory. The installation process requires that dL4 version 5.1.1 or greater is in C:\Program Files\dl4 directory. Jun 28, 2002 (Release 1.4.1) o A new option in the dxsystem.txt file allows configuration of the minimum and maximum lengths of dynamicXport user passwords. These options are PwdMinLength and PwdMaxLength. The default values for minimum and maximum are 5 and 20, respectively. It can also operate with minimum password length set to zero, provided that the appropriate HTML pages accept a zero length password. dynamicXport accepts only the first 32 characters in a password and discards any additional characters. o The view audit page now shows organization ID. It is now possible to display the username and organization name by placing mouse cursors over User ID and Organization ID values, respectively. o dynamicXport can be used with Verisign Payflow Pro to accept credit card payments. o A new test program, dxbridgetest.dl4, may be used to test a dynamicXport Application server on IP address 127.0.0.1 and TCP/IP port number 9632. Type, "run dxbridgetest.dl4", from the Application server's home directory, and it will display the dynamicXport revision number if the Application server is configured correctly. o Bug Fix: It is possible to use a dynamicXport low security option requiring a secure SSL. o Bug Fix: It was possible to grant user options from a higher level organization. May 2, 2002 (Release 1.4) o A new configuration option in the dxsystem.txt file allows dynamicXport errors to be e-mailed. Set the "EmailAddress" to the person who should be notified in the event of a dynamicXport error. The "AuditFileType" must also be set to either a "T" or an "F" to enable this new emailing feature. The content of the email message is identical to the log file. o A separate process is automatically started for house-keeping. A single process is invoked the first time the application server is accessed. This process, dxpurge.dl4, runs continuously waking up every 15 minutes to check the dxsystem.txt file to determine if it should purge dead sessions and the audit records. o A new configuration option in the dxsystem.txt file controls the frequency of purging dead sessions and audit records. Set the "CRONFREQUENCY" to the desired value in hours:minutes. The default value (every 15 minutes) is used if the "CRONFREQUENCY" setting is undefined or if it contains an invalid entry. o If the web server cannot open an html output file, then a new configuration option in the dxserver.txt file determines if the name of the missing file should be displayed. Set the "SHOWOUTPUTFILE" to a "Y" if the name of a missing html file should be displayed. Do not set it to a "Y" if the name of a missing html file should not be displayed. o A low security session is not authenticated. o A low security session remains active beyond the "TimeOut" value, meaning it is not authenticated. A low security session is removed if it exceeds the "Elapsed" or "Expired" settings in the dxsystem.txt file and an activation error is reported. o The CyberCash interface program is no longer part of dynamicXport as Verisign, the owners of CyberCash, no longer issues merchant ids to new customers. Please call Dynamic Concepts for alternatives to CyberCash or if you are interested in on-line credit card payments. o Bug fix: It is now possible to create a session if a user from the same IP address attempts to login in less than a second. o Bug fix: An unexpected or subscript error occurred if an application program returned a very large buffer. Jan 4, 2002 (Release 1.3) o It is now possible to login using any of the fields in the user file. This alternate login method, i.e. other than User ID and password usage, requires defining a LOGINFIELDS in the dxsystem.txt file. The syntax for LOGINFIELDS is: LOGINFIELDS=a field in the user file AND/OR another field Please note that the & symbol is the AND operator, and the | symbol is the OR operator. The AND operator has a higher precedence than the OR operator. The expression is evaluated from left to right, but the precedence order may be modified by using parentheses. You may add as many fields as you require, provided that the fieldname is a valid fieldname in the user file (dxuser). However, the total size of LOGINFIELDS is limited to 254 characters. Unlike the AND and OR operators, the first defined field in LOGINFIELDS is used to index into the user file. The alternate login method also requires customizing the login and the verification html page. Example: LOGINFIELDS=username&(password | useremail) o CyberCash may be accessed by calling (running) the dxccbridge.dl4 program. You must, however, first obtain your CyberCash ID from CyberCash. Please visit register.cybercash.com to sign up for CyberCash. o You can get a total session count by checking "Show Session Count" checkbox option on "View Sessions" page. o You may now evict another session from the "View Sessions" page. o It is now possible to run an SSL option from dxbridge.dl4. o It is now possible to view ascending and descending detail audit logs. o It is now possible to get summary by option, summary by user, or summary by user and option from the "View Audit" page. o Increased size of a message in the file dxmsg.txt, to 1900 characters. o The demo options may be added anytime by running the dxcreatedemo.dl4 program from the 'dxport' account. o The demo example files may be created by running docreate.dl4 o The "Prelink" field must be set to blank for the MASTER organization. o Bug fixed: Pressing the "login" icon repeatedly on the login page resulted in a login session error. o Bug fixed: Attempting to add a new option with a runtime only license reported an "Option not in file" error message. o Bug fixed: Users with non-MASTER organization IDs were unable to login. o Bug fixed: It was possible to remove the "admin" user using the dxbridge.dl4 program. o Bug fixed: S_ViewOptionType and session id fields were not returned while attempting to run non-securely an option that requires an SSL connection. o Bug fixed: It was possible to have non-alphanumeric characters in a password using the bridge program. o Bug fixed: S_VIEWOPTIONTYPE was not returned on Validate page. Jul 16, 2001 (Release 1.2.2) o It is now possible to output a user defined value for "Content-Type". DynamicXport automatically adds the two required 'CR's following the content-type value. o The dxbridge.dl4 program is now accessible to all users with a permission setting of 644. o The session ID is provided as an encrypted session id to an application program. o Bug fixed: A non-administrative user was able to add a new user using the dxbridge.dl4 program. o Bug fixed: A non-administrative user was able to change an existing user using the dxbridge.dl4 program. o Bug fixed: The Parent ID must be set to Null for a menu option type. o Bug fixed: Only audit records with proper permissions are displayed. Earlier releases displayed all audit records. o Bug fixed: Input and output of an extended audit log record is from the application's perspective, meaning input to and output from an application program. o Bug fixed: An existing U_ field is now updated with new values between sessions. o Bug fixed: Updated U_ fields' values are now logged in the extended log file. o Bug fixed: A user is now permitted to have more than 10 menu options. o Bug fixed: Those options that require SSL connections now run as https connections. o Bug fixed: Users were unable to login using browser settings for a proxy server such as a Microsoft Proxy server. May 16, 2001 (Release 1.2.1) o The dxinstall script will _NOT_ install the product unless an SSN authorized for dynamicXport has already been installed. o The dxinstall script will _NOT_ install from the super-user (root) account as the dynamicXport files must be owned by the Application server account (default dxport). o Provides improved Wireless Access Protocol (WAP) support. o The CheckBrowser option in the dxserver.txt file _must_ be set to WML to enable WAP support. o The CopyUser field is returned with Change user option with the dxbridge.dl4 program. o The dxbridge.dl4 program may add or modify a user's CopyUser field. o dynamicXport will run with a demo SSN and dL4 version 4.4 or greater. o Supports both Microsoft Internet Explorer browser versions 4 and 5. o Bug fixed: It was not possible to run an option without first logging in. o Bug fixed: The dxbridge.dl4 program received an "illegal subscript" error. o Bug fixed: The "View Audit" option did not display more than one page. o Bug fixed: The "Begin HTML Test Page" option was unable to find the HTML page filename. May 7, 2001 (Release 1.2) o OutsideIP, SecondaryServer, and AllowLocalHost options have been removed from the dxsystem.txt file. o The dxtestapp.dl4 program is no longer distributed. The dxbridge.dl4 program may be used to test dynamicXport application programs. o The product now uses a new option, REVISION, as 1.2 for this release in the dxsystem.txt file. o A new option, WebServerXIP, in the dxsystem.txt file controls the valid IP address of the webserver. The X in WebServerXIP is a sequential number for each webserver, starting with one (1) as the first webserver. o A new option, BridgeXIP, in the dxsystem.txt file controls the valid IP address of the local webserver. The X in BridgeXIP is a sequential number for each server, starting with one (1) as the first server. o A new option, AuditFileType, in the dxsystem.txt file enables connection logging. Connection logging may be enabled by setting the AuditFileType value to "T" for non-extended logging, and "F" for extended logging. Connection logging may be disabled by setting the AuditFileType value to nothing. o A new option, PurgeAuditAge, in the dxsystem.txt file specifies the number of days audit records are archived. All audit records older than the PurgeAuditAge are purged. o A new option, BufSize, in the dxsystem.txt file specifies the dynamicXport buffer size in characters for efficient memory management. Although it is restricted to 1024 as its minimum value, the maximum value is limited to free memory availability. The default value is 128K characters. o A new option, GlobalExtendedLog, may be used to log additional information. The extended log filename is audit.ext and must be purged by the developer as needed. These extended logging capabilities may be used as a debugging aid during program development. o A new program, dxpurge.dl4, may be run on the application server to remove old audit and session records. o The dxbuildfiles script builds dynamicXport support files. This script may be run anytime after installation to re-build support files. It keeps a backup copy of the original files directory as oldfiles directory. o dynamicXport auto-configures the value for S_Root if it is undefined in the dxserver.txt file. The REVISION option (open domain/dx/cgi-bin/dxserver?OPTION=REVISION from a browser) displays the recommended value for S_Root, if it is undefined in the dxserver.txt file. The S_Root should be set in the dxserver.txt file to improve performance. o A new option, ConnectRetryCount in the dxserver.txt file controls the number of connection attempts with the Application server before an error is reported. o A new option, DXBUFSIZE, in the dxserver.txt file specifies dynamicXport buffer size in characters for efficient memory management. Although its value is restricted to 1024 as its minimum value, the maximum value is limited to free memory availability. The default value for is 128K characters. o dynamicXport now supports WAP (Wireless Access Protocol) enabled browsers. o A new option, CheckBrowser in the dxserver.txt file enables WML (Wireless Markup Language) if WML is supported by the user's web browser. The syntax for CheckBrowser in the dxserver.txt file is CheckBrowser=WML. o The DXContent option in the dxserver.txt file controls the type of webserver URL encoding. This release of dynamicXport supports only HTML. o A new option, S_ContentOut in the dxserver.txt file controls the browser output header. The value is changed to WML if the browser supports WML and the CheckBrowser is set for WML. It is always set to the same value as the DXContent if the S_ContentOut is undefined in the dxserver.txt file. o A new option, S_ContentOut in the dxserver.txt file controls the browser output header. The value is set to WML if the browser supports WML and the CheckBrowser specifies WML. It is always set to the same value as DXContent if the S_ContentOut is undefined in the dxserver.txt file. o A new option, E_EnvironmentVariableName in the dxserver.txt file specifies which environment variables as seen by the web server are provided to the application programs. The syntax does not require a value for these fields. For example, setting E_HTTP_ACCESS as E_HTTP_ACCESS= in the dxserver.txt file allows an application program access to the HTTP_ACCESS environment variable as seen by the web server. o For Linux Apache and Microsoft IIS web servers, set the S_URL option in the dxserver.txt file to your domain name (e.g. http://www.dynamic.com). o For Linux Apache and Microsoft IIS web servers, set the S_SECUREURL option in the dxserver.txt file to your domain name (e.g. https://www.dynamic.com). o Times displayed on all browser pages reflect local time on the application server. o The example file contains a single customer record with DCI as its Customer ID. o The example file contains a single customer record with DCI as its Customer ID File list ========= dxinstall Installation script dxbuildfiles Builds dynamicXport support files license.txt dynamicXport product license file readme.txt dynamicXport product readme file ApplicationServer dynamicXport files for Application Server dxadmin.dl4 dynamicXport administrative program dxbridge.dl4 dynamicXport bridge program dxbridgetest.dl4 dynamicXport bridge test program dxchecklicense.dl4 part of dynamicXport installation script dxcreatecontacts.dl4 Creates dynamicXport dxcontacts support file dxcreatedemo.dl4 Creates dynamicXport example demo dxcreateoption.dl4 Creates dynamicXport dxoption support file dxcreateorg.dl4 Creates dynamicXport dxorg support file dxcreatesession.dl4 Creates dynamicXport dxsession support file dxcreateuser.dl4 Creates dynamicXport dxuser support file dxcreateuseroptions.dl4 Creates dynamicXport dxuseroptions support file dxcreateview.dl4 Creates dynamicXport dxview support file dxerror.lib dynamicXport library module dxfullisamio.lib dynamicXport library module dxgeneral.lib dynamicXport library module dxgetplatformno.dl4 gets dynamicXport platform ID dxio.lib dynamicXport library module dxlistener.dl4 dynamicXport Application server runtime module dxmsg.txt dynamicXport message file dxpurge.dl4 Purges old audit and session records dxrebuild.dl4 Rebuilds dynamicXport system files dxsocket.lib dynamicXport library module dxsystem.txt dynamicXport Application server file dxverisignpayflow.dl4 Supports Verisign Payflow Pro. examples/ dynamicXport example programs instlapp.bat batch file to install NT application server instdemo.bat batch file to install demo on NT instsrvr.bat batch file to install NT application server WebServer dynamicXport files for Web Server admin/ Contains HTML files admin/images/ Contains graphics (gif) files cgi-bin Contains CGI programs and libraries cgi-bin/dxserver.txt dynamicXport web services configuration file cgi-bin/dxserver.cgi cgi script invoked by a web page cgi-bin/dxserver dynamicXport Web server runtime module (UNIX) cgi-bin/dxserver.exe dynamicXport Web server runtime module (Windows) dl4fldrv.dll dll for Windows dl4rt.dll dll for Windows dl4sockt.dll dll for Windows dl4stdrv.dll dll for Windows stubwa10.dll dll for Windows dxstd/ Contains HTML files dxstd/icons/ Contains graphics (gif) files dxstd/images/ Contains graphics (gif) files examples/ Contains HTML files includes/ Contains JavaScript and HTML files login/ Contains subdirectories login/dxstd/ Contains gif files and HTML file styles/ Contains cascading style sheets (css) files Copyright ========= CyberCash CashRegister is a trademark or registered trademark of CyberCash, Inc. in the United States and other countries.