4 XCMD XAPI 서버 운영자 명령

이 장에서는 XCMD에서 지원되는 XAPI 서버 운영자 명령에 대해 설명합니다. 이러한 명령은 운영자 또는 관리자가 ACSLS XAPI 구성 요소를 모니터할 수 있게 해줍니다. 지원되는 명령은 다음과 같습니다.

LOG
LIST
MSGLVL
TRACE

XCMD 명령을 사용해서 ACSLS user_proc에서 이러한 명령을 실행합니다. 자세한 내용은 XCMD 명령 규약을 참조하십시오.

다음 명령 섹션에 포함된 구문 플로우 다이어그램에 사용되는 규약은 구문 표기법을 참조하십시오.

LOG

다음 절에서는 LOG 명령에 대해 설명합니다.

설명

LOG 명령은 현재 XAPI 서버 로그 설정을 변경 또는 나열합니다.

주:

로그 파일 이름 및 위치는 ACSLS 환경 변수로 설정되며 기본적으로 XAPI_WORK_PATH 디렉토리에서 파일 이름 vlog.file로 지정됩니다.

구문

다음 그림은 LOG 명령의 구문을 보여줍니다.

그림 4-1 LOG 명령 구문

매개변수

그림 4-1에 표시된 것처럼 LOG 명령에는 다음 매개변수가 포함됩니다.

LIst

선택적으로, 현재 로그 설정이 표시되도록 지정합니다. 명령 매개변수가 지정되지 않은 경우 기본값은 LIst입니다.

log_setting

선택적으로, 일련의 '0' 및 '1' 문자로 지정된 원하는 로그 설정을 나타냅니다.

0은 원하는 위치 로그 설정이 OFF 또는 사용 안함으로 설정됨을 나타냅니다.
1은 원하는 위치 로그 설정이 ON 또는 사용으로 설정됨을 나타냅니다.

지정된 값이 완전히 바뀌고, 현재 로그 설정과 병합되지 않습니다. 위치 로그 설정은 다음과 같습니다.

1 - ACSLS XAPI 구성 요소 로그에 오류 메시지를 기록합니다.
01 - 로그 파일에 메시지를 기록합니다.
001 - 로그 파일에 입력 트랜잭션 오류를 기록합니다.
0001 - 로그 파일에 모든 XML recv() 패킷을 기록합니다.
00001 - 로그 파일에 모든 XML send() 패킷을 기록합니다.
000001 - 로그 파일에 로컬 명령 및 응답을 기록합니다.

XAPI LOG 메시지는 $ACS_HOME/log/xapi/vlog.file에 저장됩니다.

주:

LOG 명령은 현재 위의 LOG 설정으로 정의된 0과 1의 여러 위치(16)를 설정 및 표시할 수 있게 해줍니다. 이러한 구성은 추가 확장을 허용하며, 여분의 0 또는 1 LOG 설정은 단순히 무시됩니다.

OFF

선택적으로, 해당 로깅이 사용 안함으로 설정되도록 지정합니다. 이 설정은 LOG 0과 동일합니다.

예

다음 예에서 사용자는 LOG 명령을 실행해서 로그 파일에 모든 오류 및 모든 XML recv() 패킷을 기록하도록 XAPI 서버를 설정합니다.

XCMD LOG 1011

LIST

다음 절에서는 LIST 명령에 대해 설명합니다.

설명

LIST 명령은 현재 XAPI 서버 상태 및 설정을 나열합니다.

구문

다음 그림은 LIST 명령의 구문을 보여줍니다.

그림 4-2 LIST 명령 구문

매개변수

그림 4-2에 표시된 것처럼 LIST 명령에는 다음 매개변수가 포함됩니다.

ALL

선택적으로, 모든 XAPI 서버 상태 및 설정을 표시합니다. 이 값은 매개변수 없이 LIST 명령을 실행할 경우의 기본값입니다.

CB 이름

이름 제어 블록이 문자로 표시되도록 지정합니다. 문자는 16진수 형식입니다. 오라클 고객지원센터의 안내에 따라서만 사용하십시오.

name에 대해 다음 제어 블록 중 하나를 지정합니다.

HTTPCVT
HTTPGBL
HTTPREQ-nnn
HTTPAPI-nnn

LIST CB HTTPREQ 및 LIST CB HTTPAPI의 경우 0~999 사이의 인덱스를 지정해야 합니다. 또한, 인덱스는 중간 공백 없이 단일 대시("-")를 사용해서 제어 블록 이름과 구분되어야 합니다. 예를 들면 다음과 같습니다.

LIST HTTPREQ-0

또는

LIST HTTPAPI-900

FILES

선택적으로, XAPI 서버 제어, 로그 및 추적 파일의 전체 경로 이름이 표시되도록 지정합니다.

HISTORY

선택적으로, 이전 24시간 동안 XAPI 트랜잭션 수 내역이 표시되도록 지정합니다.

LOG

선택적으로, 현재 XAPI 서버 로그 설정이 표시되도록 지정합니다. 이 설정은 매개변수 없이 LOG 명령을 실행하는 것과 동일합니다.

MSGLVL

선택적으로, 현재 XAPI 서버 메시지 레벨 설정이 표시되도록 지정합니다. 이 설정은 매개변수 없이 MSGLVL 명령을 실행하는 것과 동일합니다.

SERVER

선택적으로, 현재 XAPI 서버 및 UNIX 버전, 관련 매개변수 및 환경 변수, 공유 세그먼트 및 메시지 대기열이 표시되도록 지정합니다.

선택적으로 PROCESS 키워드를 포함하여 모든 활성 XAPI 서버 프로세스 ID, 스레드 및 열린 파일 수, CPU 및 메모리 사용량도 표시되도록 요청할 수 있습니다.

PROCESS

SERVER로 지정된 경우, PROCESS 키워드는 모든 활성 XAPI 서버 프로세스 ID, 스레드 및 열린 파일 수, CPU 및 메모리 사용량도 표시되도록 요청합니다.

TASKS

선택적으로, 현재 XAPI 서버 시스템 및 작업이 표시되도록 지정합니다.

TRACE

선택적으로, 현재 XAPI 서버 추적 설정이 표시되도록 지정합니다. 이 설정은 매개변수 없이 TRACE 명령을 실행하는 것과 동일합니다.

XAPI

선택적으로 현재 XAPI 서버 리스너 포트 및 IP 주소가 표시되도록 지정합니다.

선택적으로 IO 키워드를 포함하여 모든 XAPI 서버 리스너 통계도 표시되도록 요청할 수 있습니다.

예

다음 예에서 사용자는 LIst 명령을 실행해서 현재 XAPI 서버 리스너 포트, IP 주소 및 리스너 상태를 표시합니다.

XCMD LIST XAPI IO

MSGLVL

다음 절에서는 MSGLVL 명령에 대해 설명합니다.

설명

MSGLVL 명령은 XAPI 서버의 메시지 상세 정보 표시를 변경 또는 나열합니다.

구문

다음 그림은 MSGLVL 명령의 구문을 보여줍니다.

그림 4-3 MSGLVL 명령 구문

매개변수

그림 4-3에 표시된 것처럼 MSGLVL 명령에는 다음 매개변수가 포함됩니다.

LIst

현재 MSGLVL 설정이 표시되도록 지정합니다. 명령 매개변수가 지정되지 않은 경우 기본값은 LIst입니다.

level

원하는 MSGLVL 설정을 지정합니다. 레벨이 높을수록 더 자세한 XAPI 서버 메시지가 표시됩니다. 메시지 레벨은 누적됩니다. MSGLVL 8은 최대 MSGLVL 8까지의 모든 메시지를 생성합니다. 즉, MSGLVL 0~8이 생성됩니다. 메시지 레벨은 다음과 같이 일반화됩니다.

0 - 일반 시작, 종료 및 오류 메시지: 이러한 메시지는 표시하지 않을 수 없습니다.
4 - 심각한 경고 메시지입니다.
8 - 사소한 경고 메시지입니다.
12 - 시작 매개변수 및 옵션 메시지입니다.
16 - 추가 시작 및 종료 메시지입니다.
20 - 추가 진단 레벨 20 메시지입니다.
24 - 추가 진단 레벨 24 메시지입니다.
28 - 추가 작업 시작 및 종료 메시지입니다.

OFF

모든 상세 정보 메시지를 사용 안함으로 설정하도록 지정합니다. 이 설정은 MSGLVL 0과 동일합니다.

예

다음 예에서 사용자는 MSGLVL 명령을 실행해서 모든 경고 메시지를 포함하도록 XAPI 서버 메시징을 변경합니다.

XCMD MSGLVL 8

TRACE

다음 절에서는 TRACE 명령에 대해 설명합니다.

설명

TRACE 명령은 XAPI 서버 추적 설정을 변경 또는 나열합니다.

주:

추적 파일 이름 및 위치는 ACSLS 환경 변수로 설정되며 기본적으로 DV_TAG_XAPI_WORK_PATH 변수에서 파일 이름 vtrace.file로 지정됩니다.
추적은 시스템 성능에 상당한 영향을 줄 수 있습니다. Oracle StorageTek 고객지원센터의 요청이 있을 때만 추적을 ON으로 설정하십시오.
TRACE 명령은 현재 위의 TRACE 설정으로 정의된 것보다 많은 0과 1의 여러 위치(16)를 설정 및 표시할 수 있게 해줍니다. 이러한 구성은 추가 확장을 허용하며, 여분의 0 또는 1 TRACE 설정은 단순히 무시됩니다.

구문

다음 그림은 TRACE 명령의 구문을 보여줍니다.

그림 4-4 TRACE 명령 구문

매개변수

그림 4-4에 표시된 것처럼 TRACE 명령에는 다음 매개변수가 포함됩니다.

LIst

선택적으로, 현재 추적 설정이 표시되도록 지정합니다. 명령 매개변수가 지정되지 않은 경우 기본값은 LIst입니다.

trace_setting

선택적으로 일련의 '0' 및 '1' 문자로 지정된 원하는 추적 설정을 나타냅니다. 0은 원하는 위치 추적 설정이 OFF 또는 사용 안함으로 설정됨을 나타내고, 1은 원하는 위치 추적 설정이 ON 또는 사용으로 설정됨을 나타냅니다. 지정된 값이 완전히 바뀌고, 현재 추적 설정과 병합되지 않습니다. 위치 추적 설정은 다음과 같습니다.

1 - 추적 파일로 오류를 추적합니다.
01 - 추적 파일로 TCP/IP 기능 및 이벤트를 추적합니다.
001 - 추적 파일로 PGMI 또는 ACSAPI 기능 및 이벤트를 추적합니다.
0001 - 추적 파일로 분류되지 않은 XAPI 서버 이벤트를 추적합니다.
00001 - 추적 파일로 malloc() 및 free() 이벤트를 추적합니다.
000001 - 추적 파일로 XML 구문 분석기 이벤트를 추적합니다.
0000001 - 추적 파일로 명령 서버 프로세스 이벤트를 추적합니다.
00000001 - 추적 파일로 모니터 프로세스 이벤트를 추적합니다.
000000001 - 추적 파일로 CSV 기능 및 이벤트를 추적합니다.

OFF

선택적으로, 추적이 사용 안함으로 설정되도록 지정합니다. 이 설정은 TRACE 0과 동일합니다.

예

다음 예에서 사용자는 TRACE 명령을 실행해서 모든 오류, 모든 malloc() 및 free() 이벤트를 추적 파일로 추적하도록 XAPI 서버를 설정합니다.

XCMD TRACE 10001