Connection Instructions
ID and Password:
  • Your assigned ID and password are included in the registration confirmation email
  • All IDs are activated on opening day of contest
  • Password issues after open day
  • 3 failed password attempts result in revoked ID
  • Self service password reset application is available
  • Use Master the Mainframe Slack Workspace to reset password
    Password Reset Instructions

Instructions for TN3270 connection to z/OS

Windows Vista TN3270 connection instructions
  • Using Vista TN3270

    If this is your first time using Vista TN3270,
    Start Vista TN3270 and click File -> New Session Ask
    If you have used the Vista TN3270 software before, you will automatically be brought to the Vista TN3270 - Start a New Terminal Session window.

    Alternatively, overtype with as shown below
    Observe IP address was entered and Terminal Model - Mod 4 was selected

    Click Connect. Once you see the following screen, you've successfully connected to z/OS.

  • Configuring Vista TN3270 for Model 4 (Mod 4)

    To change Vista TN3270 to a model 4 display, click Options -> Options.

    Next, select the Display tab at the top and click the Mod 4 radio button. Mod 4 enlarges the display to 43 Rows by 80 Columns from the Mod 2 default of 24 rows by 80 columns.

    After clicking Okay, Vista TN3270 should prompt you for a reconnect. Click OK.

    Once logged back into z/OS, you'll note the screen resolution has increased.

  • Vista TN3270 Keyboard and Keypad

    To change Vista TN3270 Keyboard, click icon as shown in picture below.
    To use the Vista TN3270 Keypad, click icon as shown in picture below

Windows wc3270 connection instructions

Launch the Wizard and enter 1 to Create a new session

Enter a unique session name, such as MtM

Enter as Host Name

Observe the Options which can be changed

To accept all default Options, enter to proceed

Enter Y to create session file and Y to create desktop shortcut

Now a shortcut icon appears on workstation desktop

Enter 8 to Quit

Note: Right click at top of wc3270 session - select properties to increase screen and font size

Linux x3270 connection instructions
  • Use Linux x3270

    To connect to z/OS TN3270 (TSO, ISPF, etc) from a Linux workstation x3270 client, first start the client.

    From a console command line, run “x3270”. This opens a new x3270 session window.

    Ensure that your client is set to "Model 4". Click Options -> Screen Size -> Model 4 (80x43).

    Click Connect at the top and in the "Enter Hostname" box, type in IP address for z/OS.

    Linux workstation x3270 client

    Then click Connect.

    At this point, you can rest assured that the connectivity to z/OS is functioning properly.
    Refer to the Part One challenge documentation for instructions on how to log onto z/OS.

MAC 3270 connection instructions
  • Option #1 - Brown University tn3270

    Thanks to Brown University: Download and Install Brown tn3270 for MAC

    Navigate to the folder that contains the tn3270 software and double-click the tn3270 X icon to start tn3270.
    You may see a prompt about the application being downloaded from the internet.
    Select Open.

  • Option #2 - x3270

    Thanks to our IT professional friend, David, at PlanetMVS:
    Download and Install x3270 for MAC

    In the new window, enter the IP address for the contest z/OS system as the hostname and a Window Title of your choosing.

    IP Address in example below must be replaced with

    Click on "Screen Format" and set the "Large Screen Size:" option to 43x80 (Model 4). Then click Okay.

    Select Open Connection. It may take a few seconds for the z/OS or z/VM welcome screen to appear.
    Once you see this screen, congratulations, you are connected!

  • The initial password must be changed during TSO/ISPF logon using a TN3270 session
  • Using SSH for initial z/OS access will fail due to SSH inability to change initial password
  • SSH password is the new password selected during TN3270 logon

Instructions for SSH connection to z/OS

Windows SSH client

Use your personal ID and password established during TN3270 connection for SSH ID and password

The password needs to be entered in lowercase

Option #1

Your Windows may have SSH available using the command prompt as follows:

First SSH attempt requires yes response to accept connection fingerprint

Successfully logon displays z/OS Unix command prompt as follows:

Option #2

If Windows is without SSH command, then use PuTTY

Enter IP address in Host Name (or IP address) box as shown:

Example Saved Sessions name is MtM, then Save, Load, and Open at bottom

The first time you connect to z/OS Unix, you will be see a Security Alert. Click Yes to continue.

Enter your personal ID and same password (lowercase) used for TN3270 logon as shown:

Successful logon display follows:

Linux SSH client

From a local terminal, run the command ssh z#####@
The first time you connect you will be prompted to verify the authenticity of the host. Enter “yes” to continue connecting.

The z##### after SSH command is informing SSH Server the ID to be used to authenticate.

You will be greeted with the following screen.

At this point, you can rest assured that SSH connectivity to z/OS is functioning properly.

MAC SSH client

From MAC command prompt, enter SSH command as shown in the Windows and Linux examples

Next: Part One - Readme