OV_SYSTEM_SERVICE
The Things that Make Up this Example | To Execute this Example | BIF Descriptions |
DLL Required : U_BIF991.DLL
------------
Description : Performs a basic system service.
-----------
Availability : Windows -> YES
Unix -> NO
OS/400 -> NO
ARGUMENTS
---------
Type Required/ Length Decimals
Number A/N Optional Description Min Max Min Max
------ --- -------- ----------- ------- -------
1 A Req Type of system service required 1 50
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.
2 A Opt Requested Service Argument 1 1 256
When Arg 1 is Pass this argument as
------------- ---------------------
START Name of application (.EXE) to be started.
You may use a fully qualified name (ie: 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 (eg: 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 (ie:
with path information), just the .EXE name. If
you do not suffix the name with .EXE then the
.EXE suffix will be automatically added.
3 A Opt Requested Service Argument 2 1 256
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.
RETURN VALUES
-------------
Type Required/ Length Decimals
Number A/N Optional Description Min Max Min Max
------ --- -------- ----------- ------- -------
1 A Opt Basic Return Code 2 2
Returned as "OK" (completed
normally) or "ER" (error occurred).
2 N Opt Extended Error Code 1 15 0 0
This is the operating system error
code (when available) that may aid
you in error handling or error
reporting.
3 List Opt Returned working List. This list is
only returned for certain argument 1
values as follows :
When Arg 1 is This argument is
------------- ----------------
START Not returned.
START_LANSA Not returned.
START_UNIQUE Not returned.