$session = InCharge::session->new( .. options .. );

The new function first establishes a connection between the calling Perl script and a Domain Manager. It then returns a tied reference that can be used thereafter to manipulate the domain and the entities contained in its repository.

If the domain name is the sole option passed, it can be specified without the domain=> key.

The username and password options are required if connecting to a server with authentication features enabled. If neither of these arguments is given, the clientConnect.conf file is used to determine the username and password or the mechanism to obtain them.