NAME

CGI::Session::DB2 - DB2 driver for CGI::Session

SYNOPSIS

use CGI::Session;
$session = new CGI::Session("driver:DB2", undef, {DB=>'dbname', Schema=>'cgisess',Table=>'cgisess'});

For more examples, consult CGI::Session manual

DESCRIPTION

CGI::Session::DB2 is a CGI::Session driver to store session data in a DB2 table. To write your own drivers for CGI::Session refere CGI::Session manual.

Options accepted:

Database

Database name to use. Defaults to 'cgisess'.

DB2Driver

DB2::db object or package to latch on to, rather than using the internal version. Will simply add the internal table to the existing DB2::db object.

Table

Table name to use. Defaults to 'cgisess'.

Schema

Schema name to use. Defaults to 'cgisess'.

UserName

User name for authentication

UserPW

User password for authentication

Table

Table name to use. Defaults to 'cgisess'.

Schema

Schema name to use. Defaults to 'cgisess'.

STORAGE

To store session data in a DB2 database, you first need to create a suitable table for it with the following command:

perl -MCGI::Session::DB2 -e 'CGI::Session::DB2->create(DBName=>q[dbname],Schema=>q[cgisess],Table=>q[cgisess]);

For more information on database creation, see DB2::db. Also note DB2::db's requirement for DB2INSTANCE to be set. You will need to set this in your own application script(s).

COPYRIGHT

Copyright (C) 2004 Darin McBride. All rights reserved.

This library is free software and can be modified and distributed under the same terms as Perl itself.

AUTHOR

Darin McBride <dmcbride@cpan.org>

SEE ALSO

• CGI::Session - CGI::Session manual

• CGI::Session::Tutorial - extended CGI::Session manual

• CGI::Session::CookBook - practical solutions for real life problems

• RFC 2965 - "HTTP State Management Mechanism" found at ftp://ftp.isi.edu/in-notes/rfc2965.txt

• CGI - standard CGI library

• Apache::Session - another fine alternative to CGI::Session