APPENDIX B USING CL COMMANDS WITH DOMINO FOR SYSTEM I


Appendix B Using CL Commands With Domino for System i
An alternative to managing your Domino environment using the iSeries Navigator GUI interface is using CL commands.

You start the command line interface by signing on to your system, such as from a 5250 emulator window on a workstation that is communicating with the system. To enter a command, type the command on any line following the symbol ===> and press Enter. To have the system prompt you for details of a command, type the command name (such as DSPSFWRSC) and press F4 instead of Enter.

The following are the most commonly used commands when managing your Domino environment using the command line interface.

Note Help is available for any command or keyword by pressing F1 when your cursor is on the command or keyword.

CFGDOMSVR

The Configure Domino Server command allows you to either set up a Domino server to run natively on your system, or completely remove an existing Domino server.

When configuring a Domino server, you have the option of setting up a first Domino server, or adding a Domino server to an existing Domino domain. For more information on either of these options, see Chapter 6 "Chapter 6 Setting Up a First Domino Server " and Chapter 8 "Setting up an additional Domino server."

You can set the following parameters when using the CFGDOMSVR command:


By pressing F10, you can set the following additional parameters:
To use the CFGDOMSVR command, you must have the following special authorities:
CHGDOMSVR

The Change Domino Server command allows you to change the configuration of an existing Domino server on your system. The following parameters can all be modified using the CHGDOMSVR command:


By pressing F10, you can modify the following additional parameters:
To use the CHGDOMSVR command, you need the following special authorities:
DLTLICPGM

The Delete Licensed Program command allows you to delete all of the objects that make up a licensed program. When using this command to delete the Domino software, you can choose to delete the entire product or specific options of the product.

To use the DLTLICPGM command, you must have *ALLOBJ special authority.

DSPDOMCSL

The Display Domino Console command provides a way to view the status and jobs of a Domino server. When using this command, you can not submit Domino subcommands to the Domino server.

To run this command, you must have either of the following:


DSPSFWRSC

The Display Software Resources command allows you to view, print, or write to an output file the list of installed software resources. This command is useful when verifying what software versions are already installed on your system. When you enter this command, you will see a display that lists the product ID, option, feature code, and a text description of each item. To see the library and release for each item, press F11.

ENDDOMSVR

The End Domino Server command allows you to stop a Domino server that is currently running. You can choose to stop all (*ALL) Domino servers on your system, or a specific Domino server. There are two additional options that allow you to stop a Domino server in a controlled manner, or immediately.


You can also choose whether or not to stop the Java Server Controller related to your Domino server when the server stops.

To stop a Domino server, you must have *JOBCTL special authority.

LODRUN

The Load and Run Media Program command is commonly used during the installation process of a software product. You can use this command to install a product from tape, diskette, or optical device.

To use the LODRUN command, you must have *SAVSYS special authority.

RUNDOMCMD

The Run Domino Command (RUNDOMCMD) runs a CL command in the context of a particular Domino server. This command sets up the environment that allows the command to be run whether the Domino server is active or not. The setup includes setting the PATH environment variable for the server, setting the directory for the job to the data directory of the server, and running the requested command under the QNOTES user profile.

Caution If you use RUNDOMCMD in batch, specifying BATCH(*YES), the RUNDOMCMD setup does not set the current working directory for the job to the server data directory. Instead, the home directory of the QNOTES user profile is used.

To use the RUNDOMCMD command, you must have either of the following:


RSTLICPGM

The Restore Licensed Program command provides a way to load a licensed program whether you are installing for the first time, updating to a new release of a product, or recovering from a lost or damaged state.

When using the RSTLICPGM command, you must specify a device to use to restore the data. The possible devices are:


To use the RSTLICPGM command, you must have *SECADM and *ALLOBJ special authorities.

SBMDOMCMD

The Submit Domino Command provides a way to submit Domino server commands to run on a Domino server on your system. Unless you redirect it, the output from a Domino server command is displayed on the Domino console.

When submitting a Domino server command, specify the name of the Domino server to which you want to submit the server command.

To use this command, you must have either of the following:


SETDOMENV

The Set Domino Environment command sets the operating system job environment to the context of particular Domino server. It sets the PATH environment variable, the active directory to the data directory, and can optionally switch to the user profile associated with the server. The server's product library is added to the library list of this job.

To use this command, you must have either of the following:


STRDOMSVR

The Start Domino Server command allows you to start a Domino server. You can choose to start all (*ALL) Domino servers on your system, or a specific Domino server. In addition, you can choose whether or not you want to activate the Java Server Controller when you start your Domino server.

To start a Domino server, you must have *JOBCTL special authority.

UPDDOMSVR

The Update Domino Server command allows you to update specific Domino servers to newer releases. You can update all servers, or select specific servers, allowing you to control which servers are configured for specific Domino releases.

There are two parameters for this command, SERVER and TORLS. The SERVER parameter allows you to update specific servers or all servers. The TORLS parameter allows you to specify the release to which you want these servers updated.

Do not library-qualify the UPDDOMSVR command. This ensures that the command associated with the primary release, which contains the most current version information, is used to update the Domino servers.

To use the UPDDOMSVR command, you must have *SECADM, *ALLOBJ, *JOBCTL and *IOSYSCFG special authorities.

WRKDOMCSL

The Work with Domino Console command provides a way to submit Domino server commands to a specific Domino server. When using the Domino console, you can immediately see the responses from the Domino server.

Only one job can be running the WRKDOMCSL command for a specific Domino server. Other jobs can use the Display Domino Console (DSPDOMCSL) command to view the console messages for the same server.

To use the WRKDOMCSL command, you must have either of the following:


WRKDOMSVR

The Work with Domino Servers command provides a way to manipulate certain aspects of the Domino servers on your system. From this display, you can do any of the following to one or more Domino servers:


A new function (F10) was added to the WRKDOMSVR command that allows you to sort the list of Domino servers in this display either alphabetically, or by the date the server was created.

The special authorities required to execute the different options on the WRKDOMSVR display vary from function to function.

WRKSBS

The Work with Subsystems command allows you to end a subsystem, display the subsystem description, and work with subsystem jobs. Before upgrading from a previous version of Domino, all Domino subsystems must be stopped. When stopping a subsystem, first attempt to stop it using *CNTRLD. If after 20 minutes the subsystem has not stopped, use the *IMMED option.