The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


Config::LotusNotes::Configuration - Represents one Lotus Notes/Domino configuration


This documentation refers to Config::LotusNotes::Configuration 0.34, released Feb 10, 2011.


  $factory = Config::LotusNotes->new();

  # access default installation
  $conf = $factory->default_configuration();

  # basic information about a configuration
  print "Version: ", $conf->version, "\n";
  print "This is a server.\n" if $conf->is_server;

  # getting and setting environment values
  $data = $conf->get_environment_value('Directory');
  $conf->set_environment_value('$NotesEnvParameter', 'value');


A Config::LotusNotes::Configuration object represents the configuration of a local Lotus Notes/Domino installation from the view of the file system. It lets you read and modify the Lotus Notes configuration file, notes.ini, where Notes stores its environment. See "The Lotus Notes environment" in Config::LotusNotes for more information on exchanging data with Lotus Notes via the Notes environment.

Config::LotusNotes::Configuration objects also give you access to some basic information like install paths and the Notes version number.

To create these objects, use the default_configuration() and all_configurations() methods of Config::LotusNotes.



Returns the path where the program files are stored.


Returns the path where the data files are stored.


Returns the full path (including file name) of the notes.ini file.


Returns the Lotus Notes version number, e.g. 7.0 or 5.0.13a.


Returns true if the configuration belongs to a client (workstation) installation.


Returns true if the configuration belongs to a server installation.


Returns "just for me" or "all users" depending on the chosen setup type.


new(path => $path);

Constructor, returns a Config::LotusNotes::Configuration object representing the installation at the specified path.

The recommended way to create Config::LotusNotes::Configuration objects is to use the default_configuration() and all_configurations() methods of Config::LotusNotes.


Gets the value of the parameter named $item_name from notes.ini. If there is no such parameter, undef is returned.

In order to access values that were written by Lotus Notes via the environment functions, prefix the parameter name with "$".

set_environment_value($item_name, $value);

Writes a parameter/value pair to notes.ini. If the entry exists, it will be updated with the new value. If the value is undef, the whole entry is removed.

If you want the parameter to be accessible to Lotus Notes via the environment functions, prefix its name with "$".

If you write to a notes.ini file with this function, its entries will be saved in random order.


See "BUGS AND LIMITATIONS" in Config::LotusNotes.


See "EXAMPLES" in Config::LotusNotes.


Copyright (C) 2006 HS - Hamburger Software GmbH & Co. KG. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

This library is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantibility or fitness for a particular purpose.


Harald Albers,

See the Changes file for the change history.