Get-SEERegionStatus: return the status of a region

Syntax

Get-SEERegionStatus parameter parameter . .

Returns region information and lists tasks running in the region.

Parameters

Note: All parameters have these properties:

Required: false
Position: named
Default value: none
Accept pipeline input: false
Accept wildcard characters: false

-region:<region-name>: Name of the region whose status is to be queried.

-usedb:<database-server-instance>

Name of the database server instance that hosts the region database. For example:

Default database server on the local machine:	`-usedb`
Default database server on the local machine, identical to `-usedb`:	`-usedb "(local)"`
Specific database server on the local machine:	`-usedb "(local)\SQLEXPRESS"`
Default database server instance on a specific machine (SC1 used in example)	`-usedb "SC1"`
Specific database server instance on a specific machine (SC1, SQLEXPRESS used in example for machine name, database server name)	`-usedb "SC1\SQLEXPRESS"`

Note: Parameter values are not case sensitive.

-verbose: The command output displays all of the messages that the command generates.

Outputs

Get-SEERegionStatus returns an array of two objects:

The object at Index 0 contains complete region information:
- Name: The name of the region.
- DBInstance: The database server instance on which the region resides.
- RegionState: The current state of the region.
```
class CICSRegion
{
   System.String Name
   System.String DBInstance
   System.String RegionState
}
```
The object at index 1 contains information on the tasks running on the region.

Task information can also be accessed using the first object in the returned object array using SepTasksStatus.

Example

This command returns all the information for region ESDEMO residing on database server instance SQLEXPRESS on the local computer. It also lists all running tasks with details on ESDEMO.

Get-SEERegionStatus -UseDB "(local)\SQLEXPRESS" -Region "ESDEMO"