SLI_STSN_ROUTINE 동사는 MICROSOFT® WINDOWS® LUA(논리 단위 애플리케이션) 애플리케이션에 STSN 명령이 호스트에서 제공되었음을 알리고 사용자가 제공한 루틴에서 요청을 검사하고 응답을 작성할 수 있도록 합니다.
다음 구조에서는 SLI_STSN_ROUTINE 사용되는 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
제공된 매개 변수입니다. SLI(세션 수준 인터페이스) 동사에 대한 LUA_VERB_SLI 동사 코드를 포함합니다.
lua_verb_length
제공된 매개 변수입니다. LUA VCB의 길이(바이트)를 지정합니다. 발급되는 동사 레코드의 길이를 포함해야 합니다.
lua_prim_rc
동사가 완료될 때 LUA에서 설정한 기본 반환 코드입니다. 유효한 반환 코드는 발급된 LUA 동사에 따라 달라집니다.
lua_sec_rc
동사가 완료될 때 LUA에서 설정한 보조 반환 코드입니다. 유효한 반환 코드는 발급된 LUA 동사에 따라 달라집니다.
lua_opcode
제공된 매개 변수입니다. LUA_OPCODE_SLI_STSN_ROUTINE 발급할 동사에 대한 LUA 명령 코드(동사 작업 코드)를 포함합니다.
lua_correlator
제공된 매개 변수입니다. 동사를 다른 사용자가 제공한 정보와 연결하는 사용자 제공 값을 포함합니다. LUA는 이 정보를 사용하거나 변경하지 않습니다. 이 매개 변수는 선택 사항입니다.
lua_luname
제공된 매개 변수입니다. Windows LUA 세션에서 사용하는 로컬 LU의 ASCII 이름을 지정합니다.
SLI_STSN_ROUTINE lua_sid 0인 경우에만 이 매개 변수가 필요합니다.
이 매개 변수는 8바이트 길이이며, 이름이 8자보다 짧은 경우 오른쪽에 공백(0x20)이 채워집니다.
lua_extension_list_offset
SLI_STSN_ROUTINE 사용되지 않으며 0으로 설정해야 합니다.
lua_cobol_offset
Microsoft® Host Integration Server 또는 SNA Server의 LUA에서 사용되지 않으며 0이어야 합니다.
lua_sid
제공된 매개 변수입니다. 세션 식별자를 지정하고 SLI_OPEN 및 RUI_INIT 반환됩니다. 다른 동사는 이 매개 변수를 사용하여 명령에 사용되는 세션을 식별합니다. 다른 동사가 lua_luname 매개 변수를 사용하여 세션을 식별하는 경우 lua_sid 매개 변수를 0으로 설정합니다.
lua_max_length
SLI_STSN_ROUTINE 사용되지 않으며 0으로 설정해야 합니다.
lua_data_length
반환된 매개 변수입니다. 데이터 버퍼에 반환된 STSN RU(요청/응답 단위) 데이터의 길이를 지정합니다.
lua_data_ptr
SLI_STSN_ROUTINE 경우 이 매개 변수에는 STSN RU의 주소가 포함됩니다.
lua_post_handle
제공된 매개 변수입니다. 이벤트에 의해 비동기 알림을 수행할 경우 Microsoft Windows Server에서 사용됩니다. 이 변수는 신호를 받을 이벤트의 핸들 또는 창 핸들을 포함합니다.
다른 모든 환경의 경우 이 매개 변수는 예약되어 있으며 0으로 설정해야 합니다.
lua_th
반환된 매개 변수입니다. 받은 메시지의 SNA 전송 헤더(TH)를 포함합니다. 읽기 및 입찰 함수에 대해 다양한 하위 매개 변수가 반환됩니다.
lua_rh
반환된 매개 변수입니다. 보내거나 받은 메시지의 SNA 요청/응답 헤더(RH)를 포함합니다.
lua_flag1
제공된 매개 변수입니다. 애플리케이션에서 제공하는 메시지에 대한 플래그를 포함하는 데이터 구조를 포함합니다.
lua_message_type
제공된 매개 변수입니다. 호스트에 전송된 SNA 데이터 또는 명령의 형식을 지정합니다.
lua_flag2
반환된 매개 변수입니다. LUA에서 반환하는 메시지에 대한 플래그를 포함합니다.
lua_flag2.async
1로 설정하면 LUA 인터페이스 동사가 비동기적으로 완료되었음을 나타냅니다.
lua_flag2.sscp_exp
1로 설정된 경우 시스템 서비스 제어 지점(SSCP) 신속한 흐름을 나타냅니다.
lua_flag2.sscp_norm
1로 설정된 경우 SSCP 일반 흐름을 나타냅니다.
lua_flag2.lu_exp
1로 설정된 경우 LU의 신속한 흐름을 나타냅니다.
lua_flag2.lu_norm
1로 설정된 경우 LU 일반 흐름을 나타냅니다.
lua_resv56
예약되어 있으며 0으로 설정해야 합니다.
lua_encr_decr_option
SLI_STSN_ROUTINE 사용되지 않으며 0으로 설정해야 합니다.
반환 코드
LUA_OK
기본 반환 코드; 동사가 성공적으로 실행되었습니다.
LUA_SEC_OK
보조 반환 코드; LUA_OK 대한 추가 정보가 없습니다.
LUA_NEGATIVE_RSP
기본 반환 코드; LUA가 메시지에서 오류가 발견되었기 때문에 PLU(기본 논리 단위)에서 받은 메시지에 부정적인 응답을 보내거나 애플리케이션이 체인의 끝이 도착한 체인에 부정적으로 응답했습니다.
비고
SLI_STSN_ROUTINE Windows LUA 애플리케이션이 STSN 명령을 검사하고 응답하는 메커니즘을 제공합니다. Windows LUA는 호스트에서 STSN 명령을 수신했음을 Windows LUA 애플리케이션에 알깁니다. 이 작업은 사용자가 제공한 DLL(동적 연결 라이브러리)을 통해 수행됩니다. 사용자 DLL은 STSN 요청을 검사하고 요청에 대한 응답을 작성합니다.
루틴의 DLL 이름은 SLI_OPEN 동사 VCB의 확장으로 제공됩니다. lua_extension_list_offset 매개 변수는 VCB 시작부터 확장 목록의 이름까지 오프셋을 제공합니다.
Windows LUA 인터페이스는 VCB가 구조화된 스토리지 공간을 할당합니다. SLI_STSN_ROUTINE VCB에는 lua_th 및 lua_rh 포함되어 있습니다. STSN RU의 주소는 lua_data_ptr 지정되며 RU의 길이는 lua_data_length 지정됩니다.
SLI_STSN_ROUTINE Windows LUA로 돌아오면 SLI_STSN_ROUTINE 처리가 완료됩니다. STSN 응답은 STSN RU를 덮어써야 합니다. STSN이 수락되면 기본 반환 코드는 LUA_OK 설정해야 합니다. STSN이 거부되면 기본 반환 코드를 LUA_NEGATIVE_RSP 설정해야 하며 STSN 버퍼에는 음수 감지 코드가 포함됩니다. lua_data_ptr 매개 변수는 수정하면 안 됩니다.
SLI_STSN_ROUTINE 부정 응답이 반환되면 SLI_OPEN 취소됩니다. SLI_OPEN lua_prim_rc LUA_SESSION_FAILURE 설정되고 lua_sec_rc LUA_NEG_RSP_FROM_STSN_ROUTINE 설정됩니다.
또한 참조하십시오
RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND