Table of Contents

Module: gfclient Zope-2.2.1-src/lib/python/Products/ZGadflyDA/gadfly/gfclient.py

client access to gadfly server. (gfserve.py)

Imported as a module this module provides interfaces that remotely access a gadfly database server.

Remote connections: gfclient

connection = gfclient.gfclient( policy, # the name of the connection policy ["admin" for admin] port, # the port number the server is running on password,# the password of the policy [machine]) # (optional) the machine where server is running # (defaults to localhost)

methods for gfclient connections: gfclient.checkpoint() checkpoint the server (fails silently if connection is not "admin"). gfclient.restart() restart the server (fails silently if connection is not "admin"). gfclient.shutdown() shutdown the server (fails silently if connection is not "admin"). cursor = gfclient.cursor() returns a cursor on this connection

methods for cursor objects:

cursor.execute(statement, dynamic_parameters=None) execute the statement with optional dynamic parameters. Dynamic parameters can be a list of tuples for INSERT VALUES statements, otherwise they must be a tuple of values. cursor.execute_prepared(name, dynamic_parameters=None) execute a named statement configured for this connection policy, with optional dynamic parameters. Dynamic parameters permitted as for execute depending on the statement the name refers to. cursor.fetchall() return results of the last executed statement (None for non-queries, or list of tuples).

See gfstest.py for example usage.

SCRIPT INTERPRETATION:

Server maintenance utilities

COMMAND LINE: python gfclient.py action port admin_password [machine]

TEST EXAMPLE: python gfclient.py shutdown 2222 admin

action: one of shutdown: shut down the server with no checkpoint restart: restart the server (re-read the database and recover) checkpoint: force a database checkpoint now port: the port the server is running on admin_password: the administrative password for the server machine: [optional] the machine the server runs on.

Imported modules   
import gfsocket
Functions   
dosimple
main
  dosimple 
dosimple (
        action,
        port,
        pw,
        machine=None,
        )

  main 
main ()

Classes   
gfClientCursor
gfclient

Table of Contents

This document was automatically generated on Mon Sep 4 07:33:06 2000 by HappyDoc version r0_6