Commands

Start, stop, pause, or resume zRule Execution Server for z/OS from the z/OS® command line.

zRule Execution Server for z/OS supports the following z/OS commands, where <HBRSSID_NAME> is the ID of the subsystem where the server instance runs.

Starting or stopping zRule Execution Server for z/OS:
- ```
START <HBRSSID_NAME>MSTR
```
- ```
STOP <HBRSSID_NAME>MSTR
```

Pausing or resuming a job on zRule Execution Server for z/OS:

```
MODIFY <HBRSSID_NAME>MSTR,PAUSE
```
```
MODIFY <HBRSSID_NAME>MSTR,RESUME
```

Requesting a dump:

```
MODIFY <HBRSSID_NAME>MSTR,DUMP TYPE(<value>) 
```
where <value> can be one of the following values:
- JAVA: Requests a Java™ dump.
- HEAP: Requests a Heap dump.
- SYSTEM: Requests a System dump. The HLQ is assigned to start the task for the zRule Execution Server for z/OS. For example: USERID.JVM.SSIDMSTR.**.X001

For the location of the dumps, see the following table.

Dump	Location of dump
JAVA	In the same directory as CEEDUMP, or standard Javadump directory as: javacore.%Y%m%d.%H%M%S.%pid.%seq.txt.
HEAP	In the current directory as a file named heapdump.%Y%m%d.T%H%M%S.phd. See Using Heapdump for more information.
SYSTEM	On TSO as a standard MVS dataset, using the default name of the form: %uid.JVM.TDUMP.%job.D%Y%m%d.T%H%M%S (31-bit), %uid.JVM.%job.D%y%m%d.T%H%M%S.X&DS (64-bit), or as determined by the setting of the `JAVA_DUMP_TDUMP_PATTERN` environment variable.

Note: Environment variables can be passed to the zRule Execution Server for z/OS by editing the started task procedure JCL using the following example for the CEEOPTS DD statement:

//CEEOPTS DD * RPTOPTS(ON),RPTSTG(OFF),ENVAR("JAVA_DUMP_TDUMP_PATTERN=yourPatternForTheDatasetToDumpTo")