jetstream-api 0.27.1__tar.gz → 0.28.0__tar.gz

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.27.1
+Version: 0.28.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,20 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.28.0 변경 - IBMMQ 채널 MQ 인증 · 채널 사유(REASON) · 입력값 오류 표시 (자바 v2.24.0 와 같음, 짝 엔진 7.0.1.3638 이상)
+
+- 새 칸: IBMMQ 채널 MQ CONNAUTH ``mqUser`` · ``mqPassword`` (엔진 7.0.1.3638 이상). 둘은 한 쌍이다(한쪽만 있으면 엔진이 ``MIMQE_INVALID_PROPERTY``,
+  걷으려면 둘 다 ``""``). ``mqPassword`` 는 비밀 칸이다 - 조회하면 ``"*****"`` (없으면 ``""``), ``"*****"`` 를 되보내면 그대로 유지, ``""`` 는 지우기,
+  ``"{ARIA}<hex>"`` 는 봉인값으로 받는다. 클라는 비밀번호 길이를 검사하지 않고 사람이 읽는 요약에 찍지 않는다. 빈 인증 칸은 CREATE 에 싣지 않는다.
+- 새 칸: 채널 읽기 전용 ``reason`` (엔진 7.0.1.3637 이상, 최대 69자) - ERROR · STOPPED 가 된 사유(``"stopped by ..."`` · MQ cc/rc · ``"follower node"``).
+  RUNNING · STARTING 이면 빈칸이다. MQ 인증 실패는 ``MQCONNX failed cc=2 rc=2035 (auth: ...)`` 로 보인다.
+- 채널 목록(``getChannelList``)은 ``REASON`` 을 7.0.1.3637 이상, 인증 칸을 7.0.1.3638 이상 엔진에만 묻는다(``ILC.CHANNEL_REASON_MIN_REVISION`` · ``ILC.IBMMQ_AUTH_MIN_REVISION``).
+- IBMMQ 채널 흐름(엔진 7.0.1.3634 이상): START 가 실제 MQ 흐름을 띄운다(3633 · MQ SDK 없이 지은 엔진은 ``MIMQE_UNSUPPORTED``).
+  START 를 받아들인 뒤의 MQ 연결 실패는 채널 ERROR + 엔진 자동 재시도, STOP 은 1초 안에 STOPPED, MsgId · CorrelId 는 24바이트 <-> base64url 32자.
+  클러스터 팔로워의 IBMMQ 채널은 START 해도 STANDBY 로 남는다(REASON ``"follower node"``).
+- 고침: 보내기 전에 막는 열거 코드 오류(ACL ``type`` · 큐 관리자 ACLTYPE/STARTMODE · 서비스 TYPE/ACLTYPE · 로그 레벨 0~7 밖)가
+  ``MIMQC_FATAL_ERROR (MIMQE_INTERNAL_ERROR)`` 로 감싸여 보였다 - 이제 ``UnsupportedOperationException`` (``[v] is an unacceptable value. ...``) 그대로다.
+
 ## 0.27.1 변경 - 기동 · 정지 중 큐 관리자 조회 (자바 v2.23.1 와 같음, 짝 엔진 7.0.1.3633 이상)
 
 0.27.0 은 시험 판(test.pypi)만 내고 버렸다 - 회귀에서 아래 결함이 나왔다.

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/README.md

@@ -10,6 +10,20 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.28.0 변경 - IBMMQ 채널 MQ 인증 · 채널 사유(REASON) · 입력값 오류 표시 (자바 v2.24.0 와 같음, 짝 엔진 7.0.1.3638 이상)
+
+- 새 칸: IBMMQ 채널 MQ CONNAUTH ``mqUser`` · ``mqPassword`` (엔진 7.0.1.3638 이상). 둘은 한 쌍이다(한쪽만 있으면 엔진이 ``MIMQE_INVALID_PROPERTY``,
+  걷으려면 둘 다 ``""``). ``mqPassword`` 는 비밀 칸이다 - 조회하면 ``"*****"`` (없으면 ``""``), ``"*****"`` 를 되보내면 그대로 유지, ``""`` 는 지우기,
+  ``"{ARIA}<hex>"`` 는 봉인값으로 받는다. 클라는 비밀번호 길이를 검사하지 않고 사람이 읽는 요약에 찍지 않는다. 빈 인증 칸은 CREATE 에 싣지 않는다.
+- 새 칸: 채널 읽기 전용 ``reason`` (엔진 7.0.1.3637 이상, 최대 69자) - ERROR · STOPPED 가 된 사유(``"stopped by ..."`` · MQ cc/rc · ``"follower node"``).
+  RUNNING · STARTING 이면 빈칸이다. MQ 인증 실패는 ``MQCONNX failed cc=2 rc=2035 (auth: ...)`` 로 보인다.
+- 채널 목록(``getChannelList``)은 ``REASON`` 을 7.0.1.3637 이상, 인증 칸을 7.0.1.3638 이상 엔진에만 묻는다(``ILC.CHANNEL_REASON_MIN_REVISION`` · ``ILC.IBMMQ_AUTH_MIN_REVISION``).
+- IBMMQ 채널 흐름(엔진 7.0.1.3634 이상): START 가 실제 MQ 흐름을 띄운다(3633 · MQ SDK 없이 지은 엔진은 ``MIMQE_UNSUPPORTED``).
+  START 를 받아들인 뒤의 MQ 연결 실패는 채널 ERROR + 엔진 자동 재시도, STOP 은 1초 안에 STOPPED, MsgId · CorrelId 는 24바이트 <-> base64url 32자.
+  클러스터 팔로워의 IBMMQ 채널은 START 해도 STANDBY 로 남는다(REASON ``"follower node"``).
+- 고침: 보내기 전에 막는 열거 코드 오류(ACL ``type`` · 큐 관리자 ACLTYPE/STARTMODE · 서비스 TYPE/ACLTYPE · 로그 레벨 0~7 밖)가
+  ``MIMQC_FATAL_ERROR (MIMQE_INTERNAL_ERROR)`` 로 감싸여 보였다 - 이제 ``UnsupportedOperationException`` (``[v] is an unacceptable value. ...``) 그대로다.
+
 ## 0.27.1 변경 - 기동 · 정지 중 큐 관리자 조회 (자바 v2.23.1 와 같음, 짝 엔진 7.0.1.3633 이상)
 
 0.27.0 은 시험 판(test.pypi)만 내고 버렸다 - 회귀에서 아래 결함이 나왔다.

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/ilink/__init__.py

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

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/ilink/admin.py

@@ -5665,7 +5665,7 @@ class ILAdminQmgr:
     #: LIST 로 전체 속성을 받을 때의 _KEYS(설정 키 + 읽기 전용 + 목적지 그룹). IBMMQ 전용 키는 IBMMQ 를 아는 엔진에만 묻는다
     #: (모르는 엔진은 "_KEYS[i]" unknown 으로 무시하고 클라가 호출마다 경고를 남기게 된다)
     _CHANNEL_LIST_KEYS = [k for k, _ in ILChannelProperty._PV2_KEYS.values() if k not in ILChannelProperty._PV2_MQ_KEYS] + ["STATUS", "RTT", "DESTGROUP"]
-    _CHANNEL_LIST_KEYS_MQ = _CHANNEL_LIST_KEYS + list(ILChannelProperty._PV2_MQ_KEYS)
+    _CHANNEL_LIST_KEYS_MQ = _CHANNEL_LIST_KEYS + [k for k in ILChannelProperty._PV2_MQ_KEYS if k not in ILChannelProperty._PV2_MQ_AUTH_KEYS]
     #: 요약 목록의 _KEYS(요약 클래스의 칸)
     _CHANNEL_MINOR_KEYS = ["TYPE", "DIRECTION", "STATUS", "STARTMODE"]
 
@@ -5681,6 +5681,10 @@ class ILAdminQmgr:
     def _channelListV2(self, ctype=None, direction=None) -> list:
         # 종류 · 방향 거르기는 클라가 한다(옛 3016 arg "CLIENT.SEND" 의 엔진 거르기와 같은 결과)
         keys = ILAdminQmgr._CHANNEL_LIST_KEYS_MQ if self.revision >= ILC.IBMMQ_CHANNEL_MIN_REVISION else ILAdminQmgr._CHANNEL_LIST_KEYS
+        if self.revision >= ILC.CHANNEL_REASON_MIN_REVISION:
+            keys = keys + ["REASON"]
+        if self.revision >= ILC.IBMMQ_AUTH_MIN_REVISION:
+            keys = keys + list(ILChannelProperty._PV2_MQ_AUTH_KEYS)
         cs = self._channelItems(self._channelReq(_propv2.PROP_LIST, {"_KEYS": keys}))
         return [c for c in cs if (ctype is None or c.type == ctype) and (direction is None or c.direction == direction)]
 

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/ilink/common.py

@@ -888,6 +888,10 @@ class ILC:
     TOPIC_LOGGER_MIN_REVISION = 3283
     #: IBMMQ 채널(TYPE IBMMQ · MQ 전용 키)을 아는 엔진 리비전(다음 판, 엔진 590 CHLMQ-1, 7.0.1.3633). 이보다 낮으면 채널 LIST 에 MQ 키를 묻지 않는다.
     IBMMQ_CHANNEL_MIN_REVISION = 3633
+    #: 채널 읽기 전용 REASON 을 아는 엔진 리비전(다음 판, 엔진 594 CHLREASON-1, 7.0.1.3637). 이보다 낮으면 채널 LIST 에 REASON 을 묻지 않는다.
+    CHANNEL_REASON_MIN_REVISION = 3637
+    #: IBMMQ 채널 MQ CONNAUTH 칸(MQUSER · MQPASSWORD)을 아는 엔진 리비전(다음 판, 엔진 599 CHLMQAUTH-1, 7.0.1.3638). 이보다 낮으면 채널 LIST 에 묻지 않는다.
+    IBMMQ_AUTH_MIN_REVISION = 3638
 
     #: ``getLastDiag`` 가 쓰는 진단 조회(3394)가 들어온 엔진 리비전.
     #: 그 미만 엔진은 이 코드를 모르고 ``MIMQE_INVALID_REQ_CODE`` 를

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/ilink/properties.py

@@ -1366,6 +1366,11 @@ class ILChannelType(IntEnum):
         SERVER: 상대의 접속을 **받는** 채널.
         IBMMQ: IBM MQ 와 주고받는 채널(다음 판, 엔진 7). 받기(RECV)는 클러스터 리더에서만 일하고 팔로워에서는
             :attr:`ILChannelStatus.STANDBY` 로 대기한다. 이 값을 모르는 옛 클라는 IBMMQ 채널이 섞인 조회 · 목록 자체가 실패한다.
+            흐름(START)은 엔진 7.0.1.3634 이상에서 돈다(3633 은 START 가 MIMQE_UNSUPPORTED, 와이어는 같다).
+            MQ SDK 없이 지은 엔진도 START 가 MIMQE_UNSUPPORTED (... IBMMQ support is not built into this engine ...) 다.
+            START 를 받아들인 뒤의 MQ 연결 실패는 채널 ERROR 상태가 되고(사유는 큐 관리자 로그),
+            CHANNELRETRYINTERVAL 마다 엔진이 다시 붙는다. STOP 은 1초 안에 STOPPED 가 된다.
+            MsgId · CorrelId: MQ 의 24바이트는 base64url 32자로 바뀌어 들어오고, MQ 로 보낼 때 32자 모양이면 원래 24바이트로 되살린다.
     """
 
     SERVER = 0
@@ -1667,6 +1672,9 @@ class ILChannelProperty(_AutoAccessor):
             스펙: 기본 30 · 범위 -1 또는 1~2147483647 · 단위 초 · 변경 가능/재기동 불필요.
         rtt (int): **읽기 전용** 왕복 지연(밀리초). 측정 전이면 ``-1``.
             스펙: 기본 -1 · 범위 -1~2147483647 (-1=미측정) · 단위 밀리초 · 변경 불가(ReadOnly).
+        reason (str): **읽기 전용** 채널이 ERROR · STOPPED 가 된 사유(다음 판, 엔진 7.0.1.3637 이상의 JSON 에서만, 최대 69자).
+            예: ``"stopped by <누구>"`` · MQ cc/rc · ``"follower node"`` (클러스터 팔로워의 IBMMQ 채널은 START 해도 STANDBY 로 남는다).
+            RUNNING · STARTING 이 되면 엔진이 비운다. 블롭(6.x)과 그 전 엔진에서는 늘 ``""``.
         traceEnabled (bool): 이 채널의 트레이스 여부. 기본 False.
             스펙: 기본 OFF · 범위 ON | OFF · 변경 가능/재기동 불필요.
         security (ILChannelSecurity): 보안 방식. 기본 ``NONE``.
@@ -1684,6 +1692,13 @@ class ILChannelProperty(_AutoAccessor):
         mqQueue (str): **IBMMQ 전용** MQ 쪽 큐(RECV 일 때 필수). 48바이트 이하.
         ilQueue (str): **IBMMQ 전용** ILink 쪽 큐(RECV 일 때 필수). 47바이트 이하.
         batchSize (int): **IBMMQ 전용** 한 번에 옮길 메시지 수. 기본 10 · 범위 1~1000(판정은 엔진).
+        mqUser (str): **IBMMQ 전용** MQ CONNAUTH 사용자(MQCSP, 다음 판, 엔진 7.0.1.3638 이상). 255바이트 이하. 기본 ``""`` (인증 안 함).
+            ``mqPassword`` 와 한 쌍이다 - 한쪽만 있으면 엔진이 MIMQE_INVALID_PROPERTY 로 거절한다. 인증을 걷으려면 둘 다 ``""`` 로 보낸다.
+        mqPassword (str): **IBMMQ 전용 · 비밀** MQ CONNAUTH 비밀번호(다음 판, 엔진 7.0.1.3638 이상). 평문 256바이트 이하(판정은 엔진).
+            쓰기 전용처럼 다룬다 - 엔진이 봉인해 저장하고, 조회하면 값이 있을 때 ``"*****"``, 없으면 ``""`` 다.
+            ``"*****"`` 를 보내면 기존 값 유지(조회한 객체를 그대로 되보내도 지워지지 않는다), ``""`` 는 지운다,
+            ``"{ARIA}<대문자 hex>"`` 는 봉인값으로 그대로 받는다. :meth:`__str__` 에는 나오지 않는다.
+            인증 실패(MQ 2035)는 :attr:`reason` 에 ``MQCONNX failed cc=2 rc=2035 (auth: ...)`` 로 보인다.
             IBMMQ 채널은 엔진 7 JSON 으로만 만들고 바꾼다(블롭은 거절). 보안은 NONE 만, 포트는 1~65535(MQ 기본 1414),
             목적지 그룹 · balanceMode 는 쓰지 않는다(엔진이 무시한다).
         destGroup (list[DestItem]): 분산 대상 목록. 비어 있으면 단일 대상 채널이다.
@@ -1700,7 +1715,7 @@ class ILChannelProperty(_AutoAccessor):
     #: 다음 판 Property v2(엔진 P4, 설계 §15 · 덤프 tests/vectors/propv2_channel_table.json): ``{필드: (와이어 키, 종류)}``.
     #: 종류 ``CHTYPE`` · ``CHDIR`` · ``CHSEC`` · ``CHBAL`` · ``STARTMODE`` 는 와이어 문자열로 바꿔 싣는다(:data:`_CHANNEL_ENUMS`).
     #: 목적지 그룹(``DESTGROUP``)은 표에 없다 - 목록을 제자리에서 고치므로(add_dest) 읽은 사본과 대조해 다르면 통째로 싣는다.
-    #: ``status`` · ``rtt`` 는 읽기 전용이라 표에 없다.
+    #: ``status`` · ``rtt`` · ``reason`` 은 읽기 전용이라 표에 없다(보내지 않는다 - 엔진이 READONLY 로 거절한다).
     _PV2_KEYS = {
         "type": ("TYPE", "CHTYPE"),
         "direction": ("DIRECTION", "CHDIR"),
@@ -1722,9 +1737,14 @@ class ILChannelProperty(_AutoAccessor):
         "mqQueue": ("MQQUEUE", "STR"),
         "ilQueue": ("ILQUEUE", "STR"),
         "batchSize": ("BATCHSIZE", "INT"),
+        # 다음 판: MQ CONNAUTH(엔진 599 CHLMQAUTH-1, 7.0.1.3638) - 한 쌍, 비밀번호는 비밀 칸
+        "mqUser": ("MQUSER", "STR"),
+        "mqPassword": ("MQPASSWORD", "STR"),
     }
     #: IBMMQ 전용 칸(와이어 키). 다른 종류 채널의 CREATE · ALTER 본문에는 싣지 않는다(엔진이 "ibmmq-only" 로 무시한다).
-    _PV2_MQ_KEYS = ("MQCHL", "MODE", "MQINSTALLPATH", "MQQUEUE", "ILQUEUE", "BATCHSIZE")
+    _PV2_MQ_KEYS = ("MQCHL", "MODE", "MQINSTALLPATH", "MQQUEUE", "ILQUEUE", "BATCHSIZE", "MQUSER", "MQPASSWORD")
+    #: 그중 MQ CONNAUTH 칸(엔진 7.0.1.3638 부터). CREATE 에는 빈칸이면 싣지 않는다 - 그 전 IBMMQ 엔진에서도 만들기가 그대로 된다.
+    _PV2_MQ_AUTH_KEYS = ("MQUSER", "MQPASSWORD")
 
     #: 열거 <-> 와이어 문자열(엔진 기술표의 ilsc 표기). IBMMQ 는 엔진 IBMMQ 판(590, 7.0.1.3633)부터 와이어에 있다.
     _CHANNEL_ENUMS = {
@@ -1784,6 +1804,9 @@ class ILChannelProperty(_AutoAccessor):
         rtt = _propv2.take(obj, "RTT", "INT")
         if rtt is not None:
             object.__setattr__(self, "rtt", rtt)
+        reason = _propv2.take(obj, "REASON", "STR")   # 다음 판: 엔진 594 CHLREASON-1(7.0.1.3637)
+        if reason is not None:
+            object.__setattr__(self, "reason", reason)
         if "DESTGROUP" in obj:
             arr = obj["DESTGROUP"]
             if not isinstance(arr, list) or any(not isinstance(e, dict) for e in arr):
@@ -1837,6 +1860,9 @@ class ILChannelProperty(_AutoAccessor):
     def _pv2_create_body(self) -> dict:
         """CREATE 본문(``NAME`` + 설정 칸 전부 + 목적지 그룹)을 만든다. **라이브러리 내부용이다.**"""
         body = dict({"NAME": self.name}, **self._pv2_channel_body(type(self)._PV2_KEYS))
+        for k in type(self)._PV2_MQ_AUTH_KEYS:
+            if body.get(k) == "":
+                del body[k]   # 인증 안 함 = 엔진 기본값 - 3638 전 엔진에 모르는 키를 보내지 않는다
         body["DESTGROUP"] = self._pv2_dest_body()
         return body
 
@@ -1867,6 +1893,8 @@ class ILChannelProperty(_AutoAccessor):
         "mqInstallPath": _spec_maxlen(255),
         "mqQueue": _spec_maxlen(48),
         "ilQueue": _spec_maxlen(47),
+        "mqUser": _spec_maxlen(255),
+        # mqPassword 는 길이를 검사하지 않는다 - 평문 상한(256)은 엔진이 판정하고, 봉인값 "{ARIA}<hex>" 은 그보다 길다
     }
 
     def __init__(
@@ -1901,6 +1929,7 @@ class ILChannelProperty(_AutoAccessor):
         self.certFileName = ""
         self.timeout = 30
         self.rtt = -1
+        self.reason = ""
         self.traceEnabled = False
         self.balanceMode = ILChannelBalanceMode.ROUND_ROBIN
         self.mqChannel = "SYSTEM.DEF.SVRCONN"
@@ -1909,6 +1938,8 @@ class ILChannelProperty(_AutoAccessor):
         self.mqQueue = ""
         self.ilQueue = ""
         self.batchSize = 10
+        self.mqUser = ""
+        self.mqPassword = ""
         self.destGroupBufferLength = 0
         self.destGroup: List[DestItem] = []
 
@@ -2341,7 +2372,7 @@ class _PV2LoggerMixin:
         기준은 마지막으로 읽은(또는 보낸) 값이고, 읽은 적이 없으면 기본값이다.
 
         Raises:
-            PropV2Error: 레벨 칸에 0~7 밖의 코드가 있을 때.
+            UnsupportedOperationException: 레벨 칸에 0~7 밖의 코드가 있을 때.
         """
         from . import _propv2
         cls = type(self)
@@ -2352,7 +2383,7 @@ class _PV2LoggerMixin:
             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],))
+                    raise UnsupportedOperationException("[%r] is an unacceptable value. (acceptable value range: LEVEL 0~7)" % (now[0],))
                 body["LEVEL"] = cls._PV2_LOG_LEVELS[now[0]]
             if now[1] != was[1]:
                 body["FILESIZE"] = int(now[1])
@@ -2476,12 +2507,12 @@ class ILAccessRuleProperty(_AutoAccessor):
         """CREATE 본문(``_TYPE`` 없음)을 만든다. **라이브러리 내부용이다.** ID · EFFECTIVE 는 서버가 정하므로 싣지 않는다.
 
         Raises:
-            PropV2Error: 규칙 종류 코드를 와이어 글자로 바꿀 수 없을 때(0 · 1 밖 - 판정이 아니라 인코딩 불가).
+            UnsupportedOperationException: 규칙 종류 코드를 와이어 글자로 바꿀 수 없을 때(0 · 1 밖 - 판정이 아니라 인코딩 불가).
         """
         from . import _propv2
         back = {v: k for k, v in type(self)._ACL_TYPES.items()}
         if self.type not in back or isinstance(self.type, bool):
-            raise _propv2.PropV2Error("TYPE: unknown code %r (DENY(0) | ALLOW(1))" % (self.type,))
+            raise UnsupportedOperationException("[%r] is an unacceptable value. (acceptable value range: TYPE DENY(0) | ALLOW(1))" % (self.type,))
         return {"TYPE": back[self.type], "CLIENTIP": str(self.ip or ""), "CLIENTNAME": str(self.clientName or ""),
                 "CLIENTTYPE": str(self.clientType or "")}
 
@@ -3424,7 +3455,7 @@ class ILQmgrProperty(_PV2LoggerMixin, _AutoAccessor):
         if field == "autoStart":
             v = bool(v)
         if v not in back:
-            raise _propv2.PropV2Error("%s: unknown code %r" % (type(self)._PV2_KEYS[field][0], getattr(self, field)))
+            raise UnsupportedOperationException("[%r] is an unacceptable value. (acceptable value range: %s %s)" % (getattr(self, field), type(self)._PV2_KEYS[field][0], " | ".join("%s(%s)" % (k, int(v)) for k, v in type(self)._QMGR_ENUMS[field].items())))
         return back[v]
 
     def _pv2_patch_body(self) -> dict:
@@ -4714,7 +4745,7 @@ class ILServiceProperty(_PV2LoggerMixin, _AutoAccessor):
         """ALTER 본문(세터로 바꾼 칸만, ``_TYPE`` 없음)을 만든다. **라이브러리 내부용이다.**
 
         Raises:
-            PropV2Error: 열거 칸에 모르는 정수 코드가 있을 때.
+            UnsupportedOperationException: 열거 칸에 모르는 정수 코드가 있을 때.
         """
         from . import _propv2
         cls = type(self)
@@ -4725,7 +4756,7 @@ class ILServiceProperty(_PV2LoggerMixin, _AutoAccessor):
             if field in dirty:
                 back = {code: name for name, code in cls._SERVICE_ENUMS[field].items()}
                 if getattr(self, field) not in back:
-                    raise _propv2.PropV2Error("%s: unknown code %r" % (key, getattr(self, field)))
+                    raise UnsupportedOperationException("[%r] is an unacceptable value. (acceptable value range: %s %s)" % (getattr(self, field), key, " | ".join("%s(%d)" % (n, c) for n, c in cls._SERVICE_ENUMS[field].items())))
                 out[key] = back[getattr(self, field)]
         return {k: out[k] for _, (k, _) in cls._PV2_KEYS.items() if k in out}   # 표 순서
 

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.27.1
+Version: 0.28.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,20 @@ lz4 배치 압축을 쓰려면 `pip install "jetstream-api[lz4]"`, zstd 배치
 ## 설치 방법
 pip install jetstream-api
 
+## 0.28.0 변경 - IBMMQ 채널 MQ 인증 · 채널 사유(REASON) · 입력값 오류 표시 (자바 v2.24.0 와 같음, 짝 엔진 7.0.1.3638 이상)
+
+- 새 칸: IBMMQ 채널 MQ CONNAUTH ``mqUser`` · ``mqPassword`` (엔진 7.0.1.3638 이상). 둘은 한 쌍이다(한쪽만 있으면 엔진이 ``MIMQE_INVALID_PROPERTY``,
+  걷으려면 둘 다 ``""``). ``mqPassword`` 는 비밀 칸이다 - 조회하면 ``"*****"`` (없으면 ``""``), ``"*****"`` 를 되보내면 그대로 유지, ``""`` 는 지우기,
+  ``"{ARIA}<hex>"`` 는 봉인값으로 받는다. 클라는 비밀번호 길이를 검사하지 않고 사람이 읽는 요약에 찍지 않는다. 빈 인증 칸은 CREATE 에 싣지 않는다.
+- 새 칸: 채널 읽기 전용 ``reason`` (엔진 7.0.1.3637 이상, 최대 69자) - ERROR · STOPPED 가 된 사유(``"stopped by ..."`` · MQ cc/rc · ``"follower node"``).
+  RUNNING · STARTING 이면 빈칸이다. MQ 인증 실패는 ``MQCONNX failed cc=2 rc=2035 (auth: ...)`` 로 보인다.
+- 채널 목록(``getChannelList``)은 ``REASON`` 을 7.0.1.3637 이상, 인증 칸을 7.0.1.3638 이상 엔진에만 묻는다(``ILC.CHANNEL_REASON_MIN_REVISION`` · ``ILC.IBMMQ_AUTH_MIN_REVISION``).
+- IBMMQ 채널 흐름(엔진 7.0.1.3634 이상): START 가 실제 MQ 흐름을 띄운다(3633 · MQ SDK 없이 지은 엔진은 ``MIMQE_UNSUPPORTED``).
+  START 를 받아들인 뒤의 MQ 연결 실패는 채널 ERROR + 엔진 자동 재시도, STOP 은 1초 안에 STOPPED, MsgId · CorrelId 는 24바이트 <-> base64url 32자.
+  클러스터 팔로워의 IBMMQ 채널은 START 해도 STANDBY 로 남는다(REASON ``"follower node"``).
+- 고침: 보내기 전에 막는 열거 코드 오류(ACL ``type`` · 큐 관리자 ACLTYPE/STARTMODE · 서비스 TYPE/ACLTYPE · 로그 레벨 0~7 밖)가
+  ``MIMQC_FATAL_ERROR (MIMQE_INTERNAL_ERROR)`` 로 감싸여 보였다 - 이제 ``UnsupportedOperationException`` (``[v] is an unacceptable value. ...``) 그대로다.
+
 ## 0.27.1 변경 - 기동 · 정지 중 큐 관리자 조회 (자바 v2.23.1 와 같음, 짝 엔진 7.0.1.3633 이상)
 
 0.27.0 은 시험 판(test.pypi)만 내고 버렸다 - 회귀에서 아래 결함이 나왔다.

{jetstream_api-0.27.1 → jetstream_api-0.28.0}/pyproject.toml

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