JAMS 7.x Help
Execution Methods

An Execution Method defines how a Job executes within the JAMS environment. A default Execution Method is assigned to every Job if one is not specifically assigned.

JAMS ships with dozens of Executions Methods to run Jobs on Windows, Unix, Linux, OpenVMS, or any operating system supporting connections using SSH or REXEC.

In addition to the preconfigured Execution Methods that ship with JAMS, users can create and customize their own Execution Methods.

Creating a Custom an Execution Method entails a two-step process: creating the Execution Method, and then modifying its properties. Both are described in detail below.  

 

Creating a New Execution Method

  1. To create a new Execution Method, open the Execution Methods view from the Shortcut bar.
  2. Click the Add button in the Control Bar to open the Add an Execution Method dialog.
  3. Define a Name for the new Execution Method.
    NOTE: The name must be unique to existing Execution Methods.
  4. If desired, give the Execution Method a Description.
  5. Select a Base Execution Method from the drop-down list.
  6. By default, the full Job Definition dialog will open when the Job is initially saved. Click OK.
  7. The Job Definition dialog will open. Define the Execution Method, Template, Parameters, Properties, and Job Properties as desired.
  8. When the Execution Method is configured as desired, Save and Close.

 

Modify an Existing Execution Method

  1. To make changes to an existing Execution Method, open its Execution Method Definition dialog from the Execution Methods View.
    To open the Execution Method Definition dialog, users may Double-Click the execution method, Select the Execution Method and then click the Properties button in the Control Bar, or Right-click and select Properties from the Method Options menu.
  2. The Execution Method Definition dialog appears.
  3. Modify the Execution Method, Template, Parameters, Properties, and Job Properties asdesired.
  4. When the Execution Method has been reconfigured as desired, click Save and Close.

Delete an Existing Execution Method

  1. Open the Execution Methods view from the Shortcut bar.
  2. Select the desired Execution Method, then click the Delete button in the Control Bar, or Right-Click the desired Execution Method, then select Delete from the Method Options menu.
  3. A dialog will appear to confim the Execution Method deletion. If the desired Execution Method was selected for deletion, click Yes. If the incorrect Execution Method was selected, click No or Cancel.

 

Execution Method Definition Tabs

Execution Method

This tab contains the basic information about the Execution Method.

Parameters

Execution Method parameters work the same way as Parameters within Job definitions and apply to all Jobs using this Execution Method. To insert a new Parameter, select the Add button on the Parameters tab to access the Add a Parameter dialog.

NOTE: if a Job has a Parameter with the same name as the Execution Method Parameter, the Job definition is used.

 

Template

Templates provide an easy way to include standard pre and post processing for your Jobs.
At submit time, JAMS parses a Job source using either the template defined on this tab or the module defined in the Job Module property for the Job’s source code. Use the built-in text editor to edit the template for this Execution Method.

The example below sets up a simple template that maps two network drives, inserts the Job’s source code and executes a LogJobComplete program:

LogJobComplete
Copy Code
NET USE E: \\MyServer\EShare
NET USE F: \\MyServer\FShare
<<JAMS.Current.Source>>
C:\LogJobComplete.exe <<JAMS.Job.JobName>>
Properties Table
Assemblies Properties Description
Edit Assembly Name The name of the assembly that contains the class used to edit the source for this execution method.
Edit Class Name The name of the class that implements IViewExecutingJob and IViewJobHistory and will be used to view Jobs that use this execution method.
Host Assembly Name The name of the assembly that contains the class used to host this execution method.
Host Class Name The name of the class that implements IJAMSHost and will host this execution method.
View Assembly Name The name of the class that implements IEditSource and will be used to edit the source for this Execution Method.
View Class Name The name of the assemly that contains the class used to view Jobs that use this execution method.
Execute Properties Description
Execution Type This dropdown allows you to choose the Execution Method type. The supported types are:
  • Agent runs a Job using a JAMS Agent.
  • Batch runs a Job by creating a process with a Job or Command.
  • Routine executes a Job using the specified class from a specified assembly using the IJAMSHost interface.
  • Rexec runs a Job by connecting to a rexec daemon.
  • SSH Agent executes a Job using a secure shell commands with JAMS AgentX.
Application This value is passed to the Win32 Create Process function as the value for the Application Name argument.
Command This value is passed to the Win32 Create Process function as the value for the Command Line argument.
Options Properties Description
Force 32bit When set to true, this Job will run as a 32 bit process, even on 64 bit machines.
Force V2 When set to true, this Job will run using V2.0 of the .NET Framework.
Host Locally Indicates that the Job should only be hosted by the machine running the JAMS Scheduler. This setting is used for Execution Methods that need to manage connection to the Agent machine. An example would be the SSH Execution Method which executes locally and uses SSH to connect to the Agent in order to run the actual job.
Interactive When enabled, this Execution Method can interact with the desktop. Caution: this setting is not recommended since it can lead to potential security issues. The Interactive property has been included here because some applications require access to the desktop in order run properly.
No BOM When set to true, the Job's source file will not have a Unicode byte order mark.
Run As Job When set to true, the Job will run as the user defined in the Job even when Host Locally is set to true.
Source Properties Description
Edit After Start When activated, this setting permits the source to be edited after a manually submitted Job has started.
Edit Source When activated, this checkbox permits the source to be edited when manually submitting the Job
Extension Specifies the default file extension for source code files
Job Module This is the name of a text module in the template library which is used as the starting point for parsing the Job's command procedure. Entering a value in this property implies that this Job is parsed.
The template library is a combination of the macros in the BaseMacros.xml file, the file specified in the "DefaultMacroFile" configuration setting and the macros in the xml file specified in the Job's Folder definition. The BaseMacros.xml file is replaced when installing a JAMS upgrade.
Snapshot Source If enabled, the option allows JAMS to grab a copy of the source when submitting a Job.
User Interface Description
Prompt The prompt that is displayed to a user when the Job is manually submitted.
Completion Properties Description
Bad Regex Pattern A regular expression pattern, matched in log file output, that indicates a failed execution.
Exit Code Handling Specifies how JAMS should evaluate a Job's exit code.
Good Regex Pattern A regular expression pattern, matched in log file outputs, that indicates a successful execution for this Job.
Specific Informational A comma separated list of integer values for Informational Job completion exit codes.
Specific Values A comma separated list of integer values for the Job completion exit codes based on the Exit Code Handling setting.
Specific Warning A comma separated list of integer values for Warning Job completion exit codes.

 

Predefined Execution Methods

JAMS ships with dozens of Predefined Execution Methods that can run a variety of Jobs on Windows, Linux, UNIX and and other operating systems detailed below.

Predefined Execution Methods Table 
Method Description OS
Banner Executes a Banner job Windows
BannerWin Executes a Banner job on Windows Windows
Command Used to run a Windows batch procedure Windows
CRJobV12  Crystal Reports Job using Crystal Reports version 12 Windows
CRJobV13 Crystal Reports Job using Crystal Reports version 13 Windows
File Transfer Defines a file Transfer (FTP, SFTP, or FTP/SSL) Windows
FileTransferV1 Defines a file Transfer (FTP, SFTP, or FTP/SSL) Replaces File Transfer from V6.4.51 and under Windows
File Watch Watches for a File Multiple
InformaticaCloud Executes an Informatica Cloud task. Windows
JAMS Report Generates a JAMS Report Windows
JDEJob Runs a J.D. Edwards job Windows
JDEJobSsh Runs a J.D. Edwards job on Linux via SSH Windows
Mail Watch Watches for an Email. Multiple
MF Job Executes a Micro Focus Job Windows
MSDAX2012Job Executes a Microsoft Dynamics AX job Windows
NeoBatchCatalog Executes a NeoBatch Job from a NeoBatch Catalog Windows
NeoBatchJcl Executes NeoBatch Job from JCL stored in JAMS Windows
NetezzaBackup Runs a Netezza backup job using SSH Unix, Linux
NetezzaLoad Runs a Netezza Load job using SSH Unix, Linux
NetezzaSQL Executes a Netezza Query job using SSH Unix, Linux
OdbcCommand Executes ODBC Commands Windows
OleDbCommand Executes OLEDB Commands Windows
OracleEBSConcurrent Runs an Oracle EBS Concurrent process AIX, HP-UX, Linux, Solaris
OracleEBSJobSsh Runs an Oracle E-Business Suite Job via SSH AIX, HP-UX, Linux, Solaris
OracleEBSRequestSet Executes an Oracle ES Set job AIX, HP-UX, Linux, Solaris
OracleStoredProc Executes an Oracle Stored Procedure Job AIX, HP-UX, Linux, Solaris
OS400 Runs IBM System i, OS/400 jobs IBM System i
PeopleSoftJobSsh Executes a PeopleSoft job using SSH PeopleSoft
PeopleSoftJobWindows Runs a PeopleSoft job on Windows PeopleSoft
PowerShell Runs a PoweShell script on Windows Windows
PowerShell32 Runs a PoweShell script (32 bit) Windows
SAPDataService Executes a SAP Business Objects Data Services Job SAP
SAPJobV2 Executes a SAP multi-step job SAP
SAPProcessChain Executes an SAP Process Chain SAP
Sequence A building-brick style interface to configure and run tasks such as Jobs and File Transfers in sequence or in parallel. Replaces V6.X Setups. Windows
SQLAgent Runs SQL Server Agent Job Windows
SQLCommand Runs SQL commands Windows
SQLStoredProc Executes an SQL Stored Procedure    Windows
SSH Runs a Secure Shell Any
SSHAgent Deploys JAMS AgentX using SSH AIX, HP-UX, Linux, Solaris
SSHDeploy Deploys JMAS AgentX using AgentX Windows
SSHOpenVMS Runs a Secure Shell with OpenVMS using prompt matching OpenVMS
SSHPrompt Runs a Secure Shell using prompt matching Any
SSIS Runs SQL Server Integration Services Windows
SSISDirect Runs SQL Server Integration Services Windows
SSRS SQL Server Reporting Services Windows
UnixScript Run a Unix Script based on the shebang on the first line Unix/Linux
UnixShell Run a shell script on a Unix Server. Unix/Linux
Vbs Executes a VB Script Windows
VMS Runs an OpenVMS DCL Command Procedure OpenVMS
VMSParsed Runs an OpenVMS DCL Command Parsed Procedure OpenVMS
WindowsDeploy Deploys a JAMS Agent to a Windows machine Windows
Workflow Runs a Windows Workflow job Windows
zOS Executes an IBM zOS job zOS

 

See Also

Dashboards and Reports

 

 


Topic updated: 7/23/2018
©2019 HelpSystems, LLC. All Rights Reserved.

Send comments on this topic.