Syntax



INSTANCE

INST


Instance-Name

[ END | CANCEL | CAN | KEEP    ]

[ -F [ FileOpen-FileName | * ] ]

[ -D DO-macroName              ]


Operands


Instance-Name

The name of the Instance to switch to.  It IS legal to 'switch' to the current running Instance.

If the instance is not running it will be opened. If it has never been created, the normal Instance creation popup will also be displayed.

END

If there are Edit tabs in existence, they will be closed via an END command and the SPFLite session terminated. The END command will utilize whatever AUTOSAVE options are in effect. The Most Recent Files list  (MRF List) will be updated so that the next restart will re-open the same files.

CANCEL | CAN

If there are other Edit tabs in existence, they will be closed via a  CANCEL  command, and the session terminated. The MRF list will be nulled, so no files will be automatically re-opened on the next restart.

KEEP

All current tabs will be untouched, and the current session will remain open. All that will happen is the startup of the named Instance-Name. (using any -F or -D options)

-F 

This can specify a filename or a single *. The * requests use of the standard _FILEOPEN.TXT file. You may specify any other filename you choose. The format of the file is given in FileOpen Startup Files. If you specify an unqualified filename, the folder searched will be the SPFLite HomeFolder (the same folder as the normal _FILEOPEN.TXT file).

-D

Specifies the name of a DO macro to be invoked on startup of the new session. This option cannot be used if the specified Instance-Name is equal to the current session.


Description


CAUTION: The INSTANCE command is intended for advanced users of SPFLite who are familiar with the use of Instances. If you are not familiar with Instances, please read Instances and Configurations before attempting use of this command.


The INSTANCE  command allows you to request a switch to another SPFLite Instance.  


When Edit tabs are still open, you may add the END, CANCEL or KEEP operands to describe how they are to be handled. See Operands above.


The INSTANCE command, to support flexibility in usage, performs several actions to assist:


    • Except when the Instance-name equals the current Instance Name, it will create a file _FILEOPEN.TXT in the SPFLite Home folder (the one containing the CFG file) which contains the filenames of all open tabs. This file is in the format used for the Command line -FILEOPEN operand.  You can reference this list in the newly opened Instance by coding the -F * operand.
    • INSTANCE can 'point' at the current running Instance. See Instances and Configuration for how this might be useful.
    • The command will perform preliminary validation of FileOpen  and DO macro requests for correctness before attempting the Instance switch.

Created with the Personal Edition of HelpNDoc: Easily Add Encryption and Password Protection to Your PDFs