Daylight v4.9
Release Date: 1 February 2008

Name

merlindbping - verify the existence of database

Unix Synopsis

merlindbping [options] database

Description

This programs attempts to open a database, and reports on the success or failure of the operation.

merlindbping opens a Merlin pool. The user's own id (not "thorinfo") is used to connect to the server, then the pool is opened with the specified permission (see option -PASSWORD_LEVEL, below). If the login fails or the pool can't be opened, an error message is printed. Then the pool is closed and the connection to the server is closed.

This function is primarily used to verify the existence of a database, to verify that your system is configured correctly, and to verify that you have the correct passwords for the object (e.g. for use in a shell script).

The manual page for "thorfilters" describes features common to these and all "thorfilter" programs; refer to it for more information about this program and the syntax of "database".

Options

-PASSWORD_LEVEL R|W|E
If the object being "pinged" is a database, Indicates the permission that is to be used in the attempt to open the databases. Must be one of R, W, or E, indicating read, read/write, and executive, respectively. Default is "R".
-PROCESS_ID TRUE|FALSE
Returns the process id of the server being pinged. This is useful for administration purposes. Default is FALSE.
STANDARD THORFILTER OPTIONS:
----------------------------

The following options are common to most or all "thorfilter" programs. They are described in more detail in thorfilters(1).

-SECURE_PASSWORDS TRUE|FALSE

TRUE means don't allow passwords on the command line (require interactive entry). Default: TRUE.
-MERLIN_IPC_SERVICE service
Names the default TCP/IP service or "port" of the Merlin server. Default: merlin.

Return Value

This program return status is zero if the operation succeeded, and one if it failed.

Examples

merlindbping pomona93c@crawdad:merlin2:joe
Tries the Merlin database "pomona93c" on the host "crawdad", using the service "merlin2", and logging in as user "joe". The server and database passwords are entered interactively.

Files

$DY_ROOT/bin/merlindbping

Daylight License

program: merlin

Related Topics

dayevict(1) daymessage(1) merlinping(1) merlinload(1) merlinls(1) merlinwho(1) thorchange(1) thorcrunch(1) thordbinfo(1) thordelete(1) thordestroy(1) thordiff(1) thordump(1) thorlist(1) thorload(1) thorlookup(1) thorls(1) thormake(1) thorping(1) thordbping(1) thorwho(1) sthorman(1) thorserver(1) merlinserver(1) licensing(5)

Daylight Theory Manual, Daylight System Administration Manual

Bugs

None known.