다음을 통해 공유

TRANSFER_MS_DATA

  • 아티클

TRANSFER_MS_DATA 동사는 NMVT(네트워크 관리 벡터 전송) 데이터를 포함하는 SNA 요청 단위를 빌드합니다. 동사는 중앙 집중식 문제 진단 및 해결을 위해 NMVT 데이터를 NetView로 보낼 수 있습니다. 데이터는 로컬 감사 파일에 기록됩니다.

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

구문

  
struct transfer_ms_data {  
    unsigned short       opcode;  
    unsigned char        data_type;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        options;  
    unsigned char        reserv3;  
    unsigned char        origntr_id[8];  
    unsigned short       dlen;  
    unsigned char FAR *  dptr;  
};

구성원

opcode
제공된 매개 변수입니다. SV_TRANSFER_MS_DATA 작업 코드를 식별하는 동사입니다.

data_type
제공된 매개 변수입니다. 이 동사에서 제공하는 데이터 형식을 지정합니다.

  • SV_NMVT 사용하여 NMVT(NS 헤더, 주요 네트워크 관리 벡터 및 하위 벡터 포함)를 생성합니다.

  • SV_ALERT_SUBVECTORS 사용하여 NS 헤더 또는 주요 NMVT 벡터 없이 적절한 형식의 경고에 대한 데이터가 포함된 RU를 생성합니다.

  • SV_PDSTATS_SUBVECTORS 사용하여 NS 헤더 또는 주요 NMVT 벡터 없이 적절한 형식의 문제 결정 통계에 대한 데이터가 포함된 RU를 생성합니다.

  • SV_USER_DEFINED 사용하여 사용자 정의 데이터를 생성합니다. 이 데이터는 오류 로그에 기록되지만 진단 위해 구성된 연결의 시스템 서비스 제어 지점-물리적 단위(SSCP-PU) 세션에서 전송할 수 없습니다.

    reserv2
    예약된 필드입니다.

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

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

    options
    제공된 매개 변수입니다. 개별 비트를 설정하거나 해제하여 원하는 옵션을 지정합니다. (data_type SV_USER_DEFINED 설정된 경우 비트 1 , 2 및 3은 무시됩니다.) 설명 섹션을 참조하세요.

    reserv3
    예약된 필드입니다.

    origntr_id
    제공된 매개 변수입니다. TRANSFER_MS_DATA 발급하는 구성 요소의 이름을 지정합니다. 이 매개 변수는 선택적 요소입니다. 시스템에서 무시하도록 하려면 0x00 설정합니다.

    dlen
    제공된 매개 변수입니다. 이 동사에 제공할 데이터의 길이를 지정합니다. 데이터의 총 길이(사용자가 제공한 데이터 및 추가된 헤더 또는 하위 벡터)는 하나의 RU에 맞아야 합니다. 최대 RU 길이는 512바이트입니다.

    dptr
    제공된 매개 변수입니다. 보낼 데이터의 주소를 지정합니다.

반환 코드

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

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

SV_DATA_EXCEEDS_RU_SIZE

보조 반환 코드; 전송할 데이터가 너무 깁니다. 사용자가 제공한 데이터와 헤더 및 추가된 하위 벡터의 길이는 512바이트 이하인 단일 RU에 맞아야 합니다.

SV_INVALID_DATA_SEGMENT

보조 반환 코드; dptr 에서 가리키는 버퍼가 읽을 수 있는 세그먼트가 아니거나 세그먼트 경계를 넘어 확장되었습니다.

SV_INVALID_DATA_TYPE

보조 반환 코드; data_type 매개 변수에 잘못된 값이 포함되어 있습니다.

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

SV_SSCP_PU_SESSION_NOT_ACTIVE

보조 반환 코드; NMVT가 전송되지 않았습니다. SSCP-PU 세션이 활성 상태가 아니거나, 진단 정보를 받도록 구성된 노드가 활성화되지 않았거나, 네트워크 관리 연결이 구성되지 않았습니다.

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

SV_INVALID_VERB
기본 반환 코드입니다. opcode 매개 변수가 모든 동사의 작업 코드와 일치하지 않습니다. 동사가 실행되지 않았습니다.

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

SV_UNEXPECTED_DOS_ERROR
기본 반환 코드입니다. 다음 조건 중 하나가 발생했습니다.

  • 동사를 처리하는 동안 Microsoft Windows 운영 체제에서 오류가 발생했습니다. 운영 체제 반환 코드가 보조 반환 코드를 통해 반환되었습니다. 문제가 지속되면 시스템 관리자에게 정정 작업을 문의하세요.

  • CSV가 보다 일반적인 Windows PostMessage 함수 호출이 아닌 Windows SendMessage 함수 호출을 발행하는 다른 애플리케이션이 호출한 메시지 루프로부터 발행되었습니다. 동사 처리를 수행할 수 없습니다.

  • SendMessage가 애플리케이션을 호출할 때 CSV가 발행되었습니다. InSendMessage Windows API 함수 호출을 사용하면, 애플리케이션이 SendMessage를 사용하여 호출되었는지 여부를 확인할 수 있습니다.

    SV_CANCELLED
    기본 반환 코드; 이 코드는 WinCSVCleanup 호출에 의해 종료된 경우 비동기 동사에 대해 반환됩니다.

    SV_SERVER_RESOURCE_NOT_FOUND
    기본 반환 코드; 요청된 함수를 제공할 수 있는 통신 서버를 찾을 수 없습니다.

    SV_SERVER_RESOURCES_LOST
    기본 반환 코드; 연결 오류로 인해 함수를 제공한 통신 서버가 손실되었습니다.

    SV_SERVER_CONN_FAILURE

    보조 반환 코드; 물리적 경로 문제로 인해 서버에 대한 연결이 끊겼습니다. 예를 들어 서버의 전원이 꺼졌을 수 있습니다.

    SV_THREAD_BLOCKING
    기본 반환 코드; 이 동사는 허용되는 최대 동시 동기 동사 수를 초과합니다.

설명

옵션을 지정하려면 다음과 같이 비트를 켜거나 끕니다.

bit Description
0 TIME_STAMP_SUBVECTOR. 데이터에 날짜/시간 하위 벡터를 추가합니다. 허용되는 값에는 SV_ADD 및 SV_NO_ADD 포함됩니다.
1 PRODUCT_SET_ID_SUBVECTOR. 데이터에 Product_Set_ID 하위 벡터를 추가합니다. 이를 통해 네트워크 관리 서비스는 경고의 발신자를 식별할 수 있습니다. 허용되는 값에는 SV_ADD 및 SV_NO_ADD 포함됩니다.
2 SSCP_PU_SESSION. 세션이 활성 상태인 경우 진단 대해 구성된 연결에서 SSCP-PU 세션의 데이터를 보냅니다. (데이터는 세션에서 전송되는지 또는 SV_STATE_CHECK 또는 SV_COMM_SUBSYSTEM_NOT_LOADED 반환되는지 여부에 관계없이 오류 로그에 추가됩니다.) 허용되는 값에는 SV_SEND 및 SV_NO_SEND 포함됩니다.
3 LOCAL_LOGGING. 오류 로그에서 검색되어 호스트로 전달되는 로컬 경고를 기록합니다. 이 옵션은 옵션 SV_SEND data_typeSV_NMVT 또는 data_type SV_ALERT_SUBVECTORS 지정한 경우에만 유효합니다. 허용되는 값에는 SV_LOG 및 SV_NO_LOG 포함됩니다.
4~7 예약됨