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

Examples
('1' B). PPI (TRAPROUT) is not valid for a generic alert whose
subvector X'92' flag bit 4 is on. For more information, refer to the
SNA library.
1005 The specified target type does not support the data. For example,
(TRAPROUT) was specified for a message which is not an alert.
1012 The user is not authorized.
Other Any valid return code returned by a PPI request type 4 (init), 14
(send), or 22 (receive). See the IBM Tivoli NetView for
z/OS Application Programmer's Guide for information about these
return codes.
Example: Generating an Alert from Hex Data
The following REXX example produces an alert similar to the following example
on the NPDA ALD screen:
NTV7E GENAL3 COMC 13:43 EQUIPMENT
MALFUNCTION:COMM SUBSYST CTRL
The text 'Here is my subvector 31 stuff.' is seen by selecting the alert and entering
"D" to view the event detail.
Note: Vector lengths in alerts must be correct or the alert might not be recognized.
/*** Make an alert ********/
altxt = ’41038D000000000000780000’X
altxt = altxt||’0B92000001100012345678’X
altxt = altxt||’1010000D110E0A0040F2F3F4F5F6F7F8’X
altxt = altxt||’069304032012’X
altxt = altxt||’0E950601150213E1068101011504’X
altxt = altxt||’1103030109C7C5D5C1D3F34040C3D6D4C3’X
altxt = altxt||’04931001’X
altxt = altxt||’30310602046E01F40512’X||’ENU’||’032111’X
altxt = altxt||’2030’X||’Here is my subvector 31 stuff.’
’pipe (end =) var altxt’,
’| a: PPI *ALERT’,
’|cons dump’,
’= a:’,
’|color whi’,
’|cons’
PIPE PPI
Example: Responding to Requests
The following simple example responds to the COUNT request with the number of
requests processed so far. Other requests receive the response ERROR 1.
Note: The receiver is not shut down when the pipeline ends so the response can
be generated.
/*** responding to a request ********/
’PIPE (NAME CNMCOUNT END ¬)’,
’| PPI CNMCOUNT’, /* receive for receiver name "CNMCOUNT" */
’| WAIT *’, /* CORRWAIT (until RESET or STOP FORCE) */
’| COUNT EACHLINE’, /* using line count for requested data */
’| X: LOC 1.5 /COUNT/’, /* valid requests... */
’| EDIT LINECOUNT 1’, /* constructing the simple response */
’| PPI *’, /* sending the response to requestor */
, /* -------------------- end of pipeline 1 ---------- */
’¬ X:’, /* invalid requests come here. */
’| EDIT /ERROR 1/ 1’, /* error message... */
’| PPI *’ /* sending error message to requestor */
Chapter 2. Pipeline Stages and Syntax 191