casutl

An Enterprise Server utility program.

Restriction: This topic applies only when the Enterprise Server feature is enabled.

Syntax:

casutl [/res-name]
       [/sprototype:host:port]
       [/lservername]
       [/n]
       [/xfiles-to-switch]
       [/ccurrent-directory]
       [/uuserid]
       [/ppassword]
       [/ggroup]
       [/h{[e|d]}]
       [/te{[ tracelist],[aux],[all],[ims]}]
       [/td{[ tracelist],[aux],[all],[ims]}]
       [/a{[amax|admin]=nnn}

Parameters:

Table 1. Connection parameters
/r`es-name`	Connects to an enterprise server with the specified name, `es-name`. Restriction: When calling casutl from a Web service (that is, when you are running casutl within a SEP), it is not possible to use the /r option to connect to the server. In such cases, you must use either /s or /l to connect to the server.
/s`prototype`:`host`:`port`	Uses the specified URL to locate the enterprise server to connect to. For example: stcp:localhost:9003
/l`servername`	Looks up the specified `servername` to find the enterprise server to connect to.

Note: If neither /r , /s or /l is specified, this defaults to /rESDEMO[64].

Table 2. Other parameters
/n	Creates a new console log file, console.log. The contents of the current console.log are saved to a new file, console.`nnn`_switch_date_time.
/x`files-to-switch`	Switches the active aux trace, dump and/or HSF files. `files-to-switch` specifies the files to switch. This can be one or more of the following single-character arguments: t Stands for trace. Switches between casauxta.rec and casauxtb.rec. d Stands for dump. Switches between casdumpa.rec and casdumpb.rec. h Stands for HSF. Switches between cashsf-a.csv and cashsf-b.csv.
/c`current-directory`	Sets an internal FS current directory.
/u`userid`	Specifies an authorization user ID.
/p`password`	Specifies an authorization password.
/g`group`	Specifies the sign-on group to use when running commands.
/h{[e\|d]}	Enables (e) or disables (d) HSF.
/te{[ `tracelist`],[aux],[all],[ims]}	Enables trace flags. Where: `tracelist` is a comma-delimited list of trace flags. This can also include the following keywords: aux Aux trace. all All trace flags (not including aux). ims All ims trace flags. See the Examples section.
/td{[ `tracelist`],[aux],[all],[ims]}	Disables trace flags. Where: `tracelist` is a comma-delimited list of trace flags. This can also include the following keywords: aux Aux trace. all All trace flags (not including aux). ims All ims trace flags. See the Examples section.
/a{[amax\|admin]=nnn}	Change the number of default SEPs or admin SEPs: `amax` Default SEPs `admin` Default admin SEPs Note: nnn is an integer between 1 and 999.

Dependencies:

You must start the enterprise server before you can issue a casutl command.

Comments:

The /r, /s and /l options are alternatives and are mutually exclusive.

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

Examples

The following examples demonstrate a few scenarios where you can use casutl. MYREGION is the name of your enterprise server instance.

To switching the active trace file, use the following command:

casutl /rMYREGION /xt

To switch both the active dump and HSF files at the same time, use the following command:

casutl /rMYREGION /xdh

To start a new console log, use the following command:

casutl /rMYREGION /n

This creates the new log file and also creates a backup copy of the existing console.log as console.nnn_switch_date_time.

To enable aux,api,scp and kcp, use the following command:

casutl /teaux,api,scp,kcp

To enable all trace flags:

castul /teall

To disable all ims trace flags:

casutl /tdims

To dynamically modify the number of application execution processes to 5 for the duration of the current region instance:

casutl /rMYREGION /aamax=05