I2Zeebe - Revision history

Alexei.baranov at 18:26, 26 October 2023

2023-10-26T18:26:46Z

Alexei.baranov: /* i2Zeebe parameters */

2023-09-01T09:26:28Z

‎i2Zeebe parameters

Alexei.baranov: /* i2Zeebe parameters */

2023-09-01T09:24:44Z

‎i2Zeebe parameters

Alexei.baranov: /* i2Zeebe parameters */

2023-09-01T09:24:23Z

‎i2Zeebe parameters

Alexei.baranov: /* Header files */

2023-09-01T09:08:10Z

‎Header files

Alexei.baranov: /* Call from ILE RPG program */

2023-09-01T08:55:58Z

‎Call from ILE RPG program

Alexei.baranov: /* Call from ILE RPG program */

2023-09-01T08:51:22Z

‎Call from ILE RPG program

Alexei.baranov: /* Activate jobs */

2023-09-01T08:49:32Z

‎Activate jobs

Alexei.baranov at 08:47, 1 September 2023

2023-09-01T08:47:22Z

Alexei.baranov: /* Zeebe Job Worker */

2023-09-01T08:28:55Z

‎Zeebe Job Worker

@@ Line 121: / Line 121: @@
 Lets assume that we have published simple business process with service task that has type I2ZEEBE to our Zeebe cluster (ht<span>tp://gateway:26500):<br/>
 [[File:I2zeebe simple.png|500px]]<br/>
-Now we can start the process, for example from Camunda Modeller (press Start process button in the bottom of Modeller interface:<br/>
+Now we can start the process, for example from Camunda Modeler (press Start process button in the bottom of Modeler interface:<br/>
 [[File:I2zeebe simple start.png|500px]]<br/><br/>
 At this step, Zeebe process engine should start the process and wait for activation of I2ZEEBE task by some worker. Let's do it from IBMi command line interface:<br/>

@@ Line 371: / Line 371: @@
 '''In any case, in both modes, all strings in the input and output parameters are null-terminated strings.'''
-'''Memory allocation.''' When called with '--response' parameter (Shell) or with not-null value of 4th parameter 'response' (RPGLE), i2Zeebe will allocate all necessary subfields of response data structure in memory. It is required to deallocate this storage after using with call to 'Cleanup' command (Shell) or I2ZEEBEX procedure as defined in I2ZEEBECPY copysource. If response is parameter not specified, i2Zeebe will use internal data structures where needed, and will deallocate required temporary storage by himself.
+'''Memory allocation.''' When called with '--response' parameter (Shell) or with not-null value of 4th parameter 'response' (RPGLE), i2Zeebe will allocate all necessary subfields of response data structure in memory. It is required to deallocate this storage after using with call to 'Cleanup' command (Shell) or I2ZEEBEX procedure as defined in I2ZEEBECPY copysource. If response parameter is not specified, i2Zeebe will use internal data structures where needed, and will deallocate required temporary storage by himself.
 ==Shell mode==

@@ Line 367: / Line 367: @@
 Using the first mode is more convenient when calling from command line or from programs written on ILE C language. It is preferred way of calling i2Zeebe.
-The second mode called RPGLE mode is more convenient for calling from ILE RPG or programs. In this mode, we tried to eliminate operations with pointers, at least in the input parameters. However, there are some restrictions on working with strings in this mode. As a rule, all input strings passed to the program in RPGLE mode are passed as fixed-length strings, and it is not possible to extend it lengths. One exception - parameter 'variables', it is the last parameter in input structures, and you are able to alter its default length in copysource I2ZEEBECPY or in your own copy of this copysource.
+The second mode called RPGLE mode is more convenient for calling from ILE RPGLE programs. In this mode, we tried to eliminate operations with pointers, at least in the input parameters. However, there are some restrictions on working with strings in this mode. As a rule, all input strings passed to the program in RPGLE mode are passed as fixed-length strings, and it is not possible to extend it lengths. One exception - parameter 'variables', it is the last parameter in input structures, and you are able to alter its default length in copysource I2ZEEBECPY or in your own copy of this copysource.
 '''In any case, in both modes, all strings in the input and output parameters are null-terminated strings.'''

@@ Line 365: / Line 365: @@
 Depending on the programming language used, it is possible to pass parameters to the i2Zeebe in two different ways - Sell mode and RPGLE mode.
-Using the first mode is more convenient when calling from command line or programs written on ILE C language. It is preferred way of calling i2Zeebe.
+Using the first mode is more convenient when calling from command line or from programs written on ILE C language. It is preferred way of calling i2Zeebe.
 The second mode called RPGLE mode is more convenient for calling from ILE RPG or programs. In this mode, we tried to eliminate operations with pointers, at least in the input parameters. However, there are some restrictions on working with strings in this mode. As a rule, all input strings passed to the program in RPGLE mode are passed as fixed-length strings, and it is not possible to extend it lengths. One exception - parameter 'variables', it is the last parameter in input structures, and you are able to alter its default length in copysource I2ZEEBECPY or in your own copy of this copysource.

← Older revision		Revision as of 09:08, 1 September 2023
Line 651:		Line 651:

	Files are also available here: [https://www.i2rest.com/download/latest/i2zeebe.copyr i2zeebe.copyr] and [https://www.i2rest.com/download/latest/i2zeebe.h i2zeebe.h]		Files are also available here: [https://www.i2rest.com/download/latest/i2zeebe.copyr i2zeebe.copyr] and [https://www.i2rest.com/download/latest/i2zeebe.h i2zeebe.h]
		+
		+	=Questions?=
		+	Questions? Issues? Found a bug? Need a consultation? [mailto:contacts@i2rest.com Contact us!]

← Older revision		Revision as of 08:55, 1 September 2023
Line 230:		Line 230:

	<pre>		<pre>
		+	* Example how to use i2Zeebe to communicate with Zeebe gateway
		+	*
		+	* To compile:
		+	* CRTRPGMOD MODULE(I2ZEEBE/EXAMPLE1) SRCFILE(I2ZEEBE/QRPGLESRC) DBGVIEW(*ALL)
		+	* CRTPGM PGM(I2ZEEBE/EXAMPLE1) ACTGRP(*CALLER)
		+	*
		+	* To call:
		+	* ADDLIBLE I2ZEEBE
		+	* CALL EXAMPLE1
		+
	D gatewayVersion S 50a		D gatewayVersion S 50a

@@ Line 227: / Line 227: @@
 ==Call from ILE RPG program==
-To call i2Zeebe from RPGLE program, it is recommended to use pass parameters in RPG mode. In this mode, i2Zeege accepts fixed number of parameters - 5 for applying some action or 2 for releasing data allocated by the action:
+To call i2Zeebe from RPGLE program, it is recommended to pass parameters in RPG mode. In this mode, i2Zeege accepts fixed number of parameters - 5 for applying some action or 2 for releasing data allocated by the action:
 <pre>

← Older revision		Revision as of 08:47, 1 September 2023
Line 1:		Line 1:
	{{DISPLAYTITLE:i2Zeebe}}		{{DISPLAYTITLE:i2Zeebe}}
−
−	~~'''This page is under construction!'''~~
−
−
	i2Zeebe works as a bridge between IBM i server and [https://docs.camunda.io/docs/components/zeebe/zeebe-overview Zeebe process automation engine]. You can use i2Zeebe as a native equivalent of [https://docs.camunda.io/docs/apis-tools/cli-client zbctl] utility or as Zeebe client library for use in your ILE RPG/C code. i2Zeebe represents IBM i program written on ILE C, which can be called from command line or from any IBM i program. With i2Zeebe, you can interact with almost any [https://docs.camunda.io/docs/apis-tools/grpc Zeebe API (gRPC)] directly from IBM i server.		i2Zeebe works as a bridge between IBM i server and [https://docs.camunda.io/docs/components/zeebe/zeebe-overview Zeebe process automation engine]. You can use i2Zeebe as a native equivalent of [https://docs.camunda.io/docs/apis-tools/cli-client zbctl] utility or as Zeebe client library for use in your ILE RPG/C code. i2Zeebe represents IBM i program written on ILE C, which can be called from command line or from any IBM i program. With i2Zeebe, you can interact with almost any [https://docs.camunda.io/docs/apis-tools/grpc Zeebe API (gRPC)] directly from IBM i server.

@@ Line 297: / Line 297: @@
     if(!first_call) {
-       gateway_protocol_ActivateJobsResponse *response = (void *)argv[2];
+       i2ZeebeActivateJobsResponse_t *response = (void *)argv[2];
        char activatedJob[20];