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"