| HH-Unispool-Config documentation | Contained in the HH-Unispool-Config distribution. |
HH::Unispool::Config::File::Token::Numbered::System - abstract class for system S tokens
Application programmers don't need to use this class and API programmers read code.
abstract class for system S tokens
HH::Unispool::Config::File::Token::Numbered::System is an abstract class for system S tokens.
Creates a new HH::Unispool::Config::File::Token::Numbered::System 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:
acctPassed to set_acct().
apassPassed to set_apass().
block_delayPassed to set_block_delay().
execution_priorityPassed to set_execution_priority().
high_priority_loginPassed to set_high_priority_login().
initially_openPassed to set_initially_open().
remote_system_namePassed to set_remote_system_name(). Mandatory option.
timeoutPassed to set_timeout().
upassPassed to set_upass().
Options for OPT_HASH_REF inherited through package HH::Unispool::Config::File::Token may include:
input_line_numberPassed to set_input_line_number().
Options for OPT_HASH_REF inherited through package HH::Unispool::Config::File::Token::Numbered may include:
numberPassed to set_number().
Creates a new object from the specified Unispool config file line string.
Returns the remote login account (is not available on development system used).
Returns the account password (is not available on development system used).
Returns the time in seconds UNISPOOL should pause between sending two blocks.
Returns the execution priority of the driver process on MPE hosts.
This method is inherited from package HH::Unispool::Config::File::Token. Returns the line number from from which the token is read.
This method is inherited from package HH::Unispool::Config::File::Token::Numbered. Returns the number of the entry.
Returns the unique name for the remote system.
Returns the delay before closing the link after transfering the last request (in seconds) (is not available on development system used).
Returns the user paccword (is not available on development system used).
Returns whether the login must be high priotity (is not available on development system used) or not.
Returns whether the communication link should be opened at the moment UNISPOOL is started or not.
This method is overloaded from package HH::Unispool::Config::File::Token::Numbered. Reads the Unispool config file token from a line string. LINE is a plain line string. On error an exception Error::Simple is thrown.
Set the remote login account (is not available on development system used). VALUE is the value. On error an exception Error::Simple is thrown.
Set the account password (is not available on development system used). VALUE is the value. On error an exception Error::Simple is thrown.
Set the time in seconds UNISPOOL should pause between sending two blocks. VALUE is the value. On error an exception Error::Simple is thrown.
Set the execution priority of the driver process on MPE hosts. VALUE is the value. On error an exception Error::Simple is thrown.
State that the login must be high priotity (is not available on development system used). VALUE is the value. On error an exception Error::Simple is thrown.
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.
This method is inherited from package HH::Unispool::Config::File::Token. Set the line number from from which the token is read. VALUE is the value. On error an exception Error::Simple is thrown.
This method is inherited from package HH::Unispool::Config::File::Token::Numbered. Set the number of the entry. VALUE is the value. On error an exception Error::Simple is thrown.
Set the unique name for the remote system. VALUE is the value. On error an exception Error::Simple is thrown.
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. On error an exception Error::Simple is thrown.
Set the user paccword (is not available on development system used). VALUE is the value. On error an exception Error::Simple is thrown.
This method is overloaded from package HH::Unispool::Config::File::Token::Numbered. Returns a Unispool config file token line string.
HH::Unispool::Config, HH::Unispool::Config::DateFormat, HH::Unispool::Config::Entry, HH::Unispool::Config::Entry::Device, HH::Unispool::Config::Entry::Device::0, HH::Unispool::Config::Entry::Device::1, HH::Unispool::Config::Entry::Device::2, HH::Unispool::Config::Entry::Device::3, HH::Unispool::Config::Entry::Device::4, HH::Unispool::Config::Entry::Device::5, HH::Unispool::Config::Entry::Device::6, HH::Unispool::Config::Entry::Device::7, HH::Unispool::Config::Entry::Filter, HH::Unispool::Config::Entry::Numbered, HH::Unispool::Config::Entry::RemoteSystem, HH::Unispool::Config::Entry::RemoteSystem::3, HH::Unispool::Config::Entry::RemoteSystem::6, HH::Unispool::Config::Entry::RemoteSystem::7, HH::Unispool::Config::Entry::RemoteSystem::8, HH::Unispool::Config::Entry::System, HH::Unispool::Config::ExecPri, HH::Unispool::Config::File::Token, HH::Unispool::Config::File::Token::Comment, HH::Unispool::Config::File::Token::Comment::Cs, HH::Unispool::Config::File::Token::Comment::Date, HH::Unispool::Config::File::Token::Comment::Device, HH::Unispool::Config::File::Token::Comment::Filter, HH::Unispool::Config::File::Token::Comment::Group, HH::Unispool::Config::File::Token::Comment::Head, HH::Unispool::Config::File::Token::Comment::Misc, HH::Unispool::Config::File::Token::Comment::NetDesc, HH::Unispool::Config::File::Token::Comment::RSys, HH::Unispool::Config::File::Token::Comment::Scope, HH::Unispool::Config::File::Token::Comment::Tail, HH::Unispool::Config::File::Token::Factory, HH::Unispool::Config::File::Token::Numbered, HH::Unispool::Config::File::Token::Numbered::Device, HH::Unispool::Config::File::Token::Numbered::Device::0, HH::Unispool::Config::File::Token::Numbered::Device::1, HH::Unispool::Config::File::Token::Numbered::Device::2, HH::Unispool::Config::File::Token::Numbered::Device::3, HH::Unispool::Config::File::Token::Numbered::Device::4, HH::Unispool::Config::File::Token::Numbered::Device::5, HH::Unispool::Config::File::Token::Numbered::Device::6, HH::Unispool::Config::File::Token::Numbered::Device::7, HH::Unispool::Config::File::Token::Numbered::Device::Group, HH::Unispool::Config::File::Token::Numbered::Device::Info, HH::Unispool::Config::File::Token::Numbered::Device::P, HH::Unispool::Config::File::Token::Numbered::Network, HH::Unispool::Config::File::Token::Numbered::System::3, HH::Unispool::Config::File::Token::Numbered::System::6, HH::Unispool::Config::File::Token::Numbered::System::7, HH::Unispool::Config::File::Token::Numbered::System::8, HH::Unispool::Config::File::Token::Numbered::System::Info, HH::Unispool::Config::File::Token::Numbered::X, HH::Unispool::Config::File::Token::Unnumbered, HH::Unispool::Config::File::Token::Unnumbered::Bcs, HH::Unispool::Config::File::Token::Unnumbered::CSN, HH::Unispool::Config::File::Token::Unnumbered::Cs, HH::Unispool::Config::File::Token::Unnumbered::CsBcs, HH::Unispool::Config::File::Token::Unnumbered::Filter, HH::Unispool::Config::File::Token::Unnumbered::Host, HH::Unispool::Config::File::Token::Unnumbered::Misc, HH::Unispool::Config::File::Tokenizer, HH::Unispool::Config::FilterType, HH::Unispool::Config::OS, HH::Unispool::Config::Scope
None known (yet.)
First development: February 2003 Last update: September 2003
Vincenzo Zocca
Copyright 2003 by Vincenzo Zocca
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
| HH-Unispool-Config documentation | Contained in the HH-Unispool-Config distribution. |
package HH::Unispool::Config::File::Token::Numbered::System; use 5.006; use base qw( HH::Unispool::Config::File::Token::Numbered ); use strict; use warnings; use AutoLoader qw(AUTOLOAD); use Error qw(:try); # Used by _value_is_allowed our %ALLOW_ISA = ( 'execution_priority' => [ 'HH::Unispool::Config::ExecPri' ], ); # Used by _value_is_allowed our %ALLOW_REF = ( ); # Used by _value_is_allowed our %ALLOW_RX = ( 'acct' => [ '^.*$' ], 'apass' => [ '^.*$' ], 'block_delay' => [ '^\d*$' ], 'remote_system_name' => [ '^.+$' ], 'timeout' => [ '^\d*$' ], 'upass' => [ '^.*$' ], ); # Used by _value_is_allowed our %ALLOW_VALUE = ( ); # Package version our ($VERSION) = '$Revision: 0.3 $' =~ /\$Revision:\s+([^\s]+)/; 1; __END__
sub _initialize { my $self = shift; my $opt = defined($_[0]) ? shift : {}; # Check $opt ref($opt) eq 'HASH' || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::_initialize, first argument must be 'HASH' reference."); # acct, SINGLE exists( $opt->{acct} ) && $self->set_acct( $opt->{acct} ); # apass, SINGLE exists( $opt->{apass} ) && $self->set_apass( $opt->{apass} ); # block_delay, SINGLE exists( $opt->{block_delay} ) && $self->set_block_delay( $opt->{block_delay} ); # execution_priority, SINGLE exists( $opt->{execution_priority} ) && $self->set_execution_priority( $opt->{execution_priority} ); # high_priority_login, BOOLEAN exists( $opt->{high_priority_login} ) && $self->set_high_priority_login( $opt->{high_priority_login} ); # initially_open, BOOLEAN exists( $opt->{initially_open} ) && $self->set_initially_open( $opt->{initially_open} ); # remote_system_name, SINGLE, mandatory exists( $opt->{remote_system_name} ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::_initialize, option 'remote_system_name' is mandatory."); $self->set_remote_system_name( $opt->{remote_system_name} ); # timeout, SINGLE exists( $opt->{timeout} ) && $self->set_timeout( $opt->{timeout} ); # upass, SINGLE exists( $opt->{upass} ) && $self->set_upass( $opt->{upass} ); # Call the superclass' _initialize $self->SUPER::_initialize($opt); # Return $self return($self); } sub _value_is_allowed { my $name = shift; # Value is allowed if no ALLOW clauses exist for the named attribute if ( ! exists( $ALLOW_ISA{$name} ) && ! exists( $ALLOW_REF{$name} ) && ! exists( $ALLOW_RX{$name} ) && ! exists( $ALLOW_VALUE{$name} ) ) { return(1); } # At this point, all values in @_ must to be allowed CHECK_VALUES: foreach my $val (@_) { # Check ALLOW_ISA if ( ref($val) && exists( $ALLOW_ISA{$name} ) ) { foreach my $class ( @{ $ALLOW_ISA{$name} } ) { &UNIVERSAL::isa( $val, $class ) && next CHECK_VALUES; } } # Check ALLOW_REF if ( ref($val) && exists( $ALLOW_REF{$name} ) ) { exists( $ALLOW_REF{$name}{ ref($val) } ) && next CHECK_VALUES; } # Check ALLOW_RX if ( ! ref($val) && exists( $ALLOW_RX{$name} ) ) { foreach my $rx ( @{ $ALLOW_RX{$name} } ) { $val =~ /$rx/ && next CHECK_VALUES; } } # Check ALLOW_VALUE if ( ! ref($val) && exists( $ALLOW_VALUE{$name} ) ) { exists( $ALLOW_VALUE{$name}{$val} ) && next CHECK_VALUES; } # We caught a not allowed value return(0); } # OK, all values are allowed return(1); } sub get_acct { my $self = shift; return( $self->{HH_Unispool_Config_File_Token_Numbered_System}{acct} ); } sub get_apass { my $self = shift; return( $self->{HH_Unispool_Config_File_Token_Numbered_System}{apass} ); } sub get_block_delay { my $self = shift; return( $self->{HH_Unispool_Config_File_Token_Numbered_System}{block_delay} ); } sub get_execution_priority { my $self = shift; return( $self->{HH_Unispool_Config_File_Token_Numbered_System}{execution_priority} ); } sub get_remote_system_name { my $self = shift; return( $self->{HH_Unispool_Config_File_Token_Numbered_System}{remote_system_name} ); } sub get_timeout { my $self = shift; return( $self->{HH_Unispool_Config_File_Token_Numbered_System}{timeout} ); } sub get_upass { my $self = shift; return( $self->{HH_Unispool_Config_File_Token_Numbered_System}{upass} ); } sub is_high_priority_login { my $self = shift; if ( $self->{HH_Unispool_Config_File_Token_Numbered_System}{high_priority_login} ) { return(1); } else { return(0); } } sub is_initially_open { my $self = shift; if ( $self->{HH_Unispool_Config_File_Token_Numbered_System}{initially_open} ) { return(1); } else { return(0); } } sub read_string { my $self = shift; $self->SUPER::read_string(@_); } sub set_acct { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'acct', $val ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::set_acct, the specified value '$val' is not allowed."); # Assignment $self->{HH_Unispool_Config_File_Token_Numbered_System}{acct} = $val; } sub set_apass { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'apass', $val ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::set_apass, the specified value '$val' is not allowed."); # Assignment $self->{HH_Unispool_Config_File_Token_Numbered_System}{apass} = $val; } sub set_block_delay { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'block_delay', $val ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::set_block_delay, the specified value '$val' is not allowed."); # Assignment $self->{HH_Unispool_Config_File_Token_Numbered_System}{block_delay} = $val; } sub set_execution_priority { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'execution_priority', $val ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::set_execution_priority, the specified value '$val' is not allowed."); # Assignment $self->{HH_Unispool_Config_File_Token_Numbered_System}{execution_priority} = $val; } sub set_high_priority_login { my $self = shift; if (shift) { $self->{HH_Unispool_Config_File_Token_Numbered_System}{high_priority_login} = 1; } else { $self->{HH_Unispool_Config_File_Token_Numbered_System}{high_priority_login} = 0; } } sub set_initially_open { my $self = shift; if (shift) { $self->{HH_Unispool_Config_File_Token_Numbered_System}{initially_open} = 1; } else { $self->{HH_Unispool_Config_File_Token_Numbered_System}{initially_open} = 0; } } sub set_remote_system_name { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'remote_system_name', $val ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::set_remote_system_name, the specified value '$val' is not allowed."); # Assignment $self->{HH_Unispool_Config_File_Token_Numbered_System}{remote_system_name} = $val; } sub set_timeout { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'timeout', $val ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::set_timeout, the specified value '$val' is not allowed."); # Assignment $self->{HH_Unispool_Config_File_Token_Numbered_System}{timeout} = $val; } sub set_upass { my $self = shift; my $val = shift; # Check if isa/ref/rx/value is allowed &_value_is_allowed( 'upass', $val ) || throw Error::Simple("ERROR: HH::Unispool::Config::File::Token::Numbered::System::set_upass, the specified value '$val' is not allowed."); # Assignment $self->{HH_Unispool_Config_File_Token_Numbered_System}{upass} = $val; } sub write_string { my $self = shift; $self->SUPER::read_string(@_); }