Planimate command line options

PLANIMAT <modelname>

Will cause Planimate to load the model. If the model is not set to "Run On Load" then Planimate will be in the default edit mode.

The following command line options may be added:

/RUN Starts the model running.
/INIFILE=<filename> Specifies an INI file to use for file name mapping
/BATCH Runs without graphics or a window (see related note idba://./86)
/SAVEONEXIT Forces save of MDL when exitting (if available, N/A for application EXEs)
/SCENARIO=<filename> Loads a dataset into the model
/MAXIMISE or /MAX Maximises window to fit desktop
/LOGIN Enables Planimate to be run under different user credentials to the user launching it
/SHARES Enables shares to be mapped when running with different user credentials (/LOGIN)
/JOBID="xx" Sets the "jobid" field in XML packets.


The /LOGIN option

Planimate can run in a different user account than the user that launches it. This means Planimate can have access to resources and data which the user cannot access from explorer.

This works as follows:

The shortcut which launches Planimate needs to include the /LOGIN=filespec command line option, where filespec points to a password file. This file is generated using the ODBC Password Generator EXE (mentioned in release notes for 4.91J)

The generator EXE is used to create an encrypted file for Planimate containing the username and password of an account on the local machine to use. If a domain controller is used, the username entered in the password generator can be of the form "user@domain"

If /LOGIN is used and there is a problem opening the file or verifying the password, an error will be given and Planimate will close.

Under Win2000, the user account which launches Planimate must have SE_TCB_NAME privilege and in some cases SE_CHANGE_NOTIFY_NAME as well. The target account must have SE_LOGON_INTERACTIVE privilege.

The /SHARE option

When /LOGIN is used to run a PL session in a different user account, it causes a new user context to be set up which will not have any of the shared drives of the original account mapped.

PL can perform this mapping process using /SHARES=<ini file name>

The file spec specified can be the model INI file (but does not need to be). The file should have a section called [shares] and within that, one or more local drive / network name pairs, both in double quotes.

example:

[shares]
"o:" "\\laptop\work1"
"p:" "\\pippa\media"

If any of the shares fail to map, PL will give an error and not load.

Note on Batch Runs

Batch runs require that the model automatically exit when it is complete. A forced quit Exit can be used for this. Add an [EXIT] object configured with a stop count of 1, stop mode "Stop All Runs And Quit". The Exit options "Show Objects Window" and "Display Message" should be off.

Arrange for an item to enter this exit object once the run has completed. This could be triggered by a broadcast (eg: _run Pause) or somewhere in the model which knows things are finished.

The "jobid" field

This is a field in xml packets sent by PL; useful when determining where a packet has come from. Currently PL does not read this field; its useful when an external server is co-ordinating PL runs.

---

idkbase note 104