casstop [/res-name] [/sprototype:host:WebServiceport] [/lserver-name] [/i] [/w] [/f] [/uuserid] [/ppassword] [/cgroup] [/x[userid]]
| /res-name | Name of the enterprise server to stop. Defaults to ESDEMO. To use this option:
Note: When calling this utility from
a Web service (that is, when you are running the utility within a SEP) you cannot use the /r option to connect to the
server. Where this is the case, you must use the /s or /l options to connect to the server.
|
| or: | |
| /sprototype:host:WebServiceport | Location of the Web Services listener for the enterprise server to be stopped. For example, /stcp:localhost:9003 |
| or: | |
| /lserver-name | Name of the enterprise server. This differs from the /s option, in that it performs a lookup to locate the Web Service for the enterprise server |
| /i | Immediate shutdown
This option can be used with the /s or /l option so can be run on a remote machine. Casstop sends a message to the region for it to kill all its processes. There is no shutdown processing. |
| /w[n] | Causes casstop to wait 'n' seconds after initiating the stop request before returning. No region state check is performed. This is to enable synchronisation when stopping from a script. If no value for 'n' is provided casstop waits for the default wait time of 15 seconds before returning. |
| /f | Force a shutdown.
This option must be used with the /r option and can only be run on the local machine. Casstop connects to the region, retrieves the process IDs and then kills all of these processes. There is no shutdown processing. |
| /uuserid | An authorized user. This user must exist within the security domains of both: the enterprise server and MF Directory Server.
That is, the security configuration for both enterprise server and Directory Server must be able to verify the user credentials
supplied. Note that enterprise server and Directory Server may be using different security managers. Therefore, it may be
necessary that the user is defined in more than one security repository.
In order to update Directory Server status information, within the Directory Server domain, the user must have modify permission on the appropriate enterprise server resource within the Servers resource class. In order to successfully run the casstop command, within the enterprise server's security domain, the user must have alter permissions on the casstop resource within the OPERCMDS resource class. Note: This is required only if you have configured security.
|
| /ppassword | The password for the user |
| /cgroup | The sign-on group for the user. By default, when a user requests access to a resource, some external security managers will
only apply rules that refer to that user and the user's current sign-on group.
If this option is not specified, the user is signed on with a default group as determined by the security manager. |
| /x[userid] | Retrieve user credentials from user input.
Note: userid is optional.
|
If a serious error occurs, a value of 15 will be set in the return code; other, lower values may also be returned. A message explaining the error is displayed on stdout and the console log. If you are calling casstop from within your own application program, then the message is displayed only on the console log.
Comments:
On UNIX you can use a dash (-) before a parameter as an alternative to a forward slash (/).
Many of the command line utilities, including casstart, casstop, casfile, casout, and cassub, can be invoked by program using the call interface and passing the command line parameters to the call. For an example, see casstart.