casstart

Starts an enterprise server.

Syntax:

casstart [/res-name] [/oconfig-name][/uusername] [/ppassword] [/cgroup] [/wseconds] [/sstart-type] [/mhost:port]

Parameters:

/res-name Name of the enterprise server to start. Defaults to ESDEMO
/oconfig-name When using this option in MSS-enabled regions, config-name should be the name of a SIT. The region starts up using the specified SIT rather than the one defined in the Enterprise Server Administration pages.
/uuserid An authorized user. This user must exist within the security domains of both the enterprise server and Micro Focus 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. It might 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 casstart command, within the enterprise server's security domain, the user must have alter permissions on the casstart resource within the OPERCMDS resource class.

Exception: This parameter 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 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.

/wseconds

Introduces a delay (in seconds) to the end of the startup process, to allow other essential processes for the region to start before control is passed to the user. It prevents the casstart process from exiting until the region has either started or the delay expires. This option specified without the seconds argument introduces a default 15-second delay.

/sstart-type Where start-type can be w for warm or c for cold. This option is used to start enterprise server instances that are part of a PAC. Only the first enterprise server instance started in a PAC can be cold started.
Note: It is not mandatory to cold start the first enterprise server in a PAC.
The remaining enterprise server instances that are part of the PAC should be performed as warm starts. See Starting a PAC for more information.

Prior to cold starting a PAC, the following caspac command should be issued:

caspac -aInitPac=pacname -stype,host:port
Note:
  • If an attempt is made to cold start an enterprise server instance when one or more enterprise server instances are already running in the PAC, then it will ignore the cold start flag.
  • When /s is specified the value of the option will override the cold/warm start settings for TS/TD queues in the SIT. If /s is not explicitly specified then the SIT settings for TS/TD queues will be applied.
If this option is used to start an enterprise server instance that is not part of a PAC then it overrides the SIT options for TS/TD.
/mhost:port Enables you to specify the host and port that casstart should look for an MFDS service on, where the default host and port (localhost:86 or 127.0.0.1:86) is not the port the target MFDS service is bound to.

Comments:

On UNIX you can use a dash (-) before an option as an alternative to a forward slash (/).

The command line utilities casstart, casstop, casfile, casout, and cassub can be invoked by a program using the call interface and passing the command line parameters to the call. For instance, you could use the following to start a server:

01 ws-cmd-parms.
     05 ws-cmd-len         pic x(02) comp-x.
     05 ws-cmd-value     pic x(1024).
......
......
......
      *> Start up the Server 
      move 1                to ws-cmd-len
      move low-values  to ws-cmd-value
      string "-rMyRegion" delimited by size
               " -uSYSAD -pSYSAD /w30" delimited by size
               into ws-cmd-value with pointer ws-cmd-len
      end-string
      subtract 1 from ws-cmd-len
      call 'casstart' using ws-cmd-parms end-call
......
......

When used on platforms that support running both 32-bit and 64-bit applications, casstart checks its environment to determine whether to start the enterprise server in 32-bit or 64-bit mode. If the server's working mode (as specified when it was created) does not match the mode specified by the environment, casstart fails and issues an appropriate message. On UNIX platforms, you choose the mode by setting the COBMODE environment variable to 32 or 64 as appropriate. On Windows platforms, you can choose the environment by choosing the relevant command prompt from the Start menu.

You can only invoke the casstart command from the command line or from the Micro Focus Directory Server (MFDS); it cannot be invoked, for example, from a batch job.