GET_LU_STATUS

아티클
10/14/2023

GET_LU_STATUS 동사는 특정 LU(논리 단위)의 상태 반환합니다. 이 대화 동사는 동기화 지점 대화가 지원되는 경우에만 사용할 수 있습니다.

다음 구조체는 GET_LU_STATUS 동사에서 사용하는 VCB(동사 제어 블록)에 대해 설명합니다.

구문

  
struct get_type {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned char    plu_alias[8];  
    unsigned short   active_sess;  
    unsigned char    zero_sess;  
    unsigned char    local_only;  
    unsigned char    synchpoint;  
    unsigned char    pool_member;  
    unsigned char    reserv3[7];  
};

멤버

opcode
제공된 매개 변수입니다. AP_GET_LU_STATUS 동사 작업 코드를 지정합니다.

opext
이 필드는 GET_LU_STATUS 동사에서 사용되지 않습니다.

reserv2
예약된 필드입니다.

primary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 기본 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.

secondary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 보조 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.

tp_id
제공된 매개 변수입니다. TP(로컬 트랜잭션 프로그램)를 식별합니다. 이 매개 변수의 값은 호출하는 TP의 TP_STARTED 또는 호출된 TP의 RECEIVE_ALLOCATE 또는 RECEIVE_ALLOCATE_EX 반환되었습니다.

plu_alias
제공된 매개 변수입니다. 이 TP가 문의하는 LU에 대한 식별자를 제공합니다. 이 매개 변수의 값은 호출하는 TP 또는 호출된 TP의 RECEIVE_ALLOCATE MC_ALLOCATE 또는 ALLOCATE에서 반환되었습니다.

local_only AP_YES 설정된 경우에는 필요하지 않습니다.

active_sess
반환된 매개 변수입니다. 이 LU의 활성 세션 수를 제공합니다.

zero_sess
반환된 매개 변수입니다. 0 세션이 이 LU에 있는지 여부를 나타냅니다. 값은 AP_YES 또는 AP_NO.

active_sess
반환된 매개 변수입니다.

zero_sess
반환된 매개 변수입니다.

local_only
이 필드를 AP_YES 설정하면 plu_alias 지정할 필요가 없으며 동사는 로컬 LU 정보(syncpoint 및 default_pool)만 반환합니다.

synchpoint
반환된 매개 변수입니다.

pool_member
이 필드를 AP_YES 설정하면 plu_alias 지정할 필요가 없으며 동사는 로컬 LU 정보(syncpoint 및 default_pool)만 반환합니다.

reserv3
예약된 필드입니다.

반환 코드

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

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

AP_BAD_LU_ALIAS

보조 반환 코드; plu_alias 값이 APPC에서 할당한 RU와 일치하지 않습니다.

AP_BAD_TP_ID

보조 반환 코드; tp_id 값이 APPC에서 할당한 TP 식별자와 일치하지 않습니다.

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

이 대화에서 사용하는 노드에 ABEND가 발생했습니다.
TP와 PU 2.1 노드 간의 연결이 끊어졌습니다(LAN 오류).
TP 컴퓨터의 SnaBase에서 ABEND가 발생했습니다.

시스템 관리자는 오류 로그를 검사하여 ABEND의 원인을 확인해야 합니다.

AP_INVALID_VERB_SEGMENT
기본 반환 코드입니다. VCB가 데이터 세그먼트의 끝을 넘어 확장되었습니다.

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

AP_CONV_BUSY
기본 반환 코드; 모든 대화에서 한 번에 하나의 뛰어난 대화 동사만 있을 수 있습니다. 로컬 TP에 여러 스레드가 있고 둘 이상의 스레드가 동일한 conv_id 사용하여 APPC 호출을 실행하는 경우에 발생할 수 있습니다.

AP_UNEXPECTED_DOS_ERROR
기본 반환 코드입니다. 로컬 TP의 APPC 호출을 처리하는 동안 운영 체제가 APPC에 오류를 반환했습니다. 운영 체제 반환 코드는 secondary_rc를 통해 반환됩니다. Intel 바이트 스와핑 순서로 표시됩니다. 문제가 지속되면 시스템 관리자에게 문의하세요.

설명

TP가 이 동사를 발급할 때 RESET을 제외한 모든 상태에 있을 수 있습니다.

상태 변경은 없습니다.

GET_LU_STATUS 현재 버전을 사용하면 애플리케이션이 로컬 APPC LU에 대한 구성 매개 변수를 검색할 수 있습니다.

RECEIVE_ALLOCATE_EX 동사를 발급하기 전에 특정 로컬 LU의 구성을 검사 다음 동사 시퀀스를 실행해야 합니다.

TP_STARTED(관심 있는 로컬 LU 지정)
GET_LU_STATUS(local_only AP_YES 설정)
TP_ENDED(AP_SOFT)

다음을 통해 공유

GET_LU_STATUS

구문

멤버

반환 코드

설명

추가 리소스