IBM Tivoli Netview for Z/OS Programming: Assembler

Total Page:16

File Type:pdf, Size:1020Kb

IBM Tivoli Netview for Z/OS Programming: Assembler IBM Tivoli NetView for z/OS Version 6 Release 1 Programming: Assembler SC27-2858-00 IBM Tivoli NetView for z/OS Version 6 Release 1 Programming: Assembler SC27-2858-00 Note Before using this information and the product it supports, read the information in “Notices” on page 293. This edition applies to version 6, release 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. © Copyright IBM Corporation 1997, 2011. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ....................................ix About this publication .............................xi Intended audience .................................xi Publications ...................................xi IBM Tivoli NetView for z/OS library ..........................xi Related publications ...............................xiii Accessing terminology online ............................xiii Using NetView for z/OS online help .........................xiv Using LookAt to look up message explanations ......................xiv Accessing publications online ............................xv Ordering publications ...............................xv Accessibility ...................................xv Tivoli technical training ...............................xv Tivoli user groups .................................xvi Downloads ...................................xvi Support information ................................xvi Conventions used in this publication ..........................xvii Typeface conventions ..............................xvii Operating system-dependent variables and paths .....................xvii Syntax diagrams ................................xviii Part 1. Writing in Assembler Language.....................1 Chapter 1. Getting Started ............................3 The Benefits of Using Assembler Language .........................3 Testing Your Program ................................3 Chapter 2. Designing Assembler Modules .....................5 Task Structure ...................................5 General Coding Guidelines ..............................6 Processing Environment ..............................6 Coding Requirements ...............................7 Control Blocks ...................................9 Control Block Requirements .............................9 Establishing Addressability .............................11 Work Block Services ................................11 Basic Module Services ................................11 Standard NetView Buffer Structure ..........................11 Dynamic Storage Services..............................11 Releasing Queued Storage .............................12 Message Processing................................12 Calling Commands ................................16 Scheduling Commands in a Cross-Domain Environment ...................19 Additional Services .................................20 Loading and Deleting Modules in Virtual Storage .....................20 Posting and Waiting on Event Control Block (ECB) Services ..................20 Disk Services ..................................20 Parsing ....................................21 Command Authorization Checking ..........................21 Named Storage .................................21 Sending and Receiving Data Using the MS Transport ....................22 Sending and Receiving Data Using the High-Performance Transport ...............22 Passing an MSU through the NetView Automation Table ...................23 © Copyright IBM Corp. 1997, 2011 iii Numeric Code Point Translation ...........................23 Specifying Tokens in Alert Automation .........................23 Returning a Command to an Originating Domain .....................23 Resource Span Checking ..............................23 Data Services Task (DST) Unique Services ........................24 Chapter 3. Writing Installation Exit Routines ...................25 Overview of Installation Exit Routines ..........................25 Designing and Coding an Installation Exit Routine ......................27 Input ....................................27 Output ....................................27 Control Blocks .................................30 Summary of Installation Exits ............................31 Unused Installation Exits ..............................60 Installing an Installation Exit Routine...........................60 Template for an Installation Exit Routine .........................60 Chapter 4. Writing Command Processors .....................61 Overview of Command Processors ...........................61 Regular Command Processors ............................61 High-Priority Command Processors ..........................61 Immediate Command Processors ...........................61 Data Services Command Processors ..........................62 Combination Command Processors ..........................62 Long-Running Command Processors ..........................62 Unattended and Attended Operator Task Command Considerations ...............62 Designing and Coding a Command Processor ........................63 Input to the Command Processor ...........................63 Output from the Command Processor .........................64 Control Blocks .................................65 Writing a Full-Screen Command Processor ........................67 Writing a Long-Running Command Processor .......................70 Automation Task Command Processors ..........................78 Installing a Command Processor ............................78 Template for a Command Processor ...........................78 Chapter 5. Writing User Subtasks ........................81 Types of User Subtasks ...............................81 Optional Subtask Processing Overview ..........................81 Installation of User Subtasks.............................82 Initialization of the OPT ..............................83 TVBMEMNM Field ................................84 Processing ...................................84 Termination ..................................87 Additional Considerations .............................88 Data Services Task (DST) ...............................88 Installation of a DST ...............................89 Initialization of a DST ...............................89 Data Services Command Processor ..........................90 CNM Data Services................................90 VSAM Service Interface ..............................93 Example of DSCP Design..............................95 User-Defined Services ...............................98 Chapter 6. Writing User Function Directories ...................99 Overview of User-Written Functions ...........................99 Interface to Functions ...............................100 Entry Specifications ...............................100 External Function Parameter List ...........................100 Argument List .................................101 iv Programming: Assembler Evaluation Block ................................101 Directory for Function Packages ............................102 Format of the Entry in the Directory..........................103 Example of a User Function Directory .........................104 Part 2. Reference ..............................105 Chapter 7. Control Blocks ...........................107 BUFHDR: Buffer Header ..............................107 Values for HDRIND Fields .............................110 Values for HDRMTYPE Fields ............................110 BUFHDR Presentation Extension ...........................113 Example Scenario of BUFHDR Usage .........................115 DSIAIFRO: Automation Vector Extensions .........................115 Modifications of the AIFR Format ..........................115 Format of the Message Control Object .........................116 Format of the Source Object ............................118 DSICBH: Control Block Header ............................118 DSICWB: Command Work Block ............................119 DSIDSB: Data Services Block .............................120 DSIDSRB: Data Services Request Block ..........................121 DSIDTR: Data Transport Request ............................123 DSIELB: External Logging Block ............................123 DSIIFR: Internal Function Request ...........................123 AIFR–Automation Internal Function Request .......................124 Automation Internal Function Request Routing List ....................139 DSILOGDS: NetView Log ..............................140 DSIMVT: Main Vector Table .............................140 MVTAIDFT–DSIEX16 Interface Data..........................143 DSIPDB: Parse Descriptor Block ............................144 DSISCE: System Command Entry ...........................145 DSISCT: System Command Table ............................146 DSISVL: Service Routine Vector List ...........................146 DSISWB: Service Work Block .............................146 DSITECBR: Branch Table of ECB Processor Load Modules ...................147 DSITIB: Task Information Block ............................147 DSITVB: Task Vector Block ..............................149 DSIUSE: Installation Exit Parameter List .........................153 DSIXRCMD: RUNCMD Installation Exit Buffer .......................156 Chapter 8. Macros ..............................157 DSIAUTO: Invoke Automation Services .........................157 Return Codes in Register 15 ............................158 DSIBAM: Build Automation Message
Recommended publications
  • Rocket Universe 11 Structural Changes
    Rocket UniVerse 11 Structural Changes What you need to know before you install or upgrade to UniVerse 11 Rocket U2 Technical Support Supplemental Information April 2014 UNV-112-REP-OG-1 Notices Edition Publication date: April 2014 Book number: UNV-112-REP-OG-1 Product version: Rocket UniVerse V11.2 Copyright © Rocket Software, Inc. or its affiliate 1985-2014. All Rights Reserved. Trademarks Rocket is a registered trademark of Rocket Software, Inc. For a list of Rocket registered trademarks go to: www.rocketsoftware.com/about/legal. All other products or services mentioned in this document may be covered by the trademarks, service marks, or product names of their respective owners. Examples This information might contain examples of data and reports. The examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. License agreement This software and the associated documentation are proprietary and confidential to Rocket Software, Inc. or its affiliates, are furnished under license, and may be used and copied only in accordance with the terms of such license. Note: This product may contain encryption technology. Many countries prohibit or restrict the use, import, or export of encryption technologies, and current use, import, and export regulations should be followed when exporting this product. Contact information Website: www.rocketsoftware.com Rocket Software, Inc. Headquarters 77 4th Avenue, Suite 100 Waltham, MA 02451-1468 USA Tel: +1 781 577 4321 Fax: +1 617 630 7100 2 Contacting Global Technical Support If you have current support and maintenance agreements with Rocket Software, you can access the Rocket Customer Portal to report and track a problem, to submit an enhancement request or question, or to find answers in the U2 Knowledgebase.
    [Show full text]
  • A Soft Linen Emulsion Rate Intelligent Control System Based on the Domain Interpolation Algorithm with Self Adjusting
    JOURNAL OF SOFTWARE, VOL. 6, NO. 8, AUGUST 2011 1429 A Soft Linen Emulsion Rate Intelligent Control System Based on the Domain Interpolation Algorithm with Self Adjusting Xiao Ying Jinggangshan University / school of Electronic and Information Engineering, Ji’an, Jiangxi ,China 343009 [email protected] Peng Xuange Jinggangshan University / school of Electronic and Information Engineering, Ji’an, Jiangxi ,China 343009 [email protected] Abstract—A soft linen emulsion rate intelligent control linen and ramie is called as soft linen, including system based on the domain interpolation algorithm with mechanical soft linen, fuel, wet and storage. The purpose self adjusting is introduced. In the hemp textile industry, is to enable fiber loose, soft, surface lubrication, remove soft linen deal processes can directly affect its following some impurities and then fermented by the heap storage process. We take the lead to use the fuzzy control method to improve the fiber spin ability, then carding and applied in soft linen emulsion rate of Intelligent Control System. In the research process, the improvement of spinning can be carried out. This process quality has the product quality is not satisfied by basic fuzzy control direct impact on the following process, such as the method. By improving the algorithm, combined advanced quality of spinning and weaving. interpolation algorithm into fuzzy decision process, that The references show that the world, especially experience rule set has no restriction to access control list, Southeast Asia, in hemp textile the soft linen processes enhanced the flexibility of the method, and obtain fine are used the same fall behind technology model, that is enough fuzzy control table under the same rules.
    [Show full text]
  • Powerconnect 3448 User's Guide
    Dell™ PowerConnect™ 34XX Systems User’s Guide Notes, Notices, and Cautions NOTE: A NOTE indicates important information that helps you make better use of your computer. NOTICE: A NOTICE indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. CAUTION: A CAUTION indicates a potential for property damage, personal injury, or death. ____________________ Information in this document is subject to change without notice. © 2005 Dell Inc. All rights reserved. Reproduction in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell, Dell OpenManage, the DELL logo, and PowerConnect are trademarks of Dell Inc. Microsoft and Windows are registered trademarks of Microsoft Corporation. Other trademarks and trade names may be used in this document to refer to either the entities claiming the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and trade names other than its own. May 2005 Rev A01 Contents 1 Introduction System Description . 21 PowerConnect 3424 . 21 PowerConnect 3424P . 21 PowerConnect 3448 . 22 PowerConnect 3448P . 22 Stacking Overview . 22 Understanding the Stack Topology . 23 Stacking Failover Topology . 23 Stacking Members and Unit ID. 23 Removing and Replacing Stacking Members . 24 Exchanging Stacking Members . 25 Switching from the Stack Master to the Backup Stack Master. 27 Features Overview. 28 Power over Ethernet . 28 Head of Line Blocking . 28 Flow Control Support (IEEE 802.3X) . 28 Back Pressure Support . 28 Virtual Cable Testing (VCT). 28 MDI/MDIX Support . 29 Auto Negotiation . 29 MAC Address Supported Features . 29 Layer 2 Features .
    [Show full text]
  • A Meta-Semantic Language for Smart Component-Adapters
    New Jersey Institute of Technology Digital Commons @ NJIT Dissertations Electronic Theses and Dissertations Spring 5-31-2000 A meta-semantic language for smart component-adapters Leon K. Jololian New Jersey Institute of Technology Follow this and additional works at: https://digitalcommons.njit.edu/dissertations Part of the Computer Sciences Commons Recommended Citation Jololian, Leon K., "A meta-semantic language for smart component-adapters" (2000). Dissertations. 406. https://digitalcommons.njit.edu/dissertations/406 This Dissertation is brought to you for free and open access by the Electronic Theses and Dissertations at Digital Commons @ NJIT. It has been accepted for inclusion in Dissertations by an authorized administrator of Digital Commons @ NJIT. For more information, please contact [email protected]. Copyright Warning & Restrictions The copyright law of the United States (Title 17, United States Code) governs the making of photocopies or other reproductions of copyrighted material. Under certain conditions specified in the law, libraries and archives are authorized to furnish a photocopy or other reproduction. One of these specified conditions is that the photocopy or reproduction is not to be “used for any purpose other than private study, scholarship, or research.” If a, user makes a request for, or later uses, a photocopy or reproduction for purposes in excess of “fair use” that user may be liable for copyright infringement, This institution reserves the right to refuse to accept a copying order if, in its judgment,
    [Show full text]
  • A Hardware Efficient Implementation of a Boxes Reinforcement Learning System
    A Hardware Efficient Implementation of a Boxes Reinforcement Learning System Yendo Hu and Ronald D. Fellman Department of Electrical and Computer Engineering. 0407 University of California at San Diego December 21,1993 Abstract through the previously traversed system states. The effect This paper presents two modifications to the Boxes- of the reinforcement signal on a control parameter ASEIACE reinforcement learning algorithm to improve decreases exponentially with the elapsed time since the implementation efficiency and performance. A state his- system had last entered that state. In [2], a single ASE, tory queue (SHQ) replaces the decay computations asso- along with one ACE, successfully learned to solved the ciated with each conwl state, decoupling the pole balancing problem. Many other researchers have dependence of computational demand from the number also used a pole-cart balancer to benchmark the of conml states. A dynamic link table implements performance of their algorithms [81 [ll. CMAC state association to training time, yet decrease The ASE assigns a register to hold an output control minimize the number of control states. Simulations of value for each unique system state. Taken together, these the link table demonstrated its potential for minimizing registers form a control table that maps a plant state to a control states for unoptimized state-space quantization. control action. Each register holds the long-term trace Simulations coupling the link table to CMAC state asso- that represents both the output action, the trace’s sign, ciation show a 3-fold reduction in learning time. A hard- and also a confidence level, the trace’s magnitude.
    [Show full text]
  • Table of Contents
    A Comprehensive Introduction to Vista Operating System Table of Contents Chapter 1 - Windows Vista Chapter 2 - Development of Windows Vista Chapter 3 - Features New to Windows Vista Chapter 4 - Technical Features New to Windows Vista Chapter 5 - Security and Safety Features New to Windows Vista Chapter 6 - Windows Vista Editions Chapter 7 - Criticism of Windows Vista Chapter 8 - Windows Vista Networking Technologies Chapter 9 -WT Vista Transformation Pack _____________________ WORLD TECHNOLOGIES _____________________ Abstraction and Closure in Computer Science Table of Contents Chapter 1 - Abstraction (Computer Science) Chapter 2 - Closure (Computer Science) Chapter 3 - Control Flow and Structured Programming Chapter 4 - Abstract Data Type and Object (Computer Science) Chapter 5 - Levels of Abstraction Chapter 6 - Anonymous Function WT _____________________ WORLD TECHNOLOGIES _____________________ Advanced Linux Operating Systems Table of Contents Chapter 1 - Introduction to Linux Chapter 2 - Linux Kernel Chapter 3 - History of Linux Chapter 4 - Linux Adoption Chapter 5 - Linux Distribution Chapter 6 - SCO-Linux Controversies Chapter 7 - GNU/Linux Naming Controversy Chapter 8 -WT Criticism of Desktop Linux _____________________ WORLD TECHNOLOGIES _____________________ Advanced Software Testing Table of Contents Chapter 1 - Software Testing Chapter 2 - Application Programming Interface and Code Coverage Chapter 3 - Fault Injection and Mutation Testing Chapter 4 - Exploratory Testing, Fuzz Testing and Equivalence Partitioning Chapter 5
    [Show full text]
  • Control Language Application Module Reference Manual
    L Control Language Application Module Reference Manual AM27-410 L Implementation Application Module - 3 Control Language Application Module Reference Manual AM27-410 Release 420 2/96 Copyright, Trademarks, and Notices © Copyright 1992 by Honeywell Inc. Revision 06 – February 15, 1996 While this information is presented in good faith and believed to be accurate, Honeywell disclaims the implied warranties of merchantability and fitness for a particular purpose and makes no express warranties except as may be stated in its written agreement with and for its customer. In no event is Honeywell liable to anyone for any indirect, special or consequential damages. The information and specifications in this document are subject to change without notice. About This Publication This publication provides reference information about the Honeywell Control Language for the Application Module (CL/AM). This publication supports software Release 420. Change bars are used to indicate paragraphs, tables, or illustrations containing changes that have been made by Document Change Notices or an update. Pages revised only to correct minor typographical errors contain no change bars. All changes made by previous Document Change Notices have been incorporated in this update. CL/AM Reference 2/96 CL/AM Reference 2/96 Table of Contents 1 INTRODUCTION 1.1 Purpose/Background 1.2 References 1.2.1 General CL/AM Information 1.2.2 Publications with CL/AM-Specific Information 1.3 CL/AM Overview 2 RULES AND ELEMENTS OF CL/AM 2.1 Introduction to CL/AM Rules and Elements
    [Show full text]
  • HP-UX to Oracle Solaris Porting Guide Getting Started on the Move to Oracle Solaris
    An Oracle White Paper October 2011 HP-UX to Oracle Solaris Porting Guide Getting Started on the Move to Oracle Solaris HP-UX to Oracle Solaris Porting Guide Chapter 1 Introduction...................................................................... 1 Oracle Solaris ................................................................................. 1 The Advantages of Porting to Oracle Solaris.................................. 2 Chapter 2 The Porting Process........................................................ 4 Infrastructure and Application Porting Assessment ........................ 4 Build Environment Deployment....................................................... 5 Data Integration .............................................................................. 5 Source Code Porting....................................................................... 6 Application Verification.................................................................... 6 Commercial Applications and Third-Party Products ....................... 6 Chapter 3 Operating System Considerations................................... 7 Processor Endianness .................................................................... 7 Data Alignment ............................................................................... 7 Read/Write Structures..................................................................... 8 Storage Order and Alignment ......................................................... 8 64-Bit Data Models ........................................................................
    [Show full text]
  • NASA Technical Memorandum
    NASA Technical Memorandum NASA TM-86467 REAL-TIME SOLAR MAGNETOGRAPH OPERATION SYSTEM SOFTWARE DESIGN AND USER'S GUIDE By Caroline Wang Space Science Laboratory Science and Engineering Directorate September 1984 NASA National Aeronautics and Space Administration George C. Marshall Space Flight Center MSFC - Form 3190 (Rev. May 1983) TECHNICAL REPORT STANDARD TITLE PAGE 1. REPORT NO. 2. GOVERNMENT ACCESSION NO. 3. RECIPIENT'S CATALOG NO. NASA TM -86467 4. TITLE AND SUBTITLE 5. REPORT DATE Real-Time Solar Magneto graph Operation System Software September 1-984 Design and User's Guide 6. PERFORMING ORGANIZATION CODE 7. AUTHOR(S) 8. PERFORMING ORGANIZATION REPORT tf Caroline Wang 9. PERFORMING ORGANIZATION NAME AND ADDRESS 10. WORK UNIT NO. George C. Marshall Space Flight Center 1 1. CONTRACT OR GRANT NO. Marshall Space Flight Center, Alabama 35812 13. TYPE OF REPORT & PERIOD COVERED 12. SPONSORING AGENCY NAME AND ADDRESS National Aeronautics and Space Administration Technical Memorandum Washington, D.C. 20546 14. SPONSORING AGENCY CODE 15. SUPPLEMENTARY NOTES Prepared by Space Science Laboratory, Science and Engineering Directorate. 16. ABSTRACT This document presents the Real-Time Solar Magnetograph (RTSM) Operation system software design on PDP11/23+ and the User's Guide. RTSM operation software is for Real-Time Instrumentation Control, data collection and data management. The data will be used for vector analysis, plotting or graphics display. The processed data can then be easily compared with solar data from other sources, such as the Solar Maximum Mission (SMM). 17. KEY WORDS 18. DISTRIBUTION STATEMENT Real Time Solar Magnetograph (RTSM) Unclassified — Unlimited Operation System Software 19. SECURITY CLASSIF.
    [Show full text]
  • Transient Air Dynamics Modeling for an Advanced Alternative Fueled Engine
    Transient Air Dynamics Modeling for an Advanced Alternative Fueled Engine Undergraduate Honors Thesis Presented in Partial Fulfillment of the Requirements for Graduation with Distinction at The Ohio State University By Ryan V. Everett * * * * * The Ohio State University 2010 Defense Committee: Professor Giorgio Rizzoni, Advisor Dr. Shawn Midlam-Mohler Copyrighted by Ryan V. Everett 2010 ii ABSTRACT The EcoCAR challenge is a three year competition with a goal of re-engineering a 2009 General Motors crossover utility vehicle to improve vehicle emissions and fuel economy, while maintaining drivability and consumer acceptability. Ohio State’s team has selected a plug-in hybrid electric vehicle (PHEV) architecture with a 1.8 L CNG Honda engine as the auxiliary power unit. The Honda engine is converted to run on E85 fuel, which requires the engine control software to be rewritten. The purpose of this research is to write a feed forward air/fuel ratio (AFR) control algorithm to better manage fuel injection during transient engine events. AFR control has a major impact on engine fuel economy and tail pipe emissions. This research investigates the accuracy of using a dynamic intake manifold filling and emptying model coupled with a linear approximation of the Taylor Series expansion to predict air flow forward in time. To better estimate air flowing passed the throttle plate and into the intake manifold, a quasi-static effective area map of the throttle was created. The control algorithm uses the throttle effective area map to improve the accuracy of air flow estimation into the intake manifold because the MAF sensor is not a reliable flow meter during transient engine events.
    [Show full text]
  • CS152 Midterm Solution
    University of California, Berkeley College of Engineering Department of Electrical Engineering and Computer Science CS152 Midterm Solution Prof. Bob Brodersen Fall, 2000 Problem 1: Single-cycle Processor and Performance Evaluation We have a single cycle processor as we learned in class. Besides the instructions R-format, lw, sw, and beq that the processor already implemented, the designer figured that certain software does the following instructions extensively input1 cs $t $s1 $s2; cslw $t $s1 $s2; cslwcs $t $s1 $s2 . zero Besides the usual PC handling and instruction fetch as before, Greater • the cs instruction is described as: GALU $t <= max($s1, $s2) output • The cslw does the following: Input 2 $t <=memory [ max($s1,$s2)] • The cslwcs instruction the following: $t <= max{$s1, memory[ max ($s1, $s2)]} ALUcontrol So now you see that cs and lw in above names stand for compare_select and loadword. The designer plans to modify the datapath and control signal based on the processor showed in next page. It’s a textbook processor with some missing blocks and wiring to fill in. The components he can use are any of the blocks already present in the design and the generalized GALU (showed above) with an additional output GREATER that equals to 1 if Input1-Input2 >0, and equals to 0 if Input1-Input2 =< 0. box1 A box2 BC Questions: a). Describe below in words and fill in box 1 the blocks needs to be added in order to implement the cs and cslw instruction. Furthermore add in and draw in box 2 any additional blocks to implement the cslwcs instruction.
    [Show full text]
  • See Schema of Table in Sql
    See Schema Of Table In Sql When Casey pep his rengas titter not ill-advisedly enough, is Waylon composite? Unbridged Niles untwines no splices fricasseed vehemently after Francis patent zigzag, quite Oceanian. Josiah ship salubriously. Lists all layers and see various database drops for test new on object browser and see in table of schema. Managing Database Functions with SQL Runner. Your personal information we see in table sql schema of. Grant alter cover to user mysql Festival Lost form the Fifties. Andy brings up without asking for obtaining metadata with the website helps us see in table of schema name may have a scenario where viewobj. You see properties in sql query. Some cookies are placed by being party services that appear without our pages. Follow any objects necessary, you for container of the desired information regarding all sql schema of table in? We welcome your comments! The output should contain these database tables, including those were were created by comprehensive system. You can be logged into databases through to create same unqualified access control pane and see in table of schema sql server has no upper case names. The schema as far as lars pointed out different scripts, see schema of table in sql statements will see. The security is secondary. Seite verwendet werden. Einige unserer partner können, schema to import operation fails and join information about all links but will use. Select a sql developer data sources configured in some constraint, see it also provided interface tables see in table of schema sql. Create view can now we have any dam which lets you? Select view_definition from sysobjects tableobj, see in table of schema sql server query below or sql standard, see various submenus, utilizzare il nostro traffico.
    [Show full text]