{
{     The purpose of this request is to send a message to an operator.  Each
{ operator message is sent to a specified class of operator.  Only an operator
{ of the specified class may display and/or act upon the operator message.
{
{     Operators are classified according to the functions they perform.
{ Messages may be sent to the following classes of operators:
{
{         system_operator: A system operator performs general functions
{             associated with the operation of the system (job status and
{             control, queue file status and control, system task status and
{             control, etc.).
{
{         removable_media_operator: A removable media operator performs
{             functions associated with the operation of removable media
{             devices (magnetic tape, optical disk, cartridge tape, etc.).
{
{     A task may have only one operator message outstanding per operator class.
{ That is, once a message has been sent to an operator, no other message may be
{ sent by the same task to an operator in the same class until the first
{ message has been acknowledged by the operator or cleared by the task.  The
{ ofp$receive_operator_response request may be used to determine whether an
{ operator has acknowledged a message.  The ofp$clear_operator_message request
{ may be used to clear a message.
{
{     A job may have up to ofc$max_actions_per_job operator messages
{ outstanding (each from a separate task).
{
{       OFP$SEND_OPERATOR_MESSAGE_R1 (FORMATTED_MESSAGE, OPERATOR_CLASS,
{             ACKNOWLEDGEMENT_ALLOWED, CLEAR_MESSAGE_WHEN_ACKNOWLEDGED, STATUS)
{
{ FORMATTED_MESSAGE: (input) This parameter specifies the message to be sent
{       to an operator.
{
{ OPERATOR_CLASS: (input) This parameter specifies the class of operator to
{       which the message is to be sent.
{
{ ACKNOWLEDGEMENT_ALLOWED: (input) This parameter specifies whether an
{       operator is allowed to acknowledge the message.  If operator
{       acknowledgement is not allowed, then the ofp$clear_operator_message
{       request must be used to clear the message when it no longer needs to be
{       displayed to an operator.
{       If acknowledgement is allowed, then CLEAR_MESSAGE_WHEN_ACKNOWLEDGED is
{       used to determine if the message is automatically cleared. When it's
{       set, then the message is immediatly deleted and no response can be
{       obtained by the sender.
{
{ STATUS: (output) This parameter specifies the request status.
{
{      CONDITION: ofe$allocate_structure_failed
{                 ofe$max_job_operator_messages
{                 ofe$message_outstanding
{
