NAME

VCS::CMSynergy::Helper - ancillary convenience functions

SYNOPSIS

my %ccm_opts = VCS::CMSynergy::Helper::GetOptions;

GetOptions

This function extracts a set of common options from @ARGV and converts them to the corresponding options for "new" in VCS::CMSynergy. All options and arguments in @ARGV that it doesn't know about are left untouched.

It may be used to make all your CM Synergy scripts accept a uniform set of options:

use Getopt::Long;
use VCS::CMSynergy;
use VCS::CMSynergy::Helper;
...

# extract CM Synergy options from @ARGV
my %ccm_opts = VCS::CMSynergy::Helper::GetOptions;

# process other options in @ARGV
GetOptions(...);

# start CM Synergy session
my $ccm = VCS::CMSynergy->new(
    %ccm_opts,
    RaiseError => 1,
    PrintError => 0);
...

The following options are recognized:

-D, --database

absolute database path; this option corresponds to option database for VCS::CMSynergy/start

-H, --host

engine host; this option corresponds to option host for for VCS::CMSynergy/start

-U, --user

user; this option corresponds to option user for VCS::CMSynergy/start

-P, --password

user's password; this option corresponds to option password for for VCS::CMSynergy/start

--ui_database_dir

path name to which your database information is copied when you are running a remote client session; this option corresponds to option ui_database_dir for ccm start, it implies remote_client

If no database was specified GetOptions adds

CCM_ADDR => $ENV{CCM_ADDR}

to the returned hash; it will croak if $ENV{CCM_ADDR} is not defined.

Note that all recognized single letter options are in uppercase so that scripts using VCS::CMSynergy::Helper::GetOptions still can use all lowercase letters for their own options.

Here's the short description of recognized options that you can cut and paste into your script's POD:

CM Synergy Options:

-D PATH | --database PATH       database path
-H HOST | --host HOST           engine host
-U NAME | --user NAME           user name
-P STRING | --password STRING   user's password
--ui_database_dir PATH          path to copy database information to