Properti Metode

Gunakan halaman Properti metode untuk mengatur array, COBOL, desain, definisi host, dan properti recordset pada metode .

Properti Array

Gunakan ini Untuk melakukan ini
Dimensi Array Pilih dimensi array untuk nilai yang akan dikembalikan. Defaultnya adalah (tidak ada).
Apakah Array Pilih apakah nilai yang dikembalikan adalah array. Nilai yang mungkin adalah:

- Benar
- False (default)
Terjadi Tergantung Pada Pilih untuk menunjukkan bahwa item data numerik sebelum tabel (kumpulan rekaman atau array di Automation) menunjukkan jumlah baris atau elemen aktual yang dikirim atau diterima. Setara dengan tabel panjang variabel di COBOL.

Gunakan daftar drop-down untuk memilih item data numerik yang menentukan nilai ini. Untuk Tautan CICS, kumpulan rekaman atau array dan penentu panjang terkait harus masuk/keluar. Data dalam buffer yang mengikuti tabel panjang variabel segera mengikuti item data terakhir dalam tabel terlepas dari ukuran maksimum yang ditentukan untuk tabel. Array dengan beberapa dimensi hanya dapat digunakan untuk loop terluar (COBOL) atau dimensi paling kanan (Microsoft® Visual C++ ® atau Visual Basic). Defaultnya adalah (tidak ada).

Properti COBOL

Gunakan ini Untuk melakukan ini
Jenis Data Host Pilih jenis data host.
Penanganan Kesalahan Pilih penanganan kesalahan nilai yang dikembalikan. Nilai yang mungkin adalah:

- Persingkat. Pilih opsi ini untuk mengatur TI untuk memotong nilai saat terjadi kesalahan. (default)
- Bulat. Pilih opsi ini untuk mengatur TI untuk membulatkan nilai saat terjadi kesalahan.
- Kesalahan. Pilih opsi ini untuk mengatur Teknologi Informasi (TI) agar mengembalikan kesalahan saat terjadi kesalahan.
Pengisi Ketik pengisi nilai yang dikembalikan. Defaultnya adalah 0.
Dari Host Ketik jumlah byte FILLER yang mengikuti item data ini di buffer yang diterima dari server. FILLER menyebabkan celah yang tidak diterjemahkan dalam buffer. FILLER tidak terlihat di bagian Automation. Defaultnya adalah 0.
Menjadi Tuan Rumah Ketik jumlah byte FILLER yang mengikuti item data ini dalam buffer yang dikirim ke server. FILLER menyebabkan adanya kesenjangan yang tidak tercakup dalam terjemahan pada buffer. FILLER tidak terlihat di bagian Otomasi. Defaultnya adalah 0.
Skala Ketik skala nilai yang dikembalikan.
Atribut Tanda Pilih atribut tanda pengembalian nilai. Nilai yang mungkin adalah:

- Trailing. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda tersebut ada di belakang (default). Opsi ini memberi petunjuk kepada lingkungan run-time TI tentang cara memformat jenis data DISPLAY bertanda tangan dan memengaruhi bagaimana data dari host dikonversi ke dan dari jenis data Automation.
- Pemisahan Mengikuti. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda tersebut terpisah. Opsi ini menunjukkan kepada lingkungan run-time TI bagaimana format jenis data DISPLAY yang telah ditandatangani dan memengaruhi cara data dari host dikonversi dari dan ke jenis data Automation.
- Memimpin. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda di depan. Opsi ini mengindikasikan ke lingkungan run-time TI bagaimana tipe data DISPLAY bertanda diformat dan mempengaruhi konversi data antara host dan tipe data Automation.
- Kepemimpinan yang Terpisah. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda tersebut terpisah.
Ukuran Ketik ukuran nilai yang dikembalikan.
SOSI Pilih opsi ini untuk menentukan apakah data kumpulan karakter byte ganda diharapkan dimulai dengan karakter shift-out (SO) dan diakhiri dengan karakter shift-in (SI). Nilai yang mungkin adalah:

- Benar. Karakter SO dan SI dihapus dari data ketika diterima dari aplikasi host, dan karakter SO dan SI ditambahkan ke data saat dikirim ke aplikasi host. Dalam penghitungan panjang PIC G, tidak perlu menyertakan dua byte untuk karakter SO dan SI karena lingkungan run-time TI sudah menerapkannya.
- False (default)
Pembatasan String Pilih pembatas string dari nilai yang dikembalikan. Nilai yang mungkin adalah:

- Padded spasi. Memberi tahu lingkungan run-time TI bahwa representasi mainframe dari string dibatasi dengan menambahkan karakter spasi pada definisi string. Misalnya, jika definisi COBOL mainframe adalah PIC X(10) tetapi hanya tiga karakter dalam string, mainframe mengharapkan tujuh spasi di belakang. Oleh karena itu, memilih opsi ini memberi tahu lingkungan run-time TI untuk mengonversi string yang dikirim ke mainframe dengan mengubah karakter terminasi NULL pada string menjadi jumlah spasi yang sesuai sebelum mengirimkannya ke mainframe. Misalnya, jika string didefinisikan pada mainframe sebagai PIC X(10), TI akan mengirim string ABC diikuti oleh tujuh spasi berikutnya. Memilih opsi ini juga memberi tahu lingkungan run-time TI untuk mengonversi string output yang dikembalikan dari mainframe ke server TI Automation dengan mengubah spasi di akhir string menjadi satu karakter terminasi null. Untuk informasi selengkapnya, lihat Padding String Karakter Mainframe dengan Spasi. (default)
- Diakhiri dengan null. Menginformasikan lingkungan run-time TI bahwa representasi mainframe dari string dibatasi oleh karakter null (EBCDIC 0x00). Memilih opsi ini memberi tahu lingkungan run-time TI untuk menambahkan satu karakter nol ke akhir string jika masih ada ruang untuk byte tersebut sebelum mengirim string ke mainframe, dan memberi tahu lingkungan run-time TI untuk berhenti pada karakter nol pertama yang ditemui saat menerima string dari mainframe. Oleh karena itu, dengan memilih opsi ini, Anda memberi tahu TI untuk mempertahankan spasi berikutnya dalam string output yang berasal dari mainframe karena TI tidak akan mengonversi spasi berikutnya menjadi satu terminator NULL. Untuk informasi selengkapnya, lihat Pengisian Rangkaian Karakter Mainframe dengan Spasi.

Properti Desain

Gunakan ini Untuk melakukan ini
Izinkan 32K Masuk/Keluar Pilih opsi ini jika Anda ingin TI memperlakukan input DFHCOMMAREA secara independen dari output DFHCOMMAREA. TI biasanya menggabungkan input DFHCOMMAREA dan area DFHCOMMAREA output. Area gabungan tidak boleh melebihi 32 KB data. Ketika opsi ini dipilih, TI memperlakukan input DFHCOMMAREA secara independen dari output DFHCOMMAREA. Setiap area input dan output menggunakan data hingga 32 KB. Mengubah opsi ini mempengaruhi metode yang saat ini dipilih. Nilai yang mungkin adalah:

- Benar
- False (default) Catatan: Anda dapat menggunakan properti ini sebagai pendukung untuk "Gunakan Model Pemrograman Tautan" dalam model pemrograman CICS pemrosesan yang diinisiasi oleh Windows (WIP) dan dalam model pemrograman pemrosesan yang diinisiasi oleh host (HIP). Catatan: Properti ini hanya tersedia jika properti Is Link diatur ke True.
Deskripsi Ketik deskripsi metode . Deskripsinya bisa maksimal 250 karakter Unicode.
ID Konteks Bantuan Ketik ID konteks Bantuan yang terkait dengan metode ini. ID digunakan untuk disambung ke Bantuan untuk metode ini, dan akan dikembalikan ketika pengecualian terjadi selama pemanggilan metode ini. Defaultnya adalah 0.
Sertakan Parameter Konteks Pilih apakah metode objek klien secara otomatis menyertakan konteks. Nilai yang mungkin adalah:

- Benar. Visual Basic .NET secara otomatis menyertakan konteks sebagai parameter tambahan dalam argumen. Jika Anda tidak menyertakan parameter COMTIContext dalam panggilan metode Anda bersama dengan parameter Anda yang lain, Visual Basic .NET mengembalikan pesan kesalahan Pengecualian tipe 'System.MissingMemberException' yang tidak tertangani terjadi di microsoft.visualbasic.dll dan memberi tahu Anda bahwa metode tidak dapat dipanggil dengan jumlah parameter yang telah Anda tulis. Jika Anda menerima pesan ini, verifikasi bahwa Sertakan Parameter Konteks disertakan sebagai parameter dalam daftar parameter pada metode .
- False. Visual Basic .NET tidak secara otomatis menyertakan konteks sebagai parameter tambahan dalam argumen. Jika Anda mengatur properti ini ke False dan menyertakan parameter COMTIContext dalam panggilan metode Anda bersama dengan parameter Anda yang lain, Visual Basic .NET mengembalikan pesan kesalahan Pengecualian tipe 'System.MissingMemberException' yang terjadi di microsoft.visualbasic.dll dan memberi tahu Anda bahwa metode tidak dapat dipanggil dengan jumlah parameter yang telah Anda tulis. Jika Anda menerima pesan ini, hapus parameter COMTIContext dari daftar parameter metode.

Defaultnya adalah True.
Nilai Buffer Awal Ketik nilai buffer awal. Standarnya adalah null.
Ini adalah tautan Pilih apakah metode objek host menggunakan model Pemrograman tautan. Nilai yang mungkin untuk pemrosesan yang dimulai Windows (WIP) adalah:

- Benar. Gunakan model tautan. Model pemrograman tautan hanya dapat digunakan dengan protokol tautan CICS.
- False. Jangan gunakan model tautan.

Defaultnya adalah False.

Nilai yang mungkin untuk pemrosesan yang dimulai oleh host (HIP) adalah:

- Ya, ya. Gunakan model tautan. Model pemrograman tautan dapat digunakan dengan semua protokol.
- Tidak, tidak. Jangan gunakan model tautan.
- Tautan menggunakan Masukan/Keluaran 32K. Gunakan model tautan dan atur properti Dari Host dan Ke Host.

Defaultnya adalah Tidak.
Meta Data Pilih bagaimana metadata ditangani. Nilai yang mungkin adalah:

- (tidak ada). Secara default tidak ada data khusus yang dikirim ke atau diterima dari aplikasi host. Pilih tombol opsi ini jika Anda hanya ingin mengirim dan menerima data untuk metode tersebut.
- Sertakan Informasi Metode. Nama metode ini akan dikirim ke host bersama dengan data parameter. Nama metode dikirim sebagai 32 byte pertama dalam buffer. Opsi ini berguna jika beberapa panggilan metode masuk ke transaksi yang sama dan Anda ingin membedakan data dari panggilan yang berbeda.
- Sertakan Semua Informasi. Semua metadata yang tersedia untuk dikirim dan diterima dengan data metode Anda. Untuk detail format metadata, lihat deskripsi untuk "Metadata Opsional".
Nama Ketik nama metode . Namanya bisa maksimal 250 karakter Unicode. Nama harus berbeda dari nama metode lain dalam proyek yang sama. Defaultnya adalah null.
Nilai Pengembalian Posisi Setelah Ketik nilai pengembalian dari metode Automation yang mengikuti item data terpilih saat diterima dari host. Opsi ini tidak memengaruhi sisi Automation. Gunakan opsi ini saat item data yang ingin Anda tentukan sebagai nilai pengembalian Automation bukan bidang item data pertama dalam deklarasi data yang menjelaskan data yang diterima dari host.
Pengisi Awal Lihat jumlah byte FILLER yang diterima dari atau dikirim ke host.
Dari Host Ketik jumlah byte FILLER yang mengikuti item data ini di buffer yang diterima dari server. FILLER menyebabkan celah yang belum diterjemahkan dalam buffer. FILLER tidak terlihat di bagian Otomatisasi.
Ke Host Ketik jumlah byte FILLER yang mengikuti item data ini di buffer yang dikirim ke server. FILLER menyebabkan kesenjangan yang tidak bisa diterjemahkan dalam buffer. FILLER tidak terlihat di sisi Otomatisasi.
Jenis Pengembalian Pilih jenis nilai yang dikembalikan. Nilai yang mungkin adalah:

- Void
- Boolean
- Byte
- Tanggal
- Mata Uang
- Desimal
- Integer
- Lama
- Double
- Tunggal
- String
- Jenis yang ditentukan pengguna
- Recordset
- (tidak ada) (default)
Bidang Akhir Berukuran Variabel - Pilih opsi ini ketika item data terakhir adalah string untuk menunjukkan bahwa ukuran string bervariasi. Opsi ini juga digunakan untuk menentukan apakah datatable atau recordset bersifat terikat atau termasuk semua baris sesuai dengan yang ditentukan oleh pengaturan Kemunculan Maksimum pada parameter.
Dari Host - True
- False (default)
Untuk Menjadi Tuan Rumah - Benar
- False (default)

Properti Host Definisi

Gunakan ini Untuk melakukan ini
Nama Tautan-ke-Program Ketik nama tautan ke program (CICS LINK/DPL).
ID Transaksi Mirror Ketik TRANID cermin yang digunakan metode ini, jika Anda ingin menggantikan TRANID cermin untuk lingkungan jarak jauh (RE) yang terkait dengan komponen ini. Membiarkan kotak ini kosong menyebabkan TRANID cermin di deskripsi lingkungan jarak jauh digunakan.

Panjang TRANID dapat mencapai empat karakter. Karakter yang dapat diterima adalah A-Z a-z 0-9 $ @ # . / _ % & ? ! : | = , ; <>.

Nama transaksi yang dimulai dengan C dicadangkan untuk CICS dan tidak boleh digunakan. % dan karakter & dapat menyebabkan masalah dengan Fasilitas Kontrol Akses Sumber Daya (RACF) jika keamanan transaksi aktif.
Nama TP Ketik nama program transaksi sumber (TP) ketika program aplikasi CICS harus mengakses database DB2. Nama TP dirujuk dalam entri CICS Resource Control Table (RCT), yang mengaitkan transaksi CICS dengan paket DB2.

Menentukan nama program transaksi host (IMS atau CICS) atau nama program yang dihubungkan (CICS LINK/DPL).

Properti Recordset

Gunakan ini Untuk melakukan ini
Sertakan Ukuran Aktual Program host tidak akan menyertakan atau mengharapkan informasi apa pun yang menunjukkan jumlah baris (recordset) atau elemen (array) aktual yang dikirim atau diterima. Nilai yang mungkin adalah:

- Benar
- False (default)

Properti ini bersifat baca-saja dan akan selalu diatur ke False kecuali diatur ke True pada saat pustaka jenis dibuat dengan versi pertama COM Transaction Integrator.
Kemunculan Maksimum Jumlah maksimum kemunculan baris. Menunjukkan jumlah maksimum baris yang akan dikirim atau diterima dari host. Setara dengan kata kunci OCCURS n TIMES pada item grup COBOL. Defaultnya adalah 1.
Terjadi Tergantung Pada Setara dengan tabel panjang variabel di COBOL. Menunjukkan bahwa item data numerik sebelum tabel (kumpulan rekaman atau array di Automation) menunjukkan jumlah baris atau elemen aktual yang dikirim atau diterima. Gunakan daftar drop-down untuk memilih item data numerik mana yang menentukan nilai ini. Untuk Tautan CICS, kumpulan rekaman atau array dan penentu panjang terkait harus masuk/keluar. Data dalam buffer yang mengikuti tabel panjang variabel segera mengikuti item data terakhir dalam tabel terlepas dari ukuran maksimum yang ditentukan untuk tabel. Untuk array multidimensi, penggunaan hanya dapat dilakukan untuk loop terluar (COBOL) atau dimensi paling kanan (Visual C++ atau Visual Basic). Kumpulan rekaman nilai yang dikembalikan terjadi tergantung pada. Defaultnya adalah (tidak ada).
Tidak terikat Menunjukkan bahwa recordset tidak memiliki batas. Menunjukkan bahwa sejumlah baris dapat dikirim ke atau diterima dari host. Anda akan memilih opsi ini saat baris yang dikirim atau diterima berasal dari database dan jumlah baris maksimum tidak diketahui. Nilai yang mungkin adalah:

- Benar. Saat item data terakhir adalah string, ini berarti bahwa ukuran string bervariasi.
- False. Ketika item data terakhir adalah array, ini berarti bahwa jumlah elemen dalam array bervariasi. Saat item data terakhir adalah kumpulan rekaman, ini berarti bahwa jumlah baris dalam himpunan catatan bervariasi. (default)

Perhatian

Properti komponen tidak dimaksudkan untuk diatur atau diubah secara terprogram. Mengatur atau mengubah properti secara terprogram dapat menyebabkan komponen berfungsi dengan salah.

Lihat Juga

TRM dan ELM Kustom dengan COMTIContext
Method Name Node (.NET)
Properti (Proyek TI)