jetstream-api 0.24.0__tar.gz → 0.25.0__tar.gz

{jetstream_api-0.24.0/jetstream_api.egg-info → jetstream_api-0.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.24.0
+Version: 0.25.0
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003
@@ -60,6 +60,25 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.25.0 변경 - 서비스 속성 · 로거 Property v2(JSON) · 블롭 왕복 보존 (자바 v2.21.0 와 같음, 짝 엔진 7.0.1.3624 이상)
+
+- **서비스 속성이 엔진 7 과 JSON 으로 오간다**(엔진 P5-2). ``ILAdminService.getProperty`` 는 SERVICE GET + LOGGER LIST(시스템 ·
+  클라이언트 로그 칸), ``setProperty`` 는 **바꾼 칸만** SERVICE ALTER + 바뀐 로그 카테고리마다 LOGGER ALTER 다. 6.x 엔진은 기존 블롭.
+  ☠ **7.0.1.3623 이하 7.x 엔진에는 서비스 속성 조회 · 변경이 거절된다.**
+- 더함: ``ILAdminService.setPropertyWithResult`` (``ILPropertyResult``, 로그 키는 ``LOGGER.SYS.LEVEL`` 모양, ``IP`` 는 ``RESTART`` -
+  재기동 뒤 반영, 나머지는 ``NOW``). 요청이 둘 이상이라 **원자적이지 않다** - 로거 변경이 거절되면 사유 뒤에
+  ``[LOGGER <카테고리> 거절 - 이미 적용: SERVICE, ...]`` 가 붙는다(이미 적용된 쪽은 되돌리지 않는다).
+- **서비스 · 큐관리자 속성 블롭 왕복 보존**: 읽은 객체를 그대로 ``setProperty`` 로 되보내면 엔진이 준 바이트가 그대로 나간다.
+  전에는 클라가 모르는 자리(하위호환 로그 칸 · 스레드 풀 칸 등)를 0 이나 기본값으로 덮었다.
+- 문자열 상한을 엔진과 맞췄다: 큐 설명(``description``) **199바이트**(0.23.0 은 200), 서비스 IP 99 · 이름 47 · 허브 IP 23 · HOMEPATH 99
+  (엔진 7.0.1.3623 이상과 같다). 옛 판에서 저장된 더 긴 값은 읽기 · 되보내기에서 거절되지 않는다(읽을 때는 상한을 묻지 않는다).
+- 서비스 ``aclType`` · ``relayType`` 은 0/1 만 받는다(그 밖은 엔진 7.0.1.3619 이상이 거절, 엔진 7 JSON 경로는 클라가 먼저 거절).
+- 채널: 종류 · 방향을 바꿔 ``setChannelProperty`` 를 부르면 엔진 7 은 ``MIMQE_IMMUTABLE_PROPERTY (TYPE fixed at <현재 값>)`` 로 거절하고,
+  6.x 블롭은 조용히 옛 값을 유지한다(문서 정정 - 옛 문구 "다르면 NOT_FOUND" 는 틀렸다). TLS 채널을 JSON 으로 만들거나 바꾸는 것은 엔진
+  7.0.1.3617 이상에서 맞다(그 전 판은 기본 인증서를 채우지 않아 ``MIMQE_SSL_ERROR``).
+- 세션: 엔진 7.0.1.3617 이상에서 ``destroyedTime`` 이 ``-1`` 이 아니면 끊긴 세션(보관 중)이다 - 상태는 ``EXCEPTION`` 일 수 있다.
+  그 전 판은 끊긴 세션도 ``-1`` 이라 가릴 수 없다.
+
 ## 0.24.0 변경 - 채널 · 세션 Property v2(JSON) · IBMMQ 채널 종류 (자바 v2.20.0 와 같음, 짝 엔진 7.0.1.3615 이상)
 
 - **채널 관리가 엔진 7 과 JSON(Property v2) 으로 오간다**(엔진 P4). 함수 이름은 그대로 - ``createChannel`` · ``setChannelProperty`` ·

{jetstream_api-0.24.0 → jetstream_api-0.25.0}/README.md

@@ -10,6 +10,25 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.25.0 변경 - 서비스 속성 · 로거 Property v2(JSON) · 블롭 왕복 보존 (자바 v2.21.0 와 같음, 짝 엔진 7.0.1.3624 이상)
+
+- **서비스 속성이 엔진 7 과 JSON 으로 오간다**(엔진 P5-2). ``ILAdminService.getProperty`` 는 SERVICE GET + LOGGER LIST(시스템 ·
+  클라이언트 로그 칸), ``setProperty`` 는 **바꾼 칸만** SERVICE ALTER + 바뀐 로그 카테고리마다 LOGGER ALTER 다. 6.x 엔진은 기존 블롭.
+  ☠ **7.0.1.3623 이하 7.x 엔진에는 서비스 속성 조회 · 변경이 거절된다.**
+- 더함: ``ILAdminService.setPropertyWithResult`` (``ILPropertyResult``, 로그 키는 ``LOGGER.SYS.LEVEL`` 모양, ``IP`` 는 ``RESTART`` -
+  재기동 뒤 반영, 나머지는 ``NOW``). 요청이 둘 이상이라 **원자적이지 않다** - 로거 변경이 거절되면 사유 뒤에
+  ``[LOGGER <카테고리> 거절 - 이미 적용: SERVICE, ...]`` 가 붙는다(이미 적용된 쪽은 되돌리지 않는다).
+- **서비스 · 큐관리자 속성 블롭 왕복 보존**: 읽은 객체를 그대로 ``setProperty`` 로 되보내면 엔진이 준 바이트가 그대로 나간다.
+  전에는 클라가 모르는 자리(하위호환 로그 칸 · 스레드 풀 칸 등)를 0 이나 기본값으로 덮었다.
+- 문자열 상한을 엔진과 맞췄다: 큐 설명(``description``) **199바이트**(0.23.0 은 200), 서비스 IP 99 · 이름 47 · 허브 IP 23 · HOMEPATH 99
+  (엔진 7.0.1.3623 이상과 같다). 옛 판에서 저장된 더 긴 값은 읽기 · 되보내기에서 거절되지 않는다(읽을 때는 상한을 묻지 않는다).
+- 서비스 ``aclType`` · ``relayType`` 은 0/1 만 받는다(그 밖은 엔진 7.0.1.3619 이상이 거절, 엔진 7 JSON 경로는 클라가 먼저 거절).
+- 채널: 종류 · 방향을 바꿔 ``setChannelProperty`` 를 부르면 엔진 7 은 ``MIMQE_IMMUTABLE_PROPERTY (TYPE fixed at <현재 값>)`` 로 거절하고,
+  6.x 블롭은 조용히 옛 값을 유지한다(문서 정정 - 옛 문구 "다르면 NOT_FOUND" 는 틀렸다). TLS 채널을 JSON 으로 만들거나 바꾸는 것은 엔진
+  7.0.1.3617 이상에서 맞다(그 전 판은 기본 인증서를 채우지 않아 ``MIMQE_SSL_ERROR``).
+- 세션: 엔진 7.0.1.3617 이상에서 ``destroyedTime`` 이 ``-1`` 이 아니면 끊긴 세션(보관 중)이다 - 상태는 ``EXCEPTION`` 일 수 있다.
+  그 전 판은 끊긴 세션도 ``-1`` 이라 가릴 수 없다.
+
 ## 0.24.0 변경 - 채널 · 세션 Property v2(JSON) · IBMMQ 채널 종류 (자바 v2.20.0 와 같음, 짝 엔진 7.0.1.3615 이상)
 
 - **채널 관리가 엔진 7 과 JSON(Property v2) 으로 오간다**(엔진 P4). 함수 이름은 그대로 - ``createChannel`` · ``setChannelProperty`` ·

{jetstream_api-0.24.0 → jetstream_api-0.25.0}/ilink/__init__.py

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

{jetstream_api-0.24.0 → jetstream_api-0.25.0}/ilink/admin.py

@@ -100,6 +100,46 @@ def _session_get_v2(service, qmgrName: str, sessionId: str) -> ILSessionProperty
     return ILSessionProperty()._pv2_from_body(_propv2.request(service, qmgrName, _propv2.PROP_GET, {"_TYPE": "SESSION", "ID": sessionId}))
 
 
+# ── 다음 판 Property v2 SERVICE + LOGGER(엔진 P5-2) ── 서비스 레벨(큐관리자 이름 빈칸)
+
+def _service_get_v2(service) -> ILServiceProperty:
+    prop = ILServiceProperty()._pv2_from_body(_propv2.request(service, "", _propv2.PROP_GET, {"_TYPE": "SERVICE"}))
+    items = _propv2.request(service, "", _propv2.PROP_LIST, {"_TYPE": "LOGGER"}).get("_ITEMS", []) or []
+    if not isinstance(items, list):
+        raise _propv2.PropV2Error("_ITEMS must be ARRAY of OBJ")
+    return prop._pv2_logger_fill(items)
+
+
+def _service_set_v2(service, prop: ILServiceProperty) -> ILPropertyResult:
+    # SERVICE ALTER(바뀐 칸) 뒤 바뀐 카테고리마다 LOGGER ALTER. 원자성은 없다 - 실패하면 이미 적용된 쪽을 사유에 붙인다(엔진 합의)
+    merged = {"_APPLIED": [], "_IGNORED": [], "_NORMALIZED": []}
+    done = []
+
+    def merge(r: dict, prefix: str) -> None:
+        for k in merged:
+            for e in r.get(k, []) or []:
+                if isinstance(e, dict):
+                    merged[k].append(dict(e, KEY=prefix + str(e.get("KEY", ""))))
+
+    body = prop._pv2_patch_body()
+    if body:
+        merge(_propv2.request(service, "", _propv2.PROP_ALTER, dict({"_TYPE": "SERVICE"}, **body)), "")
+        prop._pv2_clear()
+        done.append("SERVICE")
+    for lb in prop._pv2_logger_patches():
+        cat = lb["CATEGORY"]
+        try:
+            r = _propv2.request(service, "", _propv2.PROP_ALTER, lb)
+        except ILOperationException as exc:
+            raise ILOperationException("%s [LOGGER %s 거절%s]" % (exc, cat, (" - 이미 적용: " + ", ".join(done)) if done else ""), exc) from exc
+        merge(r, "LOGGER.%s." % cat)
+        snap = dict(prop.__dict__.get("_il_log_snap") or ILServiceProperty()._pv2_log_now())
+        snap[cat] = prop._pv2_log_now()[cat]
+        object.__setattr__(prop, "_il_log_snap", snap)
+        done.append("LOGGER " + cat)
+    return ILPropertyResult(merged)
+
+
 class ILAdminService:
     """ilink 서버를 **관리**하는 클라이언트. 큐 관리자 생성/기동/속성 변경을 맡는다.
 
@@ -381,12 +421,16 @@ class ILAdminService:
             **읽은 뒤 고쳐서 :meth:`setProperty` 로 되돌려주는 방식**이다.
             빈 객체를 새로 만들어 넣으면 지정하지 않은 항목이 기본값으로 덮인다.
 
+            엔진 7 이면 JSON 으로 받는다(다음 판) - 서비스 칸은 SERVICE GET, 로그 칸(시스템 · 클라이언트)은 LOGGER LIST 다.
+
         Example::
 
             prop = svc.getProperty()
             print(prop.isTraceEnabled())
         """
         try:
+            if _propv2.peer_speaks_v2(self.version):   # 다음 판(엔진 P5-2): 7 이면 SERVICE GET + LOGGER LIST(JSON), 6.x 면 아래 블롭
+                return _service_get_v2(self.service)
             res_msg = self.service.inquire(ILC.MIMQ_GET_SERVER_PROPERTY)
             return ILServiceProperty(res_msg.getDataMsg().getData())
         except _PASSTHROUGH_EXCEPTIONS:
@@ -398,7 +442,8 @@ class ILAdminService:
         """서버 전체(ilsvc) 속성을 변경한다.
 
         Args:
-            vo (ILServiceProperty): 반영할 설정. **전체가 통째로 덮어써진다.**
+            vo (ILServiceProperty): 반영할 설정. 6.x 엔진에는 **전체가 통째로 덮어써진다.** 엔진 7 에는 바꾼 칸만 간다(다음 판,
+                :meth:`setPropertyWithResult` 참고 - 요청이 둘 이상이라 원자적이지 않다).
 
         Raises:
             ILOperationException: 서버가 변경을 거절했을 때.
@@ -415,6 +460,9 @@ class ILAdminService:
             svc.setProperty(prop)
         """
         try:
+            if _propv2.peer_speaks_v2(self.version):   # 다음 판(엔진 P5-2): 7 이면 바꾼 칸만 JSON, 6.x 면 아래 블롭(전체)
+                self.setPropertyWithResult(vo)
+                return
             self.service.apply(
                 ILC.MIMQ_SET_SERVER_PROPERTY,
                 vo.get_serialized(),
@@ -425,6 +473,34 @@ class ILAdminService:
         except Exception as exc:
             raise ILException(exc) from exc
 
+    def setPropertyWithResult(self, vo: ILServiceProperty) -> ILPropertyResult:
+        """:meth:`setProperty` 와 같고, 엔진이 무엇을 적용 · 무시했는지 돌려준다(다음 판).
+
+        엔진 7 에는 **바꾼 칸만** 보낸다 - 서비스 칸은 SERVICE ALTER, 로그 칸(시스템 · 클라이언트)은 바뀐 카테고리마다 LOGGER ALTER 다.
+        결과의 로그 키는 ``LOGGER.SYS.LEVEL`` 모양이다. ``IP`` 는 ``"RESTART"`` (재기동 뒤 반영, :meth:`ILPropertyResult.needs_restart`),
+        나머지는 ``"NOW"`` 다. 바꾼 것이 없으면 보내지 않고 빈 결과를 돌려준다.
+
+        Args:
+            vo (ILServiceProperty): 바꿀 설정. :meth:`getProperty` 로 읽어 고친 객체를 넘긴다.
+
+        Returns:
+            ILPropertyResult: 적용 · 무시 목록. **6.x 엔진이면 빈 결과**다(블롭으로 전체를 보낸다).
+
+        Raises:
+            ILOperationException: 엔진이 거절했을 때(사유 그대로). 요청이 둘 이상이라 **원자적이지 않다** - 로거 변경이 거절되면
+                사유 뒤에 ``[LOGGER <카테고리> 거절 - 이미 적용: SERVICE, ...]`` 를 붙인다(이미 적용된 쪽은 되돌리지 않는다).
+            ILException: 통신 실패.
+        """
+        try:
+            if not _propv2.peer_speaks_v2(self.version):
+                self.setProperty(vo)
+                return ILPropertyResult()
+            return _service_set_v2(self.service, vo)
+        except _PASSTHROUGH_EXCEPTIONS:
+            raise
+        except Exception as exc:
+            raise ILException(exc) from exc
+
     def setSystemTrace(self, enabled: bool) -> None:
         """서버 시스템 트레이스를 켜거나 끈다.
 
@@ -5909,10 +5985,10 @@ class ILAdminQmgr:
             전체가 통째로 덮어써진다.
 
         Warning:
-            **종류(type)와 방향(direction)은 바꿀 수 없다.** 기존 채널과 다르면
-            서버가 ``MIMQE_OBJECT_NOT_FOUND`` 로 답한다 - "그런 채널 없음"처럼
-            보이지만 실제로는 **종류/방향이 달라서** 못 찾은 것이다.
-            바꾸려면 지우고 다시 만들어야 한다.
+            **종류(type)와 방향(direction)은 바꿀 수 없다** - 바꾸려면 지우고 다시 만들어야 한다(이 메서드는 제거 · 재생성을 하지 않는다).
+            엔진 7(JSON)은 바꿔 보내면 ``MIMQE_IMMUTABLE_PROPERTY (TYPE fixed at <현재 값>)`` 로 **거절**한다(같은 값이면 통과).
+            ☠ 6.x 블롭 경로는 거절하지 않고 **조용히 옛 값을 유지한다**(성공을 돌려준다, 엔진 6.3.4 동작).
+            ``MIMQE_OBJECT_NOT_FOUND`` 는 채널 이름이 없을 때다.
 
         Note:
             **클러스터 팔로워에서는 거부된다.** 구성 변경(생성/변경/삭제)은 리더에서만

{jetstream_api-0.24.0 → jetstream_api-0.25.0}/ilink/properties.py

@@ -40,6 +40,19 @@ def _format_millis(value: int, fmt: str) -> str:
 LEGACY_FORCE_RELOAD_MIN = 1048576
 
 
+def _patch_blob(raw: bytes, ref: bytes, built: bytes, fields) -> bytes:
+    """서버 원본 ``raw`` 위에, 클라 표현이 달라진 칸만 ``built`` 에서 옮긴다(왕복 보존, 다음 판).
+
+    ``ref`` 는 원본을 읽은 직후 클라가 짠 바이트다. 칸 ``(오프셋, 폭)`` 마다 ``built`` 와 ``ref`` 가 다르면(= 그 뒤 바꿨으면)
+    그 칸을 덮고, 같으면 원본 바이트를 둔다. 표에 없는 자리(클라가 모르는 칸 · 예약)는 늘 원본 그대로다.
+    """
+    out = bytearray(raw)
+    for off, w in fields:
+        if built[off:off + w] != ref[off:off + w]:
+            out[off:off + w] = built[off:off + w]
+    return bytes(out)
+
+
 def _has_value(raw) -> bool:
     """서버가 준 원본이 쓸 만한지 본다.
 
@@ -753,7 +766,7 @@ class ILQueueProperty(_AutoAccessor):
             스펙: 기본 LOCAL · 범위 LOCAL | REMOTE | XMIT · 변경 불가.
         description (str): 큐 설명(다음 판, 엔진 7). 기본 ``""``. **생성할 때만** 지정한다 - 변경(ALTER)으로 보내면 엔진이 거절한다.
             ☠ **엔진 7(JSON)에서만 오간다** - 6.x 엔진과의 고정폭 블롭에는 싣지 않는다.
-            스펙: 기본 "" · 범위 200바이트 이하 문자열(블롭 칸 폭) · 생성 전용.
+            스펙: 기본 "" · 범위 199바이트 이하 문자열(칸 폭 200 − 1, 엔진 7.0.1.3620 571 과 같다) · 생성 전용.
         depth (int): **읽기 전용** 현재 깊이. 기본 0.
             스펙: 기본 0 · 범위 0~2147483647 · 단위 건 · 변경 불가.
         maxDepth (int): 최대 깊이. 넘으면 put 이 거부된다. 기본 99999999.
@@ -832,7 +845,7 @@ class ILQueueProperty(_AutoAccessor):
     # 엔진 QueueProperty::Validate() 와 같은 규칙.
     _SPEC = {
         "name": _spec_maxlen(47),
-        "description": _spec_maxlen(200),
+        "description": _spec_maxlen(199),
         "triggerProcess": _spec_maxlen(999),
         "remoteQmgrName": _spec_maxlen(47),
         "remoteQueueName": _spec_maxlen(47),
@@ -3389,9 +3402,22 @@ class ILQmgrProperty(_AutoAccessor):
             if len(ba) > offset and ba[offset] != 0x00:
                 self.subGroupTimeoutSec = ba_pick_int(ba, offset, 4)
             offset += 4
+            # 왕복 보존(다음 판): 원본과, 원본을 클라가 다시 짠 바이트
+            #   ☠ 조회 경로를 실패시키지 않는다 - 다시 짜기가 실패하면(폭 검사 등) 원본 보관을 포기하고 옛 직렬화로 간다
+            try:
+                self._blobBuilt = self._build_blob()
+                self._blobRaw = bytes(ba[:ILC.MIMQ_VO_QMGR_LEN])
+            except Exception:  # noqa: BLE001
+                self._blobRaw = None
         except Exception as exc:
             raise ILException(exc) from exc
 
+    #: 클라가 아는 칸 ``(오프셋, 폭)``. 이 밖의 자리(SSL 포트 272 · 하위호환 로그 278 · 321 · 344 · 396 · 풀 446 · 세션 610)는 원본 그대로 간다.
+    _BLOB_FIELDS = ((0, 6), (6, 60), (66, 100), (166, 100), (266, 6), (301, 20), (322, 20), (342, 2), (346, 10), (356, 10), (366, 20),
+                    (386, 10), (406, 10), (416, 10), (426, 10), (436, 10), (466, 10), (476, 20), (496, 2), (498, 13), (511, 5),
+                    (516, 2), (518, 15), (533, 5), (538, 2), (540, 15), (555, 5), (560, 2), (562, 15), (577, 5), (582, 2), (584, 15),
+                    (599, 5), (604, 2), (606, 2), (608, 2), (620, 32), (652, 10), (662, 4))
+
     def get_serialized(self, with_topic_logger: bool = True) -> bytes:
         """이 객체를 서버 규격의 **고정폭 바이트**로 직렬화한다.
 
@@ -3401,7 +3427,32 @@ class ILQmgrProperty(_AutoAccessor):
         Note:
             라이브러리가 요청을 보낼 때 내부적으로 부른다. 응용이 직접 부를
             일은 거의 없다.
+
+            **서버가 준 바이트로 만든 객체는 그 원본 위에 바뀐 칸만 덮는다** - 읽은 객체를 그대로 되보내면 같은 바이트가 나간다
+            (다음 판). 클라가 모르는 자리(하위호환 로그 · 스레드 풀 · 세션 칸 등)를 0 이나 기본값으로 덮지 않는다.
         """
+        built = self._build_blob()
+        raw = self.__dict__.get("_blobRaw")
+        ba = bytearray(built if raw is None else _patch_blob(raw, self._blobBuilt, built, type(self)._BLOB_FIELDS))
+        topic_offset, session_offset = 496, 610
+        if not with_topic_logger:
+            for i in range(20):
+                ba[topic_offset + i] = 0
+            raw = getattr(self, "_volumeTailRaw", None)
+            if raw:
+                ba[topic_offset:topic_offset + 20] = raw
+            else:
+                ba_merge(max(self.volumeMonitorSizeLimit, LEGACY_FORCE_RELOAD_MIN),
+                         ba, topic_offset, 20)
+            raw2 = getattr(self, "_sessionPerThreadRaw", None)
+            if raw2:
+                ba[session_offset:session_offset + 10] = raw2
+            else:
+                ba_merge(LEGACY_SESSION_PER_THREAD, ba, session_offset, 10)
+        return bytes(ba)
+
+    def _build_blob(self) -> bytes:
+        # 필드만으로 짠 바이트(원본 없음 기준). 서버 원본이 있으면 get_serialized 가 원본 위에 바뀐 칸만 옮긴다
         ba = bytearray(ILC.MIMQ_VO_QMGR_LEN)
         offset = 0
         ba_merge(self.status, ba, offset, 6)
@@ -3461,7 +3512,6 @@ class ILQmgrProperty(_AutoAccessor):
         # 이 자리는 구엔진의 volumeMonitorForceReloadSize 다. 값을 실어 보내면
         # 구엔진이 자기 필드로 읽어 imqlsr 가 SIGFPE 로 죽는다(6.3.1.2813 실측).
         # 비워 보내려면 get_serialized(with_topic_logger=False) 를 쓴다.
-        topic_offset = offset
         ba_merge(self.logLevelTopic, ba, offset, 2)
         offset += 2
         ba_merge(self.logFileSizeTopic, ba, offset, 13)
@@ -3499,7 +3549,6 @@ class ILQmgrProperty(_AutoAccessor):
         ba_merge(self.aclType, ba, offset, 2)
         offset += 2
         # 구엔진에만 있는 sessionPerThread 자리 - 0 을 보내면 큐관리자가 죽는다
-        session_offset = offset
         offset += 10
         ba_merge(self.deadLetterQueueName, ba, offset, 32)
         offset += 32
@@ -3507,25 +3556,6 @@ class ILQmgrProperty(_AutoAccessor):
         offset += 10
         ba_merge(self.subGroupTimeoutSec, ba, offset, 4)
         offset += 4
-        if not with_topic_logger:
-            for i in range(20):
-                ba[topic_offset + i] = 0
-            raw = getattr(self, "_volumeTailRaw", None)
-            if raw:
-                # 서버가 준 값을 그대로 되돌려 준다
-                ba[topic_offset:topic_offset + 20] = raw
-            else:
-                # 받은 값이 없다 - 엔진 생성자와 같이 sizeLimit 을 따라간다
-                # (6.3 ManagerProperty.hpp:143 이 mForceReloadSize = mSizeLimit).
-                # 엔진 세터가 1048576 미만을 올려 잡으므로 그 아래로 내리지 않는다.
-                ba_merge(max(self.volumeMonitorSizeLimit, LEGACY_FORCE_RELOAD_MIN),
-                         ba, topic_offset, 20)
-            # 구엔진에만 있는 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, 10)
         return bytes(ba)
 
     def get_status_string(self) -> str:
@@ -4440,6 +4470,76 @@ class ILServiceProperty(_AutoAccessor):
                 out[key] = back[getattr(self, field)]
         return {k: out[k] for _, (k, _) in cls._PV2_KEYS.items() if k in out}   # 표 순서
 
+    #: 다음 판 Property v2 LOGGER(엔진 P5-2): 서비스 로거 카테고리 -> (레벨 · 회전 크기 · 보관 개수 필드). 서비스는 SYS · CLI 만.
+    _PV2_LOGGERS = {"SYS": ("logLevelSystem", "logFileSizeSystem", "logFileCountSystem"),
+                    "CLI": ("logLevelClient", "logFileSizeClient", "logFileCountClient")}
+    #: LEVEL 와이어 글자(코드 0~7 순서, :meth:`ILC.get_log_level_string` 과 같다 - 4 는 ``"WARNING"``). ``"WARN"`` 은 옛 XML 별칭으로 받기만 한다.
+    _PV2_LOG_LEVELS = ("TRACE", "DEBUG", "MSG", "INFO", "WARNING", "ERROR", "FATAL", "SYSTEM")
+
+    def _pv2_log_now(self) -> dict:
+        # 카테고리 -> (레벨, 크기, 개수) 지금 값
+        return {c: tuple(getattr(self, f) for f in fs) for c, fs in type(self)._PV2_LOGGERS.items()}
+
+    def _pv2_logger_fill(self, items: list) -> "ILServiceProperty":
+        """LOGGER LIST 원소(JSON)로 로그 칸을 채운다. **라이브러리 내부용이다.** 서비스가 모르는 카테고리는 버린다.
+
+        채운 값을 비교 기준으로 둔다 - :meth:`_pv2_logger_patches` 는 이 기준과 달라진 칸만 싣는다.
+
+        Raises:
+            PropV2Error: 값 종류가 다르거나 LEVEL 글자를 모를 때(조용히 오독하지 않는다).
+        """
+        from . import _propv2
+        cls = type(self)
+        for e in items:
+            if not isinstance(e, dict):
+                raise _propv2.PropV2Error("_ITEMS must be ARRAY of OBJ")
+            fs = cls._PV2_LOGGERS.get(_propv2.take(e, "CATEGORY", "STR"))
+            if fs is None:
+                continue
+            lv = _propv2.take(e, "LEVEL", "STR")
+            if lv is not None:
+                k = "WARNING" if lv == "WARN" else lv
+                if k not in cls._PV2_LOG_LEVELS:
+                    raise _propv2.PropV2Error("LEVEL: unknown value %r" % (lv,))
+                object.__setattr__(self, fs[0], cls._PV2_LOG_LEVELS.index(k))
+            for f, key in ((fs[1], "FILESIZE"), (fs[2], "FILECOUNT")):
+                v = _propv2.take(e, key, "INT")
+                if v is not None:
+                    object.__setattr__(self, f, v)
+        self._pv2_logger_sent()
+        return self
+
+    def _pv2_logger_patches(self) -> list:
+        """바뀐 카테고리마다 LOGGER ALTER 본문(``_TYPE`` · ``CATEGORY`` + 바뀐 키만)을 만든다. **라이브러리 내부용이다.**
+
+        기준은 마지막으로 읽은(또는 보낸) 값이고, 읽은 적이 없으면 기본값이다.
+
+        Raises:
+            PropV2Error: 레벨 칸에 0~7 밖의 코드가 있을 때.
+        """
+        from . import _propv2
+        cls = type(self)
+        base = self.__dict__.get("_il_log_snap") or cls()._pv2_log_now()
+        out = []
+        for cat, now in self._pv2_log_now().items():
+            was = base[cat]
+            body = {}
+            if now[0] != was[0]:
+                if not (isinstance(now[0], int) and 0 <= now[0] < len(cls._PV2_LOG_LEVELS)):
+                    raise _propv2.PropV2Error("LEVEL: unknown code %r" % (now[0],))
+                body["LEVEL"] = cls._PV2_LOG_LEVELS[now[0]]
+            if now[1] != was[1]:
+                body["FILESIZE"] = int(now[1])
+            if now[2] != was[2]:
+                body["FILECOUNT"] = int(now[2])
+            if body:
+                out.append(dict({"_TYPE": "LOGGER", "CATEGORY": cat}, **body))
+        return out
+
+    def _pv2_logger_sent(self) -> None:
+        # 지금 로그 칸 값을 비교 기준으로 둔다(읽은 직후 · 보낸 직후)
+        object.__setattr__(self, "_il_log_snap", self._pv2_log_now())
+
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
         """서비스 속성 객체를 만든다.
 
@@ -4526,6 +4626,17 @@ class ILServiceProperty(_AutoAccessor):
         offset += 24
         self.hubPort = ba_pick_int(ba, offset, 10)
         offset += 10
+        # 왕복 보존: 원본과, 원본을 클라가 다시 짠 바이트. 직렬화는 원본 위에 클라 표현이 달라진 칸만 덮는다
+        #   ☠ 조회 경로를 실패시키지 않는다 - 다시 짜기가 실패하면(폭 검사 등) 원본 보관을 포기하고 옛 직렬화로 간다
+        try:
+            self._blobBuilt = self._build_blob()
+            self._blobRaw = bytes(ba[:ILC.MIMQ_VO_SERVER_LEN])
+        except Exception:  # noqa: BLE001
+            self._blobRaw = None
+
+    #: 클라가 아는 칸 ``(오프셋, 폭)``. 이 밖의 자리(하위호환 로그 106 · 풀 168 · 로그 3~4번째 232 · 예약 402)는 원본 그대로 간다.
+    _BLOB_FIELDS = ((0, 100), (100, 6), (128, 20), (148, 10), (158, 10), (188, 2), (190, 15), (205, 5), (210, 2), (212, 15),
+                    (227, 5), (276, 2), (278, 2), (280, 2), (282, 2), (284, 36), (320, 48), (368, 24), (392, 10))
 
     def get_serialized(self) -> bytes:
         """이 객체를 서버 규격의 **고정폭 바이트**로 직렬화한다.
@@ -4536,7 +4647,16 @@ class ILServiceProperty(_AutoAccessor):
         Note:
             라이브러리가 요청을 보낼 때 내부적으로 부른다. 응용이 직접 부를
             일은 거의 없다.
+
+            **서버가 준 바이트로 만든 객체는 그 원본 위에 바뀐 칸만 덮는다** - 읽은 객체를 그대로 되보내면 같은 바이트가 나간다
+            (다음 판). 클라가 모르는 자리(하위호환 로그 · 스레드 풀 · 로그 3~4번째 카테고리 · 예약)를 0 이나 기본값으로 덮지 않는다.
         """
+        built = self._build_blob()
+        raw = self.__dict__.get("_blobRaw")
+        return built if raw is None else _patch_blob(raw, self._blobBuilt, built, type(self)._BLOB_FIELDS)
+
+    def _build_blob(self) -> bytes:
+        # 필드만으로 짠 바이트(원본 없음 기준). 서버 원본이 있으면 get_serialized 가 원본 위에 바뀐 칸만 옮긴다
         ba = bytearray(ILC.MIMQ_VO_SERVER_LEN)
         offset = 0
         ba_merge(self.ip, ba, offset, 100)

{jetstream_api-0.24.0 → jetstream_api-0.25.0/jetstream_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.24.0
+Version: 0.25.0
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003
@@ -60,6 +60,25 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.25.0 변경 - 서비스 속성 · 로거 Property v2(JSON) · 블롭 왕복 보존 (자바 v2.21.0 와 같음, 짝 엔진 7.0.1.3624 이상)
+
+- **서비스 속성이 엔진 7 과 JSON 으로 오간다**(엔진 P5-2). ``ILAdminService.getProperty`` 는 SERVICE GET + LOGGER LIST(시스템 ·
+  클라이언트 로그 칸), ``setProperty`` 는 **바꾼 칸만** SERVICE ALTER + 바뀐 로그 카테고리마다 LOGGER ALTER 다. 6.x 엔진은 기존 블롭.
+  ☠ **7.0.1.3623 이하 7.x 엔진에는 서비스 속성 조회 · 변경이 거절된다.**
+- 더함: ``ILAdminService.setPropertyWithResult`` (``ILPropertyResult``, 로그 키는 ``LOGGER.SYS.LEVEL`` 모양, ``IP`` 는 ``RESTART`` -
+  재기동 뒤 반영, 나머지는 ``NOW``). 요청이 둘 이상이라 **원자적이지 않다** - 로거 변경이 거절되면 사유 뒤에
+  ``[LOGGER <카테고리> 거절 - 이미 적용: SERVICE, ...]`` 가 붙는다(이미 적용된 쪽은 되돌리지 않는다).
+- **서비스 · 큐관리자 속성 블롭 왕복 보존**: 읽은 객체를 그대로 ``setProperty`` 로 되보내면 엔진이 준 바이트가 그대로 나간다.
+  전에는 클라가 모르는 자리(하위호환 로그 칸 · 스레드 풀 칸 등)를 0 이나 기본값으로 덮었다.
+- 문자열 상한을 엔진과 맞췄다: 큐 설명(``description``) **199바이트**(0.23.0 은 200), 서비스 IP 99 · 이름 47 · 허브 IP 23 · HOMEPATH 99
+  (엔진 7.0.1.3623 이상과 같다). 옛 판에서 저장된 더 긴 값은 읽기 · 되보내기에서 거절되지 않는다(읽을 때는 상한을 묻지 않는다).
+- 서비스 ``aclType`` · ``relayType`` 은 0/1 만 받는다(그 밖은 엔진 7.0.1.3619 이상이 거절, 엔진 7 JSON 경로는 클라가 먼저 거절).
+- 채널: 종류 · 방향을 바꿔 ``setChannelProperty`` 를 부르면 엔진 7 은 ``MIMQE_IMMUTABLE_PROPERTY (TYPE fixed at <현재 값>)`` 로 거절하고,
+  6.x 블롭은 조용히 옛 값을 유지한다(문서 정정 - 옛 문구 "다르면 NOT_FOUND" 는 틀렸다). TLS 채널을 JSON 으로 만들거나 바꾸는 것은 엔진
+  7.0.1.3617 이상에서 맞다(그 전 판은 기본 인증서를 채우지 않아 ``MIMQE_SSL_ERROR``).
+- 세션: 엔진 7.0.1.3617 이상에서 ``destroyedTime`` 이 ``-1`` 이 아니면 끊긴 세션(보관 중)이다 - 상태는 ``EXCEPTION`` 일 수 있다.
+  그 전 판은 끊긴 세션도 ``-1`` 이라 가릴 수 없다.
+
 ## 0.24.0 변경 - 채널 · 세션 Property v2(JSON) · IBMMQ 채널 종류 (자바 v2.20.0 와 같음, 짝 엔진 7.0.1.3615 이상)
 
 - **채널 관리가 엔진 7 과 JSON(Property v2) 으로 오간다**(엔진 P4). 함수 이름은 그대로 - ``createChannel`` · ``setChannelProperty`` ·

{jetstream_api-0.24.0 → jetstream_api-0.25.0}/pyproject.toml

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