Samples: Running the sample programs

After you download and modify the source code, you can run one of the samples.

Before modifying or running the samples, read the description of the sample programs.

To run a sample, you must start the server program first. The server program must be running and ready to receive connections before you start the client program. The server is ready to receive connections when you see listening on port <server_port>. Make sure to remember or write down the <server_port >, which is the port number that you need to specify when you start the client.

Use the following command to start a sample program:

     java [-Dproperty1=value1 ... -DpropertyN=valueN] com.ibm.security.jgss.test.<program> [options]

where

[-DpropertyN=valueN] is one or more optional Java™ properties, including the names of the configuration and policy files, JGSS debug options, and the security manager. For more information, see the following example and Running JGSS applications.
<program> is a required parameter that specifies the sample program that you want to run (either Client, Server, JAASClient, or JAASServer).
[options] is an optional parameter for the sample program that you want to run. To display a list of supported options, use the following command:
```
     java com.ibm.security.jgss.test.<program> -?
```

Note: Turn off the JAAS features in a JGSS-enabled sample by setting the Java property javax.security.auth.useSubjectCredsOnly to false. Of course, the default value of the JAAS-enabled samples is to turn on JAAS, meaning that the property value is true. The non-JAAS client and server programs set the property to false, unless you have explicitly set the property value.

Related information

You may want to read about related tasks or look at an example: