To fetch an email from the POP3 server.

[ "$email" ] This user specified optional argument is the name of the "Group Variable", if not, "$email" is assumed.

• 1, if the mail is fetched successfully, else 0.

• Another method of executing this plugin is "GetMail()", then the variable $email is assumed to be the default "Group variable" argument.
• $email.count gives the total number of mails in the email account provided the value of $email.msgno is zero.
• Mail can be deleted by calling GetMail() after setting the value of $email.delete to any of the values 1,Y,YES or TRUE. The message specified by $email.msgno will be deleted from the email account.
• All mails are fetched from the POP server.
• Default Port Address of the POP server (Default :110) is automatically taken if $email.port is not specified by the user.
• Since Mails are fetched from POP server, IP address should be precisely stated.
• [ "$email" ] is of user defined type. Say, if it is given as $Variable, then the Group Variables will be $Variable.to, $Variable.body, $Variable.from etc.
• $email.errno is the Error no. returned by the POP3 server.
   
  Group variables are:
   

  Variable	Description
  $email.pop	IP Address of the POP server. E.g. "192.168.1.1".
  $email.port	(Optional )Default (i.e. "110") Port Address of the POP server.
  $email.user	User name for authentication.
  $email.pass	User password for authentication.
  $email.msgno	Message number to be retrieved from the account. Given "$email.msgno = 3" would fetch the third message.
  $email.nooflines	Number of lines in a message.
  $email.delete	If this variable is set to any of the values 1,Y,YES or TRUE, the message specified by  $email.msgno will be deleted from the email account.
  $email.count	Total number of messages in the email account.
  $email.raw	Contains the raw data of the mail specified by  $email.msgno.
  $email.size	Size of the mail in bytes.
  $email.headers	Header of the mail.
  $email.subject	Subject of the mail, if any.
  $email.from	Sender's address. This variable contains the name and email-ID of the person sending the mail.  E.g. ""Allen Samuel"<Allensam@hotmail.com""
  $email.mailfrom	Contains only the mail-ID of the sender.     E.g. Allensam@hotmail.com
  $email.to	Email-ID of the user or the recipient. This variable contains the name and email-ID of the person who receives the mail.  E.g. ""Neil Jacobsonl"<jacobsonneil@hotmail.com""
  $email.mailto	Contains only the Email-ID of the recipient.      E.g:   jacobsonneil@hotmail.com
  $email.cc	Names, if any, and Email addresses to which " Carbon Copies " of the mail has been sent. That is, the recipient has a provision to know to who all the mail has been sent.
  $email.mailcc	Contains only the Email addresses to which "Carbon Copies" of the mail has been sent.
  $email.bcc	Names, if any, and Email addresses to which "Blind Carbon Copies" of the mail has been sent, provided it is given in the raw data by the POP server.
  $email.mailbcc	Email addresses to which "Blind Carbon Copies" of the mail has been sent, provided it is there in the raw data.
  $email.date	Contains the date and time with the standard deviation from GMT.
  email.maildate	Contains the date in ddmmyyyy format. E.g. 05 Feb 2003.
  $email.mailtime	Contains only the time.
  $email.gmtdiff	Contains the difference in time with the GMT.
  $email.body	Content of the mail.
  $email.errno	Returns the Error no. if the mail could not be fetched.
  $email.error	Specifies the error when GetMail() fails. Its content will be same as that of $Error.

$Variable = GetMail()
  
or

$Variable = GetMail ( " $email" )