Knowledge Base > Agent's Job Messenger

Agent's Job Messenger

All OS agents have a Job Messenger that can be used to run and monitor jobs. You call it in the HEADER and TRAILER of Include objects. These specific job includes are available in the system 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. 0000.

A sample excerpt of the Include objectAn Automation Engine object type for a script that is frequently used in more than one object. HEADER.MVS:

//JMLDS EXEC PGM=&UC_JOBMD,
// PARM='JNR=&UC_REALNR MNR=&UC_CLIENT PNR=&UC_IP_PORT IPA=&UC_IP_ADR
//             TYP=S TXT="        Job started" 2>&1'

A sample excerpt of the Include object TRAILER.MVS:

//JMLDE    EXEC PGM=&UC_JOBMD,COND=EVEN,
// PARM='JNR=&UC_REALNR MNR=&UC_CLIENT PNR=&UC_IP_PORT IPA=&UC_IP_ADR
//             TYP=E STP=&UC_REPORT_STEPS RET=&RETCODE 2>&1'

Note that PARM statements must not exceed 100 characters.

General Start Parameters

There are several parameters that can be assigned to the Job Messenger. The following table shows the parameters that apply to all Job Messengers.

Parameter

Description

IPA

The IP address.

JNR

The RunIDShort for "run number". It is a number that provides unique information about a task's execution. The RunID can include 7 to 10 digits. It is assigned by the Automation Engine component . of the jobAn Automation Engine object type for a process that runs on a target system..

MNR

Client

PNR

The port number.

RET

The return codeThe value that represents the result of tasks and script functions..

TYP

The type ("S" - start Job Messenger, "E" - end Job Messenger)

For the GCOS8 Job Messenger, the following additional rules apply: "R" - restartA restart refers to the repetition of an object's execution. This action differs from a new start in some parts., "A" - abnormal end, "X" - Job Messenger stop and "J" - job reportA report provides more detailed information about a task's execution or a component. from the RSM system.

TXT

This text is subsequently output at the beginning of the job report and in the statusThis represents the condition of a task (such as active, blocked, generating). text's detail window.

Note that the parameter TXT= is limited to 32 characters. Use blanks for the first 8 digits because they are reserved for the Automation EngineThis component drives an Automation Engine system and consists of different types of server processes.. All other digits can be used for your individual text.

Some Job Messengers have additional start parameters:

Operating system

Parameter

Description

GCOS8

RFN

The job report's file name.

 

SNM

The job's sequential number.

 

SW

The status of the Job Messenger.

 

TIMEOUT

The period in seconds after which a timeout occurs for the connection between 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 and the Job Messenger (default value: 60).

z/OS

STP

The logging of step return codes.

"0" - No logging (default value) is made.
"1" - The Job Messenger records return codes.

 

RETRY

The number of connection attempts (default value: 4).

 

WAIT

The time interval between the individual connection attempts (default value: 30 seconds).

OS/400 OUT

The Job Messenger's message logging.

"0" - No logging (default) is made.
"1" - The job report also includes Job Messenger messages.

UNIX and VMS

RETRY

The number of connection attempts.

Default value: 3 for UNIX and VMS

 

TIMEOUT

The period in seconds after which a timeout occurs for the connection between the agent and the Job Messenger (default value: 60).

 

WAIT

The time interval between the individual connection attempts.

Default value: 120 seconds for UNIX and VMS 120.

UNIX and Windows CMD

The command that should be processed on the agent's computer.

Within this command, you can also use passwords that have been encrypted by using a PromptSet objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task. To do so, you must specify the PromptSet variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. that includes the value of the encrypted PromptSet text field. The Job Messenger automatically identifies and decrypts the passwords.

Note that the Job Messenger does NOT decrypt passwords that have been encrypted by using UCYBCRYP.EXE.

You use the message call in the Process tab of the jobs.
An example for Windows:
&UC_JOBMD CMD="ping localhost"

 

See also:

Job Includes

 


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

Copyright © 2016 Automic Software GmbH