Page History
OV_SYSTEM_SERVICE
| Note |
|---|
| Note: Built-In Function Rules |
Performs a basic system service.
| Info |
|---|
| The user of this Built-In Function is responsible for any impact it has on any application. No warranty of any kind is expressed or implied. Refer to full Disclaimer. |
Function No: | 991 |
DLL Required: | U_BIF991.DLL |
For use with
Visual LANSA for Windows | YES |
Visual LANSA for Linux | NO |
LANSA for i | NO |
Arguments
No | Type | Req/ Opt | Description | Min Len | Max Len | Min Dec | Max Dec |
|---|---|---|---|---|---|---|---|
1 | A | Req | Type of system service required Pass as one of: START Execute another (non-LANSA) application. START_LANSA Start another LANSA application executing. START_UNIQUE Execute another (non-LANSA) application if not already started. | 1 | 50 | ||
2 | A | Opt | Requested Service Argument 1 When Arg 1 is START Name of application (.EXE) to be started. You may use a fully qualified name (i.e. with path information) or just the .EXE name. If you do not suffix the name with .EXE then the .EXE suffix will be automatically added. START_LANSA Name of the LANSA process, process and function or form that is to be started as another independent system process / job. Pass this value as either PROC=PPPPPPPPPP, or, PROC=PPPPPPPPPP FUNC=FFFFFFF, or, FORM=OOOOOOOOOO only (where PPPPPPPPPP is the process name, FFFFFFF is the function name and OOOOOOOOO is the form name). Do NOT under any circumstances include any other X_RUN parameters into this argument (e.g: PART=PPP, DBID=XXXX, etc). START_UNIQUE Name of application (.EXE) to be started if it is not already started. This service is only available in MS Windows environments. You should NOT use a fully qualified name (i.e. with path information), just the .EXE name. If you do not suffix the name with .EXE then the .EXE suffix will be automatically added. Note: If Arg 1 is START or START_UNIQUE and arg 2 is LCOADM32 or LCOADM32.EXE (ie without the fully qualified path), LCOADM32.EXE will be found in the LANSA\Connect directory. | 1 | 256 | ||
3 | A | Opt | Requested Service Argument 2 When Arg 1 is START Parameters to pass to application being started. START_LANSA This argument is not required and any value specified will be ignored. START_UNIQUE Parameters to pass to the application if it needs to be started. | 1 | 256 |
Return Values
No | Type | Req/ Opt | Description | Min Len | Max Len | Min Dec | Max Dec |
|---|---|---|---|---|---|---|---|
1 | A | Opt | Basic Return Code | 2 | 2 | ||
2 | N | Opt | Extended Error Code | ||||
3 | List | Opt | Returned as START Not returned. START_LANSA Not returned. START_UNIQUE Not returned. |
Example
The following sample RDML function (which can be copied and pasted into the L4W free form function editor) requests that you specify a program (.EXE) name and any parameters to be passed to it. An attempt is then made to start the specified program executing:
...