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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.25.0
+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,65 @@ 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)만 내고 버렸다 - 회귀에서 아래 결함이 나왔다.
+
+- 고침: 엔진 7 에서 큐 관리자가 기동 · 정지 중(STARTING · STOPPING)일 때 ``getQmgrProperty`` 가 ``MIMQE_QMGR_NOT_READY`` 로 실패했다 -
+  로그 칸(LOGGER)이 큐 관리자로 넘어가는데 그 창에는 답하지 못하기 때문이다. 그래서 ``startQmgrWithStatus`` · ``stopQmgrWithStatus`` 가 도중에 끊겼다.
+  이제 그 상태에서는 로그 칸을 관리 서비스의 블롭 조회에서 채운다. 상태 대기(``start/stopQmgrWithStatus`` · ``waitForQmgrStatus``) · ``isQmgrExist`` 는
+  로그 칸 없이 상태만 묻는다(요청 하나).
+- ``connectTimeout`` · ``acceptWaitTimeout`` 은 엔진이 쓰지 않는 칸이다(저장되지 않고 동작에 영향이 없다) - 엔진 7 JSON 에는 이 칸이 없다.
+
+## 0.27.0 변경 - IBMMQ 채널 1단계 · 로거 범위 문서 (자바 v2.23.0 와 같음, 짝 엔진 7.0.1.3633 이상)
+
+0.26.0 은 시험 판(test.pypi)만 내고 prod 로 내지 않았다 - 그 내용(ACL · 큐 관리자 속성 JSON, 아래 0.26.0 절)이 이 판에 그대로 들어 있다.
+
+- **IBMMQ 채널**(엔진 590): 엔진 7 JSON 에서 채널 종류 ``IBMMQ`` 와 IBMMQ 전용 칸 여섯을 주고받는다 -
+  ``mqChannel`` (MQ 서버 연결 채널, 기본 ``SYSTEM.DEF.SVRCONN``) · ``mqMode`` (``"CLIENT"`` | ``"BIND"``) · ``mqInstallPath`` · ``mqQueue`` ·
+  ``ilQueue`` · ``batchSize`` (기본 10). 이 칸들은 IBMMQ 채널의 생성 · 변경 본문에만 실린다.
+  - IBMMQ 채널은 엔진 7 JSON 으로만 만들고 바꾼다(6.x 블롭은 거절). 보안은 NONE 만, 포트 1~65535(MQ 기본 1414), 목적지 그룹 · balanceMode 는 쓰지 않는다.
+  - 1단계에서는 IBMMQ 채널 기동(START)이 거절된다(``MIMQE_UNSUPPORTED``) - 흐름은 엔진 다음 단계.
+  - ☠ **0.26.0 이하 클라는 JSON 채널 종류 ``IBMMQ`` 를 몰라서, IBMMQ 채널이 하나라도 있으면 채널 목록 · 조회가 실패한다** - IBMMQ 채널을 만들기 전에 이 판으로 올린다.
+  - 채널 목록 요청의 IBMMQ 칸은 엔진 7.0.1.3633 이상에만 묻는다(그 전 엔진은 모르는 키로 무시하고 경고를 남긴다).
+- 로거 범위(엔진 7.0.1.3631 이상): 로그 파일 크기 1048576~104857600 · 개수 1~999 · 옛 로그 명령의 카테고리 0~4(서비스는 SYS · CLI 만)를 엔진이 즉시 거절한다
+  (그 전 판은 범위 밖 값을 받아 두었다가 다음 적재 때 조용히 기본값으로 되돌렸다). 판정은 엔진이 한다 - 클라는 검사하지 않는다
+  (``setQmgrProperty`` 문서의 "라이브러리가 먼저 막는다" 는 틀렸다). 엔진 7.0.1.3632 부터는 기동 때 범위 밖 저장값을 기본값으로 쓴다(조회 = 실제 값).
+- ``removeQmgr``: 정의를 읽지 못하는 큐 관리자를 지우면 홈 디렉터리가 남는다(로그 디렉터리는 지운다).
+
+## 0.26.0 변경 - ACL · 큐 관리자 속성 Property v2(JSON) - Property v2 전환 끝 (자바 v2.22.0 와 같음, 짝 엔진 7.0.1.3630 이상)
+
+- **큐 관리자 속성이 엔진 7 과 JSON 으로 오간다**(엔진 P5-4). ``ILAdminService`` 의 ``getQmgrList`` · ``getQmgrMinorList`` · ``getQmgrProperty`` ·
+  ``setQmgrProperty`` · ``createQmgr`` · ``removeQmgr`` 와 ``ILAdminQmgr.getProperty`` · ``setProperty`` 다. 6.x 엔진은 기존 블롭.
+  - 서비스 단위 요청이다(큐 관리자 이름 없이, 대상은 본문 ``NAME``). 로그 15칸은 LOGGER(그 큐 관리자 이름)로 따로 오간다 -
+    ``getQmgrList`` (전체 정보)는 큐 관리자마다 LOGGER 조회를 한 번 더 보낸다.
+  - 변경은 **바꾼 칸만** 보낸다. 이름 · 포트 · 홈 경로는 생성 전용이다(홈 경로는 ``setHomePath`` 전용 명령).
+  - ☠ **7.0.1.3629 이하 7.x 엔진에는 큐 관리자 속성 조회 · 변경이 거절된다.**
+- 더함: ``setQmgrPropertyWithResult`` · ``createQmgrWithResult`` (``result["HOMEPATH"]`` = 정해진 홈 경로) - 요청이 둘 이상이라 원자적이지 않다
+  (로거 변경이 거절되면 사유 뒤에 ``[LOGGER <카테고리> 거절 - 이미 적용: ...]``). ``ILQmgrProperty.clusterNode`` (읽기 전용, 0 = 비클러스터,
+  1 이상 = 노드 번호, 6.x 블롭이면 ``None``).
+- **ACL 이 엔진 7 과 JSON 으로 오간다**(엔진 P5-3). ``getAccessRuleList`` · ``addAccessRule`` · ``removeAccessRule`` (서비스 · 큐 관리자). 규칙은 원소 단위로
+  만들고 지운다(변경 없음). 더함: ``addAccessRuleWithResult`` (``result["ID"]`` = 새 규칙 ID - 블롭에는 없던 정보),
+  ``ILAccessRuleProperty.effective`` (읽기 전용, 지금 효력이 있는가 - 6.x 블롭이면 ``None``). ☠ 7.0.1.3628 이하 7.x 엔진에는 ACL 조회 · 변경이 거절된다.
+- ACL 규칙: IP · 클라이언트 이름 · 종류가 **셋 다 빈 규칙은 엔진 7.0.1.3628 이상이 거절**한다(6.x 는 받는다). 규칙 기본값은 ``""`` (= 모두)다
+  (문서가 ``"*"`` 로 잘못 적혀 있었다). 규칙 종류(``type``)는 클라가 검사하지 않는다 - 0 · 1 밖은 엔진이 거절한다.
+- 이로써 Property v2(JSON) 전환이 끝났다 - 엔진 7 과는 큐 · 채널 · 세션 · 서비스 · 로거 · ACL · 큐 관리자 · 토픽 · 쿼터 · 디스크 가드 · 클러스터가
+  모두 JSON 이다. 6.x 엔진과는 그 엔진에 있는 오브젝트(큐 · 채널 · 세션 · 서비스 · ACL · 큐 관리자)를 기존 고정폭 블롭으로 주고받는다.
+
 ## 0.25.0 변경 - 서비스 속성 · 로거 Property v2(JSON) · 블롭 왕복 보존 (자바 v2.21.0 와 같음, 짝 엔진 7.0.1.3624 이상)
 
 - **서비스 속성이 엔진 7 과 JSON 으로 오간다**(엔진 P5-2). ``ILAdminService.getProperty`` 는 SERVICE GET + LOGGER LIST(시스템 ·

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

@@ -10,6 +10,65 @@ 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)만 내고 버렸다 - 회귀에서 아래 결함이 나왔다.
+
+- 고침: 엔진 7 에서 큐 관리자가 기동 · 정지 중(STARTING · STOPPING)일 때 ``getQmgrProperty`` 가 ``MIMQE_QMGR_NOT_READY`` 로 실패했다 -
+  로그 칸(LOGGER)이 큐 관리자로 넘어가는데 그 창에는 답하지 못하기 때문이다. 그래서 ``startQmgrWithStatus`` · ``stopQmgrWithStatus`` 가 도중에 끊겼다.
+  이제 그 상태에서는 로그 칸을 관리 서비스의 블롭 조회에서 채운다. 상태 대기(``start/stopQmgrWithStatus`` · ``waitForQmgrStatus``) · ``isQmgrExist`` 는
+  로그 칸 없이 상태만 묻는다(요청 하나).
+- ``connectTimeout`` · ``acceptWaitTimeout`` 은 엔진이 쓰지 않는 칸이다(저장되지 않고 동작에 영향이 없다) - 엔진 7 JSON 에는 이 칸이 없다.
+
+## 0.27.0 변경 - IBMMQ 채널 1단계 · 로거 범위 문서 (자바 v2.23.0 와 같음, 짝 엔진 7.0.1.3633 이상)
+
+0.26.0 은 시험 판(test.pypi)만 내고 prod 로 내지 않았다 - 그 내용(ACL · 큐 관리자 속성 JSON, 아래 0.26.0 절)이 이 판에 그대로 들어 있다.
+
+- **IBMMQ 채널**(엔진 590): 엔진 7 JSON 에서 채널 종류 ``IBMMQ`` 와 IBMMQ 전용 칸 여섯을 주고받는다 -
+  ``mqChannel`` (MQ 서버 연결 채널, 기본 ``SYSTEM.DEF.SVRCONN``) · ``mqMode`` (``"CLIENT"`` | ``"BIND"``) · ``mqInstallPath`` · ``mqQueue`` ·
+  ``ilQueue`` · ``batchSize`` (기본 10). 이 칸들은 IBMMQ 채널의 생성 · 변경 본문에만 실린다.
+  - IBMMQ 채널은 엔진 7 JSON 으로만 만들고 바꾼다(6.x 블롭은 거절). 보안은 NONE 만, 포트 1~65535(MQ 기본 1414), 목적지 그룹 · balanceMode 는 쓰지 않는다.
+  - 1단계에서는 IBMMQ 채널 기동(START)이 거절된다(``MIMQE_UNSUPPORTED``) - 흐름은 엔진 다음 단계.
+  - ☠ **0.26.0 이하 클라는 JSON 채널 종류 ``IBMMQ`` 를 몰라서, IBMMQ 채널이 하나라도 있으면 채널 목록 · 조회가 실패한다** - IBMMQ 채널을 만들기 전에 이 판으로 올린다.
+  - 채널 목록 요청의 IBMMQ 칸은 엔진 7.0.1.3633 이상에만 묻는다(그 전 엔진은 모르는 키로 무시하고 경고를 남긴다).
+- 로거 범위(엔진 7.0.1.3631 이상): 로그 파일 크기 1048576~104857600 · 개수 1~999 · 옛 로그 명령의 카테고리 0~4(서비스는 SYS · CLI 만)를 엔진이 즉시 거절한다
+  (그 전 판은 범위 밖 값을 받아 두었다가 다음 적재 때 조용히 기본값으로 되돌렸다). 판정은 엔진이 한다 - 클라는 검사하지 않는다
+  (``setQmgrProperty`` 문서의 "라이브러리가 먼저 막는다" 는 틀렸다). 엔진 7.0.1.3632 부터는 기동 때 범위 밖 저장값을 기본값으로 쓴다(조회 = 실제 값).
+- ``removeQmgr``: 정의를 읽지 못하는 큐 관리자를 지우면 홈 디렉터리가 남는다(로그 디렉터리는 지운다).
+
+## 0.26.0 변경 - ACL · 큐 관리자 속성 Property v2(JSON) - Property v2 전환 끝 (자바 v2.22.0 와 같음, 짝 엔진 7.0.1.3630 이상)
+
+- **큐 관리자 속성이 엔진 7 과 JSON 으로 오간다**(엔진 P5-4). ``ILAdminService`` 의 ``getQmgrList`` · ``getQmgrMinorList`` · ``getQmgrProperty`` ·
+  ``setQmgrProperty`` · ``createQmgr`` · ``removeQmgr`` 와 ``ILAdminQmgr.getProperty`` · ``setProperty`` 다. 6.x 엔진은 기존 블롭.
+  - 서비스 단위 요청이다(큐 관리자 이름 없이, 대상은 본문 ``NAME``). 로그 15칸은 LOGGER(그 큐 관리자 이름)로 따로 오간다 -
+    ``getQmgrList`` (전체 정보)는 큐 관리자마다 LOGGER 조회를 한 번 더 보낸다.
+  - 변경은 **바꾼 칸만** 보낸다. 이름 · 포트 · 홈 경로는 생성 전용이다(홈 경로는 ``setHomePath`` 전용 명령).
+  - ☠ **7.0.1.3629 이하 7.x 엔진에는 큐 관리자 속성 조회 · 변경이 거절된다.**
+- 더함: ``setQmgrPropertyWithResult`` · ``createQmgrWithResult`` (``result["HOMEPATH"]`` = 정해진 홈 경로) - 요청이 둘 이상이라 원자적이지 않다
+  (로거 변경이 거절되면 사유 뒤에 ``[LOGGER <카테고리> 거절 - 이미 적용: ...]``). ``ILQmgrProperty.clusterNode`` (읽기 전용, 0 = 비클러스터,
+  1 이상 = 노드 번호, 6.x 블롭이면 ``None``).
+- **ACL 이 엔진 7 과 JSON 으로 오간다**(엔진 P5-3). ``getAccessRuleList`` · ``addAccessRule`` · ``removeAccessRule`` (서비스 · 큐 관리자). 규칙은 원소 단위로
+  만들고 지운다(변경 없음). 더함: ``addAccessRuleWithResult`` (``result["ID"]`` = 새 규칙 ID - 블롭에는 없던 정보),
+  ``ILAccessRuleProperty.effective`` (읽기 전용, 지금 효력이 있는가 - 6.x 블롭이면 ``None``). ☠ 7.0.1.3628 이하 7.x 엔진에는 ACL 조회 · 변경이 거절된다.
+- ACL 규칙: IP · 클라이언트 이름 · 종류가 **셋 다 빈 규칙은 엔진 7.0.1.3628 이상이 거절**한다(6.x 는 받는다). 규칙 기본값은 ``""`` (= 모두)다
+  (문서가 ``"*"`` 로 잘못 적혀 있었다). 규칙 종류(``type``)는 클라가 검사하지 않는다 - 0 · 1 밖은 엔진이 거절한다.
+- 이로써 Property v2(JSON) 전환이 끝났다 - 엔진 7 과는 큐 · 채널 · 세션 · 서비스 · 로거 · ACL · 큐 관리자 · 토픽 · 쿼터 · 디스크 가드 · 클러스터가
+  모두 JSON 이다. 6.x 엔진과는 그 엔진에 있는 오브젝트(큐 · 채널 · 세션 · 서비스 · ACL · 큐 관리자)를 기존 고정폭 블롭으로 주고받는다.
+
 ## 0.25.0 변경 - 서비스 속성 · 로거 Property v2(JSON) · 블롭 왕복 보존 (자바 v2.21.0 와 같음, 짝 엔진 7.0.1.3624 이상)
 
 - **서비스 속성이 엔진 7 과 JSON 으로 오간다**(엔진 P5-2). ``ILAdminService.getProperty`` 는 SERVICE GET + LOGGER LIST(시스템 ·

{jetstream_api-0.25.0 → 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.25.0"
+__version__ = "0.28.0"
 
 # --- Admin / Service ---
 from .admin import ILAdminService, ILAdminQmgr, ILLogBrowser, ILQueueBrowser