piomsgout Subroutine

Purpose

Sends a message from a printer formatter.

Library

None (linked with the pioformat formatter driver)

Syntax

void piomsgout ( msgstr)
char *msgstr;

Description

The piomsgout subroutine should be used by printer formatters to send a message to the print job submitter, usually when an error is detected. This subroutine is supplied by the formatter driver.

If the formatter is running under the spooler, the message is displayed on the submitter's terminal if the submitter is logged on. Otherwise, the message is mailed to the submitter. If the formatter is not running under the spooler, the message is sent as standard error output.

The piomsgout subroutine has no return values.

Parameters

Item Description
msgstr Points to the string of message text to be sent.