Mainframe Action Documentation

Mainframe actions are exposed in the Mainframe Automation framework in Quality 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 Quality 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.

QuickStart Mainframe Test Automation

To learn how you can quickly get started with Mainframe Automation in Quality Modeller, check out our QuickStart guide: QuickStart Mainframe Automation

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.

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

Mainframe 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.

Related articles