변경 시작

mqsichangeflowuserexit 명령

지원되는 운영 체제

  • Windows
  • LinuxUNIX 시스템
  • z/OS

목적

mqsichangeflowuserexit 명령을 사용하여 활성 또는 비활성 사용자 엑시트 목록을 설정하십시오. 각 실행 그룹 및 메시지 플로우에 대한 활성 및 비활성 사용자 엑시트 목록이 있습니다. 지정된 플로우에 대한 효과적인 사용자 엑시트 상태는 플로우가 시작할 때 결정됩니다. 플로우 및 해당 실행 그룹에 대한 활성 및 비활성 사용자 엑시트 목록을 고려하여 결정됩니다.

우선순위는 메시지 플로우, 실행 그룹 및 브로커 디폴트 순서입니다. 활성 목록은 메시지 플로우 및 실행 그룹 설정의 비활성 목록에 우선합니다.

지정된 사용자 엑시트 상태가 메시지 플로우에 대해 설정되어 있지 않으면 실행 그룹 설정의 상태가 사용됩니다. 해당 상태가 메시지 플로우 또는 실행 그룹에 대해 설정되어 있지 않으면 암시적으로 비활성인 디폴트 상태가 사용되거나 mqsichangebroker 명령을 통해 브로커 등록 정보 activeUserExits에 명시적으로 활성으로 정의될 수 있습니다.

특정 사용자 엑시트 이름이 메시지 플로우나 실행 그룹에 대한 활성 및 비활성 목록에 모두 있으면 활성 목록이 우선하고 사용자 엑시트는 해당 레벨에 대해 활성 상태입니다. 따라서 사용자 엑시트를 활성에서 비활성으로 변경하려면 -i 플래그를 사용하여 사용자 엑시트를 비활성 목록의 일부로 지정하고 -a 플래그를 통해 새 활성 목록을 재지정하여 해당 사용자 엑시트를 활성 목록에서 제거해야 합니다.

지정된 플로우에 대해 여러 종료가 활성이면 종료는 정의된 순서대로 호출됩니다. 메시지 플로우 활성 목록의 해당 종료는 먼저 -a 플래그에 지정된 순서대로 호출됩니다.

사용자 엑시트가 호출된 후 실행 그룹 활성 목록의 종료(메시지 플로우의 활성 및 비활성 목록에 없는)가 호출됩니다. 해당 종료는 -a 플래그에 지정된 순서대로 호출됩니다.

실행 그룹이나 메시지 플로우의 활성 또는 비활성 목록에 언급되지 않지만 브로커의 활성 목록에 있는 모든 사용자 엑시트는 브로커 등록 정보 activeUserExits가 설정될 때 지정된 순서로 호출됩니다.

활성 또는 비활성 목록에 지정된 사용자 엑시트가 대상 실행 그룹에 대해 등록되지 않으면 명령은 BIP8858 오류로 실패합니다.

명령이 정상적으로 완료한 후 지정된 사용자 엑시트가 올바르지 않으면 사용자 엑시트가 나타나는 목록에 따라 다음 조치를 수행합니다.
  • 사용자 엑시트가 메시지 플로우의 활성 또는 비활성 목록에 지정되면 해당 플로우는 시작되지 않고 시스템 로그에 BIP2315 메시지가 작성됩니다.
  • 사용자 엑시트가 실행 그룹의 활성 또는 비활성 목록에 지정되면 해당 실행 그룹은 시작되지 않고 시스템 로그에 BIP2314 메시지가 작성됩니다.
이 문제는 다음 세 가지 이유 중 하나로 인해 발생합니다.
  • 브로커 또는 실행 그룹이 사용자 엑시트 라이브러리가 포함된 디렉토리를 제거하여 MQSI_USER_EXIT_PATH 변수를 변경한 후 재시작되었습니다.
  • 브로커 또는 실행 그룹이 사용자 엑시트 라이브러리가 포함된 디렉토리를 제거하여 userExitPath 브로커 등록 정보를 변경한 후 재시작되었습니다.
  • 사용자 엑시트 라이브러리(또는 종속 중 하나)가 제거되었거나 브로커가 사용자 엑시트 라이브러리를 로드할 수 없습니다.

구문

매개변수

brokername
(필수) 브로커의 이름
-e egName
(필수) 실행 그룹의 이름.
-f messageflow
(선택사항) 메시지 플로우의 이름. 이 매개변수를 제공하면 사용자 엑시트가 해당 메시지 플로우에 대해 변경됩니다. 이 매개변수를 제공하지 않으면 사용자 엑시트가 실행 그룹 레벨에서 설정됩니다.
-a activeUserExitNames
(선택사항) 콜론으로 분리된 활성 사용자 엑시트의 이름 목록. 로드 시 사용자 엑시트가 등록한 이름입니다. 나열된 사용자 엑시트가 대상 실행 그룹에 대해 등록되지 않으면 명령은 BIP8858 오류로 실패합니다.
-i inactiveUserExitNames
(선택사항)

콜론으로 분리된 비활성 사용자 엑시트의 이름 목록. 로드 시 사용자 엑시트가 등록한 이름입니다. 나열된 사용자 엑시트가 대상 실행 그룹에 대해 등록되지 않으면 명령은 BIP8858 오류로 실패합니다.

권한 부여

이 명령을 호출하는 데 사용되는 사용자 ID에는 mqbrkrs 그룹 권한이 있어야 합니다.

응답

이 명령은 다음 응답을 리턴합니다.
  • BIP8852 사용 명령문
  • BIP80711 명령이 정상적으로 완료되었습니다.
  • BIP8858 사용자 엑시트 이름 &1이(가) 유효하지 않습니다(여기서, &1은(는) 이 명령에 지정되었지만 대상 실행 그룹에 등록되지 않아서 유효하지 않은 사용자 엑시트의 이름입니다).

플로우 레벨의 활성 종료 설정
mqsichangeflowuserexit WBRK_BROKER -e default -f myFlow -a exit2
BIP8071I: 명령이 정상적으로 완료되었습니다.
플로우 레벨의 비활성 종료 설정
mqsichangeflowuserexit WBRK_BROKER -e default -f myFlow -i exit1
BIP8071I: 명령이 정상적으로 완료되었습니다.
실행 그룹 레벨의 활성 종료 설정
mqsichangeflowuserexit WBRK_BROKER -e default -a exit3,exit1
BIP8071I: 명령이 정상적으로 완료되었습니다.
실행 그룹 레벨의 비활성 종료 설정
mqsichangeflowuserexit WBRK_BROKER -e default -1 exit2
BIP8071I: 명령이 정상적으로 완료되었습니다.
플로우 레벨에서 exit1을 비활성으로 변경하고 exit2를 활성으로 유지(이전 명령에 "-a exit1:exit2"를 사용하여 실행해서 두 종료를 모두 활성으로 설정함)
mqsichangeflowuserexit WBRK_BROKER -e default -f myFlow -i exit1 -a exit2
BIP8071I: 명령이 정상적으로 완료되었습니다.
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 5월 12, 2006
an35900_


변경 끝