Knowledge Base > Automation Engine and Target Systems > UNIX > Activating Job-Messenger Traces

Activating Job Messenger Traces

The following guide describes the activation of a trace output for UNIX and VMS Job Messengers. Doing so is possible per jobAn Automation Engine object type for a process that runs on a target system., per clientA closed environment within an Automation Engine system where you can create and run objects. A client name consists of a 4-digit number that must be indicated when a user logs on to the Automation Engine system. Users and their rights are also defined in clients. A particular Automation Engine object type. or for the whole system.

The agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host writes Job Messenger traces to the job reportA report provides more detailed information about a task's execution or a component. (REP). These outputs are found at the report's beginning (start messenger) and its end (end messenger). They contain information about the messenger's connection statusThis represents the condition of a task (such as active, blocked, generating).. Trace output is automatically activated if an error occurs in combination with the messenger program.

Activate the output as follows:

Use the parameter TRC= when calling the Job Messenger program in the Trailer and/or Header Include (see: job includes). It is automatically included in the Unix job includes. The predefined script variableA placeholder for a value within a script. &UC_MD_JOB_TRC will be assigned to this parameter. Thus, you can activate ('1') or deactivate ('0') trace output by using this variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type..

Trace activation is possible to the following extent:

By default, the activation of Job Messenger trace outputs is provided in the Header Include of UNIX jobs. Open the Include objectAn Automation Engine object type for a script that is frequently used in more than one object. HEADER.UNIX in the system client. It contains the definition for the variable &UC_JOB_MD_TRC. This variable's value will be passed on to the parameter TRC= when the Job Messenger is called (JCL line).

You can activate the trace output for a particular UNIX job by inserting the following scripting line in the PreProcess tab:

:SET &UC_JOB_MD_TRC = '1'

 

See also:

Agent's Job Messenger
Logging/Trace

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH