Synopsis
execasvr [/un:UserName] [/rc:nn /ri:nnnn] /ae:ExecuteAppli AppliParam
Description
The execasvr 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.
Specify the user name using up to 20 alphanumeric characters. Space characters and any special characters other than the hyphen (-) and the underscore (_) cannot be specified.
If omitted, the application will be started with the privileges of the user executing this command.
/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 the application that you want to activate using an absolute path. Specify the application name to 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
Solaris | /opt/FJSVsnjss/bin |
HP-UX | /opt/FHPsnjss/bin |
AIX | /opt/FAIXsnjss/bin |
Linux | /opt/FJSVsnjss/bin |
Example
In this example, "/usr/local/bin/test" is activated, being appended with the parameter "test.txt".
execasvr /ae:/usr/local/bin/test 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 [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
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.
This command cannot start the application that requires keyboard entry.
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.
To start the application with the user privileges specified with the un:UserName parameter, the user executing this command must have root privileges.
To start a shell script, specify a shell name at the beginning of the script as follows.
Example:
#! /bin/sh
