Add Arguments to the Command Line for a CimView Shortcut

About this task

You can create a Windows shortcut on the desktop, in folders, or in the Start menu as a convenient way to run CimView. Command line arguments can be added after creating the shortcut to configure how Cimview runs.

  • Create a CimView shortcut.
  • Add arguments to the command line for a CimView shortcut.

Create a CimView shortcut in the Windows Start menu

Procedure

  1. Right-click the Windows Start menu. Select Explore All Users.
  2. An Explorer window opens. Expand the Start Menu folder under All Users.
  3. Expand the Programs folder. Double-click the folder for the program group from which you want to launch Cimview.
    Note: The example below shows how to add a Cimview shortcut to the Startup program group, but you can add a Cimview shortcut to any program group or create a folder for a new program group that will appear whenever you use the Start menu.
    CAUTION: Adding a CimView shortcut to the Startup group causes CimView to run automatically whenever you start your computer. Configure System Boot Options correctly when launching CimView at system startup.
  4. In the right pane of the Explorer window you will see the startup programs, if any. Right-click in that pane and select New > Shortcut from the pop-up menu.
  5. A Browse dialog box appears. Navigate to the folder where your CimView screen is located and expand the that folder.
  6. Select a CimView file and click OK.
  7. The Create Shortcut dialog box appears. Click Next to name the shortcut and then click Finish.

    Result: The new shortcut appears in the selected folder.

    Once you have created a shortcut for a CimView screen, you can add arguments to its command line to control user access.

    To add arguments to the command line for a CimView shortcut

  8. Select Properties... from the shortcut's menu.

    The Shortcut to <screen_name> Properties dialog opens.

  9. At the start of the Target field, before the target pathname, insert C imView.exe followed by the option (or options) you want.

    Example

    If you have created a primary screen for a project (myproj.gef), your initial screen is ini.cim , and you do not want users to exit that screen, you can change the command line for the screen's CimView icon:

    From

    C:\cimplicity\myproj\ini.cim

    to

    cimview.exe /waitforproject myproj /noexit C:\cimplicity\myproj\ini.cim

    Note: The /waiforproject argument has been added to insure that the project being viewed has completed its startup. This assumes that CIMPLICITY System Boot Options have been configured to automatically load the relevant project when the system boots up. When boot options have been set to run as a viewer, The /wait argument should be used instead. The /waitforproject or /wait argument can be omitted if you are added the shortcut to a program group other than Startup and you are sure the project associated with this screen is running already.

  10. Click OK to save your changes and exit the dialog.

    You can also use the command line to start multiple CimView screens from a single shortcut. When you do this and use a command line option that affects the primary window, the first file in the list is designated as the primary window. For example, if you use /alwaysmaximized, the first screen in the list is maximized, and all other screens are displayed in their normal windows.