Skip to content

DBEnterprise Commands

You can run the Enterprise Server executable program (DBEnterprise.exe) as either a command prompt program or as a Windows dialog. This section lists the commands you can use when running DBEnterprise.exe from a command prompt.

Command-Line Options

The following table lists the command options available to you when you run Enterprise Server as a command prompt program.

Note

Some features are only available through the command-line interface.

Option Description
None Runs Enterprise Server in interactive mode as a Windows dialog box.
CACHE sourcename

[PASSWORD [ = ] "password"]

[ startafn [ [ - ] endafn | + ] ]
If caching is enabled for the base source, writes the updates from all DMSII audit files for this base source to local disk drives. If local sources are configured, the filtered updates from each audit file are also saved.

The PASSWORD option specifies the password to be used when accessing the remote source. The password must match the KEY option in the Databridge Server SOURCE.

After cache files exist, the next run of the cache command starts reading DMSII audit files from the number specified in the file LastAFN.txt located in the Cache subdirectory.

The cache command can specify an AFN range to indicate where caching should start and stop, which will override the value specified in the LastAFN.txt file. If only the startafn is specified, only that file will be cached.

Examples:

cache bankdb 460 % only 460
cache bankdb 460 - 488 % beginning of 460 through end of 488
cache bankdb 460 + % beginning of 460 to end of audit
CODE "filtername" updatelevel Writes the filtering pseudo-code to the log file. filtername is usually the same as the source name. updatelevel is the desired database update level. This command is intended for Databridge technical support's diagnostic purposes.
CONFIGURE "configfilename" Loads a configuration text file into Enterprise Server to define sources and filters. It is equivalent to using the Import button on the Databridge Enterprise window.
CONNECT socketnumber "ipaddress" Used by Databridge Director to get Enterprise Server to accept the connection from a Databridge Client or Databridge Server.
COPY "localname" { TO AS } (usercode)MCPName [ ON familyname ]

[ { FROM
DUMP sourcename afn Writes every update from a cache file to the log file.

sourcename is the name of a cached base or local (filtered) source, and afn is the cache audit file number.

This command is intended for diagnostic use upon request of Databridge Technical Support.
LOAD "configfilename" LOAD is a synonym for the CONFIGURE command.
MIRROR remotesourcename

[ PASSWORD [ = ] "password" ]
[ startafn [ [ - ] endafn | + ] ]
Mirrors audit files from a remote source. Optionally, a range or just a beginning audit file number can be specified.

The PASSWORD option specifies the password to be used when accessing the remote source. The password must match the KEY option in the Databridge Server SOURCE.

Mirroring must be configured within Enterprise Server before command line mirroring can occur. See Mirroring DMSII Audit Files.
PRINTAUDIT remotesourcename [ startafn [ - ] endafn ] [ RECORDS ] Displays mirrored audit information in human-readable form. Shows sectioned audit files one section at a time. The RECORDS option causes the report to list one line for each audit record showing the structure number, record type, and other information.

Example:

dbenterprise printaudit bankdb 357 – 359 records
VALIDATE sourcename DATABASE [=] ODBCsourcename

[ USER [=] username ] [ PASSWORD [=] "password" ]

[ TABLE [=] tablename ]
Compares a cloned database to the original flat files from a JADE database. Enterprise Server will write any differences to the log file.

sourcename is the Enterprise Server source name.

ODBCsourcename is the name of an ODBC source that provides access to the client database.

username and password are used to sign on to that ODBC source.

If a tablename is specified, only that table will be validated. The default is to validate the entire client database.
XFER

[ (usercode)MCPdirectory [ ON family ] ]

[ FROM ipnameoraddress ]

[ PORT portnbr ]

[ TO localdirectory ]

[ TEXT | BINARY [INDIRECT] ]
Transfers a file or directory of files from an MCP disk to the local computer. The XFER command performs a subset of the capabilities of the COPY command. The Databridge host computer must be configured to allow file transfers using XFER. For details, see Configuring Security on Host.

NOTE: This feature is available as an additional Enterprise Server component. Contact your sales representative for details.

MCPdirectory is a directory or filename in normal MCP format. It must include either the user code in parentheses or . For example: (PROD)DBBD/RUN ON PRINTPACK

ipnameoraddress is the host name or IP address of the MCP host system where Databridge Server is running. For example: FROM GALILEO or FROM "192.168.16.1"

portnbr is the TCP/IP port number that Databridge Server uses.

localdirectory* is the path where Enterprise Server should place the files transferred from the host system. For example: TO d:\data\MCPFiles

BINARY copies file(s) as-is. TEXT translates all characters from EBCDIC to ASCII and inserts CR-LF (except for STREAM files). For print files, TEXT translates from EBCDIC to ASCII, substituting a form feed character (0x0C) for page breaks, and inserting LF characters for line spacing.

INDIRECT forces Enterprise Server to read the source files using Indirect Disk rather than Direct Disk. This is required when Enterprise Server has visibility to MCP disks but for the wrong MCP Server.

A list of files copied by the XFER command is placed in the same directory as the corresponding log file.