INDESCA_JOB (700)


The event is generated when UEC receives a UES event that relates to a Universal Command job.

INDESCA_JOB Event Header

Field Name

Description

eventCategory

Status

eventSeverity

Informational

eventTopic

Job

eventType

700

recordedTime

recordedTime of the consolidated event is set to the recordedTime value of the first UES event received that applies to the consolidated event.

recordedTimeUsec

recordedTimeUsec of the consolidated event is set to the recordedTimeUsec value of the first UES event received that applies to the consolidated event.

reporterGroupUuid

Same as reporterObjectUuid.

reporterIpAddress

Reporter IP address is UEC host for consolidated events.

reporterName

Reporter name is "UEC" for all consolidated events.

reporterObjectUuid

Unique UUID generated by UEC at startup. Each execution of UEC will have a unique reporterObjectUuid.

reporterParentUuid

Not applicable - not reported.

reporterSysId

Not applicable - not reported.

reporterUnitUuid

Same as reporterObjectUuid.

sourceGroupUuid

Group UUID that groups (and is shared by) all UES events that comprise the consolidated event.

sourceIpAddress

Source IP address is UEC host for consolidated events.

sourceName

Source name is "UEC" for all consolidated events.

sourceObjectUuid

Same as reporterObjectUuid.

sourceParentUuid

Not applicable - not reported.

sourceSysId

Not applicable - not reported.

sourceUnitUuid

Unit UUID that groups (and is shared by) all UES events that comprise the consolidated event.

timeZone

Time zone in which the event was generated. The value is the number of seconds between UTC and local time.

version

Numeric value that is incremented whenever the header changes (that is, changes to the header format or header fields).

INDESCA_JOB Event Body

Field Name

Notes

Description

bHistorical

Indicates that the job has been recognized as having at least one restart job associated with it.

bRestarted

Specification for whether or not the UCMD Manager was restarted:

  • Value of TRUE indicates it was restarted.
  • Value of FALSE indicates it was not restarted.

If the Manager RESTART option was set to auto, this field is set to TRUE only if the Manager reestablished a session with a pending, orphaned, or disconnected UCM Server.

certId

Certificate map identifier that the client certificate was mapped to by the Universal Access Control List cert_map entries.

clientCertIssuer

Issuer field of the digital certificate provided by the UCMD Manager.

clientCertSerialNo

Serial number of the digital certificate provided by the UCMD Manager.

clientCertSubject

Subject field of the digital certificate provided by the UCMD Manager.

clientIpAddr

IP address from which the UCMD Manager's socket connection was established.

clientPort

TCP port number from which the UCMD Manager's socket connection was established.

clientUserId

User identifier of the UCMD Manager.

clientWorkId

Work identifier of the UCMD Manager.

commandId

Command identifier with which the UCMD job executed.

comment

User comment with which UCMD job.

jobCommand

Command line used to start the job. The field is relevant only if the jobFormat value is CMD.

jobFormat

Format of job requested by the UCMD Manager.

Valid values are:

  • CMD (1)
  • SCRIPT (2)

jobLoginEnvironment

Specification for whether or not a login environment was established for the job.

Possible values are:

  • 0 - Job ran with the Login Environment option off.
  • 1 - Job ran with the Login Environment option on.

jobType

Type of job requested by the UCMD Manager.

Valid values are:

  • cmdref
    Job is a UCM Server command reference.
  • service
    Job is executed by Universal Command Agent for SOA.
  • shell
    Job is executed by a shell environment, such as Windows CMD.EXE, UNIX Bourne or Korn shell, or z/OS USS shell.
  • stc
    Job is a z/OS started task.

jobUserId

User identifier with which the job executed.

jobUUID

UUID that uniquely identifies the user's started work process.

jobWorkId

Work identifier of the job started by UCMD Server.

managerFaultTolerant

Specification for whether or not the UCMD job executed in Manager Fault Tolerant mode.

Possible values are:

  • 0 - Job did not execute in Manager Fault Tolerant mode.
  • 1 - Job executed in Manager Fault Tolerant mode.

mgrAgentName

Name of the Universal Broker on the system where the UCMD Manager component executed.

mgrCommState

Last recorded communication state of the UCMD Manager component.

Possible values are:

  • 1 - Starting
  • 2 - Established
  • 3 - Disconnected
  • 4 - Orphaned
  • 5 - Reconnecting
  • 6 - Restarting
  • 7 - Restart accepted
  • 8 - Pending
  • 9 - Completed

mgrComponentId

Component identifier the UCMD Manager component.

mgrElapsedTime

Number of seconds that the UCMD Manager component executed.

The value may be zero if the job ran less than a second, resulting in the start and end time not changing at the 1 second resolution.

mgrExitCode

Exit code with which the UCMD Manager ended as reported by the operating system.

mgrExitStatus

Final exit status of the UCMD Manager component as reported by the operating system.

Valid values are:

  • Normal (1)
  • Abnormal (2)

An abnormal end indicates the component was interrupted by the operating system before it completed processing.

Examples of abnormal exits include UNIX signals, Windows exceptions, and z/OS ABENDs.

mgrStartDateTime

UTC date and time the UCMD Manager component started.

mgrStopDateTime

UTC date and time the UCMD Manager component stopped.

networkFaultTolerant

Specification for whether or not the UCMD job executed in Manager Fault Tolerant mode.

Possible values are:

  • 0 - Job did not execute in Network Fault Tolerant mode.
  • 1 - Job executed in Network Fault Tolerant mode.

restartUuid

sourceUnitUUID of the job that was started as the restart job for this job.

serverIpAddr

IP address from which the UCMD Server's socket connection was established.

serverPort

TCP port number from which the UCMD Server's socket connection was established.

srvAgentName

Name of the Universal Broker on the system where the UCMD Server component executed.

srvCommState

Last recorded communication state of the UCMD Manager component.

Possible values are:

  • 1 - Starting
  • 2 - Established
  • 3 - Disconnected
  • 4 - Orphaned
  • 5 - Reconnecting
  • 6 - Restarting
  • 7 - Restart accepted
  • 8 - Pending
  • 9 - Completed

svrComponentId

Component identifier the UCMD Server component.

svrElapsedTime

Number of seconds that the UCMD Server component executed.

The value may be zero if the job ran less than a second, resulting in the start and end time not changing at the 1 second resolution.

svrExitCode

Exit code with which the UCMD Server ended as reported by the operating system.

svrExitStatus

Final exit status of the UCMD Server component as reported by theoperating system.

Valid values are:

  • Normal (1)
  • Abnormal (2)

An abnormal end indicates the component was interrupted by the operating system before it completed processing.

Examples of abnormal exits include UNIX signals, Windows exceptions, and z/OS ABENDs.

svrStartDateTime

UTC date and time the UCMD Server component started.

svrStopDateTime

UTC date and time the UCMD Server component stopped.

userJobElapsedTime

Number of seconds in which the user process executed.

The value may be zero if the job ran less than a second, resulting in the start and end time not changing at the 1 second resolution.

userJobExitCode

Exit code of the job (user process) that was executed at the request of UCMD Manager.

userJobExitStatus

Final exit status of the job (user process) as reported by the operating system.

Valid values are:

  • Normal (1)
  • Abnormal (2)

An abnormal end indicates the component was interrupted by the operating system before it completed processing.

Examples of abnormal exits include UNIX signals, Windows exceptions, and z/OS ABENDs.

userJobStartDateTime

UTC date and time the user process started.

userJobStopDateTime

UTC date and time the user process stopped.