QuickStart Mainframe Test Automation

To learn how you can quickly get started with Mainframe Automation in Test Modeller, check out our YouTube series: https://www.youtube.com/watch?v=BP-Sv9lXR08&list=PLd_AqXM4vM-B_hctuFcjzWkq8djU274cM

Mainframe actions are exposed in the Mainframe Automation framework in Test Modeller. The corresponding Git repository is available https://github.com/CuriositySoftwareIreland/TestModeller_MainframeAutomation . This uses Jagacy with Java as the underlying automation technology.

When the framework is imported into Test Modeller the actions below are available in the 'MainframeCommands' module. This provides an accelerator for automating common actions on Mainframe (3270) applications. This class can be extended to incorporate your own keywords and actions as necessary.

Library Usage

In order to use the library actions you need to firstly open a connection to the mainframe environment. To do this you can use the command 'Open Connection' with the parameter of the location of the application. E.g.

Set Terminal("")
Set Device Name("")
Set SSL (true)
Set Context ("")
Open Connection ("host", port)
CODE

Desktop Actions

Set SSL (Boolean ssl)

Arguments

ssl - Enable / Disable SSL state for connecting.

Documentation

Set SSL enabled (true) or disabled (false)

Set SSL Context (String sslContext)

Arguments

sslContext - Context of SSL

Documentation

Set SSL Context.

Set Terminal Type (String terminal)

Arguments

terminal - Type of terminal to use for connection.

Documentation

Set the type of terminal being consumed.

Set Device Name (String deviceName)

Arguments

deviceName - LU name

Documentation

Set the LU Name of the device.

Open Connection (String host, String port)

Arguments

host - Host connection.

port - Port to connect over.

Documentation

Open Connection to the mainframe environment.

Wait For Text (String text)

Arguments

text - Text to wait to appear in the termal

Documentation

Wait for text to appear in the terminal output.

Wait For Change (int length)

Arguments

length - Length of time in seconds to wait for the terminal output to update.

Documentation

Wait for the terminal output to update.

Wait For Text (int row, int col, String text)

Arguments

row - Row

col - Column

text - Text to wait to appear at the specified location.

Documentation

Wait for text to appear at the specified location in the terminal window.

Enter Text (int row, int col, String text)

Arguments

row - Row

col - Column

text - Text to enter at the specified location

Documentation

Enter text at a specified location on the terminal window.

Enter Text (String text)

Arguments

text - Text to enter

Documentation

Enter text into the terminal window in the selected field.

Assert Text Present (int row, int col, String text)

Arguments

row - Row

col - Column

text - Text to assert is present at the specified location

Documentation

Assert text is present at a specified location in the terminal output.

Assert Text Present (String text)

Arguments

text - Text to assert is present

Documentation

Assert text is present in the terminal output.

Enter PF Command (String fNumber)

Arguments

fNumber - Number of the PF command to enter

Documentation

Enter PF command into the terminal.

Enter PA Command (String paNumber)

Arguments

paNumber - Number of the PA command to enter.

Documentation

Enter PA command into the terminal.

Type Enter

Documentation

Press Enter command.

Type Tab

Documentation

Press Tab command.

Type Clear

Documentation

Press Clear command.

Type Home

Documentation

Press Home command.

Capture Screenshot

Documentation

Capture screenshot.

Capture Screenshot (String message)

Documentation

Capture screenshot with specified message.