Syntax
seesys
-console options
-em options
-phasein options
-recycle options
-seppool options
This command is used to administer a running
Micro Focus 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
Micro Focus Enterprise Server for .NET system.
- -recycle
- Recycle SEPs in a running
Micro Focus 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