Skip to main content

NeoBatch In JAMS

Installing the NeoBatch Integration Pack​

To work with NeoBatch in JAMS, complete the following installations, then deploy an Agent to the NeoBatch Server.

On the NeoBatch Server:​
  • NeoBatch Add-on
  • JAMS Agent
note

The NeoBatch Server must be running NeoBatch Server Edition. Developer or Client editions of NeoBatch will not function with JAMS.

On the JAMS Clients that need to edit NeoBatch Jobs:​
  • NeoBatch Add-on
  • JAMS Client
note

If the JAMS Scheduler is installed on the NeoBatch Server, an Agent is not required.

Install the NeoBatch Integration Pack and JAMS Agent on the NeoBatch Server​

  • Run the JAMS Installer.
  • On the Feature Selection step, check the JAMS Agent and JAMS Add-on for NeoBatch components.
note

Un Checking components will uninstall those components.

note

The JAMS Server and NeoBatch Server should be running the same version of JAMS.

Install the JAMS Add-on for NeoBatch on JAMS Clients​

  • Run the JAMS Installer.
  • On the Feature Selection step, check the JAMS Client and JAMS Add-on for NeoBatch components.
note

Un Checking components will uninstall those components.

Deploy a JAMS Agent to the NeoBatch Server​

  1. Start the JAMS Client as an Administrator.
  2. Select the Agents shortcut from the menu.
  3. In the Agent Definitions view, select Add from the Control Bar to open the Add an Agent Definition dialog.
  4. In the dialog, give the new Agent a Name, select the Agent Type and Agent Platform, and if desired, a Description.
  5. Click OK to save the initial Agent definition. By default, JAMS will automatically open the full Agent Definition dialog after the Agent is initially saved.
  6. Set Agent Properties in the Agent Definition dialog, then Save and Close the Agent Definition dialog.
  7. In the Agent Definition view, select the Agent to be deployed.
  8. Select Deploy from the Control bar to open the Deploy JAMS Agent dialog.
  9. In the dialog, select the JAMS User that will be used when deploying the JAMS Agent.
    This user should have all necessary permissions to the defined NeoBatch Agent.
  10. Click OK.

Configuring NeoBatch Execution Methods​

Before creating Jobs with NeoBatch in JAMS, users must configure the NeoBatch Execution Methods. This will allow JAMS to connect to the NeoBatch Database when running Jobs.

  1. Run the JAMS Client as an administrator.
  2. Select the Execution Methods shortcut from the JAMS menu.
  3. Double-click the NeoBatchCatalog execution method to open the Execution Method Definition dialog.
  4. Select the Parameters tab, then double click on any parameter to open the Parameter Definition dialog.
  5. Configure the NeoBatch parameters as needed for the given NeoBatch environment:
ParameterDescription
NeoBatchClassNameAny alphanumeric string as determined by NeoBatch classes - the name of the mainframe class name that NeoBatch Jobs will run as.
NeoBatchDbConnectionStringThe connection string to the NeoBatch Database. Update this for the given environment.
NeoBatchSubmitAssemblyThe assembly used by NeoBatch. For example, (Alchemy.NeoBatch.Submit, Version=3.2.1.30, Culture=neutral, PublicKeyToken=722c951c23d7c1ea)

The NeoBatch Submit Assembly Version and Key Token can be found by running the following powershell script. Note that the PowerShell script should be edited to reflect the path to Alchemy.NeoBatch.Submit.dll for the given environment.

([system.reflection.assembly]::loadfile("c:\MyDLL.dll")).FullName

  1. Click the Save and Close button to finalize the changes.
  2. Repeat Steps 3-7 for the NeoBatchJcl execution method.

Creating NeoBatch Jobs in JAMS​

With the Execution Methods properly configured in JAMS, NeoBatch Jobs may be run by:

  • Using NeoBatchJcl to run JCL code directly in JAMS
  • Using NeoBatchCatalog to reference and run an existing Job in the NeoBatch catalog

Run JCL directly in JAMS​

  1. Select the desired folder for the NeoBatch Job, then ensure the Job Definitions tab is selected.
  2. Click the Add button from the Control Bar to open the Add a New JAMS Job Definition dialog.
  3. In the dialog, give the new Job a Name, Description (optional), and Execution Method.
    In this case, select NeoBatchJcl to create a NeoBatch JCL Job.
  4. By default, the full Job Definition dialog will open when the Job is initially saved. Click OK.
  5. The Job Definition dialog will open.
  6. Define Elements, Parameters, Security, Properties, and Documentation as desired.
note

An Execute As property should be configured with a user that has access to the NeoBatch Server.

  1. Paste or write the desired JCL code in the Source.
  2. Save and Close the Job definition.
note

Hosting JCL in JAMS allows users to use the JAMS Audit Trail to monitor JCL code changes.

Run a NeoBatch Job from the NeoBatch Catalog​

  1. Select the desired folder for the NeoBatch Job, then ensure the Job Definitions tab is selected.
  2. Click the Add button from the Control Bar to open the Add a New JAMS Job Definition dialog.
  3. In the dialog, give the new Job a Name, Description (optional), and Execution Method.
    In this case, select NeoBatchCatalog to create a NeoBatch Catalog Job.
  4. By default, the full Job Definition dialog will open when the Job is initially saved. Click OK.
  5. The Job Definition dialog will open.
  6. Define Elements, Parameters, Security, Properties, and Documentation as desired.
note

An Execute As property should be configured with a user that has access to the NeoBatch Server.

  1. In the Job Source, set the path to a desired NeoBatch Job Member in the NeoBatch Catalog. This Job will be run when the JAMS Job Runs.
  2. Save and Close the Job definition.