[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 2

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

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

Related Information

Understanding Embedded References in Printer Attribute Strings in AIX Kernel Extensions and Device Support Programming Concepts.

Adding a New Printer Type to Your System in AIX Kernel Extensions and Device Support Programming Concepts.

Example of Print Formatter in AIX General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Contents | Home | Search ]