IBM Tivoli NetView for z/OS Version 6 Release 2 Modification 1 Programming: REXX and the NetView Command List Language IBM SC27-2861-04 Note Before using this information and the product it supports, read the information in “Notices” on page 191. This edition applies to version 6, release 2, modification 1 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-2861-03. © Copyright International Business Machines 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 .............................................................................................................................. x Accessing terminology online................................................................................................................xi Using NetView for z/OS online help......................................................................................................xii Accessing publications online.............................................................................................................. xii Ordering publications ...........................................................................................................................xii Accessibility ............................................................................................................................................... xii Service Management Connect...................................................................................................................xiii Tivoli technical training............................................................................................................................. xiii Tivoli user groups.......................................................................................................................................xiii Downloads................................................................................................................................................. xiii Support information.................................................................................................................................. xiv Conventions used in this publication........................................................................................................ xiv Revision codes..................................................................................................................................... xiv Typeface conventions ......................................................................................................................... xiv Operating system-dependent variables and paths..............................................................................xv Syntax diagrams....................................................................................................................................xv Chapter 1. Getting Started..................................................................................... 1 The Benefits of Using Command Lists.........................................................................................................1 Examples of Common Startup Command Lists..................................................................................... 2 Examples of Activating a Network Control Program............................................................................. 2 Creating Command Lists..............................................................................................................................2 Controlling Access to Command Lists.........................................................................................................3 Loading Command Lists into Storage..........................................................................................................4 Running Command Lists.............................................................................................................................. 5 Running Command Lists When NetView Is Started.............................................................................. 5 Running Command Lists When Logging On........................................................................................... 5 Running Command Lists after Receiving a Message or MSU................................................................ 6 Running Command Lists from a Terminal..............................................................................................6 Running Command Lists at a Specified Time or Time Interval............................................................. 6 Running Command Lists from Another Command List......................................................................... 7 Running Command Lists from a User-Written Command Processor....................................................8 Using Network Commands in Command Lists............................................................................................ 8 Using System Commands in Command Lists........................................................................................ 9 Using Long-Running Commands in Command Lists..............................................................................9 Using Tivoli NetView for z/OS Pipelines...............................................................................................10 Using the VIEW Command................................................................................................................... 10 Using Full-Screen Commands..............................................................................................................10 Primary POI Task Restrictions............................................................................................................. 10 AUTOTASK OST Restrictions................................................................................................................11 Controlling Command List Output.............................................................................................................11 Working with Messages............................................................................................................................. 12 Chapter 2. REXX Language Overview....................................................................13 Introduction to the REXX Language.......................................................................................................... 13 iii Compiling and Running REXX Command Lists..........................................................................................13 Using %INCLUDE with Interpreted REXX................................................................................................. 14 Using Data REXX........................................................................................................................................ 14 Processing Data REXX Files................................................................................................................. 15 Additional Information.........................................................................................................................16 Data REXX Directives........................................................................................................................... 17 ⁄*%DATA............................................................................................................................................... 17 ⁄*%LOGIC..............................................................................................................................................18 Coding Conventions for REXX Command Lists and Data REXX Files....................................................... 19 Record Size...........................................................................................................................................19 Using Quotation Marks.........................................................................................................................19 Suppressing Display of Non-REXX Commands................................................................................... 21 Tivoli NetView for z/OS Restrictions on REXX Instructions......................................................................21 Pausing for Operator Input.................................................................................................................. 21 Using the SAY Instruction.................................................................................................................... 22 Using the CALL Instruction.................................................................................................................