28.11.2012 Views

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

PIPE EDIT<br />

108 <strong>Programming</strong>: <strong>Pipes</strong><br />

SESSID (input order)<br />

Specifies that the edit phrase input is the TAF session ID or, following a PPI<br />

pipe receive stage, is the SAF ID of the PPI sender.<br />

SYSCONID (input order)<br />

Use as input the 8-character MVS System Console name. If the message was<br />

not received from MVS, blanks are returned.<br />

SYSCONID is synonymous with IFRAUCON.<br />

SYSNAME (input order)<br />

Use as input the 8-character name of the system from which the message<br />

originated. If the message was issued locally, the name of the local system is<br />

returned. If the message is a remote message (one which originated on another<br />

system in a sysplex), the name returned is the remote system name, which is<br />

different from the local system name. You can compare the value returned with<br />

the &SYSNAME. system symbolic to determine whether the message is local or<br />

remote.<br />

UCHARS (input order)<br />

Obtains the 16-byte "user char" area. In the MRT, this field is available only if<br />

previously set. In PIPE EDIT, this field is equivalent to IFRAUSRC.<br />

UFLAGS (input order)<br />

Obtains the 2-byte "user flags" area. In the MRT, this field is available only if<br />

previously set.<br />

WORD (input order)<br />

WORD is similar to position.length in that it specifies that a subset of the data<br />

received on the input data stream is used as input to EDIT. Unlike<br />

position.length, WORD counts blank delimited tokens or words within the input<br />

data. A word ends when a blank is encountered. The next word begins with<br />

the next nonblank character.<br />

Startword.numwords must be specified.<br />

Startword indicates the starting word within the current line. By default,<br />

startword is counted from the first word of the line.<br />

Startword can be a positive or negative number. A negative value <strong>for</strong> startword<br />

indicates that the starting position is to be counted from the end of the current<br />

line, rather than from the beginning.<br />

Numwords is an unsigned, positive number indicating the number of words<br />

from startword to be processed. An asterisk (*) can be specified <strong>for</strong> numwords<br />

indicating that all words after startword are to be used. Startword without<br />

numwords and the period (.) separator defaults numwords to 1.<br />

If numwords is larger than the available words, all available words are used.<br />

The LEFT conversion order can be used to pad the resulting text if required.<br />

Note: The PARSE global order can affect the way words are defined.<br />

Consider the following message:<br />

PIPES CAN BE FUN!<br />

This ... Results in ...<br />

WORD 1.* PIPES CAN BE FUN!<br />

WORD 2.2 CAN BE<br />

WORD -2.* BE FUN!

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!