SomMainProgram: Difference between revisions
Created page with "This function performs SOM initialization on behalf of a new program. ==Syntax== <PRE> SOMClassMgr *rc; rc = somMainProgram(); </PRE> ==Parameters== ==Return Code== ; r..." |
mNo edit summary |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:somMainProgram}} | |||
This function performs SOM initialization on behalf of a new program. | This function performs SOM initialization on behalf of a new program. | ||
==Syntax== | ==Syntax== | ||
SOMClassMgr *rc; | |||
SOMClassMgr *rc; | rc = somMainProgram(); | ||
rc = somMainProgram(); | |||
==Return Code== | ==Return Code== | ||
; rc (SOMClassMgr *) : A pointer to the SOMClassMgr object. | ;rc (SOMClassMgr *) : A pointer to the SOMClassMgr object. | ||
==Remarks== | ==Remarks== | ||
This function informs SOM about the beginning of a new thread of execution (called a task on Windows). The SOM Kernel then performs any needed initialization, including the deferred execution of the SOMInitModule functions found in statically-loaded class libraries. This function must appear near the beginning of all Windows main programs, and may also be used in AIX or OS/2 programs. When used, it supersedes any need to call the somEnvironmentNew function | This function informs SOM about the beginning of a new thread of execution (called a task on Windows). The SOM Kernel then performs any needed initialization, including the deferred execution of the SOMInitModule functions found in statically-loaded class libraries. This function must appear near the beginning of all Windows main programs, and may also be used in AIX or OS/2 programs. When used, it supersedes any need to call the somEnvironmentNew function. | ||
A convenience macro, SOM_MainProgram, which combines the execution of this function with the scheduling of the somEnvironmentEnd function during normal program termination, is available for C and C++ programmers. | |||
==Related== | ==Related== | ||
;Functions | |||
* somEnvironmentNew | * [[somEnvironmentNew]] | ||
* somEnvironmentEnd | * [[somEnvironmentEnd]] | ||
;Macros | |||
* SOM_MainProgram | * [[SOM_MainProgram]] | ||
* SOM_ClassLibrary | * [[SOM_ClassLibrary]] | ||
[[Category:SOM | [[Category:SOM function]] | ||
Latest revision as of 02:33, 6 May 2020
This function performs SOM initialization on behalf of a new program.
Syntax
SOMClassMgr *rc; rc = somMainProgram();
Return Code
- rc (SOMClassMgr *)
- A pointer to the SOMClassMgr object.
Remarks
This function informs SOM about the beginning of a new thread of execution (called a task on Windows). The SOM Kernel then performs any needed initialization, including the deferred execution of the SOMInitModule functions found in statically-loaded class libraries. This function must appear near the beginning of all Windows main programs, and may also be used in AIX or OS/2 programs. When used, it supersedes any need to call the somEnvironmentNew function.
A convenience macro, SOM_MainProgram, which combines the execution of this function with the scheduling of the somEnvironmentEnd function during normal program termination, is available for C and C++ programmers.
Related
- Functions
- Macros