Skip to content

About the ChangeMan ZDD .NET programming interface

Note

The ChangeMan ZDD .NET programming interface is similar to the older COM programming interface, but is more powerful and flexible. It is recommended that new programs utilize the .NET interface rather than the older COM interface.

Through the .NET interface, ChangeMan ZDD exposes its functionality as a set of programmable objects. Each object can be programmatically examined and controlled. examples of ChangeMan ZDD objects are: network, servers, ChangeMan instances, and folders.

Each object exposes a set of properties and methods. A property is an attribute of an object that can be set or retrieved. A method is a function that performs some action on an object. For a server object, examples of properties are server name or IP address; examples of methods for a server object are logon or logoff.

A special type of object is a collection object, which contains a set of other objects. A servers object is a collection of server objects, and a folders object is a collection of folder objects.

Languages

The ChangeMan ZDD .NET interface allows ChangeMan ZDD operations to be performed from C#, C++/CLI, Visual Basic .NET, J#, JScript .NET, or any other language that supports .NET. Following are some typical operations you can perform from a program or script:

In this document, examples are shown in the following order:

  • C#

  • C++/CLI

  • Visual Basic

  • JScript .NET

Other languages may be used as well, but examples are not given.

Note

JScript .NET files must be compiled using the “jsc” compiler. The WSH (Windows Script Host) that was used to run older JScript files does not support the .NET environment.

Programming Samples

There are several small programming samples installed in the ChangeMan ZDD “Samples” subdirectory. Some of these samples are described in Examples.

Additionally, there is a very large C# sample called “TestApi”, which is a console application that can be used to test all of the various API features. In “TestApi” you can find coding examples for virtually every function available in the programming interface. There is a pre-built copy of “TestApi.exe” in the ChangeMan ZDD installation directory.

Security

ChangeMan ZDD is compatible with RACF®, CA-ACF2®, and CA-Top Secret®.

Access to mainframe objects and functions is granted through your mainframe security system. You are required to provide your user ID and password in ChangeMan ZDD to connect to the mainframe.

The operation of ChangeMan ZDD does not affect the existing operation of either mainframe-based applications or PC network operations.

Compatibility

PC Requirements

  • Windows® operating system

  • Microsoft® .NET Framework 4.0

Note

Refer to the Readme for the supported versions.

Mainframe Server Requirements

  • ChangeMan ZDD server installed on the mainframe LPARs to be accessed by ChangeMan ZDD on your PC.

  • IBM® z/OS® operating system (any version supported by IBM).

  • TCP/IP must be installed and running.

ChangeMan ZMF Requirements

One of the following releases are required for accessing ChangeMan ZMF functionality from your program or script:

  • ChangeMan ZMF 8.1 - any release

  • ChangeMan ZMF 7.1 - any release

  • ChangeMan ZMF 6.1 - any release

Note

When using ChangeMan ZDD 8.1.4 with earlier releases of ChangeMan ZMF, only the functionality supported within that ChangeMan ZMF release will be available.

Back to top