Visit Platform at http://www.platform.com

extern LIBESC_API int esc_controlinstance(esc_service_instance_location_t *, esc_security_def_t *)

Control service instance(s). Currently it supports four kinds of operations:

Stop the specified service instance, which is specified by service name and service instance sequence number, and restart it on the original host;

Stop all the service instances of specified service, which is specified only by the service name, and restart all the instances on the original host;

Stop all the service instances of specified service on specified host, which is specified by service name and host name; user can choose to release the host into blacklist or not. If the releasing host flag is set, EGOSC will release the original host and get a new one. After getting a new host, start all the service instances on it. Otherwise, restart all the service instances on the original host.

Stop all the service instances of all the services on the specified host, which is specified only by host name; user can choose to release the host into blacklist or not. If the releasing host flag is set, EGOSC will release the original host and get a new one. After getting a new host, start all the service instances on it. Otherwise, restart all the service instances on the original host.

Parameters:
The first parameter IN is the location of the service instance to be stopped.
The second parameter IN is the security context.
Error on return: May be ESCE_AUTH_FAIL,ESCE_SYS, ESCE_NO_VEMKD, ESCE_ESC_DOWN, ESCE_SOCK_SYS, ESCE_TIME_OUT, ESCE_BAD_ARG, ESCE_NO_MEM, ESCE_XDR, ESCE_NOSUCH_SERVICE,ESCE_NOSUCH_SERVICE_INSTANCE,ESCE_NOSUCH_ALLOCHOST, ESCE_AUTH_FAIL,ESCE_NO_ADMIN_AUTH, ESCE_NO_AUTH,ESCE_SEC_INIT_FAIL, ESCE_AUTH_FAIL_CRED_EXPIRE,ESCE_PROTOCOL,ESCE_AUTH_ALREADY, ESCE_AUTH_FAIL_CREATE_EXPIRE,ESCE_AUTH_FAIL_UNKNOWN_USER

Returns:
0 if successful. < 0 otherwise.


     
Date Modified: 26 Nov 2007
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 2001-2007 Platform Computing Corporation. All rights reserved.