Documentation ARexxAPI READPRINT

READPRINT

NAME:: ReadPrint -- Print a part of the message in the active Read window to the printer. (V2.0)

TEMPLATE:: PART/N

FUNCTION:: Sends to the printer a part of the message in the active Read window, as set by MAILREAD.

INPUTS:: PART/N - part of the message to send to the printer, possible values are 1 for the first part of the message (usually the body), 2 or higher for further parts, or no value at all to get a printout of the visible part of the message

RETURNS:: RC is set to 10 if the specified part does not exist or no Read window was previously specified as "active" with MAILREAD.

NOTES::

EXAMPLE:: {{{#!arexx /* Enable result codes */ OPTIONS RESULTS

 /* Silently decode the current message */
 MAILREAD QUIET

 /* Print the body, then close the message */
 READPRINT 1
 READCLOSE
 }}}

BUGS:: The command used to blindly act upon the first Read window opened at any given time; this was changed in V2.4 to require the use of MAILREAD to explicitely mark a window as "active".

SEE ALSO:: MAILREAD, READINFO