<job-where> <job-getLogEntry>

Definition:

<!ENTITY % cm.logEntry "
  (logEntryId,
  execResult,
  execStart,
  execEnd)
">
<!ENTITY % cm.job-getLogEntry "%cm.logEntry;">
<!ELEMENT job-getLogEntry %cm.job-getLogEntry>
<!ATTLIST job-getLogEntry
  id CDATA #REQUIRED
>
<!ELEMENT logEntryId (%cm.atom;)>
<!ELEMENT execResult (%cm.atom;)>
<!ELEMENT execStart %cm.date;>
<!ATTLIST execStart
  type CDATA #IMPLIED
>
<!ELEMENT execEnd %cm.date;>
<!ATTLIST execEnd
  type CDATA #IMPLIED
>

Aufgabe: Der Befehl gibt einen Protokolleintrag eines Jobs aus.

Spezielle Parameter dieses Funktionselements:

• id: Die ID des Protokolleintrags.

Verwendung: Zunächst wird mit job-where ein Job ermittelt. Anschließend ermittelt ein Client die Liste der Protokolleinträge zu diesem Job, indem er den Wert des Parameters log abfragt. Er kann nun mit job-getLogEntry je ID die im Protokoll gespeicherten Daten auslesen.

Rückgabewert bei Erfolg: ein Protokolleintrag.

Erforderliche Rechte: keine Einschränkungen

Beispiel:

<cm-request...>
  <job-where>
    <name>myJob</name>
  </job-where>
  <job-getLogEntry id="2060"/>
</cm-request>

<cm-response...>
  <cm-code numeric="0" phrase="ok">
    <job>
      <logEntry>
        <logEntryId>76321.26</logEntryId>
        <execResult />
        <execStart type="date">
          <isoDateTime>20020716130246</isoDateTime>
          <systemConfigFormattedTime>16.07.2002 15:02
          </systemConfigFormattedTime>
          <userConfigFormattedTime>16.07.2002 15:02
          </userConfigFormattedTime>
        </execStart>
        <execEnd type="date">
          <isoDateTime>20020716130246</isoDateTime>
          <systemConfigFormattedTime>16.07.2002 15:02
          </systemConfigFormattedTime>
          <userConfigFormattedTime>16.07.2002 15:02
          </userConfigFormattedTime>
        </execEnd>
      </logEntry>
    </job>
  </cm-code>
</cm-response>