Stops an enterprise server.
casstop [/res-name] [/sprototype:host:WebServiceport] [/lserver-name] [/i] [/w] [/f] [/uuserid] [/ppassword] [/ggroup] [/tshutdowntransaction
/res-name | Name of the enterprise server to stop. Defaults to ESDEMO. To
use this option:
Note: When calling this utility from JCL or 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 |
/w | Wait for shutdown to be completed |
/f | Force a shutdown. This option cannot be used in conjunction with /s or -/l |
/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 only required 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. |
/ttransaction-id | The MTO shutdown transaction to run. If none is specified, this defaults to CQIT. |
Note: Options /r, /s, /l are alternative ways of identifying the enterprise server to be stopped and are mutually exclusive.
Note: Where an external security manager is configured for the enterprise server, a userid and password must be supplied when stopping it.
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, please see casstart.