xa_open 문자열의 형식

xa_open 문자열은 다음과 같은 형식을 가집니다.

parm_name1 = parm_value1, parm_name2 = parm_value2, ...

여기서 parm_name 은 매개변수의 이름이고 parm_value 는 매개변수의 값입니다. 매개변수의 이름은 대소문자를 구분하지 않지만 별도로 지정하지 않는 한 매개변수의 값은 대소문자를 구분합니다. 매개변수는 순서와 관계없이 지정할 수 있습니다.

매개변수의 이름, 의미 및 올바른 값은 다음과 같습니다.

이름

의미 및 올바른 값

CHANNEL

MQI 채널의 이름입니다.

이 매개변수는 선택적 매개변수입니다. 이 매개변수가 제공되면 CONNAME 매개변수도 제공되어야 합니다.

TRPTYPE

MQI 채널의 통신 프로토콜입니다. 다음 프로토콜이 올바른 값입니다.

LU62

SNA LU 6.2

NETBIOS

NetBIOS

SPX

IPX/SPX

TCP

TCP/IP

이 매개변수는 선택적 매개변수입니다. 이 매개변수가 생략되면 기본값 TCP로 가정합니다. 이 매개변수의 값은 대소문자를 구분하지 않습니다.

CONNAME

MQI 채널의 서버 측 큐 관리자의 네트워크 주소입니다. 이 매개변수의 올바른 값은 TRPTYPE 매개변수의 값에 따라 다릅니다.

LU62

CPI-C 부가 정보 입력 항목을 식별하는 기호 대상 이름입니다.

파트너 LU의 네트워크 규정 이름은 올바른 값이 아니며 파트너 LU 알리어스도 아닙니다. 이는 트랜잭션 프로그램(TP) 이름 및 모드 이름을 지정하기 위한 추가 매개변수가 없기 때문입니다.

NETBIOS

NetBIOS 이름입니다.

SPX

4바이트 네트워크 주소, 6바이트 노트 주소 및 선택적 2바이트 소켓 번호입니다. 이러한 값은 16진 표기법으로 지정되어야 합니다. 마침표로 네트워크 및 노드 주소를 구분해야 하고 소켓 번호가 제공되는 경우 괄호로 묶어야 합니다. 예를 들면, 다음과 같습니다.

0a0b0c0d.804abcde23a1(5e86)

소켓 번호가 생략되는 경우 기본값 5e86으로 가정됩니다.

TCP

호스트 이름 또는 IP 주소이며 선택적으로 괄호로 묶은 포트 번호가 뒤에 올 수 있습니다. 포트 번호가 생략되는 경우 기본값 1414로 가정됩니다. 큐 관리자에 대한 여러 호스트 및 포트는 세미콜론 구분 기호를 사용하여 지정할 수 있습니다. 예를 들어 다음과 같습니다.

host1(1415);host2(1416);host3(1417)

이 매개변수는 선택적 매개변수입니다. 이 매개변수가 제공되면 CHANNEL 매개변수도 제공되어야 합니다.

QMNAME

MQI 채널의 서버 측 큐 관리자의 이름입니다. 이 이름은 공백이거나 단일 별표(*)일 수 없으며 별표로 시작되는 이름일 수 없습니다. 이는 이 매개변수가 이름으로 특정 큐 관리자를 식별함을 의미합니다.

이 매개변수는 필수 매개변수입니다.

클라이언트 애플리케이션이 특정 큐 관리자에 연결되면 같은 큐 관리자에 의해 트랜잭션 복구가 처리되어야 합니다.

애플리케이션이 z/OS® 대기열 관리자에 연결하는 경우 애플리케이션은 특정 대기열 관리자의 이름 또는 대기열 공유 그룹(QSG)의 이름을 지정할 수 있습니다. 큐 관리자 이름 또는 큐 공유 그룹 이름을 사용하여 애플리케이션은 QMGR 복구 단위 속성 지정 또는 GROUP 복구 단위 속성 지정에 대한 트랜잭션에 참여할지 여부를 제어합니다. GROUP 복구 단위 속성 지정을 사용하여 트랜잭션 복구가 QSG의 모든 멤버에서 처리될 수 있습니다. GROUP 복구 단위를 사용하려면 GROUPUR 큐 관리자 속성을 사용으로 설정해야 합니다. GROUP 복구 단위 사용에 대한 자세한 내용은 다음을 참조하세요. 대기열 공유 그룹의 복구 처리 단위 .

TPM

사용 중인 트랜잭션 관리자입니다. 유효한 값은 ' CICS® ' 및 TUXEDO입니다.

확장된 트랜잭션 클라이언트는 이 매개변수 및 AXLIB 매개변수를 같은 목적으로 사용합니다. 이러한 매개변수에 대한 자세한 내용은 TPM 및 AXLIB 매개변수를 참조하세요.

이 매개변수는 선택적 매개변수입니다. 이 매개변수의 값은 대소문자를 구분하지 않습니다.

AXLIB

트랜잭션 관리자의 ax_reg 및 ax_unreg 함수를 포함하는 라이브러리의 이름입니다.

이 매개변수는 선택적 매개변수입니다.

UID

인증을 위해 큐 관리자에 제공되는 사용자 ID입니다. 이 매개변수가 제공되면 PWD 매개변수도 제공되어야 합니다. 제공된 사용자 ID 및 비밀번호가 인증되면 이 사용자 ID는 트랜잭션 관리자의 연결 식별에 사용됩니다. 사용자 ID 및 비밀번호는 MQCONNX 호출 시 MQCSP 오브젝트를 채웁니다.

UID 및 PWD 매개변수는 클라이언트 및 서버 바인딩 둘 다에 유효합니다.

PWD

인증을 위해 큐 관리자에 제공되는 비밀번호입니다. 이 매개변수가 제공되면 UID 매개변수도 제공되어야 합니다.

다음은 xa_open 문자열의 예입니다.

channel=MARS.SVR,trptype=tcp,conname=MARS(1415),qmname=MARS,tpm=cics