Directories/Maintenance

The directory structure for the installed product is as follows:

.\ (VersaLex home)

VersaLex executable file (‘ VersaLex .exe’), command line file (‘ VersaLex c.exe’), and other software executable files.  If the java runtime environment (JRE) should terminate unexpectedly, it may dump trace or heap files.

Archive/copy files accumulate in this directory.

.license\

Contains product license files.

Automatically created and updated when register product and acquire permanent license.

AS2\

AS2 protocol directories

data\

Message ID and filename history

Retention period can be changed in the AS2 service AS2 tab.

mdn\

received\

Message disposition notifications (receipts) received.

You can control the storage location. See MDN Storage Folder in Local Listener AS2 Service reference. 

Received MDNs are always retained.

archived\

Archived MDN zip files.

You can set Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

sent\

Message disposition notifications (receipts) sent.

You can control the storage location. See MDN Storage Folder in Local Listener AS2 Service reference. 

For Cleo VLTrader and Cleo Harmony, sent receipts are always saved.

For Cleo LexiCom, you can configure your system to save sent receipts. See Save Sent Receipt in Specifying Local Listener advanced properties.

archived\

Archived MDN zip files.

You can set Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

received\

Copies of raw incoming messages.

You control whether these messages are saved. See Store Raw Received Message in Specifying Local Listener advanced properties

Archive/copy files accumulate in this directory.

sent\

Copies of raw outgoing messages.

You control whether these messages are saved per trading partner. See Store Raw Sent Message in AS2 Host: Advanced Tab.

Archive/copy files accumulate in this directory.

restart\

Partial incoming message.

You can change this storage location. See Restarts Temp Folder in Local Listener AS2 Service reference.

unsent\

Copies of outgoing messages waiting for asynchronous MDN.

AS3\

AS3 protocol directories.

data\

Message ID history.

You can control the retention period for this directory. See Retain Message ID History in Local Listener AS3 Service.

mdn\

received\

Message disposition notifications (receipts) received.

Received MDNs are always retained, but you can control the storage location. See MDN Storage Folder in Local Listener AS3 Service reference.

archived\

Archived MDN zip files.

You can set Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

sent\

Message disposition notifications (receipts) sent.

You can control the storage location. See MDN Storage Folder in Local Listener AS3 Service reference.

For Cleo VLTrader and Cleo Harmony, sent receipts are always saved.

For Cleo LexiCom, you can configure your system to save sent receipts. See Save Sent Receipt in Specifying Local Listener advanced properties

archived\

Archived MDN zip files.

You can set Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

received\

Copies of raw incoming messages.

You control whether these messages are saved. See Store Raw Received Message in Specifying Local Listener advanced properties

Archive/copy files accumulate in this directory.

sent\

Copies of raw outgoing messages.

You control whether these messages are saved per trading partner. See Store Raw Sent Message in AS3 Host: Advanced Tab.

Archive/copy files accumulate in this directory.

unsent\

Copies of outgoing messages waiting for asynchronous MDN.

AS4\

AS4 protocol directories

data\

Message ID history.

Retention period can be changed through the PMode.ReceptionAwareness.DuplicateDetection.MaxWindow setting.

ping\

Payloads received as part of a Test Service PING operation.

receipt\

received\

Receipts received as part of a Test Service PING operation.

sent\

Receipts sent as part of a Test Service PING operation.

receipt\

received\

Received receipts. Received receipts are always
retained.

You can control the storage location. See Local Listener AS4 Service.

archive\

Archived received receipts.

These include the actual receipt files as well as the INF files that contain auxiliary information pertinent to a push of a User Message.

You can set Archive properties. See Specifying Local Listener advanced properties.

sent\

You can control the storage location. Sent receipts are always retained. See Local Listener AS4 Service.

archive\

Archived sent receipts.

You can set Archive properties. See Specifying Local Listener advanced properties.

schemas\

Schemas used by AS4 for XML schema validation.

sent+received\

Copies of raw incoming and outgoing requests and responses. Stores information for both client-side and server-side operations.

You can configure whether raw messages are stored. See Store Raw Sent Message in AS4 Host and Store Raw Received Message in Specifying Local Listener advanced properties.

Files in this folder are not archived, so generally this setting to should be 'off' to conserve disk space.

unsent\

Transient copies of outgoing User Messages waiting for a response, either a synchronous response or an asynchronous response, depending upon the settings. Associated INF files are also stored while the transfer is in progress.

Transient copies of User Message will be deleted once the transfer is complete (successfully or otherwise). Associated INF files will be move to the receipt\received folder once the transfer is complete.

autoroute\

Cleo VLTrader and Cleo Harmony systems only.

Default directory for outgoing payload files to be automatically processed based on routing rules

You can set up the Autoroute Directory. See Using the Router.

autorun\

Default directory for “command” files to be automatically processed

You can change the Autorun Directory. See Other system options.

backup\

Versioned patch incremental backups. See Updating your software.

Archive/copy files accumulate in this directory.

BI\

Cleo VLTrader and Cleo Harmony systems only.

Business intelligence resource folder for dashboards and system monitor.

certs\

pending\

Trusted and pending (untrusted) X509 certificate authority (CA) files for secure transfers.

You can add, modify, and delete trusted and pending certificate files directly in this directory, but the preferred method is to use the Certificate Manager. See About Certificate management.

conf\

Product configuration files.

Managed via various Configure… and Tools… items.

unsynced

Synchronized configuration changes not yet applied.

data\

X509 user certificate and private key store files for secure transfers.  Can include OpenPGP and SSH keys.

Managed using the Certificate Manager. See About Certificate Management.

EBICS\

EBICS protocol directories

ack\

sent\

Acknowledgments (receipts) sent

“Save Sent Receipt” can be set in the Local Listener Advanced tab.

archive

Archived receipt zip files

“Archive ..." properties can be set in the Local Listener Advanced tab.

Archive/copy files accumulate in this directory.

schemas_2_4\

EBICS Version 2.4 schema files

schemas_2_5\

EBICS Version 2.5 schema files

sent+received\

Copies of “raw” incoming requests and corresponding outgoing responses

“Store Raw Sent And Received” can be set in the EBICS host Advanced tab

Archive/copy files accumulate in this directory.

unsent\

Transient copies of outgoing XML

ebXML

ebMS protocol directories

ack\

received\

Acknowledgments (receipts) received

You can control the storage location for received ACKs. See Local Listener ebXML Message Service.

Received ACKs are always retained.

archive\

Archived ACK zip files

sent\

Acknowledgments (receipts) sent

You can control the storage location for sent ACKs. See Local Listener ebXML Message Service.

For Cleo VLTrader and Cleo Harmony, sent receipts are always saved.

For Cleo LexiCom, you can configure your system to save sent receipts. See Save Sent Receipt in Specifying Local Listener advanced properties

archive\

Archived ACK zip files

data\

Message ID history

You can control how long this data is retained. See Local Listener ebXML Message Service. 

schemas\

ebMS schema files

sent+received\

Copies of raw incoming and outgoing messages

You can control whether raw messages received are stored. See Store Raw Received Message in Specifying Local Listener advanced properties.

You can configure whether raw sent messages are stored per trading partner. See Store Raw Sent in ebXML host.

Archive/copy files accumulate in this directory.

unsent\

Copies of outgoing messages waiting for asynchronous acknowledgment.

home\

The default location for the file/directory chooser when there is no other appropriate default folder.

hosts\

Active host XML files

Created when you activate a pre-configured host.

pre-configured\

Pre-configured host XML files

archive\

Pre-released, beta or “backup” hosts. Directory can be empty.

custom\

Custom, preconfigured hosts

See Creating a custom preconfigured host.

support\

Active support  host XML files (for communicating with Cleo web site)

pre-configured\

Pre-configured support host XML files

unsynced\

Synchronized host changes not yet applied

HTTP\

HTTP client protocol directories

sent\

Copies of raw outgoing messages

You can configure whether raw sent messages are stored per trading partner. See Store Raw Sent Message in HTTP and HTTP/S hosts.

Archive/copy files accumulate in this directory.

inbox\

Default (parent) directory for incoming payload files.

You can specify the default system inbox. See Specifying default host directories.

jre\

Java runtime environment

lib\

Main product library files

api\

Embedded custom API libraries

You can specify custom classes. See Custom ILexiComIncoming Class, Custom LexiComLogListener Class, and Custom LexiComOutgoingThread Class in Other system options.

ext\

Add-on third-party libraries, for example, database driver

help\

Product help library

ws\

Web service client runtime libraries

local\root\

Default FTP, HTTP, and SSH FTP server root directory.

Note: Cleo VLTrader and Cleo Harmony systems only.

logs\

System XML log file  (VersaLex.xml), system debug file (VersaLex.dbg), and other log and debug files

You can set system log and debug options. See Logs.

You can set web UI debug options. See Local Listener Web Browser Service.

Archive/copy files accumulate in this directory.

archive\

Default directory for archived system XML log files

You can control storage location. See Logs.

Archive/copy files accumulate in this directory.

olddbg\

Archived system debug files

Retention period of three days cannot be changed.

lostandfound\

Incoming payload for unknown trading relationships

You can specify what, if any, action should be taken when a message is received form an unknown trading partner. See Unknown Partner Message Action in Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

OFTP\

Odette FTP protocol directories

data\

Message ID history.

You can control how long this data is retained.

See Local Listener Odette FTP Service.

eerp\

received\

End-to-end responses (receipts) received

Received EERPs/NERPs are always retained.

You can control where received responses are stored.

See Local Listener Odette FTP Service.

archive\

Archived EERP zip files

You can specify Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

sent\

End-to-end responses (receipts) sent

You can control whether sent receipts are saved. See Save Sent Receipt in Specifying Local Listener advanced properties.

You can also control where sent receipts are stored. See Local Listener Odette FTP Service.

archive\

Archived EERP zip files

You can specify Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

received\

Copies of raw incoming messages

You can control whether raw messages received are stored. See Store Raw Received Message in Specifying Local Listener advanced properties.

sent\

Copies of “raw” outgoing messages

You can configure whether raw sent messages are stored per trading partner. See Store Raw Sent Message in OFTP Host.

restart\

Partial incoming message

You can change this storage location. See Restarts Temp Folder in Local Listener OFTP Service reference.

unsent\

Copies of outgoing messages waiting for EERP

outbox\

Default (parent) directory for outgoing payload files

You can specify the default system outbox. See Specifying default host directories.

test\

Files used for testing with the Cleo Test Server

receivedbox\

System actually defaults to no receivedbox.

You can specify the default system receivedbox. See Specifying default host directories.

archive\

Archived receivedbox copies zip files

You can set Sent/Received Box Archive properties. See Sent/Received Box Archive, Sent/Received Box Archive After Files, Sent/Received Box Archive Size (mbytes), and Sent/Received Box Archive Append To Zip in Other system options.

sentbox\

System actually defaults to no sentbox.

You can specify the default system sentbox. See Specifying default host directories.

archive\

Archived sentbox copies zip files

You can set Sent/Received Box Archive properties. See Sent/Received Box Archive, Sent/Received Box Archive After Files, Sent/Received Box Archive Size (mbytes), and Sent/Received Box Archive Append To Zip in Other system options.

rejectbox\

Default directory for rejected outgoing files

You can specify the default system rejectbox. See Specifying default host directories.

resource\

Installer resource files

RNIF\

RosettaNet Implementation Framework protocol directories

ack\

received\

Acknowledgments (receipts) received.

Received ACKs are always retained.

You can control where received responses are stored.

See Configuring Local Listener RosettaNet Service.

archive\

Archived ACK zip files

You can specify Archive properties. See Specifying Local Listener advanced properties.

sent\

Acknowledgments (receipts) sent

You can specify whether sent responses are stored. See Save Sent Receipt in Specifying Local Listener advanced properties

You can control where sent responses are stored.

See Local Listener RosettaNet Service.

archive\

Archived ACK zip files

You can specify Archive properties. See Specifying Local Listener advanced properties.

data\

PIP Instance/Message ID history

You can control how long this data is retained.

See Local Listener RosettaNet Service.

DTDs\

PIP content validation DTD files shipped with product or imported

pips\

Pre-defined PIPs shipped with product

schemas\

PIP content validation schema files shipped with product or imported

sent+received\

Copies of raw incoming and outgoing messages

You can control whether raw messages received are stored. See Store Raw Received Message in Specifying Local Listener advanced properties.

You can configure whether raw sent messages are stored per trading partner. See Store Raw Sent Message in RNIF Host

Archive/copy files accumulate in this directory.

unsent\

Copies of outgoing messages waiting for asynchronous acknowledgment.

SMTP\

SMTP protocol directories

data\

Message ID history

Retention period can be changed in the SMTP Service SMTP tab.

You can control how long this data is retained.

See Local Listener SMTP Service.

dsn\

received\

Delivery status notifications (receipts) received.

Received EERPs/NERPs are always retained.

You can control where received EERPs/NERPs are stored.  See Local Listener SMTP Service.

archive\

Archived DSN zip files

You can specify Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

sent\

Delivery status notifications (receipts) sent.

You can specify whether sent receipts are stored. See Save Sent Receipt in Specifying Local Listener advanced properties

You can control where sent receipts are stored. See Local Listener SMTP Service

archive\

Archived DSN zip files

You can specify Archive properties. See Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

received\

Copies of raw incoming messages

You can control whether raw messages received are stored. See Store Raw Received Message in Specifying Local Listener advanced properties.

Archive/copy files accumulate in this directory.

sent\

Copies of raw outgoing messages

You can configure whether raw sent messages are stored per trading partner. See Store Raw Sent Message in SMTP and SMTP/s hosts.

Archive/copy files accumulate in this directory.

unsent\

Copies of outgoing messages waiting for DSN

temp\

VersaLex non-persistent work area

thirdparty\

Information about included third-party software

translators\

Sub-directories containing files for use with an EDI translator

See Generating files for an integration.

webserver\

VLPortal\

Cleo VLTrader and Cleo Harmony systems only.

Web portal documents, images, HTML pages, and language-specific property files.

Files can be imported through web page and web portal build functions that are described under the Web Browser Service VLPortal tab.

doc\

img\

html\

internationalization\

WS\

Web service protocol directories

conf\

Apache AXIS and WS security files

received\

Copies of raw incoming messages

You can control whether raw received messages are stored. See Store Raw Received Message in Specifying Local Listener advanced properties.

sent\

Copies of raw outgoing messages

You can configure whether raw sent messages are stored per trading partner. See Store Raw Sent Message in WS Host.

“Store Raw Sent Message” can be set per trading partner in the WS host Advanced tab.

Files can accumulate in the directories marked with an (X) above. VersaLex will not automatically delete files in these directories.  Be sure to turn off any debugging options that may cause files to accumulate once a problem has been solved.  For example:

-     Heap files in the home directory

-     AS2 raw received files in the AS2/received directory

-     HTML*.dbg files in the logs/ directory

VersaLex will also not remove any non-empty inbound or outbound directories associated with hosts or mailboxes if the host or mailbox is renamed or deleted since these directories could also be used by other trading relationships or by other applications.  These directories may be manually removed, if desired, after verifying that they are no longer in-use.