3.5.8 Run a Processing Sequence using the DXP1FN1 function
IMPORTANT NOTE:
This section describes a technique for running a Processing Sequence from a LANSA application that is no longer recommended for new solutions. It is only useful when LANSA Composer is installed in the same LANSA run-time system as the LANSA application. This mode of installation is no longer possible for new installations and is not recommended. For new solutions, please refer to 3.5.6 Run a Processing Sequence from a LANSA application instead.
NOTE: This section assumes sound knowledge of the applicable LANSA development techniques. Refer to LANSA product documentation for detailed information on application development with LANSA.
LANSA Composer provides the DXP1FN1 function for running a Processing Sequence from a LANSA application executing in the same LANSA system and partition as LANSA Composer.
Your LANSA application can call DXP1FN1 using the CALL RDML command with PROCESS(*DIRECT):
- Function DXP1FN1 must execute on the LANSA Composer server. Your application may, however, execute it via the LANSA SuperServer CALL_SERVER_FUNCTION built-in function.
- Function DXP1FN1 executes the Processing Sequence synchronously. If you wish the Processing Sequence to run in a batch job, then you must submit the code unit in your application that calls function DXP1FN1.
- Your application can pass the necessary variable information (the processing sequence identifier and any parameter values) using a combination of the LANSA exchange list and by passing a working list.
- Your application can receive the result of the processing sequence run via the exchange list.
NOTE: The code unit in your application that calls function DXP1FN1 must be RDMLX enabled.
Refer to the following topics for more details:
Exchange the Processing Sequence identifier
Populate and pass the Parameters working list
Receive the result of the Processing Sequence run
Example function to run a Processing Sequence
For general considerations about integrating your LANSA Composer solution with your LANSA applications refer to: