Introduction

JS7 offers a number of JS7 - Job Types including JS7 - Java Jobs, JS7 - JavaScript Jobs and Shell Jobs.

• Shell Jobs are started from an OS process by the JS7 Agent
• Any number of instances of a Shell Job can be executed in parallel.

JS7 - Job Environment Variables are available to Shell Jobs.

Using Script Languages

Shell jobs execute job scripts in any scripting language available from the OS.

Unix

Running Shell Scripts

Shell scripts can be written in any Shell available from the OS such as bash, ksh, zsh, dash etc. It is recommended to add a shebang to the first line of the script that indicates the Shell to be used:

#!/bin/bash

# alternative use for bash
#!/usr/bin/env bash

# frequently used shebangs
#!/bin/sh
#!/bin/ksh
#!/bin/zsh
#!/bin/dash

Running PowerShell Scripts

In order to directly run PowerShell® script code from a JS7 shell job script the recommended approach is to use a shebang like this:

#!/usr/bin/env pwsh
 
Write-Output "Hello"
Write-Output "world"

In addition, a PowerShell® script can be executed from a file that is in reach of the JS( Agent:

pwsh -NoLogo -NonInteractive -File some_powershell_script.ps1

Running Python Scripts

In order to directly run Python® script code from a JS7 shell job script the recommended approach is to use a shebang replacement like this:

#!/usr/bin/python
 
print("Hello")
print("world")

Alternatively a Python® script can be executed from a file that has to be located in reach of the JS7 Agent:

#!/usr/bin/bash

python hello.py

Running Node.js JavaScript

In order to directly run Node.js® script code from a JS7 shell job script, the recommended approach is to use a shebang that runs Node.js® as the interpreter of the script like this:

#!/usr/bin/node

var name = (process.env.name);
var num = parseInt(process.env.num);

console.log(name);
console.log(num);

Alternatively, a Node.js® script can be executed from a file that is located within reach of the JS7 Agent that runs the job:

node  /some/location/sample_Node.js

Windows

Running Shell Scripts

Any commands available from the Windows Shell can be used in a job script like this:

@echo off

echo hello world
hostname

This includes to call .bat and .cmd command files like this:

@echo off

call C:\Documents\hello.bat
call C:\Documents\world.cmd

Running PowerShell Scripts

In order to directly run PowerShell® script code from a JS7 shell job script the recommended approach is to use a shebang replacement like this:

@@findstr/v "^@@f.*&" "%~f0"|powershell.exe -&goto:eof

Write-Output "Hello" 
Write-Output "world" 

Note: PowerShell 5.1 frequently ships with the OS and makes use of powershell.exe. Later PowerShell releases use the pwsh.exe binary.

In addition, a PowerShell® script can be executed from a file that is located in reach of the JS7 Agent:

powershell.exe -NoLogo -NonInteractive -File some_powershell_script.ps1

Running Python Scripts

Python can be invoked to execute script code like this:

@@findstr/v "^@@f.*&" "%~f0"|python.exe -&goto:eof

print("Hello")
print("world")

Alternatively a Python® script can be executed from a file that has to be located in reach of the JS7 Agent:

python.exe hello.py

Running Node.js JavaScript

In order to directly run Node.js® script code from a JS7 shell job script, the recommended approach is to use a shebang that runs Node.js® as the interpreter of the script like this:

@@findstr/v "^@@f.*&" "%~f0"|node.exe -&goto:eof

var name = (process.env.name);
var num = parseInt(process.env.num);

console.log(name);
console.log(num);

Explanation:

• If you consider this shebang replacement somewhat cryptic then add it to JS7 - Script Includes which are easily referenced from shell jobs, e.g. by using
  ::!include <name-of-script-include>
• The node.exe executable as available from the Node.js® installation is executed by the shebang.

In addition, a Node.js® script can be executed from a file located with the JS7 Agent that implements the job:

node.exe C:\Users\Documents\sample_Node.js

Accessing Arguments

Passing Variables

Further Resources

How To

• JS7 - How to run Node.js JavaScript from Shell Jobs
• JS7 - How to run PowerShell scripts from jobs
• JS7 - How to run Python scripts from jobs

Links

How To ... Shell Jobs

How To ... Shell API