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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.22.3
+Version: 0.24.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,45 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.24.0 변경 - 채널 · 세션 Property v2(JSON) · IBMMQ 채널 종류 (자바 v2.20.0 와 같음, 짝 엔진 7.0.1.3615 이상)
+
+- **채널 관리가 엔진 7 과 JSON(Property v2) 으로 오간다**(엔진 P4). 함수 이름은 그대로 - ``createChannel`` · ``setChannelProperty`` ·
+  ``getChannelProperty`` (종류별 포함) · ``getChannelList`` (종류별 · 요약 포함) · ``removeChannel`` 이 상대가 7 이면 JSON, 6.x 면 기존 블롭이다.
+  ☠ **P4 전 7.x 엔진(7.0.1.3611 미만)에는 채널 관리가 거절된다** - 판 혼재는 지원하지 않는다.
+- ``setChannelProperty`` 는 엔진 7 에 **바꾼 칸만** 보낸다. 목적지 그룹은 읽은 값과 달라졌을 때만 통째로 싣는다.
+  목적지 그룹 · ``balanceMode`` 변경은 **채널이 STOPPED 일 때만** 받는다 - 아니면 ``MIMQE_CHANNEL_NOT_STOPPED``.
+- 더함: ``createChannelWithResult`` · ``setChannelPropertyWithResult`` · ``removeChannelWithResult`` (``ILPropertyResult``, 6.x 엔진이면 빈 결과).
+  목적지 원소 상태에 ``"ERROR"`` (MIMQ_ERROR 5) 가 있다.
+- **세션 조회가 엔진 7 과 JSON 으로 오간다**(엔진 P5) - ``ILAdminQmgr`` · ``ILAdminService`` 의 ``getSessionList`` · ``getSessionMinorList`` ·
+  ``getSessionProperty``. 상대 주소(``peerAddr``)가 잘리지 않는다(블롭은 15자, IPv6 가 깨졌다).
+  서비스 레벨(``ILAdminService``)은 관리 서비스에 붙은 세션만 싣는다(블롭과 같다).
+  ☠ **7.0.1.3614 이하 7.x 엔진에는 세션 조회가 거절된다.**
+- 행동 변경: 세션 ``get_status_string`` 이 엔진 enum 7단계(``DEAD`` ``IDLE`` ``RECEIVING`` ``ON_RECV`` ``SENDING`` ``ON_SEND`` ``EXCEPTION``)를 따른다.
+  옛 클라는 6.2 시절 8단계 표라 2 이상이 한 칸씩 어긋났다(6.x 엔진에서도 - ``EXCEPTION`` 이 ``"SENDING"`` 으로 보였다).
+- ``ILChannelType.IBMMQ = 2`` - 요약 목록이 IBMMQ 채널을 Server 종류로 잘못 분류하지 않는다(IBMMQ 채널 생성은 엔진 다음 판).
+- 서비스 속성(``getProperty`` · ``setProperty``)은 이 판에서도 블롭이다 - 엔진 LOGGER 와 함께 다음 판에 JSON 으로 옮긴다.
+
+## 0.23.0 변경 - 큐 속성 Property v2(JSON) · 채널 STANDBY (자바 v2.19.0 와 같음, 짝 엔진 = Property v2 P3 판 이상)
+
+- **큐 관리가 엔진 7 과 JSON(Property v2) 으로 오간다**(엔진 P3). 함수 이름은 그대로 - ``createQueue`` · ``setQueueProperty`` ·
+  ``getQueueProperty`` (종류별 포함) · ``getQueueList`` (종류별 · 요약 포함) · ``removeQueue`` 가 상대가 7 이면 JSON, 6.x 면 기존 고정폭 블롭이다.
+  ☠ **P3 전 7.x 엔진(7.0.1.3604 이하)에는 큐 관리가 거절된다** - 판 혼재는 지원하지 않는다(엔진 · 클라 · 하네스를 함께 올린다).
+- ``setQueueProperty`` 는 엔진 7 에 **세터 · 대입으로 바꾼 칸만** 보낸다. 새로 만든 객체로 일부만 바꿔도 다른 칸을 덮지 않는다
+  (옛 블롭은 전체 교체였다). 바꾼 것이 없으면 보내지 않는다.
+- 더함: ``createQueueWithResult`` · ``setQueuePropertyWithResult`` · ``removeQueueWithResult`` (``ILPropertyResult``, 6.x 엔진이면 빈 결과),
+  ``ILQueueProperty.description`` (큐 설명, 200바이트, 생성 전용, 엔진 7 에서만).
+- ``leaderGroup`` 은 JSON 으로만 오간다 - 고정폭 블롭은 6.3.4 레이아웃으로 되돌아갔다(LG 칸 없음).
+- ``incomingDelayDepth`` · ``incomingDelay`` 의 ``0`` 은 유효한 값이다(문서 범위 고침). 세그먼트 수 · 공유 메모리 크기는 생성 전용 -
+  바꿔 보내면 ``MIMQE_IMMUTABLE_PROPERTY (SEGMENTS fixed at <n>)`` 로 거절된다.
+- 종류별 조회(``getLocalQueueProperty`` 등)는 종류가 다르면 ``MIMQE_OBJECT_NOT_FOUND (<큐> : TYPE_NOT_MATCHED)`` (옛 엔진과 같은 사유).
+- 채널: ``ILChannelStatus.STANDBY = 5`` (리더에서만 일하는 채널이 팔로워에서 대기). 이 값을 모르는 옛 클라는 STANDBY 채널이 섞인
+  채널 조회 · 목록이 실패한다. ``startChannelWithStatus`` 는 STANDBY · 오류(``"EXCEPTION"``)에서 기다리지 않고 곧바로 돌아온다
+  (전에는 오류에서 시한까지 기다렸다).
+- 없앰: ``ILC.MIMQ_COORD_OBSERVER`` ("O") - ``getReplicationStatus`` 의 3370 arg1 은 빈칸이다(엔진이 r3486 부터 읽지 않는다).
+- 예외 문구에 Property v2 본문 규칙 위반의 원인을 붙인다(전에는 ``MIMQE_INTERNAL_ERROR`` 만 보였다).
+- 알려진 엔진 결함(P3 이전부터, 엔진에서 별건): 큐를 한 번 변경하면 그 뒤 ``setQueueTrace`` 결과가 조회에 안 보인다 -
+  트레이스는 ``setQueueProperty`` 로 바꾼다.
+
 ## 0.22.3 변경 - 옛 클러스터 블롭 코덱 · actingCoordinator 제거, servicePorts (자바 v2.18.3 와 같음, 짝 엔진 7.0.1.3603 이상 권장)
 
 0.22.2 는 시험 판(test.pypi)만 내고 버렸다 - actingCoordinator 제거를 묶어 0.22.3 으로 나간다.