                          ------ * ------
               CCSC Eastern 2020 Programming Contest
                 Instructions for running pc2team
                          ------ * ------

This document explains how to run the pc2team program you will use to submit
solutions and request clarifications during the contest.

Note that this document only explains how to start the pc2team program.
For information about how to *use* pc2team, see the PC2V9TeamGuide.pdf
document included in the zipfile.

IMPORTANT: Note that only *one* team member will be able to run pc2team.
That team member will need to submit solutions on behalf of the entire team.

###############################################################
         Instructions for Linux and Mac OS systems
###############################################################

IMPORTANT: You will need Java to be installed, and the "java" command must be
runnable from a command prompt (i.e., in the terminal).  We have tested the software
with Java 8, 11, and 12.

Open a terminal program.  In the terminal program, use "cd" (change directory)
to move into the directory created when you extracted the zipfile.  For example,
if you extracted the zipfile from within your home directory, you should be
able to run the following commands:

    cd $HOME
    cd pc2-9.1.7

If you extracted the zipfile somewhere else, you will need to use cd
comamnd(s) to enter the "pc2-9.1.7" directory created by extracting the
zipfile.

Verify that you're in the right directory by running the "ls" command.  The
directory listing should look something like this:

    bin   db.1  lib   packets  pc2v9.ini  README-ccsce.txt  VERSION
    data  doc   logs  pc2.ico  README     samps

The most important thing you should verify is the existence of the "pc2v9.ini"
file.

You should now be able to run pc2team as follows:

    bin/pc2team

Depending on whether the contest server is actually running, you may see an
"Unable to contact server" dialog.  In any case, you should see the login
window for pc2team.  If you do, that is a good sign, and you should be ready
to participate.

###############################################################
             Instructions for Windows systems
###############################################################

IMPORTANT: You will need Java to be installed, and the "java" command must be
runnable from a command prompt (i.e., in a cmd.exe window).  We have tested the
software with Java 8, 11, and 12.

[If you need to install Java, we recommend using the open source OpenJDK
distribution, which you can download from the following site:

    https://adoptopenjdk.net/installation.html

Note that if you just need to run the pc2team program, it is sufficient to
install the JRE rather than the full JDK.  If you want to be able to compile
Java programs, then you should download the JDK.]

Start a command prompt window.  (One way to do this if you are running Windows 10
is to type "cmd.exe" in the search box at the bottom of the screen, and
click on the "Command Prompt" app when it appears.)

Use the "cd" command to change directory to the location where you extracted the
zipfile.  For example, if you extracted the zipfile in the root directory of your
D: drive, your commands would be

    d:
    cd \pc2-9.1.7

You can verify that you are in the correct directory by running the "dir" command.
You should see output similar to the following:

     Volume in drive D has no label.
     Volume Serial Number is FDC9-3C85
    
     Directory of D:\pc2-9.1.7
    
    10/15/2020  03:15 PM    <DIR>          .
    10/15/2020  03:15 PM    <DIR>          ..
    09/22/2014  12:39 AM               280 README
    10/15/2020  02:28 PM               373 pc2v9.ini
    09/22/2014  12:39 AM               766 pc2.ico
    10/15/2020  02:59 PM             3,268 README-ccsce.txt
    09/22/2014  12:40 AM               106 VERSION
    10/15/2020  02:20 PM    <DIR>          packets
    09/22/2014  12:40 AM    <DIR>          lib
    10/15/2020  02:20 PM    <DIR>          logs
    09/22/2014  12:40 AM    <DIR>          samps
    09/22/2014  12:40 AM    <DIR>          doc
    10/15/2020  02:20 PM    <DIR>          db.1
    10/15/2020  02:43 PM    <DIR>          bin
    09/22/2014  12:40 AM    <DIR>          data
                   5 File(s)          4,793 bytes
                  10 Dir(s)  14,860,959,744 bytes free

Now you should be able to run the pc2team program using the following command:

    bin\pc2team.bat

Depending on whether the contest server is actually running, you may see an
"Unable to contact server" dialog.  In any case, you should see the login
window for pc2team.  If you do, that is a good sign, and you should be ready
to participate.
