Mainframe3270

Change the timeout for connection in seconds.

Arguments

Examples

To give time for the mainframe screen to be "drawn" and receive the next commands, a "wait time" has been created, which by default is set to 0.5 seconds. This is a sleep applied AFTER the following keywords:

Arguments

• Execute Command
• Send Enter
• Send PF
• Write
• Write in position

If you want to change this value, just use this keyword passing the time in seconds.

Examples

To give the user time to see what is happening inside the mainframe, a "wait time after write" has been created, which by default is set to 0 seconds. This is a sleep applied AFTER sending a string in these keywords:

Arguments

• Write
• Write Bare
• Write in position
• Write Bare in position

If you want to change this value, just use this keyword passing the time in seconds.

Note: This keyword is useful for debug purpose

Examples

Disconnect from the host.

Delete the character under the cursor. If you want to delete a character that is in another position, simply pass the coordinates ypos / xpos.

Arguments

Co-ordinates are 1 based, as listed in the status area of the terminal.

Examples

Delete the entire content of a field at the current cursor location and positions the cursor at beginning of field. If you want to delete a field that is in another position, simply pass the coordinates ypos / xpos of any part in the field.

Arguments

Co-ordinates are 1 based, as listed in the status area of the terminal.

Examples

Execute a x3270 command.

Arguments

Examples

Move the cursor to the next input field. Equivalent to pressing the Tab key.

Move the cursor to the previous input field. Equivalent to pressing the Shift+Tab keys.

Create a connection to IBM3270 mainframe with the default port 23. To make a connection with the mainframe you only must inform the Host. You can pass the Logical Unit Name and the Port as optional.

Arguments

If you wish, you can provide further configuration data to extra_args. extra_args takes in a list, or a path to a file, containing x3270 command line options. Entries in the argfile can be on one line or multiple lines. Lines starting with "/docs/libraries/3rd-party-libraries/mainframe3270#" are considered comments.

# example_argfile_oneline.txt
--accepthostname myhost.com

# example_argfile_multiline.txt
--accepthostname myhost.com
# this is a comment
--charset french

Please make sure the arguments you are providing are available for your specific x3270 application and version.

Examples

Assert that all of the strings in a given list exist on the mainframe screen.

Arguments

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Assert that one of the strings in a given list exists on the mainframe screen.

Arguments

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Assert that the text displayed on the mainframe screen matches the given pattern.

Arguments

Pattern matching is similar to matching files in a shell, and it is always case sensitive. In the pattern, * matches anything and ? matches any single character.

Note that for this keyword the entire screen is considered a string. So if you want to search for the string "something" and it is somewhere other than at the beginning or end of the screen, it should be reported as follows: *something*

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Assert that a given string exists on the mainframe screen.

Arguments

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Asserts that the entered string appears the desired number of times on the mainframe screen.

Arguments

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Fails if string does not match pattern as a regular expression. Regular expression check is implemented using the Python re module. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.

Arguments

Backslash is an escape character in the test data, and possible backslashes in the pattern must thus be escaped with another backslash (e.g. \\d\\w+).

Fails if one of the strings in a given list exists on the mainframe screen. If one of the string are found, the keyword will raise a exception.

Arguments

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Assert that none of the strings in a given list exists on the mainframe screen. If one or more of the string are found, the keyword will raise a exception.

Arguments

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Assert that the text displayed on the mainframe screen does NOT match the given pattern.

Arguments

Pattern matching is similar to matching files in a shell, and it is always case sensitive. In the pattern, * matches anything and ? matches any single character.

Note that for this keyword the entire screen is considered a string. So if you want to search for the string "something" and it is somewhere other than at the beginning or end of the screen, it should be reported as follows: *something*

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Assert that a given string does NOT exists on the mainframe screen.

Arguments

The assertion is case sensitive. If you want it to be case insensitive, you can pass the argument ignore_case=True.

You can change the exception message by setting a custom string to error_message.

Examples

Fails if string does match pattern as a regular expression. Regular expression check is implemented using the Python re module. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.

Arguments

Backslash is an escape character in the test data, and possible backslashes in the pattern must thus be escaped with another backslash (e.g. \\d\\w+).

Get a string of length at screen co-ordinates ypos / xpos.

Arguments

Co-ordinates are 1 based, as listed in the status area of the terminal.

Example for read a string in the position y=8 / x=10 of a length 15:

Read the current screen and returns all content in one string.

This is useful if your automation scripts should take different routes depending on a message shown on the screen.

Examples

This keyword lets you change the keyword that runs on failure during test execution. The default is Take Screenshot, which is set on library import.

Arguments

You can set None to this keyword, if you do not want to run any keyword on failure.

Examples

Send an Enter to the screen.

Send a Program Function to the screen.

Arguments

Examples

Set a folder to keep the html files generated by the Take Screenshot keyword.

Arguments

Note that the folder needs to exist before running your automation scripts. Else the images will be stored in the ${OUTPUT DIR} set by robotframework.

Examples

Generate a screenshot of the IBM 3270 Mainframe in a html format. The default folder is the log folder of RobotFramework, if you want change see the Set Screenshot Folder.

Arguments

The Screenshot is printed in a iframe log, with the values of height=410 and width=670, you can change this values passing them to the keyword.

Examples

Wait until the screen is ready, the cursor has been positioned on a modifiable field, and the keyboard is unlocked.

Sometimes the server will "unlock" the keyboard but the screen will not yet be ready. In that case, an attempt to read or write to the screen will result in a 'E' keyboard status because we tried to read from a screen that is not ready yet.

Using this method tells the client to wait until a field is detected and the cursor has been positioned on it.

Wait until a string exists on the mainframe screen to perform the next step. If the string does not appear in 5 seconds, the keyword will raise an exception. You can define a different timeout.

Arguments

Examples

Send a string and Enter to the screen at the current cursor location.

Arguments

Examples

Send only the string to the screen at the current cursor location.

Arguments

Examples

Send only the string to the screen at screen co-ordinates ypos / xpos.

Arguments

Co-ordinates are 1 based, as listed in the status area of the terminal.

Examples

Send a string and Enter to the screen at screen co-ordinates ypos / xpos.

Arguments

Co-ordinates are 1 based, as listed in the status area of the terminal.

Examples