---

pdm

Start Photon Desktop Manager

Syntax:

pdm  [-c] [-h] [-m] [-s server]

Options:

-c

Disable PDM Configuration dialog.

-h

Disable Desktop Help button.

-m

Disable Desktop Menu button.

-s server

Server node or device name to display PDM on.

Description:

The pdm utility (Photon Desktop Manager) gives you a quick and easy way to launch applications, navigate throughout your entire 9-console desktop, and customize your desktop environment.

The pdm program starts automatically when you start Photon with the ph command.

---

You can disable the automatic startup of pdm by setting the PHPDM_DISABLE environment variable to 1: export PHPDM_DISABLE=1

---

Configuring the desktop

To launch the PDM Configuration dialog, click on the Configuration tool icon on the left side of the Desktop Manager Toolbar. The following dialog appears:

The scroll list on the left shows you the application icons that are currently available in the folder named in the "Group Name" field.

When you select an application icon from the scroll list, its configuration information (name, command, etc.) is displayed in the dialog. When you first open the PDM Configuration dialog, an application icon called New is selected for you to set up.

The Configuration dialog lets you:

• add new application icons to a folder in the Taskbar
• update or delete existing application icons
• set up Jump Gates
• create new folders
• select backdrops for the workspace and World View
• select or disable a screen saver
• view or change the current graphics display configuration.

Adding an application icon

To add new application icons to an existing folder:

1. Select a folder from the Group Name field.
2. In the Application Name field, enter the name of the application you want to launch by icon.
3. In the Command field, enter the startup command and any startup options required to launch the application.

   If you're not sure where the executable file is stored, click on the Browse button to locate the file.

   ---

   If an icon is available for the application, it will be displayed automatically as soon as you click the Add button. If you want to change an application's icon or select a new one, click the Change Icon button.

   ---

4. Click Add.

   The icon you just added appears at the end of the scroll list and in the PDM Toolbar in the folder you selected from the Group Name field.

5. Click Ok.

---

You can use shell (sh) commands in the command field. For example, if you'd like to set up Voyager to run with a Socket manager on node 1, enter: sh -c "SOCK=1 voyager" This runs the QNX shell and then passes the Voyager command line as the -c option.

---

Deleting an application icon

To delete existing application icons:

1. In the Group Name field, select the folder containing the icon you want to delete.
2. In the scroll list, click on the icon you want to delete.
3. Click Delete.

   ---

   The icon isn't deleted until you click Ok. If you change your mind, click Cancel before you close the dialog.

   ---

4. Click Ok.

Updating startup options

To update an application's startup options:

1. In the Group Name field, select the folder containing the icon you want to update.
2. In the scroll list, click on the icon you want to update.
3. Make whatever changes you want (new startup command, new icon, etc.).
4. Click Update.
5. Click Ok.

Setting up a Jump Gate

To set up a Jump Gate:

1. Make sure the application icon called New is selected (green) in the scroll list.
2. Click on the Jump Gate toggle button.
3. Enter the name you want to appear on the Jump Gate icon. Try to use a short name (six characters or less will fit the width of the icon).
4. Enter the node number or device name of the remote machine you'll be linking to.

   ---

   To ensure speed, it's a good idea to enter a fully qualified path for the node number (e.g. //250/dev/photon).

   ---

5. Enter the userid you'll be using to access the remote machine.
6. Click Ok.

A Jump Gate icon with the name you just entered will appear in the Toolbar.

Creating a folder

To create a new folder:

1. Click on the Groups tab.
2. In the Group Name field, enter the name of the folder you want to create.
3. In the Group Icon Filename field, enter the name of the file to be used for storing all the icons to be associated with this folder. If you leave this field empty, pdm will fill it in for you.
4. Click Add.
5. You may now click on the Applications tab if you'd like to specify which application icons to add to your new folder.
6. When you're finished, click Ok.

Selecting a backdrop

To select a backdrop for the workspace or World View:

1. Click on the Backdrops tab. The current backdrop image and associated filename are displayed.
2. To change the backdrop in your workspace, click the Workspace button. To change the backdrop in your World View, click the World View button.
3. Select a filename from the scroll list - a sample representation of the backdrop appears in the window.
4. To adjust whether the selected backdrop should be tiled, select the appropriate option in the Backdrop Option area.
5. When you're finished, click Ok.

Selecting/Disabling a screen saver

To select or disable a screen saver:

1. Click on the Screen Savers tab.
2. Select a screen saver from the Screen Saver field.

   ---

   If you don't want to use a screen saver, select the Disable option in the Activation Time area.

   ---

3. To view the selected screen saver, click on the Test button but be careful not to move your mouse. Any movement of the mouse, no matter how slight, ends the test.
4. In the Activation Time field, select the number of seconds for which the monitor can remain idle before the screen saver appears.

   ---

   If your monitor supports Display Power Management Signaling (DPMS), and you've chosen the "blank screen" backdrop, the Enable DPMS button is enabled. DPMS reduces the power to the monitor from on to off in stages: on, standby, suspend, and off. The DPMS Options button displays a dialog that lets you set the time for those stages.

   ---

5. When you're finished, click Ok.

Viewing/Changing the graphics display configuration

To view or change the current graphics display configuration:

1. Click on the Display tab.
   The window displays the current settings for the graphics type, colors, graphics capabilities, and resolution.
2. If you'd like to change any of these settings, click on the Configure Display button.

   See "Changing the graphics resolution and color depth" in the Photon User's Guide for information about the Display Configuration dialog.

Files:

/usr/photon/pdm/

Directory containing files and images used with pdm.

$HOME/.photon/pdm/

Directory containing personal pdm configuration information.

Environment variables:

The pdm application makes use of the following environment variables, if set:

MAILVIEWER

Contains the name of the program to use when displaying mail. Defaults to mailx.

PHBIFF

Displays a message when new mail has arrived. It must be defined before Photon is started.

PHOTON

Contains the name of the Photon server to use.

PHPDM_DISABLE

Disables pdm in the ph startup script.

---