Soapam Client Documentation

Total Page:16

File Type:pdf, Size:1020Kb

Soapam Client Documentation SOAPam Client Documentation This documentation is for SOAPam Client version 3.1. Not using this version? See Other Documentation Versions. Welcome to the documentation center for SOAPam Server by NuWave Technologies. You may navigate through the documentation using any of these methods: The table of contents The navigation links in the sidebar to the left The quick links shown below The search bar in the page header If you have comments, corrections, or questions about the product that are not answered here, please email [email protected] or submit a support ticket. Getting Started What is SOAPam Client Installing SOAPam Client For Developers The Developer's Guide Creating and Editing the Client Definition File Accessing Secure Web Services For Administrators The Administrator's Guide Installing SOAPam Client Managing SOAPam Client Command Line Reference Release Notes Table of Contents Table of Contents What is SOAPam Client Administrator's Guide Installing SOAPam Client Managing SOAPam Client Running the Client Process Collecting Process Statistics Using Configuration Files Configuration File Format Log Configuration Message Dump Configuration Statistics Configuration Common Configuration Options Event Message Reference Developers Guide Creating and Editing the Client Definition File Configuring the Client Process Generating IPM Definitions Generating DDL from a CDF Element Name Considerations Generating IPM Definitions from DDL Calling a Web Service Method Web Service Requests Web Service Replies Using the Stream Protocol Accessing Secure Web Services Using HTTP Authentication Using Client Certificates Using Credential Files Using the MAKECF Utility Using Secure Connections Using W-S Security and WS-Addressing Client Definition File Reference Schema Reference <binding> element <body> element <definitions> element <element> element <header> element <message> element <messages> element <part> element <request> element <response> element <service> element <soapMessage> element <type> element <types> element Built-in Types Character Encodings Command Line Reference CDF2DDL MAKECF SOAPAMCP STATSCON WSDL2CDF Glossary Release Notes Upgrade Considerations Upgrade Guide Product Licensing Cumulative Change Log Third Party Software Licenses Standards Compliance How to Obtain Support Other Documentation Versions View as PDF What is SOAPam Client The SOAPam Client allows NonStop applications to access, or "consume", Web services on any platform anywhere in the world. SOAPam hides the complexity of TCP/IP, HTTP, SSL and SOAP required to participate in Web services.Your NonStop application simply sends a formatted interprocess message (IPM) to the SOAPam Client Process (SOAPAMCP) which handles all of the details of mapping the IPM elements to a SOAP envelope, exchanging the SOAP envelope with the Web service provider, and parsing the SOAP response into the reply IPM. What is a Web Service? A Web service is a collection of software "methods" that can be invoked (called) through a network by a client application using the SOAP protocol. Methods typically accept one or more parameters, perform some action and return one or more parameters.An example of a Web service might be a "BankingService" that provides methods such as "getAccountBalance", "debitAccount" and "creditAccount". For example, the "getAccountBalance" method might require an "accountNumber" parameter as input and return a "balance" parameter as output. SOAPam Client Components The diagram below depicts the SOAPam Client components as they are used at design time (during client application development) and at run time. The components of the SOAPam Client product are described below: Client Process (SOAPAMCP) The Client Process relays messages sent from client applications through NonStop’s native inter-process message system to Web services anywhere in the world. SOAPAMCP hides the complexity of the TCP/IP, HTTP, SSL and SOAP protocols required to participate in Web services. When you start the SOAPAMCP process, you specify the name of a Client Definition File (CDF) that contains a description of the Web service you want to access. The CDF is an XML-formatted text file that you create using the WSDL2CDF utility. The SOAPAMCP process can be run as a standalone named process or configured as a Pathway serverclass for scalable access to the target Web service. WSDL2CDF Utility The WSDL2CDF utility creates a Client Definition File (CDF) by reading the Web Service Description Language (WSDL) file that describes the target Web service and augmenting it with mapping information. The Client Definition File (CDF) contains all of the information needed by the SOAPAMCP process to map a request IPM to a Web service request and map the Web service response back to an reply IPM. CDF2DDL Utility Your NonStop application interfaces with the SOAPAMCP process through the native interprocess message system. The format of the request and response interprocess messages (IPMs) used must correspond precisely to the definitions in the CDF file. The CDF2DDL utility facilitates this by producing NonStop DDL source for the IPMs. You then use the NonStop DDL utility to produce the host language-specific definitions that you compile into your application. Administrator's Guide Installing SOAPam Client This section contains all the information you need to install SOAPam Client. Installation Prerequisites Obtaining the Software Selecting an Installation Volume Extracting the Release Files Obtaining and Installing a License Testing the Installation Installation Prerequisites Please refer to the Release Notes for the latest information. The Release Notes can be viewed at the NuWave Technologies Support Center. SOAPam Client requires the following HP NonStop Server software: HP NonStop™ Kernel D48/G06.15/H06.09 or later HP NonStop TCP/IP HP NonStop TM/MP Although not required, SOAPam integrates with these products, if installed: HP Data Definition Language HP TCP/IP Parallel Library, or TCP/IPv6 Obtaining the Software SOAPam Client is distributed as single PAK file which you can download over the Internet. To download the software, use your Web browser to visit the NuWave Technologies Download Center. Click the hyperlink to download the PAK file to your desktop system, then use FTP to upload the file to your NonStop Server (be sure to use binary transfer mode). Note that the PAK file name is in the format CRmnppa where: mnpp indicates the version number in the form major.minor.patch, e.g., 3001 indicates release 3.0.1 a indicates the target architecture, where R indicates TNS/R (S-Series) and E indicates TNS/E (H and J series). Selecting an Installation Volume The SOAPam program files require approximately 30 megabytes of disk space and may be installed on any volume with sufficient space. Extracting the Release Files After copying the WCSPAK PAK file to your NonStop Server, perform the following steps at a TACL prompt. Note that you should substitute the correct PAK file name for your system architecture (WSCPAKR for TNS/R or WSCPAKE for TNS/E).: 1. If you are upgrading an existing installation of SOAPam Client, stop any SOAPAMCP processes running from the current subvolume. This may require shutting down any Pathway systems that are running the SOAPAMCP process as a server. tacl> STATUS *, PROG SOAPAMCP 2. Extract the release files from the archive by running WSCPAK: tacl> UNPAK PAKFILE, (*.*.*), VOL $volume.subvolume, MYID, LISTALL where $volume.subvolume specifies the location to store the extracted files. Because the UNPAK program uses the Guardian RESTORE utility, you must have "execute" permission for that program. If you are extracting the the TNS/E version, specify WSCPAKE instead of WSCPAKR. 3. You may delete the PAK file at this time if you wish: tacl> PURGE PAKFILE Obtaining and Installing a License SOAPam Client requires the installation of a license. The license is installed in an edit file on the NonStop Server which is read by the SOAPAMCP program to validate the installation. If you have purchased the product your license will be delivered via email. If you are using a trial copy of the product, trial licenses may be requested at the NuWave Technologies License Center. You must know your system number in order to request a trial license. The system number can be determined using the NonStop SYSINFO program which can be run from the TACL prompt: tacl>SYSINFO SYSINFO - T9268H01 - (01 OCT 2004) SYSTEM \NSKNODE Date 07 Jan 2015, 12:00:00 Copyright 2003 Hewlett-Packard Development Company, L.P. System name \NSKNODE EXPAND node number 001 Current SYSnn SYS00 System number 012345 Software release ID H06.nn Note that when requesting a license from the License Center you must enter all digits of the license including the leading '0's. Once your trial license is delivered via email install the license using the procedure outlined in the section Product Licensing. Testing the Installation The SOAPam Client software includes a TACL routine that tests the installation by connecting to the EchoString sample web service on NuWave's SOAPam demonstration server. You can test your installation by entering the following command at the TACL prompt: Note that. in order to run this test, your NonStop system must have access to the Internet. tacl> run ECHOTEST SOAPam(tm) Client - Echo String Test This TACL routine uses the SOAPam Client Process to access the EchoString service at http://soapam.nuwavetech.com. Starting the SOAPam Client Process ... Sending a request to the EchoString service ... Checking the
Recommended publications
  • HP Integrity Nonstop Operations Guide for H-Series and J-Series Rvus
    HP Integrity NonStop Operations Guide for H-Series and J-Series RVUs HP Part Number: 529869-023 Published: February 2014 Edition: J06.03 and subsequent J-series RVUs and H06.13 and subsequent H-series RVUs © Copyright 2014 Hewlett-Packard Development Company, L.P. Legal Notice Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Export of the information contained in this publication may require authorization from the U.S. Department of Commerce. Microsoft, Windows, and Windows NT are U.S. registered trademarks of Microsoft Corporation. Intel, Pentium, and Celeron are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Java® is a registered trademark of Oracle and/or its affiliates. Motif, OSF/1, Motif, OSF/1, UNIX, X/Open, and the "X" device are registered trademarks, and IT DialTone and The Open Group are trademarks of The Open Group in the U.S. and other countries. Open Software Foundation, OSF, the OSF logo, OSF/1, OSF/Motif, and Motif are trademarks of the Open Software Foundation, Inc.
    [Show full text]
  • Sun Storagetek Operations Manager 6.0 Installation Guide
    Sun StorageTek™ Operations Manager 6.0 Installation Guide Sun Microsystems, Inc. www.sun.com Part No. 817-7922-16 January 2008, Revision A Submit comments about this document at: http://www.sun.com/hwdocs/feedback Copyright 2002-2007 Hewlett-Packard Development Company, L.P., 3000 Hanover Street, Palo Alto, California 94304 , U.S.A. All rights reserved. Copyright 2002-2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries. This document and the product to which it pertains are distributed under licenses restricting their use, copying, distribution, and decompilation. No part of the product or of this document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and in other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun logo, AnswerBook2, docs.sun.com, Sun StorageTek , Java, and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S.
    [Show full text]
  • Quickspecs HP Nonstop S-Series Servers
    RETIRED: Retired products sold prior to the November 1, 2015 separation of Hewlett-Packard Company into Hewlett Packard Enterprise Company and HP Inc. may have older product names and model numbers that differ from current models. QuickSpecs HP NonStop S-series Servers Overview Inside view of components within a NonStop S-series Enclosure. Components The basic building blocks for the NonStop S-series Servers are listed in this section. A single type of enclosure (cabinet) can house processors or serve as an I/O enclosure. This document includes information to help you determine which NonStop S-series Server components best suit your computing needs (see figure). I/O and communications components for NonStop S-series Servers include disk, tape, printer, and communications devices. All of these devices and the Metrocluster for NonStop Server are listed in this section. All orders need to be processed using the latest version of the Quote Management System (QMS) to check for correct configuration and to produce manufacturing build documents. The manufacturing build documents, called tech docs, must be produced for manufacturing to implement the correct configuration. DA - 12157 Worldwide — Version 1 — February 1, 2005 Page 1 RETIRED: Retired products sold prior to the November 1, 2015 separation of Hewlett-Packard Company into Hewlett Packard Enterprise Company and HP Inc. may have older product names and model numbers that differ from current models. QuickSpecs HP NonStop S-series Servers Components - Processors 1974-x NonStop S88000 Processor
    [Show full text]
  • HP Nonstop Servers
    HP NonStop Servers Software Product Maintenance List Effective Date: January 2012 This document provides information regarding the support status of HP NonStop Server software products. It indicates which suport activities are or are not available for individually licensed software products based upon where in its product life cycle that product may be. The Software Product Maintenance List (SPML) addresses only those services provided to customers under the provisions of a Hewlett- Packard software support agreement. Accordingly, the maintenance level definitions are changed as of April 2003 to reflect this focus on support agreement services. Maintenance level definitions ACTIVE: All customer reported defects are analyzed. Repair action taken as appropriate. MATURE: All customer reported defects are analyzed. Repair action taken as appropriate for defects categorized as Critical (i.e. the system or application is down or at high risk; business cannot be conducted, or there are continual failures, or data corruption). LIMITED (formerly Discontinued): All customer reported defects are analyzed. Support actions limited to: - Existing fixes provided - Workarounds to known problems provided - Responses to setup, usage, and configuration questions. OBSOLETE: The product has reached the end of its service life. No support services are available for the product. For SUT-based products, at least 12 months advance notice prior to classifying a product Obsolete will be provided. For Independent Products, a minimum of 6 months notice when there is a successor product will be provided. For RVU maintenance level, the Obsolete status is equivalent to EOSL for hardware. The format is comprised of rows and columns: Products are contained in the rows; column headers contain the four statuses.
    [Show full text]
  • Backbox User Guide
    BackBox® E4.07 User Guide Edition: H06.06, J06.06 or L06.06 RVUs, or subsequent H-series, J-series or L-series RVUs Legal Notice © Copyright 2019 ETI-NET Inc. All rights reserved. Confidential computer software. Valid license from ETI-NET Inc. required for possession, use or copy- ing. The information contained herein is subject to change without notice. The only warranties for ETI-NET- products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. ETI-NET shall not be liable for technical or editorial errors or omissions contained herein. BackBox, BackPak, BackHome, BCOM, HCOM, EZX-Gateway, and BackLib are registered trademarks of ETI-NET Inc. StoreOnce is a registered trademark of Hewlett Packard Development, L.P. Microsoft, Windows, and Windows NT are U.S. registered trademarks of Microsoft Corporation. Tivoli Storage Manager (TSM) is a registered trademark of IBM Corporation. QTOS is a registered trademark of Quality Software Associates Inc. All other brand or product names, trademarks or registered trademarks are acknowledged as the prop- erty of their respective owners. This document, as well as the software described in it, is furnished under a License Agreement or Non- Disclosure Agreement. The software may be used or copied only in accordance with the terms of said Agreement. Use of this manual constitutes acceptance of the terms of the Agreement. No part of this manual may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, and translation to another programming language, for any purpose without the written permission of ETI-NET Inc.
    [Show full text]
  • Zero Latency Enterprise Business Benefits
    HP Operations Management Bundle for NonStop servers Data sheet A management software suite for HP NonStop servers with simplified monitoring that puts you in control. The management of HP NonStop servers is an important component of application availability. The HP Operations Management Bundle for NonStop servers is a suite of operations management software products that puts you in control. These products provide extensive monitoring of the NonStop server, the presentation of system status through events and graphics, an easy and powerful command and control environment, and the flexible mobility offered by the HP iPAQ Pocket PC. The suite includes • HP Availability Stats and Performance (ASAP), powerful availability monitoring software • HP Web ViewPoint, flexible operator interface software • HP Pocket ViewPoint, mobile system management software Implementation of these software products provides proactive system management, improved response time, and assurance of continuous operations for NonStop servers. Key features and benefits • Online monitoring of object status and performance • Alerting of down objects and performance bottlenecks • Historical reporting of system object status and performance • Simplified monitoring using a graphical user interface • Availability objectives monitoring • Web-based Event Management Service event monitoring and display • Web-based managing of NonStop server subsystems and user applications in a secure, automated, and customizable way • Web-based monitoring and graphing of performance attributes and trends • Flexible and secure Web access • Mobile EMS event monitoring • Mobile TACL interface • Mobile trend analyzer • Mobile EMS event query ASAP software HP Availability Stats and Performance (ASAP) software monitors the status and performance of a whole network of NonStop servers. ASAP software was developed to provide a uniquely integrated, extensible infrastructure for monitoring the availability and performance of system and application objects.
    [Show full text]
  • OSM Configuration Guide
    OSM Configuration Guide HP Part Number: 527273-040 Published: February 2014 Edition: J06.03 and subsequent J-series RVUs and H06.03 and subsequent H-series RVUs © Copyright 2014 Hewlett-Packard Development Company, L.P. Legal Notice Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Export of the information contained in this publication may require authorization from the U.S. Department of Commerce. Microsoft, Windows, and Windows NT are U.S. registered trademarks of Microsoft Corporation. Intel, Pentium, and Celeron are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Java is a U.S. trademark of Sun Microsystems, Inc. Motif, OSF/1, UNIX, X/Open, and the "X" device are registered trademarks, and IT DialTone and The Open Group are trademarks of The Open Group in the U.S. and other countries. Open Software Foundation, OSF, the OSF logo, OSF/1, OSF/Motif, and Motif are trademarks of the Open Software Foundation, Inc. OSF MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THE OSF MATERIAL PROVIDED HEREIN, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
    [Show full text]
  • Catalogue Services De Formation HP 2013 Introduction
    Catalogue Services de formation HP 2013 Introduction Introduction La formation, clés du succés de vos projets informatiques ! Le développement des connaissances est le meilleur moyen d'améliorer la productivité de vos collaborateurs, particulièrement lors de transitions technologiques. Grâce à notre expérience de plus de 30 ans consacrée à répondre aux besoins de formation de nos clients à travers le monde, nous permettons aux professionnels de l’IT et aux organisations d’obtenir des résultats tangibles de manière simple, efficace et flexible. Nous formons plus de 200 000 personnes chaque année, et les aidons ainsi à exploiter leur plein potentiel. Notre offre de formation technique, leader sur le marché, regroupe plus de 200 formations dispensées par des instructeurs et 3 000 formations en ligne qui couvrent l’infrastructure, les logiciels et les systèmes d’exploitation HP, ainsi que des formations cértifiées VMware, Microsoft et Linux. Que vous ayez besoin de formation en présentiel (inter et intra entreprise) ou à distance (RAIL, WBT), notre flexibilité et nos infrastructures nous permettent de concevoir des solutions de formation adaptées à vos délais, à vos éxigences et aux besoins spécifiques de votre entreprise. Nous proposons également un large choix de solutions de formation et d'apprentissage s'inscrivant dans le cadre de certifications professionnelles et techniques. En éspérant avoir prochainement le plaisir de répondre à vos besoins en formation ! Bien cordialement, L'équipe HP Formation 2 Accueil Impression E-mail Plein écran Page précédente Page suivante Accompagnement aux changements Accompagement aux Changements HP Formation propose des solutions complètes conçues autour des personnes, des processus et des technologies et qui sont développées autour de vos besoins, de votre culture et de votre environnement.
    [Show full text]
  • Open System Services Management and Operations Guide
    Open System Services Management and Operations Guide Abstract This guide describes how to manage and operate the HP NonStop™ operating system Open System Services (OSS) environment. Product Version OSS Monitor T8622H02, T8622G12 Supported Release Version Updates (RVUs) This guide supports G06.27 and all subsequent G-series RVUs and H06.06 and all subsequent H-series RVUs until otherwise indicated by its replacement publication. Part Number Published 527191-004 May 2006 Document History Part Number Product Version Published 527191-002 OSS Monitor T8622H01, T8622G11 July 2005 527191-003 OSS Monitor T8622H01, T8622G12 September 2005 527191-004 OSS Monitor T8622H02, T8622G12 May 2006 Open System Services Management and Operations Guide Glossary Index Figures Tables What’s New in This Guide xiii Guide Information xiii New and Changed Information xiii About This Guide xv What This Guide Is About xv Who Should Read This Guide? xv What This Guide Does Not Cover xv What Is in This Guide? xvi Related Reading, Training, and Services xvii Unsupported Utilities xix Acknowledgment xx Notation Conventions xx 1. Introducing Open System Services The Operating System Environments 1-1 Management Tools 1-2 Management and Operations Tasks 1-3 OSS File System Concepts 1-5 OSS Files 1-6 The /G Directory 1-7 The /E Directory 1-7 The /dev Directory 1-8 Components to Be Managed 1-9 Input/Output Utilities 1-9 OSS Security 1-9 OSS File-System Components 1-10 Interprocess Communication Facilities 1-11 Hewlett-Packard Company—527191-004 i Contents 2. Operating the
    [Show full text]