Description

This function returns the first 200 lines of an email in the BoxTrapper queue.

Examples 




$cpanel = new CPANEL(); // Connect to cPanel - only do this once.
$print_queued_message = $cpanel->api1('BoxTrapper', 'showmessage', array('user@example.com', '', 'example.msg') ); // Call the function.



my $cpliveapi = Cpanel::LiveAPI->new(); # Connect to cPanel - only do this once.
my $print_queued_message = $cpliveapi->api1('BoxTrapper', 'showmessage', ['user@example.com', '', 'example.msg'] ); # Call the function.

 


<cpanel Module="BoxTrapper::showmessage( $FORM('account','logdate','queuefile') )">




cpapi1 --user=username BoxTrapper showmessage user@example.com '' example.msg



Return-Path: <sender@example.com>
X-SpamCatcher-Score: 1 [X]
Received: from [127.0.0.1] (HELO example.com)
    by mail.example.com
    with ESMTP-TLS id 11111111 for user@example.com; Wed, 10 Aug 2014 12:34:56 -0600
Message-ID: <11111111.1111111@example.com>
Date: Wed, 10 Aug 2014 12:34:56 -0600
From: User Name <sender@example.com>
User-Agent: Example
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: User Name <user@example.com>
Subject: Example Email
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
 
Email text.




Parameters

ParameterTypeDescriptionPossible valuesExample
accountstring

Required

The account's email address.

A valid email address on the server.user@example.com
logdatestring

Required

The system does not use this parameter, and will ignore the value.

Any placeholder value.''
queuefilestring

Required

The message's filename.

A valid filename.example.msg

Returns

This function returns the first 200 lines of the email message, inclusive of the email's headers.