Antrean Antrean Pesan
Bagian ini menjelaskan cara menentukan antrean Microsoft Message Queuing (juga dikenal sebagai MSMQ) saat Anda menggunakan adaptor MSMQ. Ini menjelaskan konvensi untuk menentukan jalur dan juga menjelaskan peran yang dimainkan nama format dalam menerjemahkan jalur ke dalam penentuan antrean.
Konvensi Penamaan Jalur Antrean
Jika nama antrean mengacu pada jalur, gunakan konvensi penamaan dalam tabel berikut.
| Jenis antrean | Sintaks untuk jalur |
|---|---|
| Antrean publik | Computername\QueueName |
| Antrean privat | Computername\Private$\QueueName |
| Antrean Jurnal | Computername\QueueName\Journal$ |
| Catatan antrean jurnal komputer : Gunakan untuk menerima antrean saja. | Computername\Journal$ |
| Catatan antrean surat mati komputer : Gunakan untuk menerima antrean saja. | Computername\Deadletter$ |
| Catatan antrean dead-letter transaksi komputer : Gunakan untuk menerima antrean saja. | Computername\XactDeadletter$ |
Catatan
Jalur antrean harus unik.
Jika nama antrean mengacu pada nama format, nama tersebut mengambil bentuk string yang menunjukkan apakah antrean bersifat publik atau privat, diikuti oleh GUID yang dihasilkan untuk antrean dan pengidentifikasi lainnya sesuai kebutuhan. Gunakan konvensi penamaan dalam tabel berikut.
| Jenis format | Sintaks untuk nama format |
|---|---|
| Publik | FormatName:P ublic=QueueGUID |
| Langsung | FormatName:D IRECT=SPX:NetworkNumber:HostNumber\QueueName FormatName: DIRECT=TCP:IPAddress\QueueName FormatName: DIRECT=OS:ComputerName\QueueName |
Jika jalur antrean port kirim adalah daftar distribusi, maka sintaks jalur antrean adalah:
DL=DistributionListGUID
Jika jalur antrean kirim atau terima adalah URL HTTP atau HTTPS, maka sintaksnya adalah:
FormatName:DIRECT=http://<client name>/msmq/<queue name>
FormatName:DIRECT=https://<client name>/msmq/<queue name>
Catatan
"msmq" adalah folder virtual yang dibuat oleh Message Queuing di Internet Information Services (IIS).
Catatan
Anda hanya dapat menggunakan HTTP untuk mengirim pesan. Anda tidak dapat membaca pesan dalam antrean pada komputer jarak jauh jika antrean dibuka menggunakan nama format langsung HTTP. Namun, Anda masih dapat menerima pesan SOAP (diformat) dari antrean jarak jauh dengan menggunakan jalur antrean privat atau publik tanpa HTTP.
Jika nama antrean mengacu pada label teks deskriptif yang ditentukan administrator untuk antrean, maka sintaks jalur antrean yang mengacu pada label ini adalah:
LABEL:MyQueue
Catatan
Label tidak selalu unik. Oleh karena itu, Anda akan menerima kesalahan jika ada konflik nama ketika Anda mencoba menyambungkan ke antrean tertentu dengan menggunakan labelnya.
Catatan
Label adalah bidang transportasi yang diperlukan untuk adaptor.
Peran Nama Format
Antrean Pesan menggunakan nama format untuk mengidentifikasi antrean dan menentukan cara mengaksesnya. Antrean Pesan menetapkan nama format ke antrean.
Saat Anda menentukan antrean menggunakan sintaks nama jalur, misalnya myMachine\myQueue, Antrean Pesan mencari jalur untuk menemukan nama format terkait. Antrean Pesan kemudian menggunakan nama format tersebut untuk mengakses antrean. Saat Anda menentukan nama format, Antrean Pesan menggunakan nama format yang Anda gunakan.
Untuk informasi selengkapnya tentang nama format, lihat "Properti MessageQueue.FormatName" di Bantuan Pustaka Kelas .NET Framework.
Pemecahan Masalah Jalur Antrean
Pengecualian terjadi jika sintaks jalur antrean yang disediakan tidak cocok dengan salah satu format yang dijelaskan sebelumnya dalam "Konvensi Penamaan Jalur Antrean."
Berikut ini bukan karakter yang valid untuk nama komputer di jalur antrean:
\ ; , + "
Pengecualian terjadi jika nama komputer adalah angka. Misalnya: 234\private$\queue.
Untuk antrean surat mati komputer, antrean jurnal komputer, dan antrean surat mati transaksi komputer, pengecualian terjadi jika pengguna menentukan salah satu antrean sistem sebagai antrean tujuan untuk dikirim.
System.Messaging.MessageQueue.Exists tidak berfungsi untuk antrean jarak jauh. Untuk informasi selengkapnya, lihat "Metode MessageQueue.Exists" di Bantuan Pustaka Kelas .NET Framework.