I2Rpc EN - Revision history

Alexei.baranov: /* I2RC000002 RPC вызов программ */

2025-07-31T13:46:37Z

‎I2RC000002 RPC вызов программ

Alexei.baranov: /* I2RC000001 подключение к серверу */

2025-07-31T13:38:39Z

‎I2RC000001 подключение к серверу

Alexei.baranov: /* Использование i2RpcAPI */

2025-07-31T13:32:46Z

‎Использование i2RpcAPI

Alexei.baranov: /* Встроенный и внешний сервер трассировки */

2025-07-31T13:28:25Z

‎Встроенный и внешний сервер трассировки

Alexei.baranov: /* Startup parameters */

2025-07-31T09:00:01Z

‎Startup parameters

Alexei.baranov: /* Starting the server */

2025-07-31T08:57:18Z

‎Starting the server

Alexei.baranov: /* Запуск сервера */

2025-07-31T08:57:01Z

‎Запуск сервера

Alexei.baranov: /* Секция logger */

2025-07-31T08:54:30Z

‎Секция logger

Alexei.baranov: /* Секция statefull */

2025-07-31T08:43:08Z

‎Секция statefull

Alexei.baranov: /* I2RC000004 отключение от сервера */

2025-07-30T10:01:28Z

‎I2RC000004 отключение от сервера

@@ Line 358: / Line 358: @@
 :If statefull=0, then these parameters are not filled in the response
-==I2RC000002 RPC вызов программ==
+==I2RC000002 RPC program call==
-Формат I2RC000002 используется для удаленного вызова программ при помощи i2Rpc
+The I2RC000002 format is used to call programs remotely using i2Rpc
-Структура параметров
+Parameters structure
   // I2RC000002 - Run program
@@ Line 405: / Line 405: @@
   D  joblog                         *                                        O (withJobLog*+joblogProvided)
-Описание параметров:
+Parameters:
-* '''connection''' полученный ранее handler соединения
+* '''connection''' previously obtained connection handler
-* '''lib/pgm'''  input - имя вызываемой программы. В lib можно использовать *LIBL. Программа должна быть "видна" в списке библиотек целевого задания
+* '''lib/pgm'''  input - the name of the program to be called. *LIBL can be used in lib. The program must be "visible" in the list of libraries of the target job
-: output - если параметр returnResolvedName=1, то в данных полях возвращается реальное имя библиотеки и программы, использованной при удаленном вызове
+: output - if the parameter returnResolvedName=1, then the real name of the library and program used in the remote call is returned in these fields
-* '''argc''' количество параметров программы
+* '''argc''' number of program parameters
-* '''argv''' массив из argc элементов - указателей на параметры программы
+* '''argv''' array of argc elements - pointers to program parameters
-* '''argl''' массив длин параметров программы. Каждый элемент массива определяет длину соответствующего элемента массива argv
+* '''argl''' array of program parameter lengths. Each array element defines the length of the corresponding element of the argv array
-* '''sendTimeout''' таймаут (мкс) отправки сообщения в сессию
+* '''sendTimeout''' timeout (µs) for sending a message to a session
-: Если отправка не завершится за указанное время, то i2RpcAPI вернет ошибку I2RC031
+: If the sending does not complete within the specified time, i2RpcAPI will return the error I2RC031
-: если = 0, то используется соответствующий параметр конфигурации сервера
+: if = 0, then the corresponding server configuration parameter is used
-* '''recvTimeout''' таймаут (мкс) приема сообщения от сессии
+* '''recvTimeout''' timeout (µs) for receiving a message from a session
-: Если ответное сообщение от сессии не поступит в течение указанного времени после отправки, то i2RpcAPI вернет ошибку I2RC032
+: If a response message from the session is not received within the specified time after sending, i2RpcAPI will return the error I2RC032
-: если = 0, то используется соответствующий параметр конфигурации сервера
+: if = 0, then the corresponding server configuration parameter is used
 * '''traceIn''' 0/1
-: Если = 1, то в job log сессии будет распечатан массив входных параметров программы в hex формате
+: If = 1, then the program input parameters array will be printed in hex format in the session's job log
 * '''traceOut''' 0/1
-: Если = 1, то в job log сессии будет распечатан массив выходных параметров программы в hex формате
+: If = 1, then the program output parameters array will be printed in hex format in the session's job log
 * '''withJobLog''' 0/1
-: Если = 1, то сервер вернет клиенту содержимое job log сессии, сформированное в процессе вызова программы.
+: If = 1, the server will return to the client the contents of the session's job log generated during the program call
-: Для приема joblog необходимо передать в параметре joblog указатель на область памяти, где должен быть размещен текст протокола задания, и указать в параметре joblogProvided длину данной области
+: To receive joblog, you must pass in the joblog parameter a pointer to the memory area where the text of the job log should be placed, and specify the length of this area in the joblogProvided parameter
 * '''withJobLogOnError''' 0/1
-: Аналогично предыдущему параметру, но job log будет возвращен только в случаях критических сбоев вызова программы
+: Similar to the previous parameter, but the job log will be returned only in cases of critical program call failures
 * '''returnResolvedName''' 0/1
-: Если = 1, то после вызова API в переменных lib/pgm будет возвращено реальное значение использованных при вызове библиотеки и программы
+: If = 1, then after calling the API, the real value of the library and program used when calling will be returned to the lib/pgm variables
 * '''logging''' I/O/B/N/D
-: Указывает что передается в трассировку:
+: Specifies what is passed to the trace:
-:* I - входной PLIST перед вызовом программы
+:* I - input PLIST before calling the program
-:* O - выходной PLIST после вызова программы
+:* O - output PLIST after program call
-:* B - PLIST до и после вызова программы
+:* B - PLISTs before and after calling the program
-:* N - Трассировка не выполняется
+:* N - No tracing performed
-:* D или пробел - Трассировка определяется на основе настроек сервера
+:* D or space - Trace is determined based on server settings
-:: Параметры игнорируются, если на сервере отключена трассировка (нет потоков обработки трассировочных сообщений)
+:: The parameters are ignored if tracing is disabled on the server (there are no threads processing trace messages)
-* '''joblogProvided''' - количество байт, доступных в переменной joblog для приема возвращаемого joblog программы
+* '''joblogProvided''' - the number of bytes available in the joblog variable to receive the program's returned joblog
-* '''joblog''' указатель на область памяти длиной joblogProvided, куда будет размещен joblog вызванной программы
+* '''joblog''' - pointer to a memory area of length joblogProvided where the called program's joblog will be placed
 ==I2RC000003 печать joblog==

@@ Line 308: / Line 308: @@
 If the error parameter is not passed, then in case of errors, i2RpcAPI will generate an escape message. If the error parameter is passed, then after calling i2RpcAPI it will contain the error code and information accompanying the error
-==I2RC000001 подключение к серверу==
+==I2RC000001 connect to server==
-Команда I2RC000001 используется для получения хендлера соединения к серверу i2Rpc. Структура параметров команды I2RC000001:
+The I2RC000001 command is used to obtain a connection handler to the i2Rpc server. The structure of the I2RC000001 command parameters:
   // I2RC000001 - Connect
@@ Line 347: / Line 347: @@
   D  id                           10A                                        Job id
-Параметры:
+Parameters:
-* '''gateway''' адрес сервера i2Rpc (IP адрес или сетевое имя, или имя файла на файловой системе, если сервер запущен на unix-сокете)
+* '''gateway''' address of the i2Rpc server (IP address or network name, or file name on the file system if the server is listening on a unix socket)
-* '''port''' порт сервера i2Rpc. Должно равняться 0, если используется unix-сокет
+* '''port''' i2Rpc server port. Should be 0 if unix socket is used
-* '''statefull''' если = 1, то для данного соединения будет запущено персональное задание, и все RPC вызовы будут адресованы в это задание. Если = 0, то сервер i2Rpc будет использовать любое доступное задание для RPC вызовов в рамках данного соединения
+* '''statefull''' if = 1, then a private job will be submitted for this connection, and all RPC calls will be addressed to this job. If = 0, then the i2Rpc server will use any available stateless job for RPC calls within this connection
-* '''connectTimeout''' таймаут установки соединения. Если=0, по умолчанию используется 5с.
+* '''connectTimeout''' connection timeout. If=0, default is 5s
-* '''contextLength''' длина параметра contextData
+* '''contextLength''' length of the contextData parameter
-* '''contextData''' указатель на данные контекста
+* '''contextData''' pointer to context data
-* '''connection''' handler соединения
+* '''connection''' (output) connection handler
-* '''system''', '''number''', '''user''', '''id''' имя задания, запущенного на сервере i2Rpc для обслуживания данного соединения (только для statefull=1)
+* '''system''', '''number''', '''user''', '''id''' (output) - name of the job running on the i2Rpc server to service this connection (only for statefull=1)
-:Если statefull=0, то данные параметры в ответе не заполняются
+:If statefull=0, then these parameters are not filled in the response
 ==I2RC000002 RPC вызов программ==

@@ Line 273: / Line 273: @@
 <span id="I2RPCAPI/>
-=Использование i2RpcAPI=
+=How to use i2RpcAPI=
-==Параметры вызова i2RpcAPI==
+==i2RpcAPI Call Parameters==
-Для взаимодействия клиентского ПО с сервером i2Rpc, используется программа I2RPCAPI
+For interaction between the client software and the i2Rpc server, the I2RPCAPI program is used
-Прототипы:
+Prototypes:
   #include <QUSEC.h>
@@ Line 284: / Line 284: @@
   D/COPY QSYSINC/QRPGLESRC,QUSEC
-   * Основной модуль i2Rpc API
+   * i2Rpc API
-   * Параметры:
+   * Parameters:
-   *   format  - определяет команду i2Rpc API и формат ее параметров
+   *   format  - defines the i2Rpc API command and the format of its parameters
-   *   ApiData - параметры вызова i2RpcAPI, структура зависит от Format
+   *   ApiData - i2RpcAPI call parameters, structure depends on Format
-   *   error   - (не обязательно) - структура для возврата кода ошибки
+   *   error   - (optional) - structure for returning error code
+   *
   D i2RpcAPI        PR                  EXTPGM('I2RPCAPI')
@@ Line 296: / Line 296: @@
-Формальный список параметров программы i2RpcAPI:
+Formal list of parameters of the i2RpcAPI program:
-* '''format''' - команда i2Rpc, определяет команду i2Rpc и формат ее параметров. Одно из:
+* '''format''' - i2Rpc command, defines the i2Rpc command and the format of its parameters. One of:
 ** I2RC000001
 ** I2RC000002
@@ Line 303: / Line 303: @@
 ** I2RC000004
 ** I2RC000005
-* '''apiData''' - cтруктура, содержащая параметры вызова данной команды
+* '''apiData''' - a structure containing the parameters for calling this command
-* '''error''' (не обязательно) cтандартная структура для обмена информацией об ошибках, в стандартном формате API IBMi QUSEC [https://www.ibm.com/docs/en/ssw_ibm_i_74/apiref/errorcodeformat.htm ERRC0100]
+* '''error'''  (optional) standard structure for exchanging error information, in standard IBMi API QUSEC API IBMi QUSEC [https://www.ibm.com/docs/en/ssw_ibm_i_74/apiref/errorcodeformat.htm ERRC0100]
-Если параметр ошибки не передан, то в случае возникновения ошибок, i2RpcAPI сгенерирует прерывающее escape сообщение. Если параметр ошибки передан, то после вызова i2RpcAPI в нем будет содержаться код ошибки и сопровождающая ошибку информация
+If the error parameter is not passed, then in case of errors, i2RpcAPI will generate an escape message. If the error parameter is passed, then after calling i2RpcAPI it will contain the error code and information accompanying the error
 ==I2RC000001 подключение к серверу==

@@ Line 259: / Line 259: @@
 ''If any of the server configuration parameters are contained both on the command line and in the configuration file, the value of the parameter from the command line takes precedence''
-==Встроенный и внешний сервер трассировки==
+==Embedded and external tracing server==
-Как отмечено в разделе [[#logging_and_tracing|Логирование и трассировка]], для сохранения отладочных сведений о выполнении пользовательских программ, используется специальная user exit программа. Для уменьшения влияния производительности данной user exit программы на совокупную производительность сервера i2Rpc, все процедуры, связанные с трассировкой, вынесены в отдельный сервер трассировки. Сервер представляет собой поток(и), которые ожидают трассировочные сообщения от обработчиков и вызывают user exit программу протоколирования. Сервер может быть запущен как в составе основного задания сервера i2RpcG, так и в отдельном задании.
+As noted in the [[#logging_and_tracing|Logging and Tracing]], a special user exit program is used to save debug information about the execution of user programs. To reduce the impact of the performance of this user exit program on the overall performance of the i2Rpc server, all procedures associated with tracing are moved to a separate tracing server. The server is a thread(s) that wait for tracing messages from sessions and call the user exit logging program. The server can be launched either as part of the main i2RpcG server job or as a separate job
-Для использования встроенного в i2RpcG сервера трассировки, необходимо указать следующие параметры конфигурации сервера:
+To use the embedded i2RpcG tracing server, you must specify the following server configuration parameters:
 * '''logger.embedded''' = true
-* '''logger.listenerThreads''' - значение больше нуля. Определяет количество потоков сервера трассировки, которые будут запущены в составе сервера i2RpcG
+* '''logger.listenerThreads''' - value greater than zero. Defines the number of trace server threads that will be started as part of the i2RpcG server
-Для запуска внешнего сервера протоколирования, необходимо:
+To start an external logging server, you need to:
-* Указать в '''logger.embedded'''=false, '''logger.listenerThreads''' - ненулевое значение
+* Specify '''logger.embedded'''=false, '''logger.listenerThreads''' - non-zero value
-* Запустить внешний сервер протоколирования командой, аналогичной команде запуска основного сервера i2RpcG, используя имя программы I2RPCL вместо I2RPCG, например:
+* Submit job of the external logging server with a command similar to the command to start the main i2RpcG server, using the program name I2RPCL instead of I2RPCG, for example:
 :<code>SBMJOB CMD(CALL PGM(<b>I2RPCL</b>) PARM('--config=/home/i2rpc/config.json' '--stateless.minJobs' '1')) ALWMLTTHD(*YES)</code>

@@ Line 243: / Line 243: @@
 ==Startup parameters==
-Параметры конфигурации экземпляра сервера i2RPC указываются в параметрах вызова программы I2RPCG, в формате:
+The i2Rpc server instance configuration parameters are specified in the I2RPCG program call parameters, in the following format:
-<code>--parameter=value</code> или
+<code>--parameter=value</code> or
-<code>--parameter value</code> или
+<code>--parameter value</code> or
-<code>--parameter</code> - если параметр представляет собой некий признак, и не предусматривает указания значения
+<code>--parameter</code> - if the parameter is a certain flag and does not require specifying a value
-Пример:
+Example:
 <code>SBMJOB CMD(CALL PGM(I2RPCG) PARM('--config=/home/i2rpc/config.json' '--stateless.minJobs' '1')) ALWMLTTHD(*YES)</code>
-Параметр --config, если указан, определяет имя файла, содержащего параметры конфигурации экземпляра сервера. Файл должен иметь кодировку 1208 (utf-8), и содержать валидный json объект с атрибутами, соответствующими параметрам конфигурации сервера.
+The --config parameter, if entered, specifies the name of the file containing the server instance configuration parameters. The file must be encoded as 1208 (utf-8), and contain a valid json object with attributes corresponding to the server configuration parameters
-''Если какой-то из параметров конфигурации сервера содержится и в командной строке, и в файле конфигурации, то значение параметра из командной строки имеет преимущество''
+''If any of the server configuration parameters are contained both on the command line and in the configuration file, the value of the parameter from the command line takes precedence''
 ==Встроенный и внешний сервер трассировки==

@@ Line 240: / Line 240: @@
 The parameters of the SBMJOB command can be anything, however:
 * ALWMLTTHD(*YES) - mandatory parameter
-* The I2RPCG program must be present in the library list
+* The I2RPCG program must be presented in the library list
 ==Startup parameters==

@@ Line 233: / Line 233: @@
 :* '''none''' - no application logging is performed
-=Запуск сервера=
+=Starting the server=
-Для старта экземпляра сервера i2RPC необходимо запустить новое пакетное задание, в котором должна быть выполнена команда вызова основной программы сервера i2RPC:
+To start an instance of the i2Rpc server, you need to start a new batch job, in which the command to call the main program of the i2Rpc server must be executed:
-<code>SBMJOB CMD(CALL PGM(I2RPCG) PARM(<Параметры командной строки>)) ALWMLTTHD(*YES)</code>
+<code>SBMJOB CMD(CALL PGM(I2RPCG) PARM(<startup parameters>)) ALWMLTTHD(*YES)</code>
-Параметры команды SBMJOB могут быть любыми, однако:
+The parameters of the SBMJOB command can be anything, however:
-* ALWMLTTHD(*YES) - обязательный параметр
+* ALWMLTTHD(*YES) - mandatory parameter
-* Программа I2RPCG должна присутствовать в списке библиотек
+* The I2RPCG program must be present in the library list
-'''''TODO:''''' Требуемая авторизация пользователя, который запускает I2RPCG
+==Startup parameters==
 Параметры конфигурации экземпляра сервера i2RPC указываются в параметрах вызова программы I2RPCG, в формате:
@@ Line 274: / Line 272: @@
 <span id="I2RPCAPI/>
 =Использование i2RpcAPI=
 ==Параметры вызова i2RpcAPI==

@@ Line 211: / Line 211: @@
 * '''contextSetExit''' - the name of the user exit program called in the session before calling the program if the session [[#I2RC000005|context has been changed]]
-===Секция logger===
+===Section logger===
-Данная секция предназначена для настройки параметров протоколирования вызовов RPC прикладной программой трассировки (см. [[#Логирование и трассировка|Логирование и трассировка]])
+This section is intended for configuring the parameters for logging RPC calls by the tracing application (see [[#Logging and Tracing|Logging and Tracing]])
-Протоколирование параметров вызовов RPC внешней user exit программой - достаточно нагруженная процедура, поэтому в целях оптимизации вычислительных ресурсов задача протоколирования может быть отделена от основного задания сервера i2Rpc и вынесена в изолированное задание. То есть можно говорить об использовании встроенного и внешнего протоколирования вызовов RPC. За это отвечает параметр '''embedded'''.
+Logging of RPC call parameters by an external user exit program is a fairly loaded procedure, therefore, in order to optimize resources, the logging job can be separated from the main job of the i2Rpc server and moved to an isolated job. That is, we are talking about using built-in and external logging of RPC calls. The '''embedded''' parameter is responsible for this
-Сервер протоколирования (встроенный или внешний) - это многопоточный сервер, в котором организована внутренняя очередь сообщений, подлежащих передаче в user exit программу протоколирования. Для передачи сообщений от сессий в сервер протоколирования используется отдельный unix сокет (файл на файловой системе IFS), который определяется в настройках сервера
+The logging server (embedded or external) is a multi-threaded server that has an internal queue of messages to be transferred to the user exit logging program. A separate UUNIX socket (file link on the IFS file system) is used to transfer messages from sessions to the logging server. The link is defined in the server settings
-* <span id="embedded_logger">'''embedded''' - Признак использования встроенного в gateway прикладного трассировщика
-: Если embedded=false, для логирования  вызовов можно запустить отдельное задание логирования
+* <span id="embedded_logger">'''embedded''' - Flag for using the gateway's built-in application logger
-: Задание имеет те же параметры, что и основное задание gateway, только вместо <code>CALL I2RPCG</code> должен быть сделан <code>CALL I2RPCL</code>
+: If embedded=false, a separate logging job can be started to log calls
-* '''listenerThreads''' - количество потоков сервера протоколирования. При использовании встроенного сервера протоколирования, данные потоки запускаются параллельно с остальными потоками сервера i2Rpc
+: The job has the same parameters as the main gateway job, only <code>CALL I2RPCL</code> must be specified instead of <code>CALL I2RPCG</code>
-* '''link''' - линк (сокет), который используется для передачи сообщений серверу протоколирования
+* '''listenerThreads''' - the number of logging server threads. When using the built-in logging server, these threads are started in parallel with the other i2Rpc server threads
-: По умолчанию формируется в виде <code>/tmp/I2R@<port>_log.do_not_delete</code>, где port - номер порта gateway
+* '''link''' - a link (socket) that is used to transmit messages to the logging server
-: Сервер протоколирования и сессии должны иметь доступ к указанному ресурсу
+: By default, it is generated in the form <code>/tmp/I2R@<port>_log.do_not_delete</code>, where port is the gateway port number
-: Удаление линка в момент работы сервера ЗАПРЕЩЕНО
+: The logging server and sessions must have access to the specified resource
-* <span id="embedded_logger_program">'''program''' - имя программы, которая выполняет прикладное протоколирование вызовов RPC
+: Removing a link while the server is running is PROHIBITED
-* '''events''' - какие сообщения подлежат протоколированию. Возможные варианты:
+* <span id="embedded_logger_program">'''program''' - the name of the program that performs application logging of RPC calls
-:* '''output''' - сохраняются только ответные сообщения
+* '''events''' - which messages are subject to logging. Possible options:
-:* '''input''' - сохраняются только входящие запросы
+:* '''input''' - only incoming requests (before-PLISTs) are logged
-:* '''both/inputoutput''' - сохраняются входящие запросы и ответные сообщения
+:* '''output''' - only responses (after-PLISTs) are logged
-:* '''none''' - протоколирование не выполняется
+:* '''both/inputoutput''' - incoming requests and responses are logged
 =Запуск сервера=

@@ Line 170: / Line 170: @@
 * '''contextSetExit''' - the name of the user exit program called in the session if [[#I2RC000005|the session context has been changed]]
-===Секция statefull===
+===Section statefull===
-* '''job, user''' - имя работы и пользователя запускаемыx statefull сессий.
+* '''job, user''' - name of the job and user of the submitted statefull sessions
-: Если что-то не указано, по умолчанию используются параметры из клиентского задания. То есть, если что-то из job или user не указаны, и например запущенное задание данного клиента i2Rpc - 123456/I2RUSER/I2RPCC, запущено под профилем I2RPRF, то statefull сессии, запускаемые для данного клиента, будут запускаться под профилем I2RPRF, и будут иметь имя NNNNNN/I2RUSER/I2RPCC
+: If something is not specified, the parameters from the client job are used by default. That is, if something from job or user is not specified, and for example the job of this i2Rpc client is 123456/I2RUSER/I2RPCC, running under the I2RPRF profile, then statefull sessions submitted for this client will be run under the I2RPRF profile, and will have the name NNNNNN/I2RUSER/I2RPCC
-* '''submit''' - команда запуска statefull сессии.
+* '''submit''' - command to submit a statefull session
-: Указывается шаблон команды SBMJOB, которую сервер будет использовать для запуска новых statefull сессий. Можно указать любые параметры команды SBMJOB, за исключением параметра CMD. Параметр CMD формируется сервером самостоятельно
+: Specifies the template of the SBMJOB command that the server will use to start new statefull sessions. You can specify any parameters of the SBMJOB command, except for the CMD parameter. The CMD parameter is generated by the server itself
-: В шаблоне команды можно использовать следующие макроподстановки - при формировании команды данные макроподстановки будут заменены на соответствующие параметры конфигурации
+: The following macro substitutions can be used in the command template - when forming a command, these macro substitutions will be replaced with the corresponding configuration parameters
 :* ${gateway.link}
 :* ${gateway.debugLevel}
@@ Line 190: / Line 190: @@
 :* ${statefull.user}
 :* ${statefull.init}
-:* ${statefull.profile} - этот параметр определяется на основе наименования профайла, под которым работает исходное клиентское задание
+:* ${statefull.profile} - this parameter is determined based on the name of the profile under which the original client job is running
-:* ${statefull.system} - этот параметр содержит имя системы, в которой запущено исходное клиентское задание
+:* ${statefull.system} - this parameter contains the name of the system on which the original client job is running
-: По умолчанию используется значение:
+: The default value is:
 :<code>SBMJOB JOB(${statefull.job}) USER(${statefull.user})</code>
-* '''init''' - команда инициализации задания сессии. Будет выполнена первой командой в сессии, сразу после запуска задания
+* '''init''' - the command to initialize the session job. It will be executed by the first command in the session, immediately after the job is started
-: По умолчанию *NONE - команда инициализации не выполняется
+: Default is *NONE - the initialization command is not executed
-* '''submitTimeout''' - время ожидания готовности задания сессии на стороне сервера (мкс).
+* '''submitTimeout''' - the time to wait for the session job to be ready (µs)
-: Если после запуска сессии прошло указанное время, но сессия не подключилась к серверу, то считается что сессия не стартовала, клиент получит сообщение об ошибке I2RC005 "Unable to get i2Rpc connection. Session submit timed out"
+: If session has started and the specified time has passed, but the session has not connected to the server, then it is considered that the session has not started, the client will receive the error message I2RC005 "Unable to get i2Rpc connection. Session submit timed out"
-* '''jobTimeout''' - время неактивности (мкс).
+* '''jobTimeout''' -  inactivity time (µs)
-: Если сессия не получает запросов в течение указанного времени, она будет завершена
+: If the session does not receive requests within the specified time, it will be terminated
-: По умолчанию = 5000000, (5 секунд)
+: Default = 5000000, (5 seconds)
-* '''maxJobs''' - максимальное количество statefull сессий, 0 - не ограничено
+* '''maxJobs''' - maximum number of statefull sessions, 0 - unlimited
-: По умолчанию 0 - не ограничено
+: Default 0 - unlimited
-* '''sendTimeout''' - время, в течение которого клиент ожидает отправки сообщения в сессию
+* '''sendTimeout''' - the time the client waits for a message to be sent to the session
-: Если клиент не указал параметр sendTimeout при вызове RPC процедуры, то по умолчанию используется данное значение. i2RpcAPI ожидает завершения отправки указанное количество микросекунд, и если отправка не завершена - клиент получит сообщение об ошибке I2RC031
+: If the client does not specify the sendTimeout parameter when calling the RPC procedure, then this value is used by default. i2RpcAPI waits for the specified number of microseconds to complete sending, and if sending is not completed, the client will receive an error message I2RC031
-: По умолчанию 5000000 (5 секунд)
+: Default 5000000 (5 seconds)
-* '''receiveTimeout''' - время, в течение которого клиент ожидает приема сообщения от сессии
+* '''receiveTimeout''' - the time during which the client waits to receive a message from the session
-: Используется аналогично sendTimeout, для ограничения времени, затрачиваемого на прием ответа от сессии. Если прием ответа от сессии не будет завершен в течение receiveTimeout микросекунд после отправки - клиент получит сообщение об ошибке I2RC032
+: Used similarly to sendTimeout, to limit the time spent on receiving a response from the session. If the response from the session is not completed within receiveTimeout microseconds after sending, the client will receive an error message I2RC032
-: По умолчанию 5000000 (5 секунд)
+: Default 5000000 (5 seconds)
-* '''contextSetExit''' - имя user exit программы, вызываемой в сессии перед вызовом программы, если [[#I2RC000005 изменение контекста вызова|контекст сессии был изменен]]
+* '''contextSetExit''' - the name of the user exit program called in the session before calling the program if the session [[#I2RC000005|context has been changed]]
 ===Секция logger===

@@ Line 480: / Line 480: @@
 * '''connection''' указатель на хэндлер соединения, полученный ранее командой I2RC000001
 <span id="I2RC000005"/>
 ==I2RC000005 Set/update client context==
 Команда I2RC000005 позволяет клиенту выполнить установку/изменение клиентского [[#session_context|контекста сессии]]. Данный вызов сохраняет/заменяет содержимое области данных клиентского контекста, эти данные передаются серверу i2Rpc при всех последующих вызовах программ командой I2RC000002.