jetstream-api 0.5.0__tar.gz → 0.5.2__tar.gz

{jetstream_api-0.5.0 → jetstream_api-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.5.0
+Version: 0.5.2
 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.5.0 → jetstream_api-0.5.2}/ilink/__init__.py

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

{jetstream_api-0.5.0 → jetstream_api-0.5.2}/ilink/admin.py

@@ -6278,7 +6278,10 @@ class ILLogBrowser:
         self.service = service
 
     def __del__(self) -> None:
-        if self.browserId:
+        # 생성자가 중간에 실패하면 속성이 없을 수 있다. __del__ 에서 난 예외는
+        # 파이썬이 삼키고 stderr 로만 찍으므로, 동작에는 문제가 없어도 로그가
+        # 지저분해진다 - getattr 로 방어한다.
+        if getattr(self, "browserId", None) and getattr(self, "service", None):
             self.close()
 
     def close(self) -> None:
@@ -6289,10 +6292,11 @@ class ILLogBrowser:
         Note:
             닫지 않으면 서버에 커서가 남는다. ``try/finally`` 로 반드시 닫아라.
         """
-        if not self.service.isOnline():
+        service = getattr(self, "service", None)
+        if service is None or not service.isOnline():
             return
         try:
-            self.service.request(
+            service.request(
                 ILC.MIMQ_BROWSER_DELETION,
                 ILC.MIMQ_SUCCESSFUL_BROWSER_DELETION,
                 self.browserId,
@@ -6388,7 +6392,10 @@ class ILQueueBrowser:
         self.closed = False
 
     def __del__(self) -> None:
-        if self.browserId:
+        # 생성자가 중간에 실패하면 속성이 없을 수 있다. __del__ 에서 난 예외는
+        # 파이썬이 삼키고 stderr 로만 찍으므로, 동작에는 문제가 없어도 로그가
+        # 지저분해진다 - getattr 로 방어한다.
+        if getattr(self, "browserId", None) and getattr(self, "service", None):
             self.close()
 
     def close(self) -> None:
@@ -6399,10 +6406,11 @@ class ILQueueBrowser:
         Note:
             닫지 않으면 서버에 커서가 남는다. ``try/finally`` 로 반드시 닫아라.
         """
-        if not self.service.isOnline() or self.closed:
+        service = getattr(self, "service", None)
+        if service is None or not service.isOnline() or getattr(self, "closed", True):
             return
         try:
-            self.service.request(
+            service.request(
                 self.qmgrName,
                 ILC.MIMQ_BROWSER_DELETION,
                 ILC.MIMQ_SUCCESSFUL_BROWSER_DELETION,

{jetstream_api-0.5.0 → jetstream_api-0.5.2}/ilink/properties.py

@@ -92,23 +92,23 @@ class DestItem(_AutoAccessor):
     송신 채널이 이 목록을 ``balanceMode`` 규칙에 따라 돌면서 메시지를 보낸다.
 
     Attributes:
-        qmgrName (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 생성 시 지정, 이후 변경 불가. 대상 큐 관리자 이름. 기본 ``""``.
-        qmgrIp (str):
-            스펙: 기본 "" · 범위 127바이트 이하 문자열 · 생성 시 지정, 이후 변경 불가. 대상 IP 또는 호스트명. 기본 ``""``.
-        qmgrPort (int):
-            스펙: 기본 0 · 범위 1025~65535 · 생성 시 지정, 이후 변경 불가. 대상 포트. 기본 0.
-        statusCode (int):
-            스펙: 기본 STOPPED · 범위 STOPPED | RUNNING | STARTING | STOPPING · 변경 불가(ReadOnly). 이 대상의 상태. :data:`ILC.MIMQ_RUNNING` /
+        qmgrName (str): 대상 큐 관리자 이름. 기본 ``""``.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 생성 시 지정, 이후 변경 불가.
+        qmgrIp (str): 대상 IP 또는 호스트명. 기본 ``""``.
+            스펙: 기본 "" · 범위 127바이트 이하 문자열 · 생성 시 지정, 이후 변경 불가.
+        qmgrPort (int): 대상 포트. 기본 0.
+            스펙: 기본 0 · 범위 1025~65535 · 생성 시 지정, 이후 변경 불가.
+        statusCode (int): 이 대상의 상태. :data:`ILC.MIMQ_RUNNING` /
             :data:`ILC.MIMQ_STOPPED`(기본) / :data:`ILC.MIMQ_STARTING` /
             :data:`ILC.MIMQ_STOPPING`. 접근자는 :meth:`get_status` 다
             (``getStatusCode`` 가 아니다).
-        errorString (str):
-            스펙: 기본 "" · 범위 511바이트 이하 문자열 · 변경 불가(ReadOnly). 마지막 오류 사유. 정상이면 ``""``.
-        rtt (int):
-            스펙: 기본 -1 · 범위 -1~2147483647 (-1=미측정) · 단위 밀리초 · 변경 불가(ReadOnly). 왕복 지연(밀리초). 측정 전이면 ``-1``.
-        depth (int):
-            스펙: 기본 -1 · 범위 -1~2147483647 (-1=조회 실패) · 단위 건 · 변경 불가(ReadOnly). 대상 큐의 깊이. 알 수 없으면 ``-1``.
+            스펙: 기본 STOPPED · 범위 STOPPED | RUNNING | STARTING | STOPPING · 변경 불가(ReadOnly).
+        errorString (str): 마지막 오류 사유. 정상이면 ``""``.
+            스펙: 기본 "" · 범위 511바이트 이하 문자열 · 변경 불가(ReadOnly).
+        rtt (int): 왕복 지연(밀리초). 측정 전이면 ``-1``.
+            스펙: 기본 -1 · 범위 -1~2147483647 (-1=미측정) · 단위 밀리초 · 변경 불가(ReadOnly).
+        depth (int): 대상 큐의 깊이. 알 수 없으면 ``-1``.
+            스펙: 기본 -1 · 범위 -1~2147483647 (-1=조회 실패) · 단위 건 · 변경 불가(ReadOnly).
     """
 
     def __init__(
@@ -240,16 +240,16 @@ class PartitionItem(_AutoAccessor):
     """큐 파티션 하나의 적재 현황. :class:`ILQueueRealTimeInfo` 안에 목록으로 들어간다.
 
     Attributes:
-        size (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly). 이 파티션이 쓰는 총 바이트. 기본 0.
-        msgCnt (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 적재된 메시지 수(확정분). 기본 0.
-        trxCnt (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 처리 중(미커밋) 메시지 수. 기본 0.
-        fragmentCnt (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 조각 수. 기본 0.
-        fragmentSize (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly). 조각이 쓰는 총 바이트. 기본 0.
+        size (int): 이 파티션이 쓰는 총 바이트. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly).
+        msgCnt (int): 적재된 메시지 수(확정분). 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        trxCnt (int): 처리 중(미커밋) 메시지 수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        fragmentCnt (int): 조각 수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        fragmentSize (int): 조각이 쓰는 총 바이트. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly).
     """
 
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
@@ -338,13 +338,13 @@ class ILQueueMinorProperty(_AutoAccessor):
     전체 속성이 필요하면 :class:`ILQueueProperty` 를 쓴다.
 
     Attributes:
-        name (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly). 큐 이름. 기본 ``""``.
-        type (int):
-            스펙: 기본 LOCAL · 범위 LOCAL | REMOTE | XMIT · 변경 불가(ReadOnly). 큐 종류. :data:`ILC.MIMQ_LOCAL_PERSISTENT`(기본) /
+        name (str): 큐 이름. 기본 ``""``.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly).
+        type (int): 큐 종류. :data:`ILC.MIMQ_LOCAL_PERSISTENT`(기본) /
             :data:`ILC.MIMQ_REMOTE_QUEUE` / :data:`ILC.MIMQ_CHANNEL_TRANSMISSION_QUEUE`.
-        depth (int):
-            스펙: 기본 0 · 범위 0~2147483647 · 단위 건 · 변경 불가(ReadOnly). 현재 깊이(메시지 수). 기본 0.
+            스펙: 기본 LOCAL · 범위 LOCAL | REMOTE | XMIT · 변경 불가(ReadOnly).
+        depth (int): 현재 깊이(메시지 수). 기본 0.
+            스펙: 기본 0 · 범위 0~2147483647 · 단위 건 · 변경 불가(ReadOnly).
     """
 
     def __init__(
@@ -512,9 +512,9 @@ class ILQueueProperty(_AutoAccessor):
             :data:`ILC.MIMQ_REMOTE_QUEUE` / :data:`ILC.MIMQ_CHANNEL_TRANSMISSION_QUEUE`.
             스펙: 기본 LOCAL · 범위 LOCAL | REMOTE | XMIT · 변경 불가.
         depth (int): **읽기 전용** 현재 깊이. 기본 0.
-            스펙: 기본 0 · 범위 0~2147483647 · 변경 불가.
+            스펙: 기본 0 · 범위 0~2147483647 · 단위 건 · 변경 불가.
         maxDepth (int): 최대 깊이. 넘으면 put 이 거부된다. 기본 99999999.
-            스펙: 기본 99999999 · 범위 1~99999999 · 변경 가능/재기동 불필요.
+            스펙: 기본 99999999 · 범위 1~99999999 · 단위 건 · 변경 가능/재기동 불필요.
         maxMsgLength (int): 메시지 1건 최대 바이트. 기본 ``-1``(무제한).
             스펙: 기본 DISABLED (-1) · 범위 -1 또는 1~2147483647 · 단위 byte · 변경 가능/재기동 불필요.
         traceEnabled (bool): 이 큐의 트레이스 여부. 기본 False.
@@ -543,7 +543,7 @@ class ILQueueProperty(_AutoAccessor):
         expiredQueue (str): 만료된 메시지를 옮길 큐. 기본 ``""``.
             스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 가능/재기동 불필요.
         incomingDelayDepth (int): 유입 지연을 걸 깊이 기준. ``-1``(기본)이면 미사용.
-            스펙: 기본 DISABLED (-1) · 범위 -1 또는 1~2147483647 · 변경 가능/재기동 불필요.
+            스펙: 기본 DISABLED (-1) · 범위 -1 또는 1~2147483647 · 단위 건 · 변경 가능/재기동 불필요.
         incomingDelay (int): 그때 넣을 지연. ``-1``(기본)이면 미사용.
             스펙: 기본 NODELAY (-1) · 범위 -1 또는 1~2147483647 · 단위 밀리초 · 변경 가능/재기동 불필요.
         maxMemorySize (int): 메모리 상주 한도(바이트). 기본 10485760(10MB).
@@ -551,13 +551,13 @@ class ILQueueProperty(_AutoAccessor):
         sharedMemorySize (int): 공유 메모리 크기. 기본 0.
             스펙: 기본 DISABLED (0) · 범위 0~9223372036854775807 · 단위 byte · 변경 불가.
         numberOfPartition (int): 파일 파티션 개수. 기본 2.
-            스펙: 기본 2 · 범위 2~99 · 변경 불가.
-        legacyBlob (bool):
-            스펙: 서버 응답 길이로 라이브러리가 판단하는 내부 표시 · 앱이 건드리지 않는다. 이 객체가 **구버전(4096) 블롭**에서 만들어졌는지.
+            스펙: 기본 2 · 범위 2~99 · 단위 개 · 변경 불가.
+        legacyBlob (bool): 이 객체가 **구버전(4096) 블롭**에서 만들어졌는지.
             엔진 rev 3155 미만이 보낸 응답이면 True 다. 그 경우 ``expiry`` /
             ``expiredQueue`` / ``deliveryMode`` / ``maxMemorySize`` /
             ``sharedMemorySize`` / ``numberOfPartition`` 은 **서버가 준 값이 아니라
             기본값**이다 - 구엔진에는 그 설정이 없다.
+            스펙: 서버 응답 길이로 라이브러리가 판단하는 내부 표시 · 앱이 건드리지 않는다.
     """
 
     def __init__(
@@ -970,17 +970,17 @@ class ILChannelMinorProperty(_AutoAccessor):
     """채널 **요약** 정보. 목록 조회(``getChannelMinorList``)가 돌려주는 가벼운 형태.
 
     Attributes:
-        name (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly). 채널 이름. 기본 ``""``.
-        type (ILChannelType):
-            스펙: 기본 CLIENT · 범위 CLIENT | SERVER · 변경 불가(ReadOnly). 종류. ``CLIENT``(기본) / ``SERVER``.
-        direction (ILChannelDirection):
-            스펙: 기본 SEND · 범위 SEND | RECV · 변경 불가(ReadOnly). 방향. ``SEND``(기본) / ``RECV``.
-        status (ILChannelStatus):
-            스펙: 기본 STOPPED · 범위 STOPPED | RUNNING | STARTING | STOPPING | EXCEPTION · 변경 불가(ReadOnly). 상태. ``STOPPED``(기본) / ``RUNNING`` /
+        name (str): 채널 이름. 기본 ``""``.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly).
+        type (ILChannelType): 종류. ``CLIENT``(기본) / ``SERVER``.
+            스펙: 기본 CLIENT · 범위 CLIENT | SERVER · 변경 불가(ReadOnly).
+        direction (ILChannelDirection): 방향. ``SEND``(기본) / ``RECV``.
+            스펙: 기본 SEND · 범위 SEND | RECV · 변경 불가(ReadOnly).
+        status (ILChannelStatus): 상태. ``STOPPED``(기본) / ``RUNNING`` /
             ``STARTING`` / ``STOPPING`` / ``EXCEPTION``.
-        autoStart (bool):
-            스펙: 기본 AUTO · 범위 AUTO | MANUAL · 변경 불가(ReadOnly) (본체 속성으로 바꾼다). 큐 관리자 기동 시 함께 뜰지. 기본 True.
+            스펙: 기본 STOPPED · 범위 STOPPED | RUNNING | STARTING | STOPPING | EXCEPTION · 변경 불가(ReadOnly).
+        autoStart (bool): 큐 관리자 기동 시 함께 뜰지. 기본 True.
+            스펙: 기본 AUTO · 범위 AUTO | MANUAL · 변경 불가(ReadOnly) (본체 속성으로 바꾼다).
     """
 
     def __init__(
@@ -1188,9 +1188,8 @@ class ILChannelProperty(_AutoAccessor):
             스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 가능/재기동 불필요.
         timeout (int): 연결 타임아웃(**초**). ``-1`` 이면 무제한. 기본 30.
             스펙: 기본 30 · 범위 -1 또는 1~2147483647 · 단위 초 · 변경 가능/재기동 불필요.
-        rtt (int):
-            스펙: 기본 -1 · 범위 -1~2147483647 (-1=미측정) · 단위 밀리초 · 변경 불가(ReadOnly). **읽기 전용** 왕복 지연(밀리초). 측정 전이면 ``-1``.
-            스펙: 기본 -1 · 단위 밀리초 · 변경 불가.
+        rtt (int): **읽기 전용** 왕복 지연(밀리초). 측정 전이면 ``-1``.
+            스펙: 기본 -1 · 범위 -1~2147483647 (-1=미측정) · 단위 밀리초 · 변경 불가(ReadOnly).
         traceEnabled (bool): 이 채널의 트레이스 여부. 기본 False.
             스펙: 기본 OFF · 범위 ON | OFF · 변경 가능/재기동 불필요.
         security (ILChannelSecurity): 보안 방식. 기본 ``NONE``.
@@ -1202,12 +1201,11 @@ class ILChannelProperty(_AutoAccessor):
         balanceMode (ILChannelBalanceMode): 분산 방식. ``ROUND_ROBIN``(기본) /
             ``QUEUE_DEPTH`` / ``ACTIVE_STANDBY``. ``destGroup`` 이 있을 때만 의미가 있다.
             스펙: 기본 ROUND_ROBIN · 범위 ROUND.ROBIN | ACTIVE.STANDBY | QUEUE.DEPTH · 변경 가능/재기동 불필요.
-        destGroup (list[DestItem]):
-            스펙: 기본 빈 목록 · 범위 대상 수만큼 · 변경 가능/채널 정지 필요. 분산 대상 목록. 비어 있으면 단일 대상 채널이다.
+        destGroup (list[DestItem]): 분산 대상 목록. 비어 있으면 단일 대상 채널이다.
             :meth:`add_dest` / :meth:`remove_dest` 로 다룬다.
-            스펙: 변경 가능/재기동 불필요.
-        destGroupBufferLength (int):
-            스펙: 기본 0 · 범위 직렬화가 계산 · 앱이 건드리지 않는다. **직렬화용 내부 길이 필드.** 직접 건드리지 않는다.
+            스펙: 기본 빈 목록 · 범위 대상 수만큼 · 변경 가능/채널 정지 필요.
+        destGroupBufferLength (int): **직렬화용 내부 길이 필드.** 직접 건드리지 않는다.
+            스펙: 기본 0 · 범위 직렬화가 계산 · 앱이 건드리지 않는다.
 
     Note:
         와이어에는 ``ThreadCount`` / ``CommitCount`` 자리가 남아 있지만 **서버가
@@ -1437,14 +1435,16 @@ class ILChannelProperty(_AutoAccessor):
         """연결 타임아웃을 설정한다.
 
             Args:
-                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한.
+                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한, 그 밖에는 **1 이상**.
+                    ``0`` 은 거부된다.
 
             Raises:
-                UnsupportedOperationException: ``-1`` 미만일 때.
+                UnsupportedOperationException: ``-1`` 도 아니고 1 미만일 때.
         """
-        if sec < -1:
+        if sec != -1 and sec < 1:
             raise UnsupportedOperationException(
-                f"[{sec}] is an unacceptable value. (acceptable value range: -1~)"
+                f"[{sec}] is an unacceptable value."
+                " (acceptable value range: -1 for infinite, or 1 or greater)"
             )
         self.timeout = sec
 
@@ -1765,17 +1765,17 @@ class ILSecureFileProperty(_AutoAccessor):
     """서버에 보관된 보안 파일(인증서/키)의 **메타데이터.** 내용은 담기지 않는다.
 
     Attributes:
-        name (str):
-            스펙: 기본 "" · 범위 255바이트 이하 문자열 · 변경 불가(ReadOnly). 파일 이름. 기본 ``""``.
-        date (str):
-            스펙: 기본 "" · 범위 "YYYY-MM-DD HH:MM:SS" · 변경 불가(ReadOnly). 등록 일시 문자열. 기본 ``""``.
-        size (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly). 파일 크기(바이트). 기본 0.
-        keyStatus (str):
-            스펙: 기본 "" · 범위 "NotFound" | "Exist" | "" · 변경 불가(ReadOnly). 키 비밀번호 등록 상태. **``.key`` 파일에만 채워진다** -
+        name (str): 파일 이름. 기본 ``""``.
+            스펙: 기본 "" · 범위 255바이트 이하 문자열 · 변경 불가(ReadOnly).
+        date (str): 등록 일시 문자열. 기본 ``""``.
+            스펙: 기본 "" · 범위 "YYYY-MM-DD HH:MM:SS" · 변경 불가(ReadOnly).
+        size (int): 파일 크기(바이트). 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly).
+        keyStatus (str): 키 비밀번호 등록 상태. **``.key`` 파일에만 채워진다** -
             ``"NotFound"`` (비밀번호 미설정, 서버에 ``.prof`` 없음) /
             ``"Exist"`` (설정됨). 다른 확장자는 항상 빈 문자열이다.
             기본 ``""``. (rev 3291 실측)
+            스펙: 기본 "" · 범위 "NotFound" | "Exist" | "" · 변경 불가(ReadOnly).
     """
 
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
@@ -1871,30 +1871,30 @@ class ILQueueRealTimeInfo(_AutoAccessor):
         기준으로 담고 있다.
 
     Attributes:
-        curDepth (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 현재 깊이(메시지 수). 기본 0.
-        openTime (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 epoch 밀리초 · 변경 불가(ReadOnly). 큐가 열린 시각(epoch 밀리초). 기본 0.
-        lastPutTime (int):
-            스펙: 기본 0 · 범위 0 이상 (엔진 6.3.3+ 는 항상 0) · 단위 epoch 밀리초 · 변경 불가(ReadOnly). 마지막 put 시각(epoch 밀리초). **엔진 6.3.3+ 는 항상 0**.
-        lastGetTime (int):
-            스펙: 기본 0 · 범위 0 이상 (엔진 6.3.3+ 는 항상 0) · 단위 epoch 밀리초 · 변경 불가(ReadOnly). 마지막 get 시각(epoch 밀리초). **엔진 6.3.3+ 는 항상 0**.
-        lastPutClient (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 (엔진 6.3.3+ 는 항상 "") · 변경 불가(ReadOnly). 마지막으로 put 한 클라이언트 이름.
+        curDepth (int): 현재 깊이(메시지 수). 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        openTime (int): 큐가 열린 시각(epoch 밀리초). 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 epoch 밀리초 · 변경 불가(ReadOnly).
+        lastPutTime (int): 마지막 put 시각(epoch 밀리초). **엔진 6.3.3+ 는 항상 0**.
+            스펙: 기본 0 · 범위 0 이상 (엔진 6.3.3+ 는 항상 0) · 단위 epoch 밀리초 · 변경 불가(ReadOnly).
+        lastGetTime (int): 마지막 get 시각(epoch 밀리초). **엔진 6.3.3+ 는 항상 0**.
+            스펙: 기본 0 · 범위 0 이상 (엔진 6.3.3+ 는 항상 0) · 단위 epoch 밀리초 · 변경 불가(ReadOnly).
+        lastPutClient (str): 마지막으로 put 한 클라이언트 이름.
             **엔진 6.3.3+ 는 항상** ``""``.
-        lastGetClient (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 (엔진 6.3.3+ 는 항상 "") · 변경 불가(ReadOnly). 마지막으로 get 한 클라이언트 이름.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 (엔진 6.3.3+ 는 항상 "") · 변경 불가(ReadOnly).
+        lastGetClient (str): 마지막으로 get 한 클라이언트 이름.
             **엔진 6.3.3+ 는 항상** ``""``.
-        numberOfClient (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 이 큐를 열고 있는 클라이언트 수. 기본 0.
-        numberOfChannel (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 이 큐를 열고 있는 채널 수. 기본 0.
-        uncommittedPut (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 아직 커밋되지 않은 put 건수. 기본 0.
-        uncommittedGet (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 아직 커밋되지 않은 get 건수. 기본 0.
-        partitions (list[PartitionItem]):
-            스펙: 기본 빈 목록 · 범위 파티션 수만큼 · 변경 불가(ReadOnly). 파티션별 상세. 기본 빈 목록.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 (엔진 6.3.3+ 는 항상 "") · 변경 불가(ReadOnly).
+        numberOfClient (int): 이 큐를 열고 있는 클라이언트 수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        numberOfChannel (int): 이 큐를 열고 있는 채널 수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        uncommittedPut (int): 아직 커밋되지 않은 put 건수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        uncommittedGet (int): 아직 커밋되지 않은 get 건수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        partitions (list[PartitionItem]): 파티션별 상세. 기본 빈 목록.
+            스펙: 기본 빈 목록 · 범위 파티션 수만큼 · 변경 불가(ReadOnly).
     """
 
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
@@ -2072,16 +2072,16 @@ class ILQueueFlow(_AutoAccessor):
     """큐의 유입/유출량 스냅샷 하나.
 
     Attributes:
-        incomingMsgCount (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 유입 메시지 수. 기본 0.
-        outgoingMsgCount (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 유출 메시지 수. 기본 0.
-        incomingDataSize (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly). 유입 바이트. 기본 0.
-        outgoingDataSize (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly). 유출 바이트. 기본 0.
-        depth (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 이 시점의 큐 깊이. 기본 0.
+        incomingMsgCount (int): 유입 메시지 수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        outgoingMsgCount (int): 유출 메시지 수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        incomingDataSize (int): 유입 바이트. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly).
+        outgoingDataSize (int): 유출 바이트. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 byte · 변경 불가(ReadOnly).
+        depth (int): 이 시점의 큐 깊이. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
     """
 
     def __init__(
@@ -2179,16 +2179,16 @@ class ILQmgrMinorProperty(_AutoAccessor):
     """큐 관리자 **요약** 정보. 목록 조회가 돌려주는 가벼운 형태.
 
     Attributes:
-        name (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly). 큐 관리자 이름. 기본 ``""``.
-        status (int):
-            스펙: 기본 STOPPED · 범위 STOPPED | RUNNING | STARTING | STOPPING · 변경 불가(ReadOnly). 상태. :data:`ILC.MIMQ_STOPPED`(기본) /
+        name (str): 큐 관리자 이름. 기본 ``""``.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly).
+        status (int): 상태. :data:`ILC.MIMQ_STOPPED`(기본) /
             :data:`ILC.MIMQ_RUNNING` / :data:`ILC.MIMQ_STARTING` /
             :data:`ILC.MIMQ_STOPPING`.
-        port (int):
-            스펙: 기본 -1 · 범위 1025~65535 · 변경 불가(ReadOnly). 리스너 포트. 기본 ``-1``.
-        autoStart (bool):
-            스펙: 기본 AUTO · 범위 AUTO | MANUAL · 변경 불가(ReadOnly) (본체 속성으로 바꾼다). 서버 기동 시 함께 뜰지. 기본 True.
+            스펙: 기본 STOPPED · 범위 STOPPED | RUNNING | STARTING | STOPPING · 변경 불가(ReadOnly).
+        port (int): 리스너 포트. 기본 ``-1``.
+            스펙: 기본 -1 · 범위 1025~65535 · 변경 불가(ReadOnly).
+        autoStart (bool): 서버 기동 시 함께 뜰지. 기본 True.
+            스펙: 기본 AUTO · 범위 AUTO | MANUAL · 변경 불가(ReadOnly) (본체 속성으로 바꾼다).
     """
 
     def __init__(
@@ -2271,9 +2271,8 @@ class ILQmgrProperty(_AutoAccessor):
             스펙: 기본 STOPPED · 범위 STOPPED | RUNNING | STARTING | STOPPING · 변경 불가.
         version (str): **읽기 전용** 엔진 버전. 기본 ``""``.
             스펙: 변경 불가.
-        startedTimestamp (int):
-            스펙: 기본 0 · 범위 0 이상 (0=기동 전) · 단위 epoch 밀리초 · 변경 불가(ReadOnly). **읽기 전용** 기동 시각(epoch 밀리초). 기본 0.
-            스펙: 기본 0 · 단위 밀리초 · 변경 불가.
+        startedTimestamp (int): **읽기 전용** 기동 시각(epoch 밀리초). 기본 0.
+            스펙: 기본 0 · 범위 0 이상 (0=기동 전) · 단위 epoch 밀리초 · 변경 불가(ReadOnly).
         port (int): 리스너 포트. 기본 19998. **ilsvc.xml 을 직접 고쳐야 바뀐다**
             (서비스 내 중복 불가).
             스펙: 기본 19998 · 범위 1025~65535 · 변경 불가.
@@ -2301,9 +2300,9 @@ class ILQmgrProperty(_AutoAccessor):
         channelRetryTimeInterval (int): 채널 재시도 간격(초). 기본 5.
             스펙: 기본 5 · 범위 1~86400 · 단위 초 · 변경 가능/재기동 불필요.
         connectTimeout (int): 접속 타임아웃(초). ``-1``(기본)이면 무제한.
-            스펙: 기본 -1 · 범위 -1~2147483647 (초) · 변경 불가.
+            스펙: 기본 -1 · 범위 -1~2147483647 · 단위 초 · 변경 불가.
         acceptWaitTimeout (int): accept 대기(초). ``-1``(기본)이면 무제한.
-            스펙: 기본 -1 · 범위 -1~2147483647 (초) · 변경 불가.
+            스펙: 기본 -1 · 범위 -1~2147483647 · 단위 초 · 변경 불가.
         sendTimeout (int): 송신 타임아웃(초). 기본 60.
             스펙: 기본 60 · 범위 1~864000 · 단위 초 · 변경 가능/재기동 불필요.
         recvWaitTimeout (int): 수신 대기(초). 기본 86400(1일).
@@ -2320,9 +2319,9 @@ class ILQmgrProperty(_AutoAccessor):
         deadSessionKeepDuration (int): 끊긴 세션 정보 보관(초). 기본 600.
             **0 이면 계속 보관**한다.
             스펙: 기본 600 · 범위 0~2147483647 (0=무기한) · 단위 초 · 변경 가능/재기동 불필요.
-        deadSessionMaxCount (int): 끊긴 세션 보관 최대 수. 기본 10.
+        deadSessionMaxCount (int): 끊긴 세션 보관 최대 수. 기본 1000.
             **0 이면 보관하지 않는다.**
-            스펙: 기본 10 · 범위 0~2147483647 (0=보관 안 함) · 변경 가능/재기동 불필요.
+            스펙: 기본 1000 · 범위 0~2147483647 (0=보관 안 함) · 단위 건 · 변경 가능/재기동 불필요.
         logLevelSystem (int): 시스템 로그 레벨. 기본 4(WARNING).
             :data:`ILC.MIMQ_TRACE`(0) ~ :data:`ILC.MIMQ_SYSTEM`(7).
             스펙: 기본 WARN · 범위 TRACE(0) | DEBUG(1) | MSG(2) | INFO(3) | WARN(4) | ERROR(5) | FATAL(6) | SYSTEM(7) · 변경 가능/재기동 불필요.
@@ -2341,20 +2340,20 @@ class ILQmgrProperty(_AutoAccessor):
         logFileSizeChannel (int): 채널 로그 회전 크기. 기본 4194304.
             스펙: 기본 4194304 · 범위 1048576~104857600 · 단위 byte · 변경 가능/재기동 불필요.
         logFileCountSystem (int): 시스템 로그 보관 개수. 기본 5.
-            스펙: 기본 5 · 범위 1~999 · 변경 가능/재기동 불필요.
+            스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
         logFileCountClient (int): 클라이언트 로그 보관 개수. 기본 5.
-            스펙: 기본 5 · 범위 1~999 · 변경 가능/재기동 불필요.
+            스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
         logFileCountQueue (int): 큐 로그 보관 개수. 기본 5.
-            스펙: 기본 5 · 범위 1~999 · 변경 가능/재기동 불필요.
+            스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
         logFileCountChannel (int): 채널 로그 보관 개수. 기본 5.
-            스펙: 기본 5 · 범위 1~999 · 변경 가능/재기동 불필요.
+            스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
         logLevelTopic (int): 토픽 로그 레벨. 기본 4. **엔진 rev 3283 이상**.
             스펙: 기본 WARN · 범위 TRACE(0) | DEBUG(1) | MSG(2) | INFO(3) | WARN(4) | ERROR(5) | FATAL(6) | SYSTEM(7) · 변경 가능/재기동 불필요.
         logFileSizeTopic (int): 토픽 로그 회전 크기(바이트). 기본 4194304.
             **엔진 rev 3283 이상**.
-            스펙: 기본 4194304 · 범위 1~2147483647 · 단위 byte · 변경 가능/재기동 불필요.
+            스펙: 기본 4194304 · 범위 1048576~104857600 · 단위 byte · 변경 가능/재기동 불필요.
         logFileCountTopic (int): 토픽 로그 보관 개수. 기본 5. **엔진 rev 3283 이상**.
-            스펙: 기본 5 · 범위 1~2147483647 · 변경 가능/재기동 불필요.
+            스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
 
     Note:
         로그 설정은 값 범위가 강제된다 - 레벨 0~7, 회전 크기 1048576 이상,
@@ -2417,7 +2416,7 @@ class ILQmgrProperty(_AutoAccessor):
         self.startedTimestamp = 0
         self.statisticsEnabled = True
         self.deadSessionKeepDuration = 600
-        self.deadSessionMaxCount = 10
+        self.deadSessionMaxCount = 1000
 
         if isinstance(name, (bytes, bytearray)):
             self._from_bytes(bytes(name))
@@ -2773,14 +2772,16 @@ class ILQmgrProperty(_AutoAccessor):
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_QUEUE`(2) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_CHANNEL`(3).
-                value (int): 회전 크기(바이트). **1048576(1MB) 이상**이어야 한다.
+                value (int): 회전 크기(바이트). **1048576(1MB) ~ 104857600(100MB)**
+                    이어야 한다.
 
             Raises:
-                UnsupportedOperationException: 1048576 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1048576:
+        if value < 1048576 or value > 104857600:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1048576~)"
+                f"[{value}] is an unacceptable value."
+                " (acceptable value range: 1048576~104857600)"
             )
         setattr(self, "logFileSize" + self._log_suffix(logger_type), value)
 
@@ -2807,14 +2808,14 @@ class ILQmgrProperty(_AutoAccessor):
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_QUEUE`(2) /
                     :data:`ILC.MIMQ_LOGGER_TYPE_CHANNEL`(3).
-                value (int): 보관 개수. **1 이상**이어야 한다.
+                value (int): 보관 개수. **1~999** 여야 한다.
 
             Raises:
-                UnsupportedOperationException: 1 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1:
+        if value < 1 or value > 999:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1~)"
+                f"[{value}] is an unacceptable value. (acceptable value range: 1~999)"
             )
         setattr(self, "logFileCount" + self._log_suffix(logger_type), value)
 
@@ -2993,16 +2994,16 @@ class ILSessionMinorProperty(_AutoAccessor):
     """세션 **요약** 정보. 목록 조회가 돌려주는 가벼운 형태.
 
     Attributes:
-        id (str):
-            스펙: 기본 "" · 범위 8자리 숫자 문자열 · 변경 불가(ReadOnly). 세션 식별자(8자리 숫자 문자열). 기본 ``""``.
-        status (int):
-            스펙: 기본 1 · 범위 세션 상태 코드 · 변경 불가(ReadOnly). 세션 상태 코드. 기본 1.
-        peer (str):
-            스펙: 기본 "" · 범위 "host:port" · 변경 불가(ReadOnly). 상대 주소. 기본 ``""``.
-        clientName (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly). 클라이언트 이름. 기본 ``""``.
-        clientType (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly). 클라이언트 종류. 기본 ``""``.
+        id (str): 세션 식별자(8자리 숫자 문자열). 기본 ``""``.
+            스펙: 기본 "" · 범위 8자리 숫자 문자열 · 변경 불가(ReadOnly).
+        status (int): 세션 상태 코드. 기본 1.
+            스펙: 기본 1 · 범위 세션 상태 코드 · 변경 불가(ReadOnly).
+        peer (str): 상대 주소. 기본 ``""``.
+            스펙: 기본 "" · 범위 "host:port" · 변경 불가(ReadOnly).
+        clientName (str): 클라이언트 이름. 기본 ``""``.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly).
+        clientType (str): 클라이언트 종류. 기본 ``""``.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly).
     """
 
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
@@ -3091,13 +3092,11 @@ class ILSessionProperty(_AutoAccessor):
             스펙: 기본 "" · 변경 불가.
         peerPort (int): 상대 포트. 기본 0.
             스펙: 기본 0 · 범위 0~65535 · 변경 불가.
-        createdTime (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 epoch 밀리초 · 변경 불가(ReadOnly). 접속 시각(내부 형식). 기본 0.
+        createdTime (int): 접속 시각(내부 형식). 기본 0.
             :meth:`get_created_time` 으로 읽는 편이 낫다.
-            스펙: 기본 0 · 단위 밀리초 · 변경 불가.
-        destroyedTime (int):
-            스펙: 기본 0 · 범위 0 이상 (0=아직 살아 있음) · 단위 epoch 밀리초 · 변경 불가(ReadOnly). 종료 시각(내부 형식). 살아 있으면 0.
-            스펙: 기본 0 · 단위 밀리초 · 변경 불가.
+            스펙: 기본 0 · 범위 0 이상 · 단위 epoch 밀리초 · 변경 불가(ReadOnly).
+        destroyedTime (int): 종료 시각(내부 형식). 살아 있으면 0.
+            스펙: 기본 0 · 범위 0 이상 (0=아직 살아 있음) · 단위 epoch 밀리초 · 변경 불가(ReadOnly).
         transacted (bool): 트랜잭션 세션인지. 기본 False.
             스펙: 기본 False · 범위 True | False · 변경 불가.
         autoCommit (bool): 자동 커밋 세션인지. 기본 False.
@@ -3105,17 +3104,17 @@ class ILSessionProperty(_AutoAccessor):
         lastAccessObject (str): 마지막으로 건드린 객체 이름. 기본 ``""``.
             스펙: 기본 "" · 변경 불가.
         totalPutCount (int): 누적 put 건수. 기본 0.
-            스펙: 기본 0 · 범위 0~ · 변경 불가.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가.
         totalGetCount (int): 누적 get 건수. 기본 0.
-            스펙: 기본 0 · 범위 0~ · 변경 불가.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가.
         totalPutSize (int): 누적 put 바이트. 기본 0.
             스펙: 기본 0 · 범위 0~ · 단위 byte · 변경 불가.
         totalGetSize (int): 누적 get 바이트. 기본 0.
             스펙: 기본 0 · 범위 0~ · 단위 byte · 변경 불가.
         countPutting (int): 진행 중(미커밋) put 건수. 기본 0.
-            스펙: 기본 0 · 범위 0~ · 변경 불가.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가.
         countGetting (int): 진행 중(미커밋) get 건수. 기본 0.
-            스펙: 기본 0 · 범위 0~ · 변경 불가.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가.
         sizePutting (int): 진행 중 put 바이트. 기본 0.
             스펙: 기본 0 · 범위 0~ · 단위 byte · 변경 불가.
         sizeGetting (int): 진행 중 get 바이트. 기본 0.
@@ -3416,9 +3415,9 @@ class ILServiceProperty(_AutoAccessor):
         logFileSizeClient (int): 클라이언트 로그 회전 크기. 기본 4194304.
             스펙: 기본 4194304 · 범위 1048576~104857600 · 단위 byte · 변경 가능/재기동 불필요.
         logFileCountSystem (int): 시스템 로그 보관 개수. 기본 5.
-            스펙: 기본 5 · 범위 1~999 · 변경 가능/재기동 불필요.
+            스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
         logFileCountClient (int): 클라이언트 로그 보관 개수. 기본 5.
-            스펙: 기본 5 · 범위 1~999 · 변경 가능/재기동 불필요.
+            스펙: 기본 5 · 범위 1~999 · 단위 개 · 변경 가능/재기동 불필요.
     """
 
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
@@ -3627,14 +3626,15 @@ class ILServiceProperty(_AutoAccessor):
         """소켓 송신 타임아웃을 설정한다.
 
             Args:
-                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한.
+                sec (int): 타임아웃(**초**). **1~864000**.
+                    엔진 rev 3283(TMOGUARD-1) 부터 ``-1``(무제한)과 ``0`` 은 거부된다.
 
             Raises:
-                UnsupportedOperationException: ``-1`` 미만일 때.
+                UnsupportedOperationException: 1~864000 을 벗어날 때.
         """
-        if sec < -1:
+        if sec < 1 or sec > 864000:
             raise UnsupportedOperationException(
-                f"[{sec}] is an unacceptable value. (acceptable value range: -1~)"
+                f"[{sec}] is an unacceptable value. (acceptable value range: 1~864000)"
             )
         self.timeoutSocketSend = sec
 
@@ -3642,14 +3642,15 @@ class ILServiceProperty(_AutoAccessor):
         """소켓 수신 타임아웃을 설정한다.
 
             Args:
-                sec (int): 타임아웃(**초**). ``-1`` 이면 무제한.
+                sec (int): 타임아웃(**초**). **1~864000**.
+                    엔진 rev 3283(TMOGUARD-1) 부터 ``-1``(무제한)과 ``0`` 은 거부된다.
 
             Raises:
-                UnsupportedOperationException: ``-1`` 미만일 때.
+                UnsupportedOperationException: 1~864000 을 벗어날 때.
         """
-        if sec < -1:
+        if sec < 1 or sec > 864000:
             raise UnsupportedOperationException(
-                f"[{sec}] is an unacceptable value. (acceptable value range: -1~)"
+                f"[{sec}] is an unacceptable value. (acceptable value range: 1~864000)"
             )
         self.timeoutSocketRecv = sec
 
@@ -3714,14 +3715,16 @@ class ILServiceProperty(_AutoAccessor):
             Args:
                 logger_type (int): 로거 종류. :data:`ILC.MIMQ_LOGGER_TYPE_SYSTEM`(0) 또는
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1). 서비스는 이 둘뿐이다.
-                value (int): 회전 크기(바이트). **1048576(1MB) 이상**이어야 한다.
+                value (int): 회전 크기(바이트). **1048576(1MB) ~ 104857600(100MB)**
+                    이어야 한다.
 
             Raises:
-                UnsupportedOperationException: 1048576 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1048576:
+        if value < 1048576 or value > 104857600:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1048576~)"
+                f"[{value}] is an unacceptable value."
+                " (acceptable value range: 1048576~104857600)"
             )
         setattr(self, "logFileSize" + self._log_suffix(logger_type), value)
 
@@ -3744,14 +3747,14 @@ class ILServiceProperty(_AutoAccessor):
             Args:
                 logger_type (int): 로거 종류. :data:`ILC.MIMQ_LOGGER_TYPE_SYSTEM`(0) 또는
                     :data:`ILC.MIMQ_LOGGER_TYPE_CLIENT`(1). 서비스는 이 둘뿐이다.
-                value (int): 보관 개수. **1 이상**이어야 한다.
+                value (int): 보관 개수. **1~999** 여야 한다.
 
             Raises:
-                UnsupportedOperationException: 1 미만이거나 종류가 잘못됐을 때.
+                UnsupportedOperationException: 범위를 벗어나거나 종류가 잘못됐을 때.
         """
-        if value < 1:
+        if value < 1 or value > 999:
             raise UnsupportedOperationException(
-                f"[{value}] is an unacceptable value. (acceptable value range: 1~)"
+                f"[{value}] is an unacceptable value. (acceptable value range: 1~999)"
             )
         setattr(self, "logFileCount" + self._log_suffix(logger_type), value)
 
@@ -3815,6 +3818,13 @@ class ILProxyProperty(_AutoAccessor):
         구조 항목(``port`` / ``destIp`` / ``destPort``)은 리스닝 소켓과 목적지가 바뀌는
         것이라 **프록시를 정지한 뒤**에 바꿔야 하고, 실제 적용도 다음 기동부터다.
 
+    Note:
+        기동 중인 프록시는 목적지 생존을 확인하려고 **60초마다 목적지에 직접 붙어
+        본다**(엔진 7.0.1.3350 이상. 그 이전은 서비스가 10초마다 프록시 리스닝
+        포트에 붙었고 그게 목적지까지 이어졌다). 목적지가 또 다른 ilink 오브젝트면
+        **그쪽 접속 통계·접속 로그에 60초 간격 연결이 잡힌다** - 정상이고 끌 수
+        없다. 트래픽 없이 목적지 장애를 알려면 실제로 붙어 보는 수밖에 없다.
+
     Attributes:
         name (str): 프록시 이름. 기본 ``""``.
             스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가.
@@ -3837,7 +3847,7 @@ class ILProxyProperty(_AutoAccessor):
             엔진 7.0.1.3350 이상은 그 연결이 **5분에 한 번**이라 사실상 안 걸리지만,
             그 이전은 **10초마다**여서 유휴 프록시가 1 로 보이는 구간이 흔했다.
             정확한 동시 접속 수가 필요하면 이 값에 기대지 말 것.
-            스펙: 기본 0 · 범위 0~2147483647 · 변경 불가.
+            스펙: 기본 0 · 범위 0~2147483647 · 단위 건 · 변경 불가.
         status (int): **읽기 전용** 상태. 기본 :data:`ILC.MIMQ_STOPPED`.
             ERROR 는 대부분 **목적지 불통**을 뜻한다. **프록시가 고장난 것이
             아니라서** 리스닝은 그대로 유지하고 목적지 연결만 빠르게 실패시킨다 -
@@ -4000,15 +4010,17 @@ class ILDiskGuardProperty(_AutoAccessor):
         어긋나기 때문이다. 둘 중 **하나라도** 걸리면 차단하고, 해제는 **둘 다**
         회복되어야 한다.
 
-        ``resumePercent`` 는 ``suspendPercent`` **미만**이어야 한다(히스테리시스).
-        같은 값으로 붙여 두면 경계에서 차단/해제가 반복된다.
+        엔진이 강제하는 상호 제약이 셋 있다 - ``warnPercent`` <= ``suspendPercent``,
+        ``resumePercent`` < ``suspendPercent``(히스테리시스. 같은 값으로 붙여 두면
+        경계에서 차단/해제가 반복된다), ``resumeMinFreeMB`` >= ``minFreeMB``.
+        어기면 :meth:`validate` 와 서버가 함께 거절한다.
 
     Attributes:
         enabled (bool): 디스크 가드 사용 여부. 기본 True.
             스펙: 기본 ON · 범위 ON | OFF · 변경 가능/재기동 불필요.
         warnPercent (int): 경고 임계(사용률 %). 여기부터 경고 로그만 남고 쓰기는
             계속된다. 기본 90.
-            스펙: 기본 90 · 범위 1~100 · 단위 % · 변경 가능/재기동 불필요.
+            스펙: 기본 90 · 범위 1~100 (suspendPercent 이하) · 단위 % · 변경 가능/재기동 불필요.
         suspendPercent (int): 쓰기 차단 임계(사용률 %). 넘으면 쓰기만 막고 연결은
             유지한다(``MIMQE_QMGR_SUSPENDED``). 기본 95.
             스펙: 기본 95 · 범위 1~100 · 단위 % · 변경 가능/재기동 불필요.
@@ -4132,14 +4144,14 @@ class ILSpokeProperty(_AutoAccessor):
     """허브에 연결된 스포크 서버 하나의 정보.
 
     Attributes:
-        key (str):
-            스펙: 기본 "" · 범위 36자 UUID · 변경 불가(ReadOnly). 스포크 키(36자). 제거/전환 시 **이 값**을 쓴다. 기본 ``""``.
-        name (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly). 스포크 이름. 기본 ``""``.
-        peer (str):
-            스펙: 기본 "" · 범위 "host:port" · 변경 불가(ReadOnly). 상대 주소. 기본 ``""``.
-        running (bool):
-            스펙: 기본 False · 범위 True | False · 변경 불가(ReadOnly). 살아 있는지. 접근자는 :meth:`isRunning` 이다. 기본 False.
+        key (str): 스포크 키(36자). 제거/전환 시 **이 값**을 쓴다. 기본 ``""``.
+            스펙: 기본 "" · 범위 36자 UUID · 변경 불가(ReadOnly).
+        name (str): 스포크 이름. 기본 ``""``.
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 · 변경 불가(ReadOnly).
+        peer (str): 상대 주소. 기본 ``""``.
+            스펙: 기본 "" · 범위 "host:port" · 변경 불가(ReadOnly).
+        running (bool): 살아 있는지. 접근자는 :meth:`isRunning` 이다. 기본 False.
+            스펙: 기본 False · 범위 True | False · 변경 불가(ReadOnly).
     """
 
     def __init__(self, ba: bytes | bytearray | None = None) -> None:
@@ -4231,26 +4243,26 @@ class ILClusterNode(_AutoAccessor):
     운영자가 다루는 식별자는 qmgrName + host:port 다.
 
     Attributes:
-        nodeId (int):
-            스펙: 기본 0 · 범위 1~2147483647 (클러스터 안에서 유일) · 변경 가능/클러스터 정지 필요. 노드 번호. 기본 0. **1 이상이고 클러스터 안에서 유일**해야
+        nodeId (int): 노드 번호. 기본 0. **1 이상이고 클러스터 안에서 유일**해야
             한다(0 은 비클러스터 예약값). :meth:`ILClusterProperty.add_node` 가
             max+1 로 채번하므로 직접 매길 일은 없다. 중복이면 서버가 거부한다
             (**엔진 rev 3323+**).
-        host (str):
-            스펙: 기본 "" · 범위 127바이트 이하 문자열 · 변경 가능/클러스터 정지 필요. 노드의 IP 또는 호스트명. 기본 ``""``.
-        port (int):
-            스펙: 기본 0 · 범위 1025~65535 · 변경 가능/클러스터 정지 필요. 노드 큐 관리자의 리스너 포트. 기본 0. 심판(witness) 노드일
+            스펙: 기본 0 · 범위 1~2147483647 (클러스터 안에서 유일) · 변경 가능/클러스터 정지 필요.
+        host (str): 노드의 IP 또는 호스트명. 기본 ``""``.
+            스펙: 기본 "" · 범위 127바이트 이하 문자열 · 변경 가능/클러스터 정지 필요.
+        port (int): 노드 큐 관리자의 리스너 포트. 기본 0. 심판(witness) 노드일
             때는 **상대 ilcc 포트**를 넣는다. ``host:port`` 조합은 클러스터 안에서
             **유일**해야 한다 - 같은 큐 관리자를 두 번 넣으면 서버가 거부한다
             (**엔진 rev 3323+**).
-        status (int):
-            스펙: 기본 0 · 범위 노드 상태 코드 · 변경 불가(ReadOnly). **읽기 전용** 노드 상태. 서버가 채운다. 기본 0.
-        qmgrName (str):
-            스펙: 기본 "" · 범위 47바이트 이하 문자열 (빈 값 금지, rev 3319+) · 변경 가능/클러스터 정지 필요. 노드 큐 관리자 이름. 기본 ``""``. **필수 값이다** -
+            스펙: 기본 0 · 범위 1025~65535 · 변경 가능/클러스터 정지 필요.
+        status (int): **읽기 전용** 노드 상태. 서버가 채운다. 기본 0.
+            스펙: 기본 0 · 범위 노드 상태 코드 · 변경 불가(ReadOnly).
+        qmgrName (str): 노드 큐 관리자 이름. 기본 ``""``. **필수 값이다** -
             클러스터 기동/정지가 이 이름으로 노드를 찾으므로 비어 있으면 그 노드가
             제어 대상에서 빠진다. 엔진 **rev 3319 부터 빈 이름은 저장이 거부된다.**
             노드 **식별**은 host:port 로 한다(이름 중복은 막지 않는다 - HA 는 양
             노드 이름이 같은 구성이 정상이다).
+            스펙: 기본 "" · 범위 47바이트 이하 문자열 (빈 값 금지, rev 3319+) · 변경 가능/클러스터 정지 필요.
     """
 
     def __init__(self, ba: bytes | bytearray | None = None,
@@ -4332,15 +4344,15 @@ class ILClusterControlResult(_AutoAccessor):
     놓친다.**
 
     Attributes:
-        controlled (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 실제로 제어된 노드 수. 기본 0.
-        skipped (int):
-            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly). 제어 대상에서 빠진 노드 수. 기본 0. **0 이 아니면 확인하라.**
-        skippedNodes (list[str]):
-            스펙: 기본 빈 목록 · 범위 "host:port" 문자열 목록 · 변경 불가(ReadOnly). 빠진 노드 주소 목록(``"호스트:포트"``). 기본 빈 목록.
-        known (bool):
-            스펙: 기본 False · 범위 True | False · 변경 불가(ReadOnly). 엔진이 집계를 실어 보냈는지. ``False`` 면 **rev 3317 미만이라
+        controlled (int): 실제로 제어된 노드 수. 기본 0.
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        skipped (int): 제어 대상에서 빠진 노드 수. 기본 0. **0 이 아니면 확인하라.**
+            스펙: 기본 0 · 범위 0 이상 · 단위 건 · 변경 불가(ReadOnly).
+        skippedNodes (list[str]): 빠진 노드 주소 목록(``"호스트:포트"``). 기본 빈 목록.
+            스펙: 기본 빈 목록 · 범위 "host:port" 문자열 목록 · 변경 불가(ReadOnly).
+        known (bool): 엔진이 집계를 실어 보냈는지. ``False`` 면 **rev 3317 미만이라
             알 수 없다**는 뜻이지 "빠진 노드가 없다"는 뜻이 아니다.
+            스펙: 기본 False · 범위 True | False · 변경 불가(ReadOnly).
 
     Note:
         엔진이 이 값을 채워 주는 것은 **rev 3317 부터**다. 그 전 엔진은 응답에
@@ -4428,7 +4440,7 @@ class ILClusterProperty(_AutoAccessor):
         heartbeatIntervalMs (int): 하트비트 주기(**밀리초**). 기본 1000.
             스펙: 기본 1000 · 범위 100~2147483647 · 단위 밀리초 · 변경 가능/재기동 필요.
         heartbeatMissCount (int): 연속 미수신 몇 번을 사망으로 볼지. 기본 5.
-            스펙: 기본 5 · 범위 1~99 · 변경 가능/재기동 필요.
+            스펙: 기본 5 · 범위 1~99 · 단위 회 · 변경 가능/재기동 필요.
         electionDelayMs (int): 사망 판정 후 승격까지 지연(**밀리초**). 기본 3000.
             플래핑을 막는 값이다.
             스펙: 기본 3000 · 범위 0~2147483647 · 단위 밀리초 · 변경 가능/재기동 필요.

{jetstream_api-0.5.0 → jetstream_api-0.5.2}/jetstream_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jetstream-api
-Version: 0.5.0
+Version: 0.5.2
 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.5.0 → jetstream_api-0.5.2}/pyproject.toml

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