RUI_PURGE

RUI_PURGE 동사는 이전 RUI_READ 취소합니다.

다음 구조체는 RUI_PURGE 사용하는 VCB(동사 제어 블록)의 LUA_COMMON 멤버에 대해 설명합니다.

구문

  
struct LUA_COMMON {  
    unsigned short lua_verb;  
    unsigned short lua_verb_length;  
    unsigned short lua_prim_rc;  
    unsigned long  lua_sec_rc;  
    unsigned short lua_opcode;  
    unsigned long  lua_correlator;  
    unsigned char  lua_luname[8];  
    unsigned short lua_extension_list_offset;  
    unsigned short lua_cobol_offset;  
    unsigned long  lua_sid;  
    unsigned short lua_max_length;  
    unsigned short lua_data_length;  
    char FAR *      lua_data_ptr;  
    unsigned long  lua_post_handle;  
    struct LUA_TH  lua_th;  
    struct LUA_RH  lua_rh;  
    struct LUA_FLAG1 lua_flag1;  
    unsigned char  lua_message_type;  
    struct LUA_FLAG2 lua_flag2;  
    unsigned char  lua_resv56[7];  
    unsigned char  lua_encr_decr_option;  
};  

멤버

lua_verb
제공된 매개 변수입니다. RUI(요청 단위 인터페이스) 동사에 대한 LUA_VERB_RUI 동사 코드를 포함합니다.

lua_verb_length
제공된 매개 변수입니다. LUA(논리 단위 애플리케이션) VCB의 길이(바이트)를 지정합니다. 발급되는 동사 레코드의 길이를 포함해야 합니다.

lua_prim_rc
동사가 완료될 때 LUA에서 설정한 기본 반환 코드입니다. 유효한 반환 코드는 발급된 LUA 동사에 따라 달라집니다.

lua_sec_rc
동사가 완료될 때 LUA에서 설정한 보조 반환 코드입니다. 유효한 반환 코드는 발급된 LUA 동사에 따라 달라집니다.

lua_opcode
제공된 매개 변수입니다. LUA_OPCODE_RUI_PURGE 발급할 동사에 대한 LUA 명령 코드(동사 작업 코드)를 포함합니다.

lua_correlator
제공된 매개 변수입니다. 동사를 다른 사용자가 제공한 정보와 연결하는 사용자가 제공한 값을 포함합니다. LUA는 이 정보를 사용하거나 변경하지 않습니다. 이 매개 변수는 선택적 요소입니다.

lua_luname
제공된 매개 변수입니다. Windows LUA 세션에서 사용하는 로컬 LU의 ASCII 이름을 지정합니다.

RUI_PURGElua_sid 0인 경우에만 이 매개 변수가 필요합니다.

이 매개 변수는 8바이트 길이로, 이름이 8자보다 짧은 경우 오른쪽에 공백(0x20)이 채워집니다.

lua_extension_list_offset
Microsoft® Host Integration Server의 RUI에서 사용되지 않으며 0으로 설정해야 합니다.

lua_cobol_offset
호스트 통합 서버에서 LUA에서 사용되지 않으며 0이어야 합니다.

lua_sid
제공된 매개 변수입니다. 세션 식별자를 지정하고 SLI_OPEN 및 RUI_INIT 반환합니다. 다른 동사는 이 매개 변수를 사용하여 명령에 사용되는 세션을 식별합니다. 다른 동사에서 lua_luname 매개 변수를 사용하여 세션을 식별하는 경우 lua_sid 매개 변수를 0으로 설정합니다.

lua_max_length
RUI_PURGE 사용되지 않으며 0으로 설정해야 합니다.

lua_data_length
RUI_PURGE 사용되지 않으며 0으로 설정해야 합니다.

lua_data_ptr
취소할 RUI_READ 동사 VCB의 위치를 가리킵니다.

lua_post_handle
제공된 매개 변수입니다. 이벤트에 의해 비동기 알림을 수행할 경우 Microsoft® Windows Server에서 사용됩니다. 이 변수에는 신호를 받을 이벤트의 핸들 또는 창 핸들이 포함됩니다.

lua_th
RUI_PURGE 사용되지 않으며 0으로 설정해야 합니다.

lua_rh
RUI_PURGE 사용되지 않으며 0으로 설정해야 합니다.

lua_flag1
RUI_PURGE 사용되지 않으며 0으로 설정해야 합니다.

lua_message_type
RUI_PURGE 사용되지 않으며 0으로 설정해야 합니다.

lua_flag2
반환된 매개 변수입니다. LUA에서 반환된 메시지에 대한 플래그를 포함합니다.

lua_flag2.async

1로 설정된 경우 LUA 인터페이스 동사가 비동기적으로 완료되었음을 나타냅니다.

lua_resv56
예약된 및 는 0으로 설정해야 합니다.

lua_encr_decr_option
예약된 및 는 0으로 설정해야 합니다.

반환 코드

LUA_OK
기본 반환 코드입니다. 동사가 성공적으로 실행되었습니다.

LUA_CANCELED
기본 반환 코드; 동사가 다른 동사에 의해 취소되었기 때문에 동사가 성공적으로 완료되지 않았습니다.

LUA_TERMINATED

보조 반환 코드; RUI_PURGE 보류 중인 동안 RUI_TERM 발행되었습니다.

LUA_PARAMETER_CHECK
기본 반환 코드입니다. 매개 변수 오류로 인해 동사가 실행되지 않았습니다.

LUA_BAD_DATA_PTR

보조 반환 코드; lua_data_ptr 매개 변수가 null로 설정되었습니다.

LUA_BAD_SESSION_ID

보조 반환 코드; lua_sid 잘못된 값이 VCB에 지정되었습니다.

LUA_INVALID_POST_HANDLE

보조 반환 코드; 이벤트를 비동기 게시 방법으로 사용하는 Windows 운영 체제의 경우 Windows LUA VCB에는 유효한 이벤트 핸들이 포함되어 있지 않습니다.

LUA_RESERVED_FIELD_NOT_ZERO

보조 반환 코드; 동사 레코드의 예약 필드 또는 이 동사에서 사용하지 않는 매개 변수가 0이 아닌 값으로 설정되었습니다.

LUA_VERB_LENGTH_INVALID

보조 반환 코드; LUA에 의해 예기치 않은 lua_verb_length 값으로 LUA 동사가 발급되었습니다.

LUA_STATE_CHECK
기본 반환 코드입니다. 동사가 잘못된 상태에서 발행되었으므로 실행되지 않았습니다.

LUA_NO_RUI_SESSION

보조 반환 코드; 이 동사에 지정된 LU 이름에 대한 RUI_INIT 아직 완료되지 않았습니다.

LUA_UNSUCCESSFUL
기본 반환 코드; 제공된 동사가 유효했지만 동사가 성공적으로 완료되지 않았습니다.

LUA_INVALID_PROCESS

보조 반환 코드; 이 동사를 발급한 OS/2 프로세스는 이 세션에 대해 RUI_INIT 발급한 프로세스와 다릅니다. 세션을 시작한 프로세스만 해당 세션에서 동사를 실행할 수 있습니다.

LUA_NO_READ_TO_PURGE

보조 반환 코드; lua_data_ptr RUI_READ VCB에 대한 포인터가 없거나 RUI_PURGE 실행 되기 전에 완료된 RUI_READ.

LUA_COMM_SUBSYSTEM_ABENDED
기본 반환 코드입니다. 다음 조건 중 하나를 나타냅니다.

• 이 대화에서 사용하는 노드에 ABEND가 발생했습니다.

• TP(트랜잭션 프로그램)와 PU(물리적 단위) 2.1 노드 간의 연결이 끊어졌습니다(LAN 오류).

• TP 컴퓨터의 SnaBase에서 ABEND가 발견되었습니다.

  LUA_SESSION_FAILURE
  기본 반환 코드; 필요한 Host Integration Server 구성 요소가 종료되었습니다.

  LUA_LU_COMPONENT_DISCONNECTED

  보조 반환 코드; 는 링크 서비스 또는 호스트 LU 문제로 인해 LUA 세션이 실패했음을 나타냅니다.

  LUA_RUI_LOGIC_ERROR

  보조 반환 코드; LUA 내에서 내부 오류가 검색되었습니다. 이 오류는 정상 작업 중에는 발생하지 않습니다.

  LUA_INVALID_VERB
  기본 반환 코드; 동사 코드 또는 작업 코드 또는 둘 다 잘못되었습니다. 동사가 실행되지 않았습니다.

  LUA_STACK_TOO_SMALL
  기본 반환 코드입니다. 애플리케이션의 스택 크기가 너무 작아서 동사를 실행할 수 없습니다. 애플리케이션의 스택 크기를 늘리세요.

  LUA_COMM_SUBSYSTEM_NOT_LOADED
  기본 반환 코드; 동사를 처리하는 동안 필수 구성 요소를 로드하거나 종료할 수 없습니다. 따라서 통신을 수행할 수 없습니다. 정정 작업은 시스템 관리자에게 문의하세요

  LUA_UNEXPECTED_DOS_ERROR
  기본 반환 코드; 운영 체제 호출을 실행한 후 예기치 않은 운영 체제 반환 코드가 수신되고 보조 반환 코드에 지정됩니다.

설명

RUI_READlua_flag1.nowait (즉시 반환) 옵션을 사용하지 않고 전송되고 지정된 흐름에서 데이터를 사용할 수 없는 경우 무기한 대기할 수 있습니다. RUI_PURGE 대기 중인 동사가 강제로 반환됩니다(기본 반환 코드가 LUA_CANCELED).

이 동사는 RUI_READ 발급되어 완료 보류 중인 경우에만 사용됩니다. 기본 반환 코드는 LUA_IN_PROGRESS.

참고 항목

RUI_INIT
RUI_READ
RUI_TERM
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND