8.3.1 adshappagent command (application execution agent start command) [only for Windows execution environment]
Syntax
adshappagent [-q] [-c]
Description
This command starts the application execution agent, monitors execution of the adshappexec command and then starts the executable application specified by the adshappexec command.
Each user executing the adshappexec command needs to execute the adshappexec command (mapping OS user of JP1/Base).
The user must be assigned rights with the administration tool of Windows under Local security policy > Local policy > Assign user rights > Create global object.
If the right to "create a global object" cannot be enabled due to security problems, a user who can enable the rights to "create a global object" must use the application execution agent function.
- Functions for performing registration on startup of Windows and cancellation from startup are provided. We recommend using this function to automatically start up at logon.
-
If you select All Programs > Advanced Shell > Application Execution Agent from Start menu of Windows, theApplication Execution Agent icon appears in the notification area of the Task bar.
If you place a cursor on the Application Execution Agent icon, the following description of the icon appears:
Status of icons changes as follows:
(Icon color: White) The executable application has not been started yet.
(Icon color: Green) The executable application is being executed.
(Icon color: Yellow) The executable application is forcibly terminated.
Use the argument-c of the adshappagent command or adshappexec command when you reference the information of the running executable application. Information cannot be obtained from the job definition script.
Arguments
- No arguments are specified.
-
Start up the application execution agent.
- -q
-
Terminates the application execution agent.
To terminate the application execution agent including when you switch the node of cluster link, use this argument.
- -c
-
This command outputs contents of the shared memory of the application-execution agent functionality.
The adshcollect command uses this argument.
To use the application execution agent, the agent needs to be redirected to the file.
Information is not displayed on the console.
In addition, the information to be acquired is the information for each login user and this information needs to be acquired with the executed login user.
Return codes
Return code |
Meaning |
---|---|
0 |
Normal termination. |
Other than 0 |
Termination with an error. |
Notes
-
You need to execute the adshappagent command before you execute the adshappexec command.
-
If you adopt the setting that waits for the executable application to finish (-w) by using the adshappexec command, do not finish the application execution agent until the executable application finishes. If the application execution agent finishes, the activated executable application keeps running and the job that started the executable application becomes an error.
-
Domain user and users other than domain users need to be handles as a different user in the application-execution agent functionality.
-
When you perform uninstallation and installation for version upgrade, finish the application execution agent, log in as the user who registered the application execution agent in startup and then delete the application execution agent from startup. If you perform uninstallation without deleting the application execution agent registered in startup, install JP1/Advanced Shell again, log in as the user that startup remains and then delete the application execution agent remains in startup.
-
If you execute the system switchover while running the application-execution agent program. Information before the system switchover is not inherited after executing system switchover. You need to finish the application execution agent by using the -q option and then start the application execution agent after performing the system switchover.
-
Only one application execution agent can be started for the same user. If multiple application execution agents are started, an error occurs.
-
You need to execute the adshappagent command in the logon area. Do not execute the command as the extension of the job of JP1/AJS operating in the service space. If you operate the command, you cannot operate the interactive type application.
-
Do not specify the argument-q and argument-c with other arguments at the same time. If you specify the argument-q and argument-c with other arguments simultaneously, an error occurs.