JMX Jobs

{"URL":["/*.*/awa/pa_view_JOBS_JMX"],"heroDescriptionIdentifier":"ice_jmx_jobs","customCards":[{"id":"ice_jmxjob_defining","title":"Defining JMX Jobs","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job_JMX.htm","languages":["en-us"]},{"id":"ice_jmx_attributes","title":"JXM Job Attributes","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job_Attributes_JMX.htm","languages":["en-us"]},{"id":"ice_attributes_alljobs","title":"Attributes for all Job Types","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job_Attributes_All.htm","languages":["en-us"]},{"id":"ice_registered_job_output","title":"Registered Job Output","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_Job_RegisteredOutput.htm","languages":["en-us"]},{"id":"ice_scripting_and_the_ae_scripting_language","title":"The Automation Engine Scripting Language","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Writing/AE_Scripting_Language.htm","languages":["en-us"]},{"id":"ice_jcl_for_jmx","title":"JCL for JMX","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/Script/Reference/JCL_JMX.htm","languages":["en-us"]},{"id":"ice_jobs_overview","title":"About Job Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job.htm","languages":["en-us"]},{"id":"ice_jobs_workingwith","title":"Working with Job Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_job.htm","languages":["en-us"]},{"id":"ice_working_with_objects","title":"Working with Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/obj_WorkingWithOverview.htm","languages":["en-us"]},{"id":"ice_job_executing","title":"Executing Jobs","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Executions/Exec_Jobs.htm","languages":["en-us"]},{"id":"ice_ExecutingObjects","title":"Executing Objects","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Executions/obj_Executing_overview.htm","languages":["en-us"]},{"id":"ice_jobs_monitoring","title":"Monitoring Jobs","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/ProcMonitoring/JOBSMonitor/PM_MonitoringJobsOverview.htm","languages":["en-us"]},{"id":"ice_monitoringtasks_overview","title":"Monitoring Tasks","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/ProcMonitoring/PM_MonitoringTasksOverview.htm","languages":["en-us"]},{"id":"ice_ExecutionData","title":"Execution Data","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Executions_Overview.htm","languages":["en-us"]},{"id":"ice_jobreports","title":"Job Reports","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Reports_Jobs.htm","languages":["en-us"]},{"id":"ice_ReportsOverview","title":"Understanding the Reports","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Reports_Overview.htm","languages":["en-us"]},{"id":"ice_reportsview_workingwith","title":"Reports Window","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Reports/Reports_Window.htm","languages":["en-us"]},{"id":"ice_AWIs_CommonFunctions","title":"Common Functions","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/CommonFunctions/CF_OverviewOfChapter.htm","languages":["en-us"]},{"id":"ice_UnderstandingPA","title":"Understanding the Process Assembly Perspective","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/AWA/Objects/ProcessAssembly.htm","languages":["en-us"]},{"id":"ice_Overview_AWI","title":"Understanding the User Interface","type":"customize","url":"https://docs.automic.com/documentation/webhelp/english/ALL/components/DOCU/*.*/Automic%20Automation%20Guides/Content/_Common/GettingStarted/GS_OverviewAWI.htm","languages":["en-us"]}]}

If your Automic Automation system is integrated with JMX through the Java EE/JMX Agent, you can use JMX Jobs to run scripts on JMX platforms. The JMX Agent interprets and transforms the commands sent by the Client so that JMX understands them.

Prerequisites:

  • The JMX Agent is active
  • The JMX Agent is assigned to the job on the Attributes page
  • The Job has a Login (LOGIN) object assigned that contains the credentials to log in to the JMX system

Defining JMX Jobs

An JMX Job definition is made up of the following pages:

Server Settings Section

jmx jobs
  • MBean Server: Local Java VM

    Select this option if the MBean server is on the same computer as the JMX agent and select the server to be used from the Server Connection dropdown list.

    The options are:

    • Use any existing MBean Server

      If you select this option, an arbitrary MBean server is retrieved automatically.

      The option Create new instance if not found is displayed.

    • Specify MBean Server

      Select this option if you want to specify the agent that will process the JMX jobs and enter it in the Agent ID field. It can contain up to 20 characters.

    • Via JNDI

      Select this option if the connection is established to a local MBean server that is located in an SAP Java EE server.

      The Object Name field is displayed, where you enter the name of the object that will be called. It can contain up to 22 characters.

  • MBean Server: Remote Java VM

    Select this option if the MBean server is on a different computer than tn the JMX agent an specify it using the following options:

    • Initial Context Factory

      Depending on the vendor of the MBean server, you might need to enter a value here.

    • Server URL

      URL of the computer on which the MBean server is located.

Job Report Section

For information on the Job Report section, see Job Reports.

JMX Commands

JMX Jobs contain sets of predefined commands. A command is a group of JMX-specific strings or functions. You build the logic of an JMX Job on its Process page by adding commands to it. The JMX Process pages contain an additional view called Forms, an intuitive and user-friendly way of depicting the values in a particular command. The Form view of a command can contain dropdown lists, input fields, radio buttons, and so on. For more information, see Process Pages and Forms View on the Process Page

Creating JMX Jobs with Oracle

  1. Select Remote Java VM .
  2. Enter weblogic in the Initial Context Factory field.
  3. Enter the URL with the following format:

    t3://name of the Weblogic server:port of the Weblogic server

Creating JMX Jobs with IBM WebSphere

To create Jobs using the RMI connector:

  1. Select Remote Java VM .
  2. Enter websphere in the Initial Context Factory field.
  3. Enter the URL with the following format:

    Host name of the WebSphere:port of BOOTSTRAP_ADDRESS

To create Jobs using the SOAP connector, that is, WebSphere with activated administrative security:

  1. Select Remote Java VM .
  2. Enter websphere in the Initial Context Factory field.

    Important! As of WebSphere version 7, there is the option to not include any settings in the [WEBSPHERE] INI file section. In this case, you must enter websphere soap in the Initial Context Factory field.

  3. Enter the URL with the following format:

    Host name of the WebSphere:SOAP port

    Retrieve the port number as follows:

    1. Log on to the administrator console.
    2. Click on Servers > Application server.
    3. Click on your server.
    4. Select Transfers > Ports.

      Use the port number shown here in the URL. The SOAP port's default value is 8880

    5. Return to the Automic Web Interface and specify the three passwords in the job's Login object: User, Keystore and Truststore.

Important! The SOAP connector must be activated. Its port is usually 8880.

Creating JMX Jobs with JBoss

  1. Select Local Java VM.
  2. Select Use existing MB Server

    It is not necessary to activate the Create new instance if not found option.

Creating JMX Jobs with Oracle Containers for Java EE

  1. Select Remote Java VM .
  2. Enter oc4j in the Initial Context Factory field.
  3. Enter the URL with the following format:

    service:jmx:rmi://Host name of the Java EE server:port/oc4j

Creating JMX Jobs with SAP Netweaver

  1. Select JNDI.
  2. Enter jmx in Object Name.

Creating JMX Jobs if the JMX Agent Runs Outside an Application Server

  1. Select Local Java VM.
  2. Activate both Use existing MBean Server and Create new instance.

See also:

Jobs (JOBS)