<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org">
    <title>Message Format</title>
    <meta name="GENERATOR" content=
    "Modular DocBook HTML Stylesheet Version 1.7">
    <link rel="HOME" title=" LPRng Reference Manual" href=
    "index.htm">
    <link rel="UP" title="Remote Logger Operation" href=
    "remotelogger.htm">
    <link rel="PREVIOUS" title="Logger Messages" href="x10991.htm">
    <link rel="NEXT" title="Dump Messages" href="x11024.htm">
  </head>

  <body class="SECT1" bgcolor="#FFFFFF" text="#000000" link=
  "#0000FF" vlink="#840084" alink="#0000FF">
    <div class="NAVHEADER">
      <table summary="Header navigation table" width="100%" border=
      "0" cellpadding="0" cellspacing="0">
        <tr>
          <th colspan="3" align="center">LPRng Reference Manual: 24
          Sep 2004 (For LPRng-3.8.28)</th>
        </tr>

        <tr>
          <td width="10%" align="left" valign="bottom"><a href=
          "x10991.htm" accesskey="P">Prev</a></td>

          <td width="80%" align="center" valign="bottom">Chapter
          21. Remote Logger Operation</td>

          <td width="10%" align="right" valign="bottom"><a href=
          "x11024.htm" accesskey="N">Next</a></td>
        </tr>
      </table>
      <hr align="LEFT" width="100%">
    </div>

    <div class="SECT1">
      <h1 class="SECT1"><a name="AEN10996">21.3. Message
      Format</a></h1>

      <p>Each message is encoded as a URI escaped string. That is,
      non-alphanumeric characters are encoded as the 3 character
      sequence <var class="LITERAL">%xx</var>, where <var class=
      "LITERAL">xx</var> is the hexadecimal value of the character.
      The message has the format <var class=
      "LITERAL">key=value</var>, where <var class=
      "LITERAL">key</var> indicates the message type. For
      example:</p>

      <div class="INFORMALEXAMPLE">
        <a name="AEN11003"></a>
<pre class="SCREEN">
    dump=host=h4.private%0aprinter=t1%0aprocess=1613%0a
    update_time=1999-03-23-20:32:17.148%0a\
    value=queue=holdall 0%25250aprinting_aborted=0x0%25250a\
    printing_disabled=0x0%25250aspooling_disabled=\
    0x0%25250a%250a%0a
</pre>
      </div>
      <br>
      <br>

      <p>The following keys are used:</p>

      <ol type="1">
        <li>
          <p>dump A status dump of the current contents of a print
          queue.</p>
        </li>
      </ol>
      <br>
      <br>

      <p>Each message has a set of headers and a value. For
      example, the decoded dump message from the previous section
      would be:</p>

      <div class="INFORMALEXAMPLE">
        <a name="AEN11010"></a>
<pre class="SCREEN">
    host=h4.private
    printer=t1
    process=1613
    update_time=1999-03-23-20:32:17.148
    value=queue=holdall 0%250aprinting_aborted=0x0%250a\
    printing_disabled=0x0%250aspooling_disabled=0x0%250a%0a
</pre>
      </div>
      <br>
      <br>

      <p>Each line consists of a key and a value. The <var class=
      "LITERAL">host</var> key indicates the host name, <var class=
      "LITERAL">printer</var> is the print queue, <var class=
      "LITERAL">process</var> is the process which generated the
      report or action, <var class="LITERAL">update_time</var> is
      the time at which the report was generated, and <var class=
      "LITERAL">value</var> is the value of the report.</p>

      <p>The decoded <var class="LITERAL">value</var> of the above
      report is:</p>

      <div class="INFORMALEXAMPLE">
        <a name="AEN11020"></a>
<pre class="SCREEN">
    queue='holdall 0%0aprinting_aborted=0x0%0aprinting_disabled=0x0%0a\
    spooling_disabled=0x0%0a
</pre>
      </div>
      <br>
      <br>

      <p>The <var class="LITERAL">queue</var> key provides the
      current value of the queue control file.</p>
    </div>

    <div class="NAVFOOTER">
      <hr align="LEFT" width="100%">

      <table summary="Footer navigation table" width="100%" border=
      "0" cellpadding="0" cellspacing="0">
        <tr>
          <td width="33%" align="left" valign="top"><a href=
          "x10991.htm" accesskey="P">Prev</a></td>

          <td width="34%" align="center" valign="top"><a href=
          "index.htm" accesskey="H">Home</a></td>

          <td width="33%" align="right" valign="top"><a href=
          "x11024.htm" accesskey="N">Next</a></td>
        </tr>

        <tr>
          <td width="33%" align="left" valign="top">Logger
          Messages</td>

          <td width="34%" align="center" valign="top"><a href=
          "remotelogger.htm" accesskey="U">Up</a></td>

          <td width="33%" align="right" valign="top">Dump
          Messages</td>
        </tr>
      </table>
    </div>
  </body>
</html>



syntax highlighted by Code2HTML, v. 0.9.1