modifyWMQConnectionFactory 명령

modifyWMQConnectionFactory 명령을 사용하여 WebSphere® MQ 메시징 제공자 연결 팩토리의 특정 매개변수를 변경할 수 있습니다.

이 명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.

[IBM i]wsadmin 스크립트 클라이언트는 Qshell에서 실행됩니다. 자세한 정보는 "Qshell을 구성하여 WebSphere Application Server 스크립트 실행" 주제를 참조하십시오.

이 명령은 WebSphere Application Server 버전 7 이상 애플리케이션 서버에서 사용될 때만 유효합니다. 이전 버전에서는 사용하지 마십시오.

사용 가능한 IBM MQ 메시징 제공자 관리 명령 목록과 각 명령에 대한 간략한 설명을 보려면 wsadmin 프롬프트에 다음 명령을 입력하십시오.

print AdminTask.help('WMQAdminCommands')

제공된 명령에 대한 개요 도움말을 보려면 wsadmin 프롬프트에 다음 명령을 입력하십시오.

print AdminTask.help('command_name')

명령을 사용한 후 변경사항을 마스터 구성에 저장하십시오. 예를 들어, 다음 명령을 사용하십시오.

AdminConfig.save()

목적

modifyWMQConnectionFactory 명령을 사용하여 명령이 발행되는 범위에서 정의된 WebSphere MQ 메시징 제공자 연결 팩토리를 수정합니다.

참고: WebSphere MQ 메시징 제공자 연결 팩토리를 수정하면 mappingAliascontainerAuthAlias 매개변수 간 상호작용이 있습니다. 이 상호작용은 containerAuthAlias 매개변수가 지정되지만 mappingAlias는 지정되지 않는 경우 발생합니다. 이 상황에서 mappingAlias 매개변수는 자동으로 value DefaultPrincipleMapping으로 설정됩니다.

대상 오브젝트

특정 범위의 WebSphere MQ 메시징 제공자 연결 팩토리입니다.

필수 매개변수

이 명령의 매개변수는 WebSphere MQ 메시징 제공자 연결 팩토리를 작성하는 데 사용된 매개변수와 동일합니다.

선택적 매개변수

이 명령의 매개변수는 WebSphere MQ 메시징 제공자 연결 팩토리를 작성하는 데 사용된 매개변수와 동일합니다.

참고: -connectionNameList 매개변수를 지정하지 않고 -qmgrHostname 또는 -qmgrPortNumber 매개변수가 지정되면 연결 이름 목록이 WebSphere MQ 연결에 더 이상 사용되지 않아야 하고 지정된 호스트 이름 및 포트 번호 정보를 대신 사용해야 하는 것으로 가정합니다. 이에 대한 결과로 -connectionNameList 매개변수가 공백으로 설정됩니다.

-customProperties 매개변수에 대한 이 명령의 동작에 유의하십시오.

-customProperties
이 매개변수는 WebSphere MQ 메시징 제공자 연결 팩토리 구현에 전달할 사용자 정의 특성을 지정합니다. 일반적으로 사용자 정의 특성은 WebSphere 관리 인터페이스에서 직접 지원되지 않는 연결 팩토리의 속성을 설정하기 위해 사용됩니다.
사용자 정의 특성은 이름 및 값 테이블 단계 매개변수를 사용하여 지정합니다. 테이블 단계이기 때문에 2개의 매개변수 순서가 고정되어 있습니다. 따라서 항상 이름을 먼저 지정하고 값을 두 번째에 지정해야 합니다.
  • Jython: [name value]
  • Jacl: {name value}
새 이름/값 쌍이 다음 규칙을 사용하는 기존 사용자 정의 특성 세트에 추가됩니다.
  • 기존 특성 세트에 수정 명령의 일부로 제공된 이름과 같은 이름을 가진 특성이 없는 경우 사용자 정의 특성에 지정된 값이 있으면 이 값이 무시될 때 제공된 특성이 사용자 정의 특성 세트에 추가됩니다.
  • 기존 특성 세트에 수정 명령의 일부로 제공된 이름과 같은 이름을 가진 특성이 있고 수정 명령이 이 특성의 값도 지정하는 경우 기존 값이 제공된 값으로 대체됩니다.
  • 기존 특성 세트에 수정 명령의 일부로 제공된 이름과 같은 이름을 가진 특성이 있지만 수정 명령이 이 특성 값을 지정하지 않는 경우 기존 사용자 정의 특성에서 같은 이름을 가진 특성이 삭제됩니다.

예제

  • Jython 사용:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    
    wsadmin>AdminTask.listWMQConnectionFactories("9994GKCNode01(cells/
    9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)") 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)
    
    wsadmin>AdminTask.modifyWMQConnectionFactory("cf1(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#MQConnectionFactory_1098737234986)", ["-description
     'My new description'"])  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)
  • Jacl 사용:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)  
    
    wsadmin>$AdminTask listWMQConnectionFactories 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)
    
    wsadmin>$AdminTask modifyWMQConnectionFactory 
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986) {-description "My new description"}  
    cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    MQConnectionFactory_1098737234986)

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmj_wmq_jmscf_modify
파일 이름:rmj_wmq_jmscf_modify.html