queueDescriptorRecord
queueDescriptorRecord 특성은 메시지 큐의 구조에 대한 정보를 WebSphere® MQ 시스템으로 전달하는 레코드 변수를 식별합니다.
특성이 식별하는 레코드 변수는 BasicRecord를 기반으로 합니다. 큐를 열거나 닫을 때 이 레코드가 필요합니다.
EGL 프로그램은 WebSphere MQ MQOPEN 및 MQCLOSE 함수를 호출하여 메시지 큐 레코드와 연관된 큐를 열고 닫습니다. WebSphere MQ Object Descriptor 구조(MQOD)는 MQOPEN 및 MQCLOSE 호출의 매개변수입니다.
queueDescriptorRecord 특성을 지정하지 않으면 EGL은 기본 MQOD 구조를 자동으로 빌드합니다. EGL은 오브젝트 유형, 큐 관리자 이름 및 큐 이름을 제외한 모든 필드를 초기값으로 설정합니다. EGL은 큐의 오브젝트 유형을 MQOT_Q로 설정합니다. EGL은 큐 관리자 이름 및 큐 이름을 recordName.resourceAssociation 변수에 지정된 현재 값으로 설정합니다. recordName.resourceAssociation에 큐 관리자 이름이 지정되지 않은 경우에는 OBJECTQMGRNAME의 값이 지정되지 않습니다. 메시지를 넣거나 가져오기 전에 큐 관리자를 변경하려는 경우 OBJECTQMGRNAME 및 OBJECTNAME 값은 중요합니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| STRUCID | CHAR(4) | 구조 ID |
| VERSION | INT | 구조 버전 번호 |
| OBJECTTYPE | INT | 오브젝트 유형 |
| OBJECTNAME | CHAR(48) | 오브젝트 이름 |
| OBJECTQMGRNAME | CHAR(48) | 오브젝트 큐 관리자 이름 |
| DYNAMICQNAME | CHAR(48) | 동적 큐 이름 |
| ALTERNATEUSERID | CHAR(12) | 대체 사용자 ID |
| RECSPRESENT | INT | 존재하는 오브젝트 레코드 수 |
| KNOWNDESTCOUNT | INT | 열린 로컬 큐 수 |
| UNKNOWNDESTCOUNT | INT | 열린 원격 큐 수 |
| INVALIDDESTCOUNT | INT | 열기에 실패한 큐 수 |
| OBJECTRECOFFSET | INT | MQOD에서 첫 번째 오브젝트 레코드의 오프셋 |
| RESPONSERECOFFSET | INT | MQOD에서 첫 번째 응답 레코드의 오프셋 |
| OBJECTRECPTR | INT | MQOD에서 첫 번째 오브젝트 레코드의 주소 |
| RESPONSERECPTR | INT | MQOD에서 첫 번째 응답 레코드의 주소 |
queueDescriptorRecord 특성을 사용하여 MQOD를 지정하거나 MQOD를 기반으로 사용자 자체 변수를 지정할 수 있습니다. 큐에 액세스하기 전에 프로그램을 코딩하여 MQOD 레코드 변수에서 필드를 초기화하고 설정하십시오. EGL은 기본 구조 대신 MQOD 구조를 사용합니다.
옵션 레코드에 대한 자세한 정보는 MQRecord를 위한 옵션 레코드의 내용을 참조하십시오. WebSphere MQ 상수(예: MQOT_Q)의 전체 목록은 WebSphere MQ 문서를 참조하십시오.