ZosApplication

The ZosApplication object represents a ChangeMan ZMF application. This object can be obtained using either the GetApplication method or the GetApplications method of ZosChangeManInstance.

ZosApplication Properties

ZosApplication exposes the following properties:

Property	Type	R/W	Description
Name	String	R	Name of the application.
Path	String	R	Full path name of the application.
ChangeManInstance	ZosChangeManInstance	R	Parent ChangeMan instance for this application.
Description	String	R	Description of the application.
BaselineMemberFilters	ZosNameFilters	R	Collection of member name filters for baseline libraries.
PackageMemberFilters	ZosNameFilters	R	Collection of member name filters for package libraries.
PackageMemberFilters PromotionMemberFilters	ZosNameFilters4	R	Collection of member name filters for promotion libraries.

ZosApplication Methods

ZosApplication exposes the following methods:

GetBaselineLibrary Method

Gets a single baseline library by name.

ZosBaselineLibrary GetBaselineLibrary(
    String libType
)

GetBaselineLibraries Method

Gets an array containing the baseline libraries for the application.

ZosBaselineLibrary[] GetBaselineLibraries()

GetComponentHistory Method

Gets a list of component history records for a given component.

All arguments are optional.

ZosComponentHistory[]  GetComponentHistory(  
    String componentType, [opt]  
    String componentName, [opt]  
    ZosComponentHistoryType type, [opt]  
    String package, [opt]  
    ZosComponentHistoryStatus flags,  
    DateTime fromChangeDate, [opt]  
    DateTime toChangeDate, [opt]  
    DateTime fromBaselineDate, [opt]  
    DateTime toBaselineDat [opt] 
)

Parameters

componentType - Component type filter

componentName - Component name filter

ZosComponentHistoryType - Indicates type of history list to be returned

package - Package name filter

ZosComponentHistoryStatus - History status

fromChangeDate - Components changed after this date

toChangeDate - Components changed before this date

fromBaselineDate - Packages baselined after this date

toBaselineDat - Packages baselined before this date

GetPackage Method

Gets a single package by name.

ZosPackage  GetPackage( String packageName)

GetPackages Method

Gets an array of packages.

The applications can optionally be filtered by package levels, package types, package status, department numbers, install date range, or package number range.

If filtering by department number, the department numbers in the list can contain wild characters. See the section on wild characters for details.

Overloads

GetPackages( )

ZosPackage  GetPackages( )

...

GetPackages(ZosPackageLevelFlags, ZosPackageTypeFlags, ZosPackageStatusFlags)

ZosPackages[] GetPackages(
    ZosPackageLevelFlags levelFlags,
    ZosPackageTypeFlags typeFlags,
    ZosPackageStatusFlags statusFlags
    )

...

GetPackages(String[] )

ZosPackages[] GetPackages(
    String[] departments
    )

...

GetPackages(DateTime, DateTime )

ZosPackages[] GetPackages(
    DateTime minInstallDate,
    DateTime maxInstallDate
    )

...

GetPackages(Int32, Int32)

ZosPackages[] GetPackages(
    Int32 minPackageNumber,
    Int32 maxPackageNumber
    )

...

GetPackages(ZosPackageLevelFlags, ZosPackageTypeFlags, ZosPackageStatusFlags, String[] )

ZosPackages[] GetPackages(
    ZosPackageLevelFlags levelFlags,
    ZosPackageTypeFlags typeFlags,
    ZosPackageStatusFlags statusFlags,
    String[] departments
    )

...

GetPackages(ZosPackageLevelFlags, ZosPackageTypeFlags, ZosPackageStatusFlags, String[], DateTime, DateTime )

ZosPackages[] GetPackages(
    ZosPackageLevelFlags levelFlags,
    ZosPackageTypeFlags typeFlags,
    ZosPackageStatusFlags statusFlags,
    String[] departments,
    DateTime minInstallDate,
    DateTime maxInstallDate
    )

...

GetPackages(ZosPackageLevelFlags, ZosPackageTypeFlags, ZosPackageStatusFlags, String[], DateTime, DateTime, Int32, Int32 )

ZosPackages[] GetPackages(
    ZosPackageLevelFlags levelFlags,
    ZosPackageTypeFlags typeFlags,
    ZosPackageStatusFlags statusFlags,
    String[] departments,
    DateTime minInstallDate,
    DateTime maxInstallDate,
    Int32 minPackageNumber,
    Int32 maxPackageNumber
    )

...

GetPromotionLevel Method

Gets a promotion level, given the site name and promotion name or level number.

Overloads

GetPromotionLevel(String, String)

ZosPromotionLevel  GetPromotionLevel(
    String siteName,  
    String promotionName  
) 

...

GetPromotionLevel(String, Int16)

ZosPromotionLevel  GetPromotionLevel(
    String siteName,  
    Int16 promotionLevel  
)

...

GetPromotionSites Method

Gets an array containing the promotion sites for the application.

ZosPromotionSite[] GetPromotionSites()

GetPromotionSite Method

Gets a single promotion site by name.

ZosPromotionSite GetPromotionSite( String siteName )

GetSiteNames Method

Gets an array containing the site names defined for an application. String[] GetSiteNames( Boolean ipOnly [optional] )

Parameters

ipOnly – Requests only sites that have an IP address defined

ZosApplication Examples

Examples of using ZosApplication are shown below:

C

ZosApplication app;
ZosPackage package = app.GetPackage(“TEST000123”);
ZosPackage[] packages = app.GetPackages();

...

C++

ZosApplication^ app;
ZosPackage package = app.GetPackage(“TEST000123”);
array<ZosPackage^>^ packages = app.GetPackages();

...

Visual Basic

Dim app as ZosApplication;
Dim package As ZosPackage = app.GetPackage(“TEST000123”)
Dim packages() As ZosPackage = app.GetPackages()

...

Jscript

var app : ZosApplication;
var package : ZosPackage app = app.GetPackage(“TEST000123”);
var packages : ZosPackage [] = app.GetPackages();

...