mqsichangetrace 명령

mqsichangetrace 명령을 사용하여 통합 노드에 대한 추적 특성을 설정하십시오.

목적

이 명령은 다음에 유효합니다.
  • 사용자 추적. -u 옵션을 지정하십시오.
  • 서비스 추적. -t 옵션을 지정하십시오. BIPxxxx 메시지에 설명된 조치 또는 IBM 지원 센터에서 지시하는 경우에만 이 옵션을 사용하십시오.
  • Trace 노드. Trace 노드를 켜거나 끄려면 -n 옵션을 지정하십시오. Trace 노드를 오프로 전환하여 플로우의 성능을 상당히 향상시킬 수 있습니다.

통합 노드에 대한 사용자 추적(또는 서비스 추적)을 시작하거나 수정하거나 종료할 수 있습니다.

통합 노드의 추적 노드는 켜고 끌 수 있지만, 이 명령을 사용하여 통합 추적 도구 ( IBM App Connect Enterprise )에 대한 서비스 추적을 시작할 수는 없습니다.

통합 노드 또는 해당 자원 (통합 서버 또는 메시지 플로우) 을 지정하는 경우 추적을 시작하기 전에 이를 배치해야 합니다. mqsichangetrace 명령을 사용하여 사용자 추적을 시작하거나 중지하려면 통합 노드가 실행 중인지 확인해야 합니다. 그러나 서비스 추적의 경우, mqsichangetrace 명령을 사용하여 통합 노드가 종료 상태에 있을 때 추적을 사용하거나 사용하지 않을 수도 있습니다. 그러면 통합 노드 컴포넌트의 시동을 추적할 수 있습니다.

이들 명령에 의해 생성되는 서비스 및 사용자 추적의 출력은 log 서브디렉토리의 추적 파일에 기록됩니다.

로그 파일은 일반 텍스트로 작성됩니다.

추적을 켜면 추적 중인 통합 노드의 모든 활동에 대해 추가 처리가 실행됩니다. 추적이 활성일 때 영향을 받을 성능을 예상하십시오.

명령 처리를 직접 추적하고자 하는 경우, -v | --trace 매개변수를 지정할 수 있습니다. 또는 추적을 시작하기 전에 환경 변수 MQSI_UTILITY_TRACE 및 MQSI_UTILITY_TRACESIZE 를 설정할 수 있습니다.

정상 또는 디버그 추적을 원하는지 여부에 따라 MQSI_UTILITY_TRACE 를 normal 또는 debug로 설정할 수 있으며 MQSI_UTILITY_TRACESIZE 를 필요한 추적 파일의 최대 크기 (KB) 로 설정해야 합니다. 기본값은 102400 (100MB) 입니다.

선택된 명령에 대한 추적이 완료되면 이 변수를 재설정해야 합니다. 재설정하지 않으면, 모든 후속 명령도 추적되며 성능이 저하됩니다. MQSI_UTILITY_TRACE 및 MQSI_UTILITY_TRACESIZE에 대한 자세한 정보는 서비스 추적 시작을 참조하십시오.

웹 사용자 인터페이스 및 REST API를 사용하여 통합 서버 및 메시지 플로우 에 대한 추적 활동을 시작하고 중지할 수도 있습니다. 자세한 정보는 사용자 추적을 참조하십시오.

사용자의 엔터프라이즈에서 사용하는 플랫폼에서 이 명령의 세부사항에 대한 적절한 링크를 선택하십시오.