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

{jetstream_api-0.23.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.23.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,43 @@ 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`` ·
+  ``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`` ·