Komut Yürütme › Telnet Komut Dosyasını Çalıştırma İşleci › Girdi Parametreleri › Komut Dosyası › Telnet Komut Dosyası Çalıştır İşleç Satır İçi Komut Dosyası API'leri

Telnet Komut Dosyası Çalıştır İşleç Satır İçi Komut Dosyası API'leri

Ürün, Telnet Komut Dosyası Çalıştır işleci Satır İçi Komut Dosyası alanı için bean shell veya JavaScript'te yazılan bir komut dosyası kullanır. Komut dosyası, aşağıdaki API'leri ortaya çıkaran conn nesnesini kullanır:

void send (String str, boolean log) throws Exception

Bu yöntem, uzak ana bilgisayara veri gönderir.

String str

Uzak ana bilgisayara gönderilecek verileri tanımlar.

boolean log

Uzak ana bilgisayara gönderilen verileri CA Process Automation günlüklerinde gösterir/gizler.

Hata ayıklamak için, işleç ve uzak ana bilgisayar arasındaki etkileşimi izleyin. Aşağıdaki kodu <install_dir>/server/conf/log4j.xml dosyasında ayarlayın:

<category name="com.company.c2o.servicegroup.netutils">	

   <priority value="DEBUG" />
</category>

Ayrıca, DEBUG ifadelerini log4j.xml'de kabul etmek için CA Process Automation günlük dosyasını (c2o.log) ayarlayın.

Hata ayıklama seviyesini ayarladığınızda, Komut Yürütme işleç kategorisi, CA Process Automation günlük dosyasına (c2o.log) DEBUG seviyesinde kaydetmeye başlar. CA Process Automation günlükleri, send veya sendLine aracılığıyla uzak ana bilgisayara gönderilen verileri gösterir.

Değerler:

True: DEBUG seviyesinde günlüğe kayıt yaparken String str değerini günlüğe kaydeder.

False: String str değerini günlüğe kaydetmez.

Not: c2o.log, işlem günlükleri değil, CA Process Automation günlük dosyasıdır. İşleçler, işlem günlüğüne ileti yazmaz.

Bu yöntem, bir değer döndürmez. API, verileri uzak ana bilgisayara yazamazsa ürün bir özel durum oluşturur.

public void sendLine (String str, boolean log) throws Exception

Bu yöntem, verilere yeni bir satır karakteri ekler ve bunu uzak ana bilgisayara gönderir. Uzak ana bilgisayarı, parametrede gönderilen komutu çalıştırmaya başlamaya zorlamak için bu yöntemi kullanın.

Bu yöntem void send (String str, boolean log) throws Exception ile aynı parametrelere ve değerlere sahiptir.

void send (String str) throws Exception

Bu yöntem, Send'e (String str, true) eşdeğerdir.

void sendLine (String str) throws Exception

Bu yöntem, SendLine'a (String str, true) eşdeğerdir.

public boolean waitFor(String pattern, int timeout) throws Exception

Bu yöntem çıktıyı uzak ana bilgisayardan okur ve aşağıdaki sonuçlardan biri meydana geldiğinde durur:

• Çıktı, parametrelerde belirtilen desenle eşleşiyor.
• Zaman aşımı aralığının süresi doluyor.

  Ürün, waitFor yöntemine yapılan her bir çağrı ile uzak ana bilgisayardan gelen çıktıyı, getLastOutput() yöntemi aracılığıyla erişilebilen bir arabellekte depolar. Her waitFor çağrısı, önceki çağrıdaki arabellek içeriğini geçersiz kılar.

  Bir sonraki waitFor çağrısı, önceki waitFor çağrısının okumayı durdurduğu yerden okumayı başlatır. Bu, yöntemi getLastOutput.() ile kullandığınızda uygun olur. Örneğin, bir waitFor çağrısı, komut çıktısının tamamıyla eşleşmiyorsa bir sonraki çağrı önceki komuttan kalan çıktıyı içerebilir.

  Önemli! Önceki komut çıktısıyla geçerli komut çıktısını karıştırmaktan kaçınmak için her sendLine çağrısından sonra waitFor çağrısı yapın.

  Telnet komut dosyası ve SSH komut dosyası işleçleri, uzak ana bilgisayardan çıktı okumak için farklı mekanizmalar kullanır:

• Telnet waitFor, verileri doğrudan ana bilgisayardan okumaya başlar ve ana bilgisayardan okurken eşleştirir.
• SSH waitFor, o ana kadar bir arabellekten okunan verileri alır ve bunları ilgili desenle eşleştirir.
• Her sendLine çağrısından sonra waitFor çağrısı yapmak SSH ve Telnet işleçlerinin benzer şekilde davranmasını sağlar.

  Parametreler aşağıdakileri içerir:

String pattern

Ürünün uzak ana bilgisayardan okuduğu verilerle eşleştirmek için normal bir ifade tanımlar. Genellikle bu desen, sonraki komut istemine kadar tüm verileri eşleştirir (örneğin, ".*[$]"). Komut çıktı verilerini (bir sonraki komut istemine kadar yeni satırlar dahil) eşleştirebileceğiniz (ve alabileceğiniz) için deseni .* ile başlatın.

Not: Yöntem, okunan verilerin tümünü (bu waitFor çağrısı sırasında) desenle eşleştirir. Yöntem, deseni okunan verilerin bir alt dizesi olarak eşleştirmez. Ayrıca, nokta işareti ( . ) yeni bir satır sonlandırıcıyla eşleştirebilir (çok satırlı yanıt verilerini eşleştirmek için kullanılabilir).

Int timeout

Uzak ana bilgisayardaki verilerin okunup desenle eşleştirileceği zaman aralığını (saniye olarak) tanımlar.

Boole değerleri döndürülür:

True

Zaman aşımı süresi dolmadan önce okunan veriler desenle eşleşir.

False

Zaman aşımı süresi dolmadan önce okunan veriler desenle eşleşmez.

Not: Bu yöntem, desenle eşleşme olduğu anda veya zaman aşımı süresi dolduğu anda bir değer döndürür.

Aşağıdaki durumlarda ürün bir özel durum oluşturur:

• Int timeout parametresi 0'dan küçük veya 0'a eşit.
• String pattern parametresi null veya boş.
• Ürün Telnet oturumundan veri okuyamaz.
• Desen geçersiz sözdizimi içeriyor.
• Desenle alınan veri eşleştirildiğinde bir hata oluşuyor.

  public String getLastOutput()
  

  Bu yöntem, son waitFor çağrısının uzak ana bilgisayardan okuduğu verileri kaydettiği arabelleğin içeriğini döndürür. Bu veriler her zaman waitFor deseniyle eşleşmez. waitFor ister true ister false döndürsün, arabellek, en son waitFor çağrısı neyse onu depolar.

  Bu yöntemde parametre yoktur.

  Bu yöntem özel durum oluşturmaz.