Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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
      Pass this argument as:

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
      Pass this argument as:

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
OK = Completed (normally)
ER = Error occurred.

2

2



2

N

Opt

Extended Error Code
This is the operating system error code (when available) that may aid you in error handling or error reporting.





3

List

Opt

Returned as
OK = Completed normally
ER = Error occurred.
Only returned for certain argument 1 values as follows:

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:

...