Mainframe Action Documentation
    • Dark
      Light

    Mainframe Action Documentation

    • Dark
      Light

    Article summary

    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.

    QuickStart Mainframe Test Automation

    To learn how you can quickly get started with Mainframe Automation in Test 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.