ZosChangeManInstance

The ZosChangeManInstance object represents a single ChangeMan instance on the server. This object can be obtained using the ChangeManInstance property of ZosServer or the Item property of ZosChangeManInstances.

ZosChangeManInstance Properties

ZosChangeManInstance exposes the following properties:

Property	Type	R/W	Description
Name	String	R	Name of the ChangeMan instance.
Path	String	R	Full path name of the ChangeMan instance.
Server	ZosServer	R	Parent server for this ChangeMan instance.
Port	Int32	R/W	I/P port number for ChangeMan instance.
UtcOffset	TimeSpan	R	Time zone offset from UTC. UTC + UtcOffset = Local
Today	DateTime	R	Current date on the server.
Description	String	R/W	ChangeMan description.
EnvironmentType	ZosEnvironmentTyp e	R	ChangeMan environment type.
Filters	ZosNameFilters	R	Collection of all application name filters for folder. Default is all applications.
FileFormatMappi ngs	ZosileFormatMappin gs	R	Collection of file format mappings for server.
EroLicensed	Boolean	R	Indicates whether ERO is licensed
EroSupported	Boolean	R	Indicates whether ERO functions are supported
IsHidden	Boolean	R/W	Indicates that this ChangeMan is hidden in the File Explorer and the ZDD user interface. This is a user-specific setting.

...

ZosChangeManInstance Methods

ZosChangeManInstance exposes the following methods:

GetApplication Method

Gets a single application by name.

ZosApplication  GetApplication(
        String appName
        )

GetApplications Method

Gets an array of applications.

Overloads

GetApplications(Boolean)

Gets an array of applications. Hidden applications can optionally be included.

ZosApplication[]  GetApplications(  
        Boolean includeHidden [optional] 
        )

GetApplications(String, Boolean)

Gets an array of applications. The applications can optionally be filtered by name. The filter string can contain ‘*’ and ‘?’ wild characters. Multiple filters can be specified, separated by spaces. Hidden applications can optionally be included.

ZosApplication[]  GetApplications( 
        String nameFilters, [optional]  
        Boolean includeHidden [optional] 
        )

GetReleases Method

Gets an array of releases. The releases can optionally be filtered by name. The filter string can contain ‘*’ and ‘?’ wild characters. Multiple filters can be specified, separated by spaces. Hidden releases can optionally be included.

Overloads

GetReleases(Boolean)

ZosRelease[]  GetReleases(
        Boolean includeHidden [optional] 
        )

...

GetReleases(String, Boolean)

ZosRelease[]  GetReleases(  
        String nameFilters, [optional]  
        Boolean includeHidden [optional] 
        )

...

GetPackages Method

Gets an array of packages that match search arguments. The packages can be filtered by package name, package levels, package types, package status, install date range, department, release, or promotion location. The package name filter contains one or more packages names, separated by semicolons. Each package name can be masked using the asterisk (*) wild character. Example: JOHN*;MARY*;JUDY\ |

ZosPackage[]  GetPackages( 
        String nameFilters, [optional] 
        ZosPackageLevelFlags levels, [optional] 
        ZosPackageTypeFlags  types, [optional] 
        ZosPackageStatusFlags  status, [optional] 
        DateTime  minInstallDate, [optional] 
        DateTime  maxInstallDate, [optional] 
        String  department, [optional] 
        String  release, [optional] 
        String  promotionSite, [optional] 
        String  promotionName [optional] 
        ) 

QueryImpact Method

Performs an impact analysis query.

Overloads

QueryImpact( ZosImpactRelationship, String, String, String [optional] )

ZosQueryImpactResult[] QueryImpact(
        ZosImpactRelationship rel,  
        String topComponent,  
        String topApp, [optional] 
        String topLibType [optional] 
        )

...

ZosQueryImpactResult[] QueryImpact(ZosImpactRelationship, String, String , String , String , String, String )

ZosQueryImpactResult[] QueryImpact(
         ZosImpactRelationship rel,  
         String topComponent, [opt]  
         String topApp, [opt]  
         String topLibType, [opt]  
         String bottomComponent,  
         String bottomApp, [opt]  
         String bottomLibType [opt] 
        ) 

...

ZosQueryImpactResult[] QueryImpact( ZosImpactRelationship, String, UInt32)

ZosQueryImpactResult[] QueryImpact(
        ZosImpactRelationship rel,  
        String topComponent,  
        UInt32 topBun 
)

...

ZosQueryImpactResult[] QueryImpact(ZosImpactRelationship, String, String, String, String, String, String, UInt32)

ZosQueryImpactResult[] QueryImpact(
        ZosImpactRelationship rel, 
        String topComponent, 
        String topApp, 
        String topLibType, 
        String bottomComponent, 
        String bottomApp, 
        String bottomLibType, 
        UInt32 topBun
)

...

SubmitXml Method

Submits XML request to ChangeMan.

void  SubmitXml(  
        String inputFileName,  
        String outputFileName  
        )

...

ZosChangeManInstance Examples

Examples of using ZosChangeManInstance are shown below:

C

ZosChangeManInstance changeman;
changeman.SubmitXml(“C:\XML\Request.xml”, “C:\XML\Response.xml”);
ZosApplication app = changeman.GetApplication(“DEMO”);
ZosApplication[] apps = changeman.GetApplications();
ZosApplication[] apps = changeman.GetApplications(“A* B*”);

...

C++

ZosChangeManInstance^ changeman;
changeman->SubmitXml(“C:\XML\Request.xml”, “C:\XML\Response.xml”);
ZosApplication app = changeman.GetApplication(“DEMO”);
array<ZosApplication^>^ apps = changeman.GetApplications();
array<ZosApplication^>^ apps = changeman.GetApplications(“A* B*”);

...

Visual Basic

Dim changeman As ZosChangeManInstance;
changeman.SubmitXml(“C:\XML\Request.xml”, “C:\XML\Response.xml”)
Dim app As ZosApplication = changeman.GetApplication(“DEMO”)
Dim apps() As ZosApplication = changeman.GetApplications()
Dim apps() As ZosApplication = changeman.GetApplications(“A* B*”)

...

Jscript

var changeman : ZosChangeManInstance;
changeman.SubmitXml(“C:\XML\Request.xml”, “C:\XML\Response.xml”);
var app : ZosApplication app = changeman.GetApplication(“DEMO”);
var apps : ZosApplication[] = changeman.GetApplications();
var apps : ZosApplication[] = changeman.GetApplications(“A* B*”);

...