jetstream-api 0.6.5__tar.gz → 0.6.6__tar.gz

{jetstream_api-0.6.5 → jetstream_api-0.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.5
+Version: 0.6.6
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.6.5 → jetstream_api-0.6.6}/ilink/__init__.py

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

{jetstream_api-0.6.5 → jetstream_api-0.6.6}/ilink/admin.py

@@ -605,31 +605,28 @@ class ILAdminService:
             ILException: 통신 실패.
 
         Warning:
-            **속성 객체를 직접 채워 넘길 때만 해당한다.** 이름/포트만 넘기는
-            호출은 나머지가 기본값으로 채워지므로 조용히 바뀔 값이 없고, 넘기는
-            이름·포트·홈경로는 모두 신원 항목이라 규격을 벗어나면 **거부된다** -
-            모르고 지나갈 수 없다.
+            **값 검증은 엔진이 한다.** 이 API 는 문자열 길이(와이어 폭) 외의 값
+            범위를 검사하지 않으므로, 범위 밖 값을 넣었을 때 무슨 일이 일어나는지는
+            **상대 엔진에 달려 있다.** 아래는 실측 결과다.
 
-            :class:`ILQmgrProperty` 를 채워 넘기면 다르다. **값 검증은 엔진이
-            하는데**(이 API 는 문자열 길이 외의 범위를 검사하지 않는다) 엔진의
-            처리가 **생성과 변경에서 다르다.**
-
-            * **숫자 설정값**(타임아웃/주기/보관 수 등)이 범위를 벗어나면 엔진
-              7.1.1 이상은 거부하지 않고 **조용히 기본값으로 바꿔서 만든다.**
-              대조할 저장값이 없어 판정할 수 없기 때문이다. **오타를 내도
-              만들기는 성공하므로** 만든 뒤 :meth:`getQmgrProperty` 로 값을
-              확인한다::
+            * **범위 검사층이 있는 엔진은 생성 시 범위 밖 값을 거부한다**
+              (``MIMQE_INVALID_PROPERTY``). 숫자 설정값이든 이름·포트 같은 신원
+              항목이든 마찬가지다 - 생성 경로는 저장값과 대조하지 않고 범위만 본다::
 
                   vo = ILQmgrProperty("QMGR01", 19999)
                   vo.setSendTimeout(999999)   # 범위 밖 (1~864000)
-                  svc.createQmgr(vo)          # 성공한다 - 값은 기본값 60 이 된다
-
-            * 그래서 만든 뒤 봐야 할 것은 신원 항목이 아니라 숫자 설정값 쪽이다.
-            * **엔진 7.1.1 미만에는 이 검사층 자체가 없다.** 어떤 값도 걸러지지
-              않으므로 호출자가 스스로 확인해야 한다.
-
-            :meth:`setQmgrProperty` (변경)는 다르다 - 저장값과 다른 범위 밖
-            값은 거부된다.
+                  svc.createQmgr(vo)
+                  # 7.0.1.3367 -> ILOperationException
+                  #   MIMQE_INVALID_PROPERTY (SOCKTIMEOUTSND must be 1~864000 sec)
+
+            * **그 검사층이 없는 구엔진에서는 범위 밖 값이 그대로 저장된다.**
+              위와 같은 호출이 6.3.1 / 6.3.4 에서는 오류 없이 성공하고 저장값도
+              999999 가 된다. **조용히 잘못된 값으로 도는 쪽은 구엔진이므로**,
+              만든 뒤 :meth:`getQmgrProperty` 로 되읽어 확인한다.
+
+            :meth:`setQmgrProperty` (변경)는 판정 기준이 다르다. 검사층이 있는
+            엔진은 **저장값과 대조**해서, 손대지 않은 왕복은 통과시키고 범위 밖
+            **새** 값만 거부한다 - 구엔진 설정 이관이 막히지 않게 하려는 것이다.
 
         Note:
             만든 뒤 :meth:`startQmgr` 로 기동해야 접속할 수 있다.

{jetstream_api-0.6.5 → jetstream_api-0.6.6}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.6.5
+Version: 0.6.6
 Summary: Python client API for iLink M.O.M. (Message Oriented Middleware)
 Author: snowjeans
 License: Boost Software License - Version 1.0 - August 17th, 2003

{jetstream_api-0.6.5 → jetstream_api-0.6.6}/pyproject.toml

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