dxstart exe Syntax and Parameters

LANSA Composer

dxstart.exe Syntax and Parameters

You can specify switches and parameters on the dxstart.exe command line to control its behaviour.

 

  dxstart.exe    /request={dxclient|dxtxmon|dxrun|dxreorg|dxregister}

 

                 /lang=lll

 

                 /part=ppp

 

                 /offline

 

                 /shortcut=path

 

/request= {dxclient|dxtxmon|dxrun|dxreorg|dxregister}

This switch specifies the LANSA Composer client or server function to be performed.  The functions that may be requested are:

  • dxclient: Starts the LANSA Composer client application.  This is the default if the /request switch is not provided or the value is not recognised.
  • dxtxmon: Starts the LANSA Composer Document Manager application.
  • dxrun: Executes a processing sequence run "shortcut" file.  The path to the shortcut file must be provided using the /shortcut switch.  In normal usage, LANSA Composer registers the file extension associated with a LANSA Composer processing sequence run "shortcut" file (.dxrun) such that the default Windows Explorer action for files with that extension is to invoke dxstart.exe with this switch and the /shortcut switch.
  • dxreorg: Executes the LANSA Composer database housekeeping task.  The database housekeeping task will use the parameter specifications last used or last saved through the LANSA Composer client.  Refer to Database Housekeeping for more information.  This function can only be executed on the LANSA Composer Windows server.
  • dxregister: May be used to explicitly invoke dxtstart.exe to register the .dxrun file with Windows Explorer and associate dxstart.exe with it.  Normally this occurs in the course of standard LANSA Composer installation and processing.

/lang=lll

This switch may be used to specify the national language used to start LANSA Composer.  If not specified, LANSA Composer will automatically detect French and Japanese systems and start the LANSA Composer client in the appropriate language.  If this switch is specified, its value overrides the automatic detection and any value that may be specified in the dxstart.cfg configuration file.

/part=ppp

This switch may be used to specify the partition name used to start LANSA Composer.  If specified, this value overrides any value that may be specified in the dxstart.cfg configuration file.  In a standard LANSA Composer installation it should not be necessary to specify this switch as the software is always installed in partition named LIC.  The partition specified here does not affect or override the partition name used for the connection to the LANSA Composer server.

/offline

For /request=dxclient or /request=dxtxmon, this switch may be specified to cause the LANSA Composer client or LANSA Composer Document Manager application to start in offline mode, without showing the Connect to LANSA Composer Server dialog.

You would never use this switch in a standard LANSA Composer client installation, as such an installation does not have a local LANSA Composer database and therefore cannot run in offline mode.

This switch is typically used with the LANSA Composer client that is installed with a LANSA Composer Server for Windows installation.

/shortcut=path

For /request=dxrun, this switch specifies the full path to the LANSA Composer processing sequence "shortcut" file to be executed.  Such a file usually has a file extension of .dxrun.  If the path contains spaces or other special characters it should be fully-enclosed in double-quote marks.