jetstream-api 0.6.0__tar.gz → 0.6.2__tar.gz

{jetstream_api-0.6.0 → jetstream_api-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.0
+Version: 0.6.2
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.6.0 → jetstream_api-0.6.2}/ilink/__init__.py

@@ -1,6 +1,6 @@
 """iLink - Python client API for iLink M.O.M. (Message Oriented Middleware)."""
 
-__version__ = "0.6.0"
+__version__ = "0.6.2"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser

{jetstream_api-0.6.0 → jetstream_api-0.6.2}/ilink/admin.py

@@ -3430,9 +3430,13 @@ class ILAdminQmgr:
             ILOperationException: 엔진이 6.3.3(rev 3067) 미만일 때.
 
         Note:
-            유량 통계는 6.3.4 에서 들어왔다. 구엔진은 요청 코드 자체를 모르므로
-            응답이 없거나 엉뚱한 리포트가 온다. 무엇이 잘못됐는지 알 수 없는
-            타임아웃 대신 **왜 안 되는지 적힌 예외**로 끊는다.
+            배열 요청(3344)은 엔진 6.3.3.3067 에서 들어왔다. 그 미만 엔진은 이
+            코드를 모르고 ``MIMQE_INVALID_REQ_CODE`` 를 돌려준다 - 즉시 응답이라
+            행이 나지는 않지만(6.3.1 에서 7ms, 실측), 호출자에게는 **왜 안 되는지
+            적힌 예외**가 더 쓸모가 있다.
+
+            **단건 조회에는 이 게이트를 걸지 않는다.** 요청 코드 3201 은 훨씬
+            오래된 코드라 6.3.1.2813 에서도 정상 응답한다(실측).
         """
         if 0 < self.revision < ILC.QUEUE_FLOW_ARRAY_MIN_REVISION:
             raise ILOperationException(
@@ -3793,14 +3797,19 @@ class ILAdminQmgr:
             ``getIncomingDataSize()`` / ``getOutgoingDataSize()`` / ``getDepth()``).
 
         Raises:
-            ILOperationException: 그런 큐가 없을 때. 또는 엔진이 6.3.4(rev 3299)
-                미만이라 유량 통계 자체를 지원하지 않을 때.
+            ILOperationException: 그런 큐가 없을 때.
             ILException: 통신 실패.
 
         Note:
             **한 시점의 스냅샷**이다. 시간에 따른 추이를 보려면
             :meth:`getQueueFlowInfoArray` 를 쓴다.
 
+            **구엔진에서도 동작한다.** 요청 코드 3201 은 오래된 코드라
+            6.3.1.2813 / 6.3.2.2856 / 6.3.3.3155 / 7.0.1.3366 네 엔진 모두에서
+            유입/유출 건수와 깊이를 정상으로 받았다(실측: put 5건 후
+            in=5 out=0 depth=5). 여러 구간을 한 번에 보는
+            :meth:`getQueueFlowInfoArray` 만 6.3.3(rev 3067) 이상이 필요하다.
+
         .. note:: 값은 **1초 주기**로 채워진다
 
             유량 스냅샷은 서버가 1초마다 적재한다. 그래서 갓 만든 큐도 **조회
@@ -3861,8 +3870,11 @@ class ILAdminQmgr:
             실제 기록이 그보다 적으면 0 으로 채운 항목이 들어간다.
 
         Raises:
-            ILOperationException: 그런 큐가 없을 때. 또는 엔진이 6.3.4(rev 3299)
-                미만이라 유량 통계 자체를 지원하지 않을 때.
+            ILOperationException: 그런 큐가 없을 때. 또는 엔진이 6.3.3(rev 3067)
+                미만이라 **배열** 조회(요청 코드 3344)를 지원하지 않을 때.
+                단건 :meth:`getQueueFlowInfo` 는 그보다 오래된 엔진에서도
+                동작하므로, 구엔진까지 지원해야 하면
+                ``ILRC.MIMQE_NOT_SUPPORTED`` 를 받았을 때 단건으로 폴백하라.
             ILException: 통신 실패.
 
         Note:

{jetstream_api-0.6.0 → jetstream_api-0.6.2}/ilink/common.py

@@ -734,15 +734,15 @@ class ILC:
     #: 큐 속성이 2200 레이아웃으로 바뀐 **첫 엔진 리비전**(6.3.3.3155).
     #: 이 값보다 낮으면 4096 레이아웃으로 주고받아야 한다.
     QUEUE_LAYOUT_MIN_REVISION = 3155
-    #: 구버전(4096) 블롭에서 공통 접두가 끝나고 레이아웃이 갈리는 지점.
-    #: 큐 **유량 통계** 조회가 들어온 첫 엔진 리비전(6.3.4.3299).
-    # 큐 유량 통계 **배열** 조회(요청 3344)가 들어온 첫 리비전(6.3.3.3067).
-    # 단건 조회(3201)는 훨씬 오래된 코드라 6.3.1.2813 에서도 응답한다(실측).
+    #: 큐 유량 통계 **배열** 조회(요청 코드 3344)가 들어온 첫 엔진 리비전(6.3.3.3067).
+    #: 단건 조회(3201)는 훨씬 오래된 코드라 6.3.1.2813 에서도 정상 응답한다(실측) -
+    #: 이 기준은 **배열에만** 적용된다.
     QUEUE_FLOW_ARRAY_MIN_REVISION = 3067
-    # 큐관리자 속성의 토픽 로거 구간(20바이트)이 들어온 첫 리비전(7.1.1.3283).
-    # 그 자리는 구엔진의 volumeMonitorForceReloadSize 다 - 값을 실어 보내면
-    # 구엔진 imqlsr 가 SIGFPE 로 죽는다(6.3.1.2813 실측).
+    #: 큐관리자 속성의 **토픽 로거** 구간(20바이트)이 들어온 첫 엔진 리비전(7.1.1.3283).
+    #: 그 자리는 구엔진의 ``volumeMonitorForceReloadSize`` 다 - 값을 실어 보내면
+    #: 구엔진 imqlsr 가 SIGFPE 로 죽는다(6.3.1.2813 실측).
     TOPIC_LOGGER_MIN_REVISION = 3283
+    #: 구버전(4096) 블롭에서 공통 접두가 끝나고 레이아웃이 갈리는 지점.
     QUEUE_LEGACY_DIVERGE_OFFSET = 1772
     #: 구버전(4096) 블롭에서 incomingDelayDepth 가 있는 위치. 현행과 같다.
     QUEUE_LEGACY_TAIL_OFFSET = 2142

{jetstream_api-0.6.0 → jetstream_api-0.6.2}/ilink/properties.py

@@ -28,6 +28,9 @@ def _format_millis(value: int, fmt: str) -> str:
 
 # 구엔진(rev 3283 미만)의 StorageVolumeMonitor ForceReloadSize 기본값.
 LEGACY_FORCE_RELOAD_SIZE = 1048576
+# 구엔진(6.3.x)의 TCPListener SessionPerThread 기본값.
+# 0 이면 imqlsr 가 nSessionCnt / nSessionPerThread 에서 0 나눗셈으로 죽는다.
+LEGACY_SESSION_PER_THREAD = 10
 
 def _spec_maxlen(n):
     """``n`` 바이트 이하 문자열 규칙."""
@@ -2479,6 +2482,7 @@ class ILQmgrProperty(_AutoAccessor):
         self.volumeMonitorInterval = 10
         self.volumeMonitorSizeLimit = 10485760
         self._volumeTailRaw = None
+        self._sessionPerThreadRaw = None
         self.logLevelSystem = 4
         self.logFileSizeSystem = 4194304
         self.logFileCountSystem = 5
@@ -2628,6 +2632,11 @@ class ILQmgrProperty(_AutoAccessor):
             offset += 2
             self.aclType = ba_pick_int(ba, offset, 2)
             offset += 2
+            # v6.3.4 에서 async 를 없애며 sessionPerThread 를 뺐지만
+            # **구엔진(6.3.x)에는 실재하는 필드**다. 0 을 보내면 imqlsr 가
+            # nSessionCnt / nSessionPerThread 에서 죽는다(ManagerListener.h:129,
+            # SIGFPE - 6.3.1 실측). 원본을 보관해 되돌려 쓴다.
+            self._sessionPerThreadRaw = bytes(ba[offset:offset + 10])
             offset += 10
             self.deadLetterQueueName = ba_pick_string(ba, offset, 32)
             offset += 32
@@ -2692,7 +2701,14 @@ class ILQmgrProperty(_AutoAccessor):
         offset += 10
         ba_merge(self.recvWaitTimeout, ba, offset)
         offset += 10
-        offset += 20
+        # v6.3.4 에서 async 를 없애며 acceptPoolSize/eventPoolSize 를 뺐지만
+        # 구엔진(6.3.x)은 이 두 필드를 읽고 1~9 로 검증한다. 0 을 보내면
+        # MIMQE_INVALID_ARGUMENT (AcceptPoolSize : 0) 로 거부된다(6.3.1 실측).
+        # 자바는 v1.5.2 에서 같은 이유로 기본값 1 을 되살렸다 - 그것과 맞춘다.
+        ba_merge(1, ba, offset)
+        offset += 10
+        ba_merge(1, ba, offset)
+        offset += 10
         ba_merge(self.volumeMonitorInterval, ba, offset)
         offset += 10
         ba_merge(self.volumeMonitorSizeLimit, ba, offset)
@@ -2738,6 +2754,8 @@ class ILQmgrProperty(_AutoAccessor):
         offset += 2
         ba_merge(self.aclType, ba, offset)
         offset += 2
+        # 구엔진에만 있는 sessionPerThread 자리 - 0 을 보내면 큐관리자가 죽는다
+        session_offset = offset
         offset += 10
         ba_merge(self.deadLetterQueueName, ba, offset)
         offset += 32
@@ -2755,6 +2773,12 @@ class ILQmgrProperty(_AutoAccessor):
             else:
                 # 새로 만든 객체라 받은 값이 없다 - 엔진 기본값을 쓴다
                 ba_merge(LEGACY_FORCE_RELOAD_SIZE, ba, topic_offset)
+            # 구엔진에만 있는 sessionPerThread 도 되돌려 준다
+            raw2 = getattr(self, "_sessionPerThreadRaw", None)
+            if raw2:
+                ba[session_offset:session_offset + 10] = raw2
+            else:
+                ba_merge(LEGACY_SESSION_PER_THREAD, ba, session_offset)
         return bytes(ba)
 
     def get_status_string(self) -> str:
@@ -3649,7 +3673,14 @@ class ILServiceProperty(_AutoAccessor):
         offset += 10
         ba_merge(self.timeoutSocketRecv, ba, offset)
         offset += 10
-        offset += 20
+        # v6.3.4 에서 async 를 없애며 acceptPoolSize/eventPoolSize 를 뺐지만
+        # 구엔진(6.3.x) ilsvc 는 이 값으로 스레드 풀을 만든다
+        # (ILinkServerMainClass.cpp:151, ServerListener.cpp:17). 0 이면 풀이 0개다.
+        # 자바는 v1.5.2 에서 기본값 1 을 되살렸다 - 그것과 맞춘다.
+        ba_merge(1, ba, offset)
+        offset += 10
+        ba_merge(1, ba, offset)
+        offset += 10
         ba_merge(self.logLevelSystem, ba, offset)
         offset += 2
         ba_merge(self.logFileSizeSystem, ba, offset)

{jetstream_api-0.6.0 → jetstream_api-0.6.2}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.0
+Version: 0.6.2
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.6.0 → jetstream_api-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "jetstream-api"
-version = "0.6.0"
+version = "0.6.2"
 description = "Python client API for iLink M.O.M. (Message Oriented Middleware)"
 authors = [{name = "snowjeans"}]
 readme = "README.md"