Running Python Scripts

JAMS provides three Execution Methods to let you easily run Python scripts. Each Execution Method is specific to the supported operating system. You will need to choose the appropriate one based on your environment.

The following Execution Methods are available:

• PythonSSH – Execute Python code on an SSH Agent.
• PythonUnix – Execute Python code on a Unix Agent.
• PythonWindows – Execute Python code on a Windows Agent or JAMS Scheduler.

Running Python Scripts on an SSH Agent

JAMS has an Execution Method to let you run Python code on an SSH Agent. With this Execution Method, you can copy and paste your code into the Job and have JAMS run it.

Before you Begin

• Ensure you have JAMS AgentX installed.
• Ensure Python is installed on the JAMS Agent.
• Ensure you have a JAMS Credential created to run the Job in JAMS. This Credential should have permissions to the relevant Agent. See Credentials for more information.

Using the PythonSSH Execution Method

1. Click Execution from the main menu.
2. Click Execution Methods.
3. Click the PythonSSH Execution Method to review its properties.
4. Click the Template tab.
5. Enter the location of the Python executable on the Agent. The default value of this is:
   

#!/usr/bin/env python 
<<JAMS.Source>>

6. Click Save.
7. Click Jobs from the main menu.
8. In the Folder Navigator, select a Folder where the Job will be saved.
9. Click Add to add a new Job.
10. In the Job Name field, enter a name for the Job.
11. In the Execution Method field, select PythonSSH.
12. Click Save and Continue to Edit.
13. On the Source tab, paste your Python code.
14. Click the Schedules tab.
15. As needed, schedule when the Job will run.
16. Click the Properties tab.
17. In the Agent field, select the JAMS Agent that will run the Job.
18. In the Execute As field, select the JAMS Credential that will be used to run the Job.
19. Click Save.

Running Python Scripts on a Unix Agent

JAMS has an Execution Method to let you run Python code in a Unix environment. With this Execution Method, you can copy and paste your code into the Job and have JAMS run it.

Before you Begin

• Ensure you have a JAMS AgentD installed. See JAMS AgentD for Linux/Unix for more information.
• Ensure Python is installed on the JAMS Agent.
• Ensure you have a JAMS Credential created to run the Job in JAMS. This credential should have permissions to the relevant Agent. See Credentials for more information.

Using the PythonUnix Execution Method

1. Click Execution from the main menu.
2. Click Execution Methods.
3. Click the PythonUnix Execution Method to review its properties.
4. Click the Template tab.
5. Enter the location of the Python executable on the Agent. The default value of this is:
   

#!/usr/bin/env python
<<JAMS.Source>>

6. Click Save.
7. Click Jobs from the main menu.
8. In the Folder Navigator, select a Folder where the Job will be saved.
9. Click Add to add a new Job.
10. In the Job Name field, enter a name for the Job.
11. In the Execution Method field, select PythonUnix.
12. Click Save and Continue to Edit.
13. On the Source tab, paste your Python code.
14. Click the Schedules tab.
15. As needed, schedule when the Job will run.
16. Click the Properties tab.
17. In the Agent field, select the JAMS Agent that will run the Job.
18. In the Execute As field, select the JAMS Credential that will be used to run the Job.
19. Click Save.

Running Python Scripts on Windows Agent

JAMS has an Execution Method to let you run Python code in a Windows environment. With this Execution Method, you can copy and paste your code into the Job and have JAMS run it.

You can also have your Python code in a separate .PY file and reference it within a JAMS Job by using the Command Execution Method. Both Execution Methods are described in the sections below.

Before you Begin

• Ensure you have a JAMS Windows Agent installed. See JAMS Agent for Windows for more information.
• Ensure Python (Python.exe) is installed on the JAMS Windows Agent or JAMS Scheduler.
• Ensure you have a JAMS Credential created to run the Job in JAMS.

Using the PythonWindows Execution Method

1. Click Execution from the main menu.
2. Click Execution Methods.
3. Click the PythonWindows Execution Method to review its properties.
4. Click the Properties tab.
5. From the list of properties, go to the Command property.
6. Update or verify the property that lists the location of the Python.exe on your JAMS Windows Agent or JAMS Scheduler. It will look similar to the following: C:\Users\MyAccount\AppData\Local\Programs\Python\Python314\python.exe "{0}". Ensure the "{0}" is included.
7. Click Save.
8. Click Jobs from the main menu.
9. In the Folder Navigator, select a Folder where the Job will be saved.
10. Click Add to add a new Job.
11. In the Job Name field, enter a name for the Job.
12. In the Execution Method field, select PythonWindows.
13. Click Save and Continue to Edit.
14. On the Source tab, paste your Python code.
15. Click the Schedules tab.
16. As needed, schedule when the Job will run.
17. Click the Properties tab.
18. In the Agent field, select the JAMS Agent that will run the Job. Leave it blank to have it run on the JAMS Scheduler.
19. In the Execute As field, select the JAMS Credential that will be used to run the Job.
20. Click Save.

Using the Command Execution Method to run Python Scripts on Windows

1. Click Jobs from the main menu.
2. In the Folder Navigator, select a Folder where the Job will be saved.
3. Click Add to add a new Job.
4. In the Job Name field, enter a name for the Job.
5. In the Execution Method field, select Command.
6. Click Save and Continue to Edit.
7. On the Source tab, paste your Python code. You will need to reference the location of the python.exe and .py files. It may look similar to the following:
   

c:\Users\MyAccount\AppData\Local\Programs\Python\Python314\python.exe c:\hello.py

8. Click the Schedules tab.
9. As needed, schedule when the Job will run.
10. Click the Properties tab.
11. In the Agent field, select the JAMS Agent that will run the Job. Leave it blank to have it run on the JAMS Scheduler.
12. In the Execute As field, select the JAMS Credential that will be used to run the Job.
13. Click Save.