OV_SYSTEM_SERVICE

LANSA

OV_SYSTEM_SERVICE

The Things that Make Up this ExampleTo Execute this ExampleBIF 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.