MVS samples tutorial

MVS samples tutorial

This section provides examples for creating, testing, and consuming MV Web Services based on subroutine calls and AQL statements.

The MVS Toolkit is used to create and test the web services. After they are created, the web services can be consumed by a number of different clients including .NET, Java, and JavaScript.

Client examples in .NET C-sharp, .NET Visual BASIC, and Java are included with the MVS Toolkit installer and are highlighted here.

All client examples are located in the <MVS.install.dir>\samples\ folder of your installation.

Important: To run this tutorial, you must update the MVDEMO account. To update the MVDEMO account:
  1. Log into the MVDEMO account.
  2. Download the TOOLKITDEMO.D3P patch file from the Rocket Customer Portal.

    To download this file, navigate to Rocket MVS ToolKit in the Downloads section of the Customer Portal and click the MVS ToolKit 2.0.0 link.

  3. Complete one of the following steps:
    • For Windows: Create a tape device that points to the pseudo image.
    • For UNIX: Change to a tape device that points to the pseudo image.
  4. Run the set-device n command where n is the device number that was created or changed.
  5. Run the t-load md (o command.
  6. Run the patch command.

The DEMO.BP file in the MVDEMO account contains additional subroutines that serve as coding examples for MVSP in general and are not valid for Web service examples for the MVS Toolkit. Some of these additional subroutines will appear to function, but produce erroneous results. When building test Web services using the MVS Toolkit, use the subroutines provided in the DEMO.BP specifically referenced in this MVS Toolkit tutorial or use new subroutines developed specifically for use as Web services.

  1. Creating MV web services
    In this example, you create a Web Service that provides the following Web Service Operations:
  2. Testing MV web services
    After the Web Service Operations have been created, they can be tested by running the Test Web Service utility from the Web Services menu.
  3. Consuming MV web services
    This section illustrates creating C-Sharp and Visual BASIC projects that consume MV Web Services. Also included is the Java client code used to invoke the mvs Web Service.