Net::EPP::ResponseCodes(3pm)				User Contributed Perl Documentation			      Net::EPP::ResponseCodes(3pm)

NAME

       Net::EPP::ResponseCodes - a module to export some constants that correspond to EPP response codes

SYNOPSIS

	       use Net::EPP::ResponseCodes;
	       use Net::EPP::Simple;
	       use strict;

	       my $epp = Net::EPP::Simple->new(
		       host    => 'epp.nic.tld',
		       user    => 'my-id',
		       pass    => 'my-password',
	       );

	       my $result = $epp->domain_transfer_request('example.tld', 'foobar', 1);

	       if ($result) {
		       print "Transfer initiated OK
";

	       } else {
		       if ($Net::EPP::Simple::Code == OBJECT_PENDING_TRANSFER) {
			       print "Error: domain is already pending transfer
";

		       } elsif ($Net::EPP::Simple::Code == INVALID_AUTH_INFO) {
			       print "Error: invalid authcode provided
";

		       } elsif ($Net::EPP::Simple::Code == OBJECT_DOES_NOT_EXIST) {
			       print "Error: domain not found
";

		       } elsif ($Net::EPP::Simple::Code == STATUS_PROHIBITS_OP) {
			       print "Error: domain cannot be transferred
";

		       } else {
			       print "Error code $Net::EPP::Simple::Code
";

		       }
	       }

DESCRIPTION

       EPP is the Extensible Provisioning Protocol. EPP (defined in RFC 4930) is an application layer client-server protocol for the provisioning
       and management of objects stored in a shared central repository. Specified in XML, the protocol defines generic object management
       operations and an extensible framework that maps protocol operations to objects. As of writing, its only well-developed application is the
       provisioning of Internet domain names, hosts, and related contact details.

       Every response sent to the client by an EPP server contains a "<result>" element that has a "code" attribute. This is a four-digit numeric
       code that describes the result of the request. This module exports a set of constants that provide handy mnemonics for each of the defined
       codes.

EXPORTS

       "Net::EPP::ResponseCodes" exports the following constants. The number in brackets is the integer value associated with the constant.

   Successful command completion responses(1nnn)
       OK(1000)
       OK_PENDING(1001)
       OK_NO_MESSAGES(1300)
       OK_MESSAGES(1301)
       OK_BYE(1500)

   Command error responses(2nnn)
       Protocol Syntax

       UNKNOWN_COMMAND(2011)
       SYNTAX_ERROR(2011)
       USE_ERROR(2011)
       MISSING_PARAM(2011)
       PARAM_RANGE_ERROR(2011)
       PARAM_SYNTAX_ERROR(2011)

       Implementation-specific Rules

       UNIMPLEMENTED_VERSION(2100)
       UNIMPLEMENTED_COMMAND(2101)
       UNIMPLEMENTED_OPTION(2102)
       UNIMPLEMENTED_EXTENSION(2103)
       BILLING_FAILURE(2104)
       NOT_RENEWABLE(2105)
       NOT_TRANSFERRABLE(2106)

       Security(22nn)

       AUTHENTICATION_ERROR(2200)
       AUTHORISATION_ERROR(2201)
       AUTHORIZATION_ERROR(2201)
       INVALID_AUTH_INFO(2202)

       Data Management(23nn)

       OBJECT_PENDING_TRANSFER(2300)
       OBJECT_NOT_PENDING_TRANSFER(2301)
       OBJECT_EXISTS(2302)
       OBJECT_DOES_NOT_EXIST(2303)
       STATUS_PROHIBITS_OP(2304)
       ASSOC_PROHIBITS_OP(2305)
       PARAM_POLICY_ERROR(2306)
       UNIMPLEMENTED_OBJECT_SERVICE(2307)
       DATA_MGMT_POLICY_VIOLATION(2308)

       Server System(24nn)

       COMMAND_FAILED(2400)

       Connection Management(25nn)

       COMMAND_FAILED_BYE(2500)
       AUTH_FAILED_BYE(2501)
       SESSION_LIMIT_EXCEEDED_BYE(2502)

AUTHOR

       CentralNic Ltd (<http://www.centralnic.com/>).

COPYRIGHT

       This module is (c) 2012 CentralNic Ltd. This module is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself.

SEE ALSO

       o   Net::EPP::Client

       o   Net::EPP::Frame

       o   Net::EPP::Proxy

       o   RFCs 4930 and RFC 4934, available from <http://www.ietf.org/>.

       o   The CentralNic EPP site at <http://www.centralnic.com/resellers/epp>.

perl v5.14.2							    2012-04-23					      Net::EPP::ResponseCodes(3pm)