seesys: administer a running system

Syntax

seesys
             -console options 
             -em      options
             -phasein options
             -recycle options
             -seppool options

This command is used to administer a running Enterprise Server for .NET system. Functionality includes:

Listing and replying to pending console input requests.
Phasing in a new version of a program that has already been loaded by one or more SEPs. This will cause a SEP that has already loaded the program to be unloaded and replaced by a new SEP. A transaction or job that is currently running in a SEP that needs to be replaced will be allowed to complete before the SEP gets unloaded.
Recycling SEPs. This may need to be done periodically to reduce the memory footprint of the processes that are hosting the SEPs. A transaction or job that is currently running in a SEP that needs to be recycled will be allowed to complete before the SEP gets unloaded.
Listing of all active SEP pools in the running system.
Recovery of tasks running in SEP pools that have been orphaned when the machine in which they are running dies or gets unconditionally powered down.
Listing of all event monitors registered in the cross-region-database
Deletion of event monitors that are no longer active (i.e. their state is in doubt)

Actions

-console: List, or reply to, pending console input requests.
-em, -event_monitor: List registered event monitors, or delete a registered event monitor when its state is in doubt
-phasein: Phase in a program to a running Enterprise Server for .NET system.
-recycle: Recycle SEPs in a running Enterprise Server for .NET system.
-seppool: List active SEP pools, or recover orphaned tasks running in SEP pools when the machine in which they are running dies or gets unconditionally powered down.

Options

-delete: Delete a registered event monitor (-em, -event_monitor)
-id:<reply-id>: Console input request id (-console).
-list: List pending console input requests (-console), active SEP pools (-seppool), or registered event monitors (-em, -event_monitor) .
-nobanner: Do not display the banner, or -list column headers.
-program:<program-name>: Program name (-phasein).
-recover: Recover orphaned tasks running in the SEP pool (-seppool).
-region:<region-name>: Name of the region being administered (-console, -phasein, -recycle).
-reply:<reply text>: Reply to a console input request (-console).
-server:<machine-name>[:<port>]: The name of the machine running the event monitor that will coordinate the administration function. Specify <port> if the event monitor on the target machine is not listening on the default 9186 port.; The default is localhost:9186. (-phasein, -recycle)
-server:<machine-name>: Machine targetted for SEP pool recovery (-seppool -recover).
-url:<sep-pool-url>: URL targetted for SEP pool recovery (-seppool -recover).
-url:<event-monitor-url>: URL of event monitor to be deleted (-em -delete, -event_monitor -delete)
-usedb: Use the default SQL Server instance (-console, -em, -event_monitor, -phasein, -recycle).
-usedb:instance: Use the specified SQL Server instance (-console, -em, -event_monitor, -phasein, -recycle).

Examples

Recycle all of the SEPs for the region named MYREGION hosted on the database server instance named MYDBINST:

seesys -recycle -usedb:MYDBINST -region:MYREGION

Phase in the program named MYPROG for the region named MYREGION hosted on the database server instance named MYDBINST:

seesys -phasein -program:MYPROG -usedb:MYDBINST -region:MYREGION

List all pending console input requests for the region named MYREGION hosted on the database server instance named MYDBINST:

seesys -console -list -usedb:MYDBINST -region:MYREGION

Reply to the console input request with id 8 for the region named MYREGION hosted on the database server instance named MYDBINST:

seesys -console -id:8 -reply:"Hello world" -usedb:MYDBINST -region:MYREGION

List all SEP pool processes registered in the cross-region database on the database server instance named MYDBINST:

seesys -seppool -list -usedb:MYDBINST

Recover all orphaned tasks that are associated with SEP pool processes registered in the cross-region database on the database server instance named MYDBINST that were running on the machine named MYSERVER:

seesys -seppool -recover -usedb:MYDBINST -server:MYSERVER

List all event monitor processes registered in the cross-region database on the database server instance named MYDBINST:

seesys -em -list -usedb:MYDBINST

Delete the event monitor process with the given URL from the cross-region database on the default database server instance:

seesys -em -delete -url:net.tcp://MYMC:9186/MicroFocus/SEE/MonitorService/Endpoint -usedb