Knowledge Base > Automation Engine and Target Systems > SAP > SAP Solution Manager Integration

SAP Solution Manager Integration

You can use the SAP 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 to access an AE system with the SAP Solution Manager and read various information or manage processes in the AE system. This document explains the configurationA set of constituent components that make up a system. This includes information on how the components are connected including the settings applied. process and the details of this integration.

Some functions are not directly available in the Solution Manager but by setting up a specific integration, you can call the UserInterfaceThis is the Automation Engine's graphical user interface. [Formerly called the "Rich Client", "RichGUI" and "Dialog Client."] directly from the Solution Manager and quickly access these functions. For further details about the affected functions and how to configure the integration, see Setting up the UserInterface Integration.

Configuration

To use the SAP Solution Manager for AE, you must define the settings for the SMSE (Solution Manager Scheduling Enabler) inferface in the agent's Connection object. Then restartA restart refers to the repetition of an object's execution. This action differs from a new start in some parts. your SAP agent.

Note that you need a separate SAP agent for the SAP Solution Manager Integration.

In the Connection objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task of the SAP agent that should be used for the integration, start off by configuring a connection to the SAP system (CONN object: General -> Connection Parameter). Then complete all fields in the CONN object's Interfaces -> SMSE section:

Restart the agent and call the transaction EXTSDL in your SAP system. The RFC connection that you have defined in the Connection object should be listed and marked as the default connection. By clicking Connection Test, you can test whether you can successfully establish a connection to the Automation EngineThis component drives an Automation Engine system and consists of different types of server processes..

Functionality

When you have successfully completed the configuration process, you can run the following AE functions with the SAP Solution Manager:

Function Description
Reading clients This provides a listShows entities in a grid view of all an AE system's clients and their descriptions.
Canceling tasks

The available commands are cancel, stop, stop (recursive), go, go (recursive).

Retrieving the states of tasks This queries the statusThis represents the condition of a task (such as active, blocked, generating). of a certain activityAn activity (or task) is an entity that can be planned, assigned to a user or a team and tracked with respect to their plan and state (started, cancelled, suspended, completed)..
Reading folders

This supplies a list that includes the ID, the folderTop level entities such as Environment, Deployment Target, Activity, … are stored in folders. The permissions a user has on an entity depend on the permissions that are set on the folder for the entities. name, the folder title and the name of the superordinate folder.

If the name of the folder or the parentThere are different ways of activating objects. The originator of an activation is referred to as the superordinate task (parent). See also: Child; Children folder exceed a length of 80 characters, they will be truncated. The title has a maximum length of 255 characters. Special folders such as the Recycle Bin, Transport Case, <No Folder> etc. are not part of the list.

Retrieving a list of SAP systems This retrieves the name and the description of a certain client's SAP agents. The additional description contains the basic SAP version and the agent's Automation Engine version.
Querying a list of queues This queries the object name, the title and the max. slots of the queues.
Retrieving the executable object types This retrieves a list that includes the types and a description of the executable objects (such as CALL - notificationAn Automation Engine object type used to send messages to users and user groups. [Formerly called "CallOperator."]).
Retrieving the executable objects

This retrieves a list that includes the names and the object types of the executable objects.

You can specify a certain folder whose objects should be listed. You can also filter for the name or the object typeAn individual object is provided for the individual activities: There are User, UserGroup, Notification, Cockpit, CodeTable, Documentation, Event, Agent, FileTransfer, Group, Include, Job, Workflow, Calendar, Login, Client, RemoteTaskManager, Schedule, Script, Server, Sync, Variable and TimeZone objects.

Retrieving the status filter

This retrieves a list of status groups that are used to filter activitiesDeployment-related activities (such as ANY_OK or ANY_ABEND).

Querying a list of activities

This queries the content of the Activity Window of the particular client.

You can define a status filter and a sorting order (ascending or descending) in order to limit the results.

The time and date fields (such as the start time) are converted to UTC and displayed. The system assumes that the actual time zoneIt defines a local time. A particular Automation Engine object type. in AE complies with the local time zone.

Retrieving a taskAn executable object that is running. Tasks are also referred to as activities.'s list of reports

This provides a list that includes all a task's reports and outputs.

This lists contains the reportA report provides more detailed information about a task's execution or a component. type (such as REP or ACT) and the output type ("L" = jobAn Automation Engine object type for a process that runs on a target system. log, "S" = spool list, "A" = applicationAn application is a software which helps a user to fulfill specific tasks. In the context of ARA see also: Application entity. log, "O" = other).

Reading a report content This retrieves the report content of a task.
Retrieving the user of a task

This retrieves the name and the department of the user who has started the task.

It is read from the statistical details. If the name exceeds a length of 40 characters, it will be truncated.

Reading the prompt parameters of an object definition

The following parameters can be read:

-) The name of the PromptSet object
-) The reference variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type.
-) The type of the PromptSet elementFields/control elements that are used to query User values. They are the content of a PromptSet input mask. ("N" = number, "D" = timestamp, "S" = all other types)
-) The value of the PromptSet element
-) The property "Value required" ("X" = the option is set, " " = the option is not set or not known)
-) Whether an input assistant is available ("X" = yes, " " = no or not known)

Reading the parameters of a task This reads the name and the value of an activity's object and PromptSet variables (detail - object variablesPlaceholder for values that are stored in an object's "Variables & Prompts" tab/section.).
Creating or delete BAE events in AE

This creates or deletes BAE events as AE Sync objects.

The AE Sync objects that represent BAE events have the value "SMSE" as their archive key 1. This includes that you can search and filter for these specific objects. The Sync objects have only two states: CLEARED (initial stateThe state a package or a task currently is in.) and RAISED.

Reading BAE events from AE

This retrieves the Sync objects that represent BAE events (object type = SYNC, archive key 1 = SMSE).

You can filter for the object name.

Retrieving the status of BAE events

This is the current status of a Sync objectIt synchronizes executable objects based on defined states and actions. A particular Automation Engine object type. that represents a BAE eventAction that is triggered if particular conditions apply. It can be an Automation Engine object type or an entry in a Policy Orchestrator EventBase.. The Sync MonitorWindow which contains the state of a Sync object and the assigned tasks. is read for this purpose. The object title is returned as a description.

Possible values: R (RAISED) or C (CLEARED)

Querying BAE event instances This is a list of the tasks that wait for a Sync object that represent a BAE event. It is also read from the Sync Monitor.
Reading notifications

This reads the monitor of active or ended Notification objects.

The following details will be returned:
-) Subject
-) Possible answers
-) Message text
-) Activator (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 .)
-) Start time
-) Status (depending on the notification type. Alarm or request: "Q" = active, "R" = ended. message: "N" = active, "R" = ended)
-) Object type of the triggering object.

Reading the message text of notifications

This retrieves the message text of an active notification.

Input parameter: The RunID of the notification.

Confirming a notification

You can accept or reject an active notification.

Input parameter: The RunID of the notification.

Scheduling, changing and starting tasks

The following actions are possible:

-) to activate the task once or recurrently
-) to restart a task
-) to restart a task from its last restart point
-) to reschedule the task. If you change the activation of a task from recurrently to once, it will be rescheduled (new RunID).

These functions (except for "Reading clients") refer to the AE client that has been specified for the SMSE interface in the Connection object.

 

 


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

Copyright © 2016 Automic Software GmbH