User Guide > Objects > Alphabetical Listing > Console Tab

Console Tab

The Console tab is objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task-type specific and it is only available in "Event" objects. It can be used to define the conditions of particular eventAction that is triggered if particular conditions apply. It can be an Automation Engine object type or an entry in a Policy Orchestrator EventBase. types.

Object: Event
Object class:
Executable object
Object type (short name):
EVNT

Event type "Console" currently supports the monitoring of:

The event monitors the target system according to the specifications made in this tab. The scriptA particular Automation Engine object type. statements and functions that are specified in the !Process tab are executed if conditions such as the Event IDFirst RunID of FileSystem and Console Events in the Automation Engine. Both Event types require communication between the AE component and an Agent. They communicate via the first RunID. Otherwise, Event identification is no longer possible after the first log change. or message filter apply.

Occurring events of type "Console" are always in the statusThis represents the condition of a task (such as active, blocked, generating). "Sleeping."

Message filter specifications must always start with a wildcard character.

 


BS2000

[BS2000] [z/OS] [OS/400] [SAP] [Windows]

Description

Field/Control

Description

Event type Console

 

Host

Select 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 whose console output should be monitored. You can also specify an agent group.

Table

 

Message filter

Specify the console-output filter that should be searched.

You can use the wildcard charactersThese are placeholders for characters when you specify filters. ? stands for exactly one character, * for any number of characters. "*" and "?". "*" stands for any number of characters, "?" for one specific character.

Comments

In BS2000, you can monitor the console output. To do so, you must install the utility for the Console UCXEB2xU. It should run parallel to the BS2000 agent.

 


z/OS

[BS2000] [z/OS] [OS/400] [SAP] [Windows]

Description

Field/Control

Description

Event type Console

 

Host

Select the agent whose console output should be monitored. You can also specify an agent group.

System name

Specify a filter for the userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management.-defined system nameName of the Automation Engine instance to which a user is connected. that can be used to distinguish various OS instances.

Maximum 8 digits.

OS-Name

Set a filter for the OS name as defined by IBM. Currently, it is always "MVS."

Maximum 8 figures.

Table

 

Job name

Select a filter for a jobAn Automation Engine object type for a process that runs on a target system. name (maximum 32 characters).

You can use the wildcard characters "*" and "?". "*" stands for any number of characters, "?" for one specific character.

Message filter

Specify a filter for the console output (for example, *VOL01D*).

You can use the wildcard characters "*" and "?". "*" stands for any number of characters, "?" for one specific character.

Comments

In z/OS, you can monitor the console output (Multiple Console Support - MCS). To do so, you must install the Event Monitor UCXEMxx and start it with a corresponding entry in the z/OS agent's INI file.

 


OS/400

Description

Field/Control

Description

Event type Console

 

Host

Select the agent whose message queue should be monitored. You can also specify an agent group.

Message type

Specifies the message type.

Allowed  values:
"01" - Completion
"02" - Diagnostic
"04" - Informational
"05" - Inquiry
"06" - Sender's copy
"08" - Request
"10" - Request with prompting
"14" - Notify (handled exception)
"15" - Escape (handled exception)
"16" - Notify (unhandled exception)
"17" - Escape (unhandled exception)
"21" - Reply, not validity checked
"22" - Reply, validity checked
"23" - Reply, message default used
"24" - Reply, system default used
"25" - Reply, from system reply listShows entities in a grid view

Severity

Define the severity of the message.
Allowed values: "0" to "99"

Table

 

Message ID

Specify a filter for the message ID.

You can use the wildcard characters "*" and "?". "*" stands for any number of characters, "?" for one specific character.

Message filter

Specify a filter for the message text.

You can use the wildcard characters "*" and "?". "*" stands for any number of characters, "?" for one specific character.

Comments

In OS/400, you can monitor message queues. Use the OS/400 agent's INI file to define the particular message queue that should be monitored.

 


SAP

The SAP Console event distinguishes several data sources.

ABAP Event History

Description

Field/Control

Description

Event type Console

 

Host

Select an agent that is connected to the SAP system and whose events should be monitored. You can also specify an agent group.

Data source

The ABAP event history serves as the data source.

Table

 

Event ID

Filter for the name of the SAP ABAP event. 

You can use the wildcard characters "?" and "*". "?" for one specific character, "*" stands for any number of characters.

Event Parameter

Filter for the parameter of the SAP ABAP event.

You can use the wildcard characters "?" and "*". "?" for one specific character, "*" stands for or any number of characters.

Event Server

Filter for the batch-server name of the SAP ABAP event.

You can use the wildcard characters "?" and "*". "?" for one specific character, "*" stands for or any number of characters.

Comments

XBP 3.0 is required in order to monitor SAP events via the event type "Console."

The XBP interface version that is used must be specified in the SAP agent's Connection object.

The agent periodically polls the SAP system for occurred SAP events and reports them to the active Console events. The administrator can define the required interval in the variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. UC_HOSTCHAR_DEFAULT, key JOB_CHECKINTERVAL.

Note that as of version 8.00A, the SAP agent always uses the XBP interface. This includes that the SAP criteria profiles must be adjusted in order to ensure that the selected triggered events are logged in the Event History. Otherwise, the Console event cannot react.

Use the transaction SM64 in order to create a criteria profile for the Event History.

The script functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… GET_EVENT_INFO supplies additional information about the SAP event.

Java Event History  

Description

Field/Control

Description

Event-type Console

 

Host

Select an agent that is connected to the SAP system and whose events should be monitored. You can also specify an agent group.

Data source

The Java Event History serves as the data source.

Table

 

Event Type

Selection of a filter for the type of SAP Java Scheduler event.

The drop-down menu's content is retrieved from the variable UC_SAP_XJBP_EVENTTYPES which is 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. 0. The Variable object is supplied with all possible event types and should not be changed by users.

Event Parameter

Filter for the parameters of the SAP Java Scheduler event.

You can use the wildcard characters "*" and "?". "?" stands for exactly one, "*" for any number of characters.

Event Additional Parameter

Filter for additional parameters of the SAP Java Scheduler event.

You can use the wildcard characters "*" and "?". "?" stands for exactly one, "*" for any number of characters.

Comments

The agent periodically polls the SAP system for occurred SAP events and informs the active Console events. The administrator can define the interval in the variable UC_HOSTCHAR_DEFAULT, key JOB_CHECKINTERVAL.

The script function GET_EVENT_INFO supplies additional information about the SAP event.

XI Communication Channels

Description

Field/Control

Description

Event type Console

 

Host

Select an agent which is connected to the XI system whose communication channels should be monitored. You can also specify an agent group.

Login

Name of a Login object which contains the XI object.

Use different Login objects for SAP and XI systems if both are installed on the same hostComputer, target system.. Otherwise, the loginAn Automation Engine object type that stores account credentials used by agents on target systems. entry would not be unique.

The Login object overrules the user specified in the Connection object.

Data source

XI communication channels serve as data source.

Table

 

Channel

Filter for the communication channel.

You can use the wildcard character "*".

Partner

Filter for the partner.

You can use the wildcard character "*".

Service

Filter for the service.

You can use the wildcard character "*".

State

Filter for the status.

Possible values: "ERROR", "OK", "INACTIVE", "UNKNOWN" and "UNREGISTERED"

Activation stateThe state a package or a task currently is in.

Filter for the activation status.

Possible values: "STARTED" and "STOPPED"

Comments

The filter list describes the nominal status of one or several communication channels. An event is triggered for each communication channel that

No event is triggered if the communication channel meets the nominal condition when the Event object starts.

The script function GET_EVENT_INFO supplies additional information about the XI communication channel.


Windows

[BS2000] [z/OS] [OS/400] [SAP] [Windows]

Description

Field/Control

Description

Event type Console

 

Host

Select the agent whose event viewer should be monitored by Windows. You can also specify an agent group.

Type

Select the log that should be monitored from the list (system, security, applicationAn application is a software which helps a user to fulfill specific tasks. In the context of ARA see also: Application entity., directory service, DNS server or File Replication Service).

Source

Determine the Windows event's source.

Category

Enter the Windows event's category.

The category is defined by the source that has logged the event. It combines events of the same categorical value. Category names must be numbers.

No particular category is filtered if value "0" has been specified.

Table

 

Event-ID

Enter the Event ID of the Windows event.

No particular Event ID is filtered if value "0" has been specified.

Type

Select the Windows event's type from the list.

User

Specify a user to whom the Windows event should be assigned.

Message filter

Specify a filter for the description of the Windows event.

You can use the wildcard characters "*" and "?". "*" stands for any number of characters, "?" for one specific character.

Comments

In Windows, you can monitor the Windows Event Viewer. The first step that is required in order to react to particular messages is to analyze the event viewer. The required entries are provided in the event details. You can open them by double-clicking a line in the Windows Event Viewer.

In Microsoft Windows, message texts consist of static and variable parts. The event only supplies the variable message parts. If you use a message filter, the event only reacts if variable message parts are searched. Refer to the document that describes the script function GET_WIN_EVENT in order to obtain more detailed information about querying a variable message text.  

See also:

GET_CONSOLE
GET_WIN_EVENT
 

 


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

Copyright © 2016 Automic Software GmbH