Ingres::Utility::IINamu - API to IINAMU Ingres RDBMS utility
Version 0.04
List registered INGRES (IIDBMS) services:
use Ingres::Utility::IINamu; my $foo = Ingres::Utility::IINamu->new(); # list all INGRES-type servers (iidbms) print $foo->show('INGRES'); # process each server separately while (my @server = $foo->getServer()) { print "Server type: $server[0]\tname:$server[1]\tid:$server[2]"; if (defined($server[3])) { print "\t$server[3]"; } print "\n"; } # stop IIGCN server (no more connections to all of Ingres) $ret = $foo->stop(); ...
This module provides an API to the iinamu utility for Ingres RDBMS, which provides local interaction and control of IIGCN server, in charge of registering all Ingres services.
Through this interface, it is possible to obtain a list of all registered services, for later processing (eg. iimonitor), and also stopping the IIGCN server (extreme caution!).
Create a new instance, checking environment prerequisites and preparing for interfacing with iinamu utility.
Returns the output of SHOW command, and prepares for parsing the servers sequentially with getServer().
Takes one optional argument for the service: 'INGRES'(IIDBS, default), 'COMSVR' (IIGCC), etc.
Returns sequentially (call-after-call) each server reported by show() as an array of 3~4 elements.
Shuts down the IIGCN daemon, making it no longer possible to stablish new connections to any Ingres service. After this, a total restart of Ingres will most probably be necessary.
Ingres environment variable II_SYSTEM not set
Ingres environment variables should be set on the user session running this module. II_SYSTEM provides the root install dir (the one before 'ingres' dir). LD_LIBRARY_PATH also. See Ingres RDBMS docs.
Ingres utility cannot be executed: _COMMAND_FULL_PATH_
The IINAMU command could not be found or does not permits execution for the current user.
Requires Ingres environment variables, such as II_SYSTEM and LD_LIBRARY_PATH.
See Ingres RDBMS documentation.
Expect::Simple
None reported.
No bugs have been reported.
Please report any bugs or feature requests to bug-ingres-utility-iinamu at rt.cpan.org, or through the web interface at http://rt.cpan.org.
bug-ingres-utility-iinamu at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc Ingres::Utility::IINamu
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Ingres-Utility-IINamu
CPAN Ratings
http://cpanratings.perl.org/d/Ingres-Utility-IINamu
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Ingres-Utility-IINamu
Search CPAN
http://search.cpan.org/dist/Ingres-Utility-IINamu
Thanks to Computer Associates (CA) for licensing Ingres as open source, and let us hope for Ingres Corp to keep it that way.
Joner Cyrre Worm <FAJCNLXLLXIH at spammotel.com>
<FAJCNLXLLXIH at spammotel.com>
Copyright (c) 2006, Joner Cyrre Worm <FAJCNLXLLXIH at spammotel.com>. All rights reserved.
Ingres is a registered brand of Ingres Corporation.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.
BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
To install Ingres::Utility::IINamu, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Ingres::Utility::IINamu
CPAN shell
perl -MCPAN -e shell install Ingres::Utility::IINamu
For more information on module installation, please visit the detailed CPAN module installation guide.