NAME

HH::Unispool::Config::Entry::RemoteSystem::3 - UNISPOOL type 3 remote system

SYNOPSIS

# Information on remote system type 0 is obtained through an
# informal document. I guess this remote system type is out
# of fashion...

use strict;

use HH::Unispool::Config;
use HH::Unispool::Config::OS;
use HH::Unispool::Config::Scope;
use HH::Unispool::Config::Entry::System;
use HH::Unispool::Config::Entry::RemoteSystem::3;

# Create a config from scratch with a _Local_ scope
my $conf = HH::Unispool::Config->new( {
    scope => HH::Unispool::Config::Scope->new ( {
        scope => [ qw( _Local_) ],
    } ),
} );

# Create the _Local_ system and add it to the configuration
my $sysn = HH::Unispool::Config::Entry::System->new( {
    name => '_Local_',
    local_system_name => 'foo',
    network_name => 'foo.bar.org',
    os => HH::Unispool::Config::OS->new( {
        os => 'Solaris',
    } ),
} );
$conf->add_system($sysn);

# Add a type 3 remote system to _Local_
my $dev = HH::Unispool::Config::Entry::RemoteSystem::3->new( {
    name => 'rsys3',
    acct => 'fred',
    apass => '123wilma',
    upass => '123pebbles',
    remote_node_name => 'barney.bedrock.org',
} );
$sysn->add_remote_system($dev);

# Write the configuration
$conf->write('t/config.sample.r3.out');

ABSTRACT

UNISPOOL type 3 remote system

DESCRIPTION

Class HH::Unispool::Config::Entry::RemoteSystem::3 holds information for UNISPOOL type 3 remote systems

CONSTRUCTOR

new(OPT_HASH_REF)

Creates a new HH::Unispool::Config::Entry::RemoteSystem::3 object. OPT_HASH_REF is a hash reference used to pass initialization options. OPT_HASH_REF is mandatory. On error an exception Error::Simple is thrown.

Options for OPT_HASH_REF may include:

acct: Passed to set_acct().
apass: Passed to set_apass().
high_priority_login: Passed to set_high_priority_login(). Defaults to 0.
initially_open: Passed to set_initially_open().
remote_node_name: Passed to set_remote_node_name(). Mandatory option.
timeout: Passed to set_timeout(). Defaults to 180.
upass: Passed to set_upass().

Options for OPT_HASH_REF inherited through package HH::Unispool::Config::Entry may include:

name: Passed to set_name(). Mandatory option.

Options for OPT_HASH_REF inherited through package HH::Unispool::Config::Entry::Numbered may include:

diff_number: Passed to set_diff_number(). Defaults to 0.
number: Passed to set_number().

Options for OPT_HASH_REF inherited through package HH::Unispool::Config::Entry::RemoteSystem may include:

description: Passed to set_description().
execution_priority: Passed to set_execution_priority(). Defaults to HH::Unispool::Config::ExecPri->new( { execution_priority = '' } )>.

new_from_tokenizer(TOKENIZER)

This method is an implementation from package HH::Unispool::Config::Entry::RemoteSystem. Constructs a new HH::Unispool::Config::Entry object using tokens. TOKENIZER is an HH::Unispool::Config::File::Tokenizer reference. On error an exception Error::Simple is thrown.

METHODS

diff(TO [, DIFF_NUMBER])

This method is an implementation from package HH::Unispool::Config::Entry::RemoteSystem. Finds differences between two objects. In diff terms, the object is the from object and the specified TO parameter the to object. TO is a reference to an identical object class. Returns an empty string if no difference found and a difference descritpion string otherwise. On error an exception Error::Simple is thrown. Paremeter DIFF_NUMBER if specified, overrules the value of get_diff_number.

get_acct()

Returns the remote login account (is not available on development system used).

get_apass()

Returns the account password (is not available on development system used).

get_description()

This method is inherited from package HH::Unispool::Config::Entry::RemoteSystem. Returns the description for the remote system.

get_execution_priority()

This method is inherited from package HH::Unispool::Config::Entry::RemoteSystem. Returns the execution priority of the driver process on MPE hosts.

get_name()

This method is inherited from package HH::Unispool::Config::Entry. Returns the entry name.

get_number()

This method is inherited from package HH::Unispool::Config::Entry::Numbered. Returns the entry number.

get_remote_node_name()

Returns the name of the system as it can be resolved by the network software.

get_timeout()

Returns the delay before closing the link after transfering the last request (in seconds) (is not available on development system used).

get_upass()

Returns the user paccword (is not available on development system used).

is_diff_number()

This method is inherited from package HH::Unispool::Config::Entry::Numbered. Returns whether diff() should consider the number attribtutes or not.

is_high_priority_login()

Returns whether the login must be high priotity (is not available on development system used) or not.

is_initially_open()

Returns whether the communication link should be opened at the moment UNISPOOL is started or not.

set_acct(VALUE)

Set the remote login account (is not available on development system used). VALUE is the value. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^.*$

set_apass(VALUE)

Set the account password (is not available on development system used). VALUE is the value. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^.*$

set_description(VALUE)

This method is inherited from package HH::Unispool::Config::Entry::RemoteSystem. Set the description for the remote system. VALUE is the value. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^.*$

set_diff_number(VALUE)

This method is inherited from package HH::Unispool::Config::Entry::Numbered. State that diff() should consider the number attribtutes. VALUE is the value. Default value at initialization is 0. On error an exception Error::Simple is thrown.

set_execution_priority(VALUE)

This method is inherited from package HH::Unispool::Config::Entry::RemoteSystem. Set the execution priority of the driver process on MPE hosts. VALUE is the value. Default value at initialization is HH::Unispool::Config::ExecPri-new( { execution_priority => '' } )>. On error an exception Error::Simple is thrown.

VALUE must be a (sub)class of:

HH::Unispool::Config::ExecPri

set_high_priority_login(VALUE)

State that the login must be high priotity (is not available on development system used). VALUE is the value. Default value at initialization is 0. On error an exception Error::Simple is thrown.

set_initially_open(VALUE)

State that the communication link should be opened at the moment UNISPOOL is started. VALUE is the value. On error an exception Error::Simple is thrown.

set_name(VALUE)

This method is inherited from package HH::Unispool::Config::Entry. Set the entry name. VALUE is the value. VALUE may not be undef. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^.+$

set_number(VALUE)

This method is inherited from package HH::Unispool::Config::Entry::Numbered. Set the entry number. VALUE is the value. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^\d*$

set_remote_node_name(VALUE)

Set the name of the system as it can be resolved by the network software. VALUE is the value. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^[\w\.]+$

set_timeout(VALUE)

Set the delay before closing the link after transfering the last request (in seconds) (is not available on development system used). VALUE is the value. Default value at initialization is 180. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^\d*$

set_upass(VALUE)

Set the user paccword (is not available on development system used). VALUE is the value. On error an exception Error::Simple is thrown.

VALUE must match regular expression:

^.*$

write(FILE_HANDLE)

This method is an implementation from package HH::Unispool::Config::Entry::RemoteSystem. Writes the entry to the specified file handle. FILE_HANDLE is an IO::Handle reference. On error an exception Error::Simple is thrown.

BUGS

None known (yet.)

HISTORY

First development: February 2003 Last update: September 2003

AUTHOR

Vincenzo Zocca

COPYRIGHT

LICENSE

This file is part of the HH::Unispool::Config module hierarchy for Perl by Vincenzo Zocca.

The HH::Unispool::Config module hierarchy is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

The HH::Unispool::Config module hierarchy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with the HH::Unispool::Config module hierarchy; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

To install HH::Unispool::Config, copy and paste the appropriate command in to your terminal.

cpanm

cpanm HH::Unispool::Config

CPAN shell

perl -MCPAN -e shell
install HH::Unispool::Config

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

NAME

SYNOPSIS

ABSTRACT

DESCRIPTION

CONSTRUCTOR

METHODS

SEE ALSO

BUGS

HISTORY

AUTHOR

COPYRIGHT

LICENSE

Module Install Instructions