firebird/firebird-mirror
firebird/firebird-mirror
8
0
Fork 1
mirror of https://github.com/FirebirdSQL/firebird.git synced 2025-01-22 18:03:03 +01:00
Code Issues

Documentation for new SPB parameters

Browse Source
This commit is contained in:
alexpeshkoff 2008-09-17 06:56:45 +00:00
parent 53c6411ef9
commit a96cea114d
2 changed files with 40 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
doc/README.services_extension Normal file
View File

@ -0,0 +1,33 @@
Services API enhancements in Firebird v2.
-----------------------------------------
1) Services API extension for new shutdown modes.
(Alex Peshkov, peshkoff@mail.ru, 2008)
New DB shutdown modes can now be set using services. A number of new
isc_spb_prp_* constants should be used for it.
isc_spb_prp_shutdown_mode and isc_spb_prp_online_mode are used to perform
database shutdown/online operation. They have a single byte parameter,
setting new shutdown mode: isc_spb_prp_sm_normal, isc_spb_prp_sm_multi,
isc_spb_prp_sm_single and isc_spb_prp_sm_full. They exactly match gfix's
shutdown modes. When performing shutdown operation, you must specify
also type of shutdown: one of isc_spb_prp_force_shutdown,
isc_spb_prp_attachments_shutdown or isc_spb_prp_transactions_shutdown.
They have single int (4-byte) parameter, specifying timeout for desired
operation.
Please note that old-styled parameters are also supported and should be
used to enter default shutdown (currently 'multy') and online ('normal')
modes.
Samples of use of new parameters in fbsvcmgr utility (supposing login and
password are set using some other method):
Shutdown database to single-user maintenance mode:
fbsvcmgr service_mgr action_properties dbname employee prp_shutdown_mode prp_sm_single prp_force_shutdown 0
After it enable multi-user maintenance:
fbsvcmgr service_mgr action_properties dbname employee prp_online_mode prp_sm_multi
After it go to full shutdown mode, disabling new attachments during 60 seconds:
fbsvcmgr service_mgr action_properties dbname employee prp_shutdown_mode prp_sm_full prp_attachments_shutdown 60
Return to normal state:
fbsvcmgr service_mgr action_properties dbname employee prp_online_mode prp_sm_normal

7
doc/WhatsNew
View File

@ -2,6 +2,13 @@
* v2.5 Alpha 1
**************
* Improvement CORE-1107
Services API extension for new (single, full) shutdown modes
See also:
/doc/README.services_extension
Contributor(s):
Alex Peshkov <peshkoff at mail.ru>
* Bugfix CORE-1930
Possible server crash if procedure was altered to have no outputs and dependent procedures were not recompiled
Contributor(s):