16.4.3 Action Stop API

This section explains the action stop API (Mp_StopAction).

Synopsis

long Mp_StopAction (unsigned char *AppName, 
             long handle)

Description

This API stops actions that have been requested to the Action Control Server.

Parameters

AppName

Specify the address of the application (specified in the action execution API) that requested the action that you want to stop.

handle

Specify the action control number (return value of the action execution API).

Return Values

Return Value	Meaning	Action
0	This stops the action.	-
MPACT_NOTACTION	Specified action does not exist (already terminated).	-
MPACT_NOTSTOP	Cannot stop the action because it is being executed.	The action cannot be stopped because it is currently running.
MPACT_NOTACCESS	You do not have permission to stop the action.	Execute the action as a user with Administrator privileges.
MPACT_PARAMERR	There is a parameter error.	Check for incorrect parameter settings.
MPACT_NOMEMORY	There is not enough memory.	Either increase the size of the page file or add more physical memory.
MPACT_NOTMOVE	The Action Control Server has not been started.	Check that Systemwalker MpAosfB is running.
MPACT_COMFAIL	Communication with the Action Control Server has failed.	Check that Systemwalker MpAosfB and Systemwalker MpAosfX are running.
MPACT_SYSERR	An error has occurred on the Action Control Server.	Refer to the message output to the event log or syslog, eliminate the cause of the error and then restart Systemwalker. If the problem persists after the cause of the error has been eliminated and Systemwalker has been restarted, use the maintenance information collection tool to collect event monitoring data and contact a Fujitsu SE.
MPACT_NOTDLL	DLL for the action request cannot be loaded.	Check that the file f3crhxac.dl (see Note), which is needed for action management, exists in the following folder: Systemwalker installation directory\mpwalker\bin If the file is not located in the above folder, either reinstall Systemwalker or use the maintenance information collection tool to collect event monitoring data and contact a Fujitsu SE.
MPACT_EXCEPT	The address of an invalid area has been specified.	An internal logic error has occurred. Collect data with the maintenance information collection tool and contact a Fujitsu SE.

Program Example

Below is an example program of the action stop API:

#include "f3crhxac.h"

unsigned char *AppName = "execution API" ;  // application name specified in the action 
                                            // execution API
long handle            = 1 ;                // return value of the action execution API
long lrc ;

lrc = Mp_StopAction(AppName,handle) ;
if ( lrc != 0 ) {
    /* error processing */
}

/* normal completion */

16.4.3 Action Stop API

16.4.3.1 Action Stop API