BORU KöKü VE BORU $STEM

Sözdizimi

STEM

Read syntax diagramSkip visual syntax diagramSTEM$STEM (0) (number) (COMMON) (TASK) stemroot COLLECT FROM 1 FROM frnumber APPEND

Komut Tanımı

STEM aşaması, ardışık işlem hattında herhangi bir yerde kullanılabilir.

STEM ilk aşamaysa, sapma komutu yordam değişkenlerinin bir dizisinden kayıtları okur. Her bir kayıt, ardışık işlem çıkış akışına tek satırlık bir ileti olarak geçirilir.

STEM ilk aşama değilse, her bir iletinin her satırını, bir komut yordamı değişkenlerinin kök ayrıştırmalı dizisi içindeki bir değişkene yazar ve çıkış akışıdır. Buna ek olarak, verili değişken adının sonuna bir tamsayı eklenir (örneğin, VARNAMEn). Sayı, işlenmekte olan ileti satırının konumunu temsil eder. Örneğin, VARNAME1 ilk satırdır, VARNAME2 ikinci satırdır. Tüm satırlar işlendiğinde, sonuna sıfır eklenmiş bir değişken (VARNAME0) değişken havuza yazılır, ancak çıkış akımıyla yazılmaz. Bu değişken, işlenen tüm hatların toplam sayısını içerir.

Bu nedenle, VARNAME1,VARNAME2, ve VARNAME3 , sırasıyla 1, 2 ve 3 numaralı iletileri içeren yaratılır. VARNAME0 , 3 sayısını içerir.

STEM aşaması, komut yordamı ortamlarıyla sınırlıdır (REXX, NetView® komut listesi dili ve HLL). Ancak, (COMMAND) ya da (GÖREV) seçeneği kullanılırsa, STEM ileti otomasyonundan, PPT görevinde ya da isteğe bağlı bir görevdeki komutla ya da bir komut yordamında başlatan etiketli bir komut kullanılarak başlatılabilir. Use of the STEM stage outside of these environments results in message DSI290I and termination of the pipeline.

Buna karşılık, VAR aşaması, bir diziyi temsil etmemek üzere benzersiz olarak adlandırılmış değişkenlere okur ve yazar.

$STEM aşaması, STEM ile aynıdır, ancak bunun dışında, belirli kök ayrıştırmalı veri değişkenleri dizisiyle ilişkilendirilmiş VIEW özniteliği değişkenlerini ($ile başlayan) okur ya da yazar. $STEM ilk aşamaysa, öznitelik değişkenlerinde belirtilen renk ve vurgulama çıkış iletilerine çevrilir. $STEM ilk aşama değilse, giriş iletilerinde belirtilen renk ve vurgulama öznitelikleri öznitelik değişkenlerine çevrilir.

Akışlar

Akış Tipi Desteklenen Sayı
Giriş 1
Çıkış 1

Sonlandırma Koşulları

İlk aşama olarak belirtilirse, çıkış akımı kesildiğinde ya da veri depolandığında sona erdirildiğinde, STEM ve $STEM sona erdirilir. Sonraki aşama olarak belirtilirse, giriş akımı kesildiğinde STEM ve $STEM sonlanır.

Işlenen Tanımları

(COMMON)
Kişisel değişken sözlüğünüz yerine genel genel değişken sözlüğüne erişildiğini belirtir.
(TASK)
Kişisel değişken sözlüğünüz yerine görev genel değişkeni sözlüğüne erişildiğini belirtir.
APPEND
Yeni verilerin, sıfır öğesindeki sayıyla belirlenmiş olan STEM verilerini izleyen ek STEM değişkenleri olarak ekleneceğini belirtir. APPEND, yalnızca ilk olmayan bir aşamada kullanılabilir.

APPEND seçeneği, STEM ilk aşamadaysa etkinleştirilmez. APPEND seçeneği işlenmek üzere, STEM değişkeninin kayıt sayısı sıfır ya da artı olmalıdır.

COLLECT
STEM ' nin birçok tek satırlı ileti yerine bir çok satırlı ileti oluşturmasına neden olur. COLLECT, yalnızca STEM bir ardışık düzende ilk aşama olduğunda kullanılabilir. STEM aşamasındaki COLLECT tipi işleneni kullanarak, STEM aşaması ve ardından COLLECT aşaması kullanılarak eşdeğer işlevsel bir eşdeğerdir, ancak daha hızlı ve daha az depolama kullanır. Toplama işlemi yalnızca ilk aşamada kullanılabilir.
stemroot
Okuma ya da yazma işlemi için STEM değişkeninin adını belirtir. REXX komut yordamı kullanıyorsanız, bu işlemi bir nokta (.) ile sona erdirin. Ampersand (&) ekleme ( NetView komut listesi dilinde, ve işareti olarak işarettir). The name length (ad plus appended STEM count) can be up to 11 characters in the NetView command list language and up to 31250 characters in REXX and HLL except when $STEM is used, in which case, the limits are 10 and 30249, respectively. Adda küçük harfli karakterler, işlenmeden önce büyük harfe çevrilir. NetView komut listesi dilinde kullanılan & 1-& 31 değişkenleri, STEM aşamasındaki kullanım için desteklenmez. Ancak, bu değerleri STEM aşamasında kullanabileceğiniz diğer adlandırılmış değişkenlere ya da diğer adlandırılmış değişkenlere atayabilirsiniz.

STEM değişkenine ilişkin kayıt sayısı, sonuna sıfır eklenmiş olarak name ' dur. Sayı, STEM değişkeninin içerdiği kayıt sayısını gösterir. SSTEM kayıtları, sonuna sayısal bir değer eklenmiş ad ' dan oluşur.

(number)
Değişkenleri ayarlarken başvuruda bulunmak için sayı çağrılarını (oluşturmalar) belirtir. Nesiller sayısı, REXX, PL/I ya da C arama sırası içinde yürürlükteki içiçe yerleştirme düzeyini gösterir.

(Sayı) değeri sıfır (0) ya da daha büyük ve var olan nesiller sayısından az ya da ona eşit olmalıdır. (sayı) , (0) değerinden büyükse, değişkenler yürürlükteki neslin öncesindeki bir kuşakta yer alıyor. Belirtilen oluşturma, bu tür bir oluşturma varsa, PIPE komutunun yayınının verildiği nesneden önce olabilir.

(number) için varsayılan değer sıfırdır (0).

FROM
Kök değişkenlere erişim için bir başlangıç noktası olduğunu gösterir. FROM belirtilirse, frNumber da belirtilmelidir. FROM, ilk önce ya da ilk olmayan aşamalarda kullanılabilir.
frNumber
Pozitif bir sayı. STEM ilk aşamaysa, çıkış akışına yazılan ilk kök değişkenin numarasıdır. STEM ilk aşama değilse, bu, depolanan ilk değişkenin numarasıdır. Hem FROM hem de APPEND belirtmeyin.

Kullanım Notları ®

  • STEM bir ardışık düzen belirtiminin ilk aşaması olduğunda, aşağıdaki koşullar geçerli olur:
    • STEM aşamasından gelen ileti arabelleği çıkışının büyüklük üst sınırı 32.000 bayttır. 32.000 baytı aşan ileti arabellekleri 32.000 bayta kısaltılır.
    • STEM aşamasında belirtilen değişken geçerli olmayan bir kayıt sayısına sahipse, ardışık işlem hattı DWO206Iiletisiyle reddedilir ve ardışık işlem sona erer. STEM değişkeninin kayıt sayısı sıfır (sıfır) ya da artı (artı) ve 10.000değerinden küçük olmalıdır.
  • STEM bir ardışık düzen belirtiminin ilk aşaması değilse, aşağıdaki koşullar geçerli olur:
    • Sayı değişkeninin değeri ('0' ile eklenenad ), ardışık düzen kullanıma hazırlanırken (APPEND belirtilmediyse) çok erken kullanıma hazırlanır. Ardışık işleminiz bir hata ya da RESET koşulu nedeniyle çalıştırılamazsa, ardışık işlem hattınıza işlenmemiş olsa da, bu değişken sıfır değerine sahip olabilir. Benzer şekilde, iletiler STEM tarafından işlenmezse, sayı değişkeninin değeri sıfır olur.
    • STEM aşamasına ilişkin giriş iletileri, aşağıdaki gibi ileti satırlarında incelenir:
      • Tek bir ileti satırı içeren bir giriş akışı, iki STEM kaydının kaydedilmesine neden olur: iletiyi içeren bir STEM değişkeni ve kayıt sayısını içeren bir STEM0 .
      • 10 satırlık MLWTO içeren bir giriş akımı, 11 STEM kaydının saklanmasına neden olur: bir MLWTO ' nun her satırı için bir adet, kayıt sayısını içeren STEM0 için bir.
      • Tek satırlı bir iletinden ve 10 satırlı MLWTO ' dan oluşan bir giriş akımı, 12 STEM kaydının kaydedilmesine ve bu şekilde kaydedilmesine neden olur.
  • COMMON seçeneğiyle COLLECT kullanılırken, çok daha verimli ve öngörülebilir bir davranış elde edilir. STEM ilk aşamaysa, COLLECT, STEM aşamasında belirtilmelidir. STEM ilk aşama değilse, COLLECT aşaması STEM aşamasından önce gelmelidir.
    Örneğin, bir görev ortak genel kök X. ' i güncelliyorsa ve göreviniz bunu okuyorsa, aşağıdaki örnek, güncellenen X. değerlerinden bazılarını ve bazı eski değerleri alabilir:
    PIPE STEM (COMMON) X. | CONSOLE
    Ancak, aşağıdaki komut tüm eski değerleri ya da güncellenen değerlerin tümünü alır.
    PIPE STEM (COMMON) X. COLLECT | CONSOLE
  • STEM, aldığı iletilerin yapısını yoksayar. böylece 10 adet tek satırlık mesaj seti 10 kök kayıt ve bir 10 satırlık bir mesaj da 10 kök kayıt belirledi.
  • Tek bir STEM aşamasına birden çok akış girilemiyor. FANIN aşaması, birden çok akışın tek bir çıkış akışına çökmesi için kullanılabilir. Bu akış, STEM ' ye giriş olarak kullanılabilir. FANIN ile ilgili ek bilgi için PIPE FANINHELP PIPE FANIN (BORU FANININ YARDıMı)
  • TASK ve COMMON değişkenleri için sayı değişkeninin değeri (ad '0' eklenmiş olarak) ayarlanmadıysa, sayı değişkeninin değeri boş değer olur. Ancak, sayı değişkeni sıfır (0) olarak ayarlandıysa, boş değer aynı şekilde işlenir.
  • Görev ve genel genel değişken adları ve değerleri için uzunluk sınırları 250 ve 31000 baytsa da, Save/Restore database (DSISVRT görevi tarafından yönetilen) veritabanı sınırları daha düşüktür. Daha ayrıntılı bilgi için GLOBALV SAVE komutuna bakın. Çift baytlık karakter takımları (DBCS) için, çift bayt karakter sayısı üst sınırı (X'0E') ve çift bayt dizilimi başlangıç (X'0F') denetim karakterleri arasında 15499 karakter bulunur.

Örnek: Stemmed Değişkenlerine Yazma

PRIME adlı bir NetView komut listesi NetView otomasyonunun sonucu olarak çalıştırılırsa, komut listesi SECCND adlı ikinci bir komut listesini çalıştırır. SECND 'ye PRIME adı verilen iletiye aynı erişimi verebilir ve tüm çıkış verilerini PRIME' nin SSLT değişkenine (REXX 'te) girerek aşağıdaki bilgileri girerek saklayabilirsiniz:
 PIPE SAFE *
      | NETVIEW SECND
      | STEM SSLT.

Örnek: İşlenen Kayıtların Sayılarının Saklanması

Bu örnekte, CNMCMD dosyası ardışık düzene okunup A adlı STEM değişkenine kaydedilir. When the pipeline completes, the record count in A0 indicates the number of lines read from CNMCMD.
 /* REXX COMMAND LIST */
 'PIPE < CNMCMD INCL',
     '| STEM A'
 SAY 'THERE ARE ' A0 ' LINES IN CNMCMD.'

$STEM kullanımına ilişkin örnekler için, WINDON komut listesine bakın (CNME1505).