mqsichangeflowuserexits 명령

지원되는 운영 체제

  • Windows
  • LinuxUNIX 시스템
  • BIPCHUE 유틸리티를 사용하는 z/OS브로커 PDSE 컨텐츠를 참조하십시오.

목적

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

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

메시지 플로우에 대한 사용자 엑시트 상태가 설정되지 않으면 실행 그룹 설정에서 상태를 가져옵니다. 메시지 플로우 또는 실행 그룹에 대해 사용자 엑시트의 상태가 설정되지 않으면 디폴트 상태인 비활성으로 설정되거나 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은 이 명령에서 지정되었지만 대상 실행 그룹에 등록되지 않았기 때문에 올바르지 않은 사용자 엑시트의 이름입니다.)

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