IBM Tivoli NetView for z/OS Version 6 Release 2 Programming: Pipes IBM SC27-2859-04 IBM Tivoli NetView for z/OS Version 6 Release 2 Programming: Pipes IBM SC27-2859-04 Note Before using this information and the product it supports, read the information in “Notices” on page 327. This edition applies to version 6, release 2 of IBM Tivoli NetView for z/OS (product number 5697-NV6) and to all subsequent versions, releases, and modifications until otherwise indicated in new editions. This edition replaces SC27-2859-03. © Copyright IBM Corporation 1997, 2014. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ................................... vii About this publication ............................. ix Intended audience ................................. ix Publications ................................... ix IBM Tivoli NetView for z/OS library .......................... ix Related publications ............................... xi Accessing terminology online ............................ xi Using NetView for z/OS online help .......................... xii Accessing publications online ............................ xii Ordering publications ............................... xii Accessibility ................................... xiii Service Management Connect ............................. xiii Tivoli technical training ............................... xiii Tivoli user groups ................................. xiii Downloads ................................... xiii Support information ................................ xiv Conventions used in this publication .......................... xiv Typeface conventions ............................... xiv Operating system-dependent variables and paths...................... xv Syntax diagrams................................. xv Chapter 1. NetView Pipelines Introduction and General Concepts ........... 1 What Is a Pipeline ................................. 1 Pipeline Stages .................................. 2 PIPE Command .................................. 3 Stage Input and Output ............................... 4 First and Subsequent Stages ............................. 6 Complex Pipelines ................................. 7 Creating a Complex Pipeline ............................. 7 Processing a Complex Pipeline ............................ 9 Stages ..................................... 11 Device Drivers ................................. 11 Filters .................................... 12 Understanding NetView Pipelines ............................ 12 How a Pipeline Begins .............................. 12 How a Pipeline Ends ............................... 12 Online Help Facility ................................ 13 Getting Started with NetView Pipelines .......................... 13 Chapter 2. Pipeline Stages and Syntax ...................... 19 PIPE (NCCF) ................................... 19 PIPE Stages .................................. 23 PIPE APPEND .................................. 26 PIPE BETWEEN .................................. 28 PIPE CASEI ................................... 30 PIPE CHANGE .................................. 31 PIPE CHOP ................................... 34 PIPE COLLECT .................................. 36 PIPE CONSOLE .................................. 41 PIPE COREVENT ................................. 44 PIPE COREVTDA ................................. 45 PIPE CORRCMD ................................. 46 PIPE CORRWAIT ................................. 49 PIPE COUNT................................... 54 © Copyright IBM Corp. 1997, 2014 iii PIPE CPDOMAIN ................................. 57 PIPE CZR .................................... 59 PIPE DELDUPES ................................. 61 PIPE DIVERT................................... 63 PIPE DROP ................................... 64 PIPE DUPLICAT ................................. 66 PIPE EDIT.................................... 67 PIPE ENVDATA ................................. 114 PIPE EXPOSE .................................. 115 PIPE FANIN................................... 117 PIPE FANINANY ................................. 118 PIPE FANOUT .................................. 120 PIPE FMTPACKT ................................. 121 PIPE HELDMSG ................................. 126 PIPE HOLE ................................... 127 PIPE INSTORE .................................. 129 PIPE INTERPRT ................................. 131 PIPE IPLOG ................................... 134 PIPE JOINCONT ................................. 135 PIPE KEEP ................................... 137 PIPE LITERAL .................................. 140 PIPE LOCATE .................................. 141 PIPE LOGTO .................................. 143 PIPE LOOKUP .................................. 144 PIPE MEMLIST.................................. 148 PIPE MVS ................................... 150 PIPE NETVIEW ................................. 152 PIPE NLOCATE ................................. 156 PIPE NLS ................................... 157 PIPE NOT ................................... 159 PIPE NPDAEVD ................................. 160 PIPE PERSIST .................................. 161 PIPE PICK ................................... 164 PIPE PIPEND .................................. 166 PIPE PPI .................................... 168 PIPE PRESATTR ................................. 173 PIPE QSAM ................................... 176 PIPE REVERSE .................................. 180 PIPE REVISRPT ................................. 182 PIPE ROUTE .................................. 182 PIPE SAFE ................................... 185 PIPE SEPARATE ................................. 188 PIPE SORT ................................... 190 PIPE SPLIT ................................... 192 PIPE SQL.................................... 195 Performing a Query with SQL SELECT......................... 198 Performing a Query with DESCRIBE SELECT ...................... 198 Loading Tables with SQL INSERT .......................... 199 Release statement, Set Connection, Set Current Degree, Set Current Package Set, Set Current Rules, or Send Current SQLID ................................. 199 Using SQL LISTREGS .............................. 199 Using SQL EXECUTE .............................. 200 Using Multiple Concurrent SQL Stages ......................... 200 Other Considerations When Using SQL ........................ 201 PIPE SQLCODES ................................. 201 PIPE STEM and PIPE $STEM ............................. 202 PIPE STRIP ................................... 206 PIPE SUBSYM .................................. 208 PIPE TAKE ................................... 209 PIPE TOSTRING ................................. 210 PIPE TSO.................................... 212 iv Programming: Pipes PIPE TSROUTE.................................. 217 PIPE UNIX ................................... 218 PIPE VAR and PIPE $VAR .............................. 222 PIPE VARLOAD ................................. 225 PIPE VERIFY .................................. 229 PIPE VET ................................... 230 PIPE VTAM ................................... 235 PIPE XCFMSG .................................. 238 PIPE XCFQUERY ................................. 239 PIPE XCFTABLE ................................. 241 PIPE XLATE................................... 243 PIPE < (From Disk) ................................ 245 PIPE > (To Disk) ................................. 248 Chapter 3. NetView Pipelines Device Drivers ................... 249 Interfacing with the Task: CONSOLE, HELDMSG, LITERAL, LOGTO ............... 249 Displaying Messages: CONSOLE ........................... 249 Copying Held Messages into the Pipeline: HELDMSG.................... 252 Inserting Text into the Pipeline: LITERAL ........................ 253 Copying Pipeline Contents to a Log: LOGTO....................... 255 Interfacing with Other Applications: NETVIEW, VTAM .................... 256 Running a NetView Command: NETVIEW ....................... 256 Running a VTAM Command: VTAM ......................... 259 Working with DASD Data: < (From Disk) ......................... 261 Reading from DASD: (<) ............................. 261 Accessing Variables within Command Procedures: VAR, STEM, SAFE ............... 262 Reading from or Writing to Named Variables: VAR..................... 262 Reading from or Writing to Variables in a Stemmed Array: STEM ................ 263 Reading from or Writing to a Command Procedure Message: SAFE ............... 265 Building Large PIPE Commands: INTERPRT ........................ 267 Using the INTERPRT Stage............................. 267 Chapter 4. NetView Pipeline Filters ....................... 269 Manipulating Messages: SEPARATE, COLLECT ....................... 269 Breaking Up an MLWTO: SEPARATE ......................... 269 Building an MLWTO: COLLECT ........................... 270 Selecting Messages by Content: LOCATE, NLOCATE, TOSTRING ................. 271 Keeping or Discarding Matching Messages: LOCATE, NLOCATE ................ 272 Selecting Messages Up to and Including a Message That Matches a Specified Text String: TOSTRING .... 275 Selecting Messages by Position: TAKE, DROP ....................... 277 Keeping the First or Last n Messages: TAKE ....................... 277 Discarding the First or Last n Messages: DROP ...................... 278 Emptying the Pipeline: HOLE ............................. 279 Determining Correlation: HOLE ..........................