Synopsis
EXECASVR.EXE [/UN:UserName] [/LG:LoginGroup] [/RC:nn /RI:nnnn] /AE:ExecuteAppli AppliParam
Description
The EXECASVR.EXE command activates any application installed on a server. The activated application runs in the background and is not displayed on-screen.
This command will end without waiting for the application to complete.
Parameters
/UN:UserName
Specifies the right to be used to start an application by specifying the user name.
And the user name specified to UserName must be set in the password management book in advance. If UserName contains a space character, enclose it in double quotation marks.
To specify UserName, use either one of the following formats: "domain name\user name" or "server name\user name". The domain name or server name must be no longer than 15 alphanumeric characters, and the user name must be no longer than 20 alphanumeric characters.
If this parameter is omitted, the application is started with the system rights.
/LG:LoginGroup
Specifies a login definition name used to manage the password management book.
Specify LoginGroup within 256 characters, and enclose it in double quotation marks if a space character is contained.
If the /UN parameter is specified, be sure to specify this parameter.
/RC:nn
Specifies the retry count in case an error occurs in application startup.
Specify an integer value between 0 and 99 for nn. Setting any other value results in an error. If omitted, no retry is performed.
/RI:nnnn
Specifies the retry interval in case an error occurs.
Specify an integer value between 0 and 9999 (in seconds) for nnnn. Setting any other value results in an error. The default value is 0.
This parameter is valid when 1 or a greater value is specified to nn in the /RC parameter.
/AE:ExecuteAppli
Specifies an application that you want to activate using a local drive path. Specify the application name in ExecuteAppli. If the application name contains a space character, enclose it in double quotation marks. The total number of characters in ExecuteAppli including AppliParam must be no longer than 511 characters.
AppliParam
Specifies parameters for the application specified in ExecuteAppli. If more than one parameter is specified, put a space character between parameters. If a space is contained in any parameter, enclose it in double quotation marks.
Return Values
Return value | Meaning |
|---|---|
0 | Completed |
Value other than 0 | Abended |
Command Location
Systemwalker Operation Manager installation directory\MpWalker.JM\bin
Example
In the following example, the application "c:\Program files\app\App.exe" is started using the user rights of "foo\User1". The user's password used in server logon is obtained from the login definition name "grp1" in the password management book.
EXECASVR.EXE /UN:foo\Usr1 /LG:grp1 /AE:"c:\Program files\app\App.exe"
Execution Results/Output Format
After the command has been through processing, the information at command completion is output to the standard output.
The contents to be output are shown below.
[Process start time] MM-DD-YYYY HH:MM:SS [Application] Name of the application activated [Retry count] Number of retries performed [Error] Error message [Process end time] MM-DD-YYYY HH:MM:SS
In [Error], "None" is output if the command completed successfully. A message is output if the command is canceled or failed. For details on the messages, see the Systemwalker Operation Manager Message Guide.
If an error occurs before starting the application, a message is output in the following format:
[Process start time] MM-DD-YYYY HH:MM:SS [Command error] Error message [Process end time] MM-DD-YYYY HH:MM:SS
For details on the messages, see the Systemwalker Operation Manager Message Guide.
Cautions
The Task Link service must be already working on the server side when you use this command.
Prior to running this command, you need to configure the password management book by using the password management command. See "9.3.1 LGMANAGE.EXE Password Management Command" for further details.
This command does not monitor the application process that the command activated. To review the process results, the application itself needs to have the feature to report a completion code.
The application started by this command always operates behind the screen, so applications launch on a specific screen cannot be activated by this command. Also, this command cannot start an application that requires user registry.
When specifying the /UN:UserName and /LG:LoginGroup parameters, you need to set "Logon as a service" beforehand for the user specified to UserName. To do it on the Windows Server 2008 or later based computer, use the "Local Security Policy Setting".
The application started by this command cannot be canceled, even if you cancel this command.
If this command is canceled, it is carried out at the point when the application has completely started. Therefore, the command takes a longer time to quit as the application takes more to start.
This command cannot start the application that requires keyboard entry.
