ZosRelease

The ZosRelease object represents a ChangeMan ZMF release (ERO). This object can be obtained using either the GetRelease method or the GetReleases method of ZosChangeManInstance.

ZosRelease Properties

ZosRelease exposes the following properties:

Property	Type	R/W	Description
Name	String	R	Name of the release.
Path	String	R	Full path name of the release.
ChangeManInstance	ZosChangeManInstance	R	ChangeMan instance.
CreatorUserID	String	R	Creator user ID.
Description	String	R/W	Release description.
RequestorName	String	R/W	Requestor name.
RequestorPhone	String	R/W	Requestor telephone number.
WorkRequest	String	R/W	Work request number or name.
Department	String	R/W	Department number or name.
ImplementationInstructions	String	R/W	Parent super or complex package.
OtherProblemAction	String	R/W	Other problem action description.
ProblemActionType	ZosProblemActionType	R/W	Problem action type.
Status	ZosReleaseStatus	R	Release status.
AuditReturnCode	Int32	R	Audit return code.
FromInstallTime	DateTime	R	Starting install date and time.
ToInstallTime	DateTime	R	Ending install date and time.
CreatedTime	DateTime	R	Date and time release was created.
BlockedTime	DateTime	R	Date and time release was blocked.
ApprovedTime	DateTime	R	Date and time release was approved.
RejectedTime	DateTime	R	Date and time release was rejected.
RevertedTime	DateTime	R	Date and time release was reverted.
InstalledTime	DateTime	R	Date and time release was installed.
BackedOutTime	DateTime	R	Date and time release was backed out.
BaselinedTime	DateTime	R	Date and time release was baselined.
MemoDeletedTime	DateTime	R	Date and time release was memo deleted.
Approvers	ZosReleaseApprover[]	R	Approvers for the release.

ZosRelease Methods

ZosRelease exposes the following methods:

Approve Method

Approve a release.

void  Approve(  
        String entity  
    ) 

Block Method

Blocks the release.

void Block() 

...

GetApplicationNames Method

Gets an array of application names that are joined to this release.

String[]  GetApplicationNames() 

GetPackage Method

Get a package name.

ZosPackage  GetPackage( String name )

GetPackages Method

Gets array of all packages attached to the release.

ZosPackage[]  GetPackages()

GetReleaseArea Method

Get a release area by area name.

ZosReleaseArea  GetReleaseArea(  
        String name  
        )

GetReleaseAreas Method

Gets array of all the release areas.

ZosReleaseArea[]  GetReleaseAreas()

Refresh Method

Refreshes the release information.

void  Refresh() 

Reject Method

Reject a release approval. The reason is single string, but can contain multiple lines, delimited by newline characters. If a line exceeds 72 characters, the text will automatically be split on word boundaries into multiple lines.

void Reject(  
        String entity,  
        String reason  ) 

Revert Method

Reverts a release to development status. The reason is a single string, but can contain multiple lines, delimited by newline characters. If a line exceeds 72 characters, the text will automatically be split on word boundaries into multiple lines. The job card is used only when a remote site is specified. If the job card, contains multiple lines, they should be separated by a newline character.

Overloads

Revert(String)

void Revert(  
        String reason  
    ) 

...

Revert(String, String, String)

void Revert(  String reason,  String site,  String jobCard  ) 

...

SetInstallTime Method

Updates start and end install times for the release.

void  SetInstallTime(  
        DateTime fromTime,  
        DateTime toTime  
        ) 

Test Method

Test release for errors, and optionally, perform automatic cleanup of packages and components. cleanupEmptyPackage - Detach empty packages from the release cleanupCmpFromDiffPkg - If different versions of a component exist in different packages, the version not checked into the release will be deleted from the package cleanupNotCheckedInCmp - Delete components from the package, if they were not checked into the release jobCard - Jobcards to use for automatic cleanup

Overloads

ZosTestReleaseResult[] Test()

ZosTestReleaseResult[] Test()

...

Test(Boolean, Boolean, Boolean, String)

ZosTestReleaseResult[]  Test(  
        Boolean cleanupEmptyPackage,  
        Boolean cleanupCmpFromDiffPkg,  
        Boolean cleanupNotCheckedInCmp,  
        String jobCard
        ) 

...

Unblock Method

Unblocks the release.

void  Unblock()

ZosRelease Examples

Examples of using ZosRelease are shown below.

C

ZosRelease release;
ZosReleaseArea area = release.GetArea(“QA”);
ZosReleasePackage[] packages = release.GetPackages();
release.RequestorName = “Mickey Mouse”;
release.Revert(“Terrible design”);

...

C++

ZosRelease^ release;
ZosReleaseArea area = release->GetArea(“QA”);
array<ZosReleasePackage^>^ packages = release->GetPackages();
release->RequestorName = “Mickey Mouse”;
release->Revert(“Terrible design”);

...

Visual Basic

Dim release as ZosRelease
Dim area As ZosReleaseArea = release.GetSite(“QA”)
Dim packages () As ZosPackage = release.GetPackages()
release.RequestorName = “Mickey Mouse”
release.Revert(“Terrible design”)

...

Jscript

var release : ZosRelease;
var area: ZosReleaseArea = release.GetSite(“QA”);
var packages : ZosPackage[] = release.GetPackages();
release.RequestorName = “Mickey Mouse”;
release.Revert(“Terrible design”);

...