Syntax
seesys
-console 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.
Actions
- -console
- List, or reply to, pending console input requests.
- -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
- -id:<reply-id>
- Console input request id (-console).
- -list
- List pending console input requests (-console), or active SEP pools (-seppool).
- -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).
- -usedb
- Use the default SQL Server instance (-console, -phasein, -recycle).
- -usedb:instance
- Use the specified SQL Server instance (-console, -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
