Bagikan melalui


Properti Metode

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

Properti Array

Gunakan ini Untuk melakukan ini
Dimensi Array Pilih dimensi array untuk nilai yang dikembalikan. Defaultnya adalah (tidak ada).
Adalah 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 (recordset 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 CICS Link, recordset 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:

- Potong. 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 TI untuk 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 sisi Automation. Defaultnya adalah 0.
Ke Host Ketik jumlah byte FILLER yang mengikuti item data ini dalam buffer yang dikirim ke server. FILLER menyebabkan celah yang tidak diterjemahkan dalam buffer. FILLER tidak terlihat di sisi Automation. Defaultnya adalah 0.
Skala Ketik skala nilai yang dikembalikan.
Tanda tangani Atribut Pilih atribut tanda nilai yang dikembalikan. Nilai yang mungkin adalah:

- Di belakang. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda berada di belakang (default). Opsi ini menunjukkan ke lingkungan run-time TI bagaimana jenis data DISPLAY yang ditandatangani diformat dan memengaruhi bagaimana data dari host dikonversi ke dan dari jenis data Automation.
- Trailing Terpisah. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda tersebut terpisah. Opsi ini menunjukkan ke lingkungan run-time TI bagaimana jenis data DISPLAY yang ditandatangani diformat dan memengaruhi bagaimana data dari host dikonversi ke dan dari jenis data Automation.
- Memimpin. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda di depan. Opsi ini menunjukkan ke lingkungan run-time TI bagaimana jenis data DISPLAY yang ditandatangani diformat dan memengaruhi bagaimana data dari host dikonversi ke dan dari jenis data Automation.
- Memimpin Terpisah. Untuk jenis data DISPLAY yang ditandatangani, menunjukkan bahwa tanda tersebut terpisah.
Ukuran Ketik ukuran nilai yang dikembalikan.
SOSI Pilih opsi ini untuk menentukansetelah data kumpulan karakter byte ganda diharapkan dimulai dengan shift-out (SO) dan diakhiri dengan karakter shift-in (SI). Nilai yang mungkin adalah:

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

- Ruang-padded. Memberi tahu lingkungan run-time TI bahwa representasi mainframe string dibatasi dengan mengayuh definisi string dengan karakter spasi. Misalnya, jika definisi COBOL mainframe adalah PIC X(10) tetapi hanya tiga karakter dalam string, mainframe mengharapkan tujuh spasi berikutnya. Oleh karena itu, memilih opsi ini memberi tahu lingkungan run-time TI untuk mengonversi string yang dikirim ke mainframe untuk mengubah karakter penghentian NULL string ke jumlah spasi berikutnya 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 Automation TI dengan mengonversi spasi berikutnya string menjadi satu karakter penghentian null. Untuk informasi selengkapnya, lihat Padding String Karakter Mainframe dengan Spasi. (default)
- Dihentikan null. Memberi tahu lingkungan run-time TI bahwa representasi mainframe string dibatasi oleh karakter null (EBCDIC 0x00). Memilih opsi ini memberi tahu lingkungan run-time TI untuk menambahkan satu karakter null ke akhir string jika ada ruang untuk byte sebelum mengirim string ke mainframe, dan memberi tahu lingkungan run-time TI untuk berhenti pada karakter null 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 Padding String 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. Potensi nilai:

- Benar
- Catatan False (default) : Anda dapat menggunakan properti ini sebagai aksesori untuk "Gunakan Model Pemrograman Tautan" dalam model pemrograman CICS pemrosesan yang dimulai Windows (WIP) dan dalam model pemrograman pemrosesan yang dimulai 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 menyambungkan ke Bantuan untuk metode ini, dan 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:

- True. 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 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.
Adalah Tautan Pilih apakah metode objek host menggunakan model Pemrograman tautan. Nilai yang mungkin untuk pemrosesan yang dimulai Windows (WIP) adalah:

- True. 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 host (HIP) adalah:

- Ya, benar. Gunakan model tautan. Model pemrograman tautan dapat digunakan dengan semua protokol.
- Tidak, tidak. Jangan gunakan model tautan.
- Tautkan menggunakan 32K Masuk/Keluar. 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 yang 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 . Nama 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 metode Automation yang mengikuti item data yang dipilih 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 tidak diterjemahkan di buffer. FILLER tidak terlihat di sisi Automation.
Ke Host Ketik jumlah byte FILLER yang mengikuti item data ini di buffer yang dikirim ke server. FILLER menyebabkan celah yang tidak diterjemahkan di buffer. FILLER tidak terlihat di sisi Automation.
Jenis Hasil Pilih jenis nilai yang dikembalikan. Nilai yang mungkin adalah:

- Kekosongan
- Boolean
- Byte
- Tanggal
- Penukaran valuta asing
- Desimal
- Integer
- Lama
- Double
- Satu
- 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 datatable atau recordset sebagai terikat atau karena menyertakan semua baris sebagaimana didefinisikan sebagai Kemunculan Maksimum yang diatur pada parameter .
Dari Host - Benar
- False (default)
Ke Host - Benar
- False (default)

Properti Definisi Host

Gunakan ini Untuk melakukan ini
Nama Tautan-ke-Program Ketik nama tautan-ke-program (CICS LINK/DPL).
ID Transaksi Cermin Ketik cermin TRANID yang digunakan metode ini, jika Anda ingin mengambil alih TRANID cermin untuk lingkungan jarak jauh (RE) yang dikaitkan dengan komponen ini. Membiarkan kotak ini kosong menyebabkan TRANID cermin dalam 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. Karakter % dan & dapat menyebabkan masalah dengan Resource Access Control Facility (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 link-to (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 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 Kemunculan baris maksimum. 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 (recordset 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, recordset 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 dengan beberapa dimensi, array hanya dapat digunakan 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 dibatasi. 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 maksimum baris tidak diketahui. Nilai yang mungkin adalah:

- True. Saat item data terakhir adalah string, ini berarti ukuran string bervariasi.
- False. Saat item data terakhir adalah array, ini berarti bahwa jumlah elemen dalam array bervariasi. Saat item data terakhir adalah recordset, ini berarti bahwa jumlah baris dalam recordset bervariasi. (default)

Perhatian

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

Lihat juga

TRM kustom dan ELM dengan COMTIContext
Node Nama Metode (.NET)
Properti (Proyek TI)