Synopsis
execacli HostName [/am:AppMode] [/we:WaitEnd] [/rc: nn /ri:nnnn] /ae:ExecuteAppli [AppliParam]
Description
The execacli command activates any application installed on a client. This command can wait for the application to complete.
Parameters
HostName
Specifies a host name of the client where the application will be activated.
Specify a host name in HostName within 15 alphanumeric characters. If HostName contains a space character, enclose it in double quotation marks.
/am:AppMode
Specifies the mode to start the application.
Select one of the following:
Activates the application in a normal window.
Activates the application in iconic state.
If this parameter is omitted, it defaults to the normal mode, activating in a normal window.
/we:WaitEnd
Specifies the time to wait for the activated application to complete. Specify an integer value between 1 and 9600 (in seconds) in WaitEnd. Specifying any other value results in an error.
If omitted, waiting for the application to complete is not performed.
/rc:nn
Specifies the retry count in case an error occurs in application startup.
Specify an integer value between 0 and 99 for nn. Specifying any other value results in an error. If omitted, no retry is performed.
/ri:nnnn
Specifies the retry interval in case an error occurs. This parameter is valid if 1 or a greater value is specified to nn in the /rc parameter.
Specify an integer value between 0 and 9999 (in seconds) for nnnn. Specifying any other value results in an error. The default value is 0.
/ae:ExecuteAppli
Specifies an application name that you want to activate using the local drive path with no longer than 511 characters. If the name of the target application or any parameter to be passed to the application contains a space character, enclose each parameter in double quotation marks.
AppliParam
Specifies the parameter(s) for the application specified with ExecuteAppli. If more than one parameter is specified, put a space between parameters. If a space character is contained in any parameter, enclose it in double quotation marks.
Return Values
Return value | Meaning |
|---|---|
0 | Completed |
Value other than 0 | Abended (or an application started with the /we parameter has terminated with a return value other than 0.) |
Command Location
Solaris | /opt/FJSVsnjss/bin |
HP-UX | /opt/FHPsnjss/bin |
AIX | /opt/FAIXsnjss/bin |
Linux | /opt/FJSVsnjss/bin |
Example
In this example, the application "c:\program files\app.exe" on the client "foo" is activated in a normal window, and then waits for this application to complete for 60 seconds. "test.txt" is a parameter for the application "app.exe".
execacli foo /am:normal /we:60 /ae:"C:\\program files\\app.exe" test.txt
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 [Client host name] HostName [Application] Name of the application that was 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 Client Task Link service must be already working on the client side when you use this command.
This command waits for the application to complete only when the /we parameter is specified.
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 been completely started. Therefore, the command takes a longer time to quit as the application takes more to start.
A backslash (\) in a path name for personal computer can be interpreted as an escape sequence depending on UNIX shells. To use a backslash in such shell string, enter two backlashes (\\).
