Skip to content

RLSMRLSE SERVICE LIST

The RLSMRLSE SERVICE LIST message lists scheduler dates, times, and status for a named release.

The XML service/scope/message tags and attributes for this message are:

<service name="RLSMRLSE">
<scope name="SERVICE">
<message name="LIST">

These tags appear in both requests and replies.

RLSMRLSE SERVICE LIST — Request

The following example shows how you might code a request to list the scheduler dates, times, and status for a named release. Data structure details for the <request> tag follow the example.

Example XML — RLSMRLSE SERVICE LIST Request

<?xml version="1.0"?>
<service name="RLSMRLSE">
    <scope name="SERVICE">
        <message name="LIST">
            <header>
                <subsys>4</subsys>
                <test> </test>
                <product>CMN</product>
            </header>
            <request>
                <releaseParms> </releaseParms>
                <release>S4712010</release>
            </request>
        </message>
    </scope>
</service>

...

RLSMRLSE SERVICE LIST <request> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<release> Required 1 String (8), variable Release name.
<releaseParms> Required 1 String (1) Release parameters. Values:
A = ADMIN list. List all releases regardless of the release status.
blank = List only those releases that have fully configured release areas.

...

RLSMRLSE SERVICE LIST — Reply

The XML reply to a RLSMRLSE SERVICE LIST request returns one <result> data element, which lists status flags and other information for the release.

The standard <response> data element follows any <result> tags in the reply and indicates the success or failure of the request. Successful requests have a return code of 00. Unsuccessful requests have a return code of 04 or higher. Because it is the final data element in the XML reply message, the <response> tag serves as an end-of-list marker.

The following example shows what the reply message might look like. Data structure details for the <result> tag follow the example.

Example XML — RLSMRLSE SERVICE LIST Reply

<?xml version="1.0"?>
<service name="RLSMRLSE">
    <scope name="SERVICE">
        <message name="LIST">
            <result>
                <release>S4712010</release>
                <releaseDesc>Financial Accounting Release S4.V712 \#010</releaseDesc>
                <releaseStatus>DEV</releaseStatus>
                <releaseRequestorName>NATHAN CHOY</releaseRequestorName>
                <releaseRequestorPhone>808-555-1212</releaseRequestorPhone>
                <releaseRequestorDept>FINANCE</releaseRequestorDept>
                <releaseWorkChangeRequest>F5567792</releaseWorkChangeRequest>
                <releaseSchedulerCmn>Y</releaseSchedulerCmn>
                <releaseSchedulerManual>Y</releaseSchedulerManual>
                <releaseSchedulerOther>Y</releaseSchedulerOther>
                <releaseSchedulerType>MANUAL</releaseSchedulerType>
                <addReleaseInterfacingApprovers>Y</addReleaseInterfacingApprovers>

...

                <isReleaseAreasConfigured>Y</isReleaseAreasConfigured>
                <releaseSyslibOrder>A</releaseSyslibOrder>
                <auditEnforceIHASetting>N</auditEnforceIHASetting>
                <auditIgnoreHigherAreas>N</auditIgnoreHigherAreas>
                <isReleaseLinked>N</isReleaseLinked>
                <isAutoFixDevPackages>N</isAutoFixDevPackages>
                <isAutoFixFrzPackages>N</isAutoFixFrzPackages>
                <isReleaseInstallBuildJclPending>N</isReleaseInstallBuildJclPending>
                <isReleaseInstallPending>N</isReleaseInstallPending>
                <isReleaseRevertPending>N</isReleaseRevertPending>
                <isReleaseBackoutPending>N</isReleaseBackoutPending>
                <isReleaseApprovalPending>N</isReleaseApprovalPending> 
                <isReleaseBlockPending>N</isReleaseBlockPending>
                <releaseProblemActionCode>1</releaseProblemActionCode>
                <releaseAuditMinRule>0</releaseAuditMinRule>
                <releaseCheckinMinRule>0</releaseCheckinMinRule>
                <releaseBlockingMinRule>0</releaseBlockingMinRule>
                <releaseRetrieveMinRule>0</releaseRetrieveMinRule>
                <releaseApproveMinRule>0</releaseApproveMinRule>
                <releaseFromInstallDate>20131005</releaseFromInstallDate>
                <releaseFromInstallTime>000100</releaseFromInstallTime>
                <releaseDateCreated>20120312</releaseDateCreated>
                <releaseTimeCreated>123024</releaseTimeCreated>
                <releaseCreateUserid>KCAMPBE</releaseCreateUserid>
                <releaseToInstallDate>20131231</releaseToInstallDate>
                <releaseToInstallTime>235959</releaseToInstallTime>
                <releaseImplInst>All packages attached to this release will be installed on Saturday</releaseImplInst>
                <releaseImplInst>DEC 17, 2012. If there are problems with any part of this install</releaseImplInst>
                <releaseImplInst>call the Release Manager.</releaseImplInst>
                <releaseHighLevelName>CMNTP</releaseHighLevelName>
                <releaseDsnPattern>HRAPL</releaseDsnPattern>
                <releaseHighLevelPath>/cmntp</releaseHighLevelPath>
                <totalReleasePackages>00003</totalReleasePackages>
            </result>
            <response>
                <statusMessage>CMR8700I - Release Management service completed </statusMessage>
                <statusReturnCode>00</statusReturnCode>
                <statusReasonCode>8700</statusReasonCode>
            </response>
        </message>
    </scope>
</service>

...

RLSMRLSE SERVICE LIST <result> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<addReleaseInterfacingApprovers> Optional 0 - 1 String (1) Y = Add related approvers.
N = Do not add related approvers.
<auditEnforceIHASetting> Optional 0 - 1 String (1) Y = Enforce IHA setting.
N = Do not enforce IHA settings.
<auditIgnoreHigherAreas> Optional 0 - 1 String (1) Y = Ignore higher areas.
N = Do not ignore higher areas.
C = If the current release has only a single path through it, process as if "Y" had been specified. If the current release has multiple paths through it, process as if "N" had been specified.
<isAutoFixAprPackages> Optional 0 - 1 String (1) Y = Automatically cleanup APR packages.
N = Do not automatically cleanup APR packages.
<isAutoFixDevPackages> Optional 0 - 1 String (1) Y = Automatically cleanup DEV packages.
N = Do not automatically cleanup DEV packages.
<isAutoFixFrzPackages> Optional 0 - 1 String (1) Y = Automatically cleanup FRZ packages.
N = Do not automatically cleanup FRZ packages.
<isReleaseApprovalPending> Optional 0 - 1 String (1) Y = Release approval is pending.
N = Release approval is not pending.
<isReleaseAreasConfigured> Optional 0 - 1 String (1) Y = Release areas are configured.
N = Release areas are not configured.
<isReleaseBackoutPending> Optional 0 - 1 String (1) Y = Release backout is pending.
N = Release backout is not pending.
<isReleaseBlockPending> Optional 0 - 1 String (1) Y = Release block is pending.
N = Release block is not pending.
<isReleaseInstallBuildJclPending> Optional 0 - 1 String (1) Y = Release install JCL builds are pending.
N = Release install JCL builds are not pending.
<isReleaseInstallPending> Optional 0 - 1 String (1) Y = Release install is pending.
N = Release install is not pending.
<isReleaseLinked> Optional 0 - 1 String (1) Y = Release is linked.
N = Release is not linked.
<isReleaseRevertPending> Optional 0 - 1 String (1) Y = Release revert is pending.
N = Release revert is not pending.
<release> Optional 0 - 1 String (8), variable Release name.
<releaseApproveMinRule> Optional 0 - 1 Integer (1) Release minimum approval rule. Values:
0 = No approvals required.
1 = Approvals required before checkin.
2 = Approvals required before advancing to the next area (check-off).
3 = Rule 1 and rule 2.
<releaseAuditMinRule> Optional 0 - 1 Integer (1) Release area minimum audit rule. Values:
0 = Audit optional.
1 = Audit required. RC < 20 (audit failure).
2 = Audit required. RC <= 12 (out-of-sync errors within audited area).
3 = Audit required. RC <= 8 (out-of-sync errors with respect to next areas/final areas in prior releases/baseline).
4 = Audit required. RC < = 4 (no out-of-sync errors but some duplicates exist).
5 = Audit required. RC = 0 (no out-of-sync errors and no warnings).
<releaseAuditReturnCode> Optional 0 - 1 String (2) Release audit return code.
<releaseBackoutUserid> Optional 0 - 1 String (8), variable User ID of user who backed out release.
<releaseBlockUserid> Optional 0 - 1 String (8), variable User ID of user who blocked release.
<releaseBlockingMinRule> Optional 0 - 1 Integer (1) Release minimum blocking rule. Values:
0 = Wide open.
1 = Audit required.
2 = User must pass entity check (and rule 0).
3 = Rule 1 and rule 2.
<releaseBuildNumber> Optional 0 - 1 String (10), variable Release build number.
<releaseCheckinMinRule> Optional 0 - 1 Integer (1) Release minimum checkin rule. Values:
0 = Wide open.
1 = Area or package audit required before moving to next area.
2 = Area must be blocked (or package frozen) before moving to next area.
3 = User must pass entity check (and rule 0).
4 = Rule 1 and rule 2.
5 = Rule 1 and rule 3.
6 = Rule 2 and rule 3.
7 = Rule 1, rule2, and rule 3.
<releaseCreateUserid> Optional 0 - 1 String (8), variable User ID of user who created release.
<releaseDateApproved> Optional 0 - 1 Date, yyyymmdd Date that release was approved.
<releaseDateBackedOut> Optional 0 - 1 Date, yyyymmdd Date that release was backed out.
Optional 0 - 1 Date, yyyymmdd Date that release was baselined.
<releaseDateBlocked> Optional 0 - 1 Date, yyyymmdd Date that release was blocked.
<releaseDateCreated> Optional 0 - 1 Date, yyyymmdd Date that release was created.
<releaseDateDisReceived> Optional 0 - 1 Date, yyyymmdd Date that DEV site received all notifications that release was successfully distributed to all remote sites.
<releaseDateDistributed> Optional 0 - 1 Date, yyyymmdd Date that release was distributed.
<releaseDateInstalled> Optional 0 - 1 Date, yyyymmdd Date that release was installed.
<releaseDateMemoDeleted> Optional 0 - 1 Date, yyyymmdd Date that release was memo-deleted.
<releaseDateRejected> Optional 0 - 1 Date, yyyymmdd Date that release was rejected.
<releaseDateReverted> Optional 0 - 1 Date, yyyymmdd Date that release was reverted.
<releaseDesc> Optional 0 - 1 String (72), variable Release description.
<releaseDsnPattern> Optional 0 - 1 String (5), variable Release dataset name pattern.
<releaseFromInstallDate> Optional 0 - 1 Date, yyyymmdd Install start date.
<releaseFromInstallTime> Optional 0 - 1 Time, hhmmss Install start time.
<releaseHighLevelName> Optional 0 - 1 String (8), variable Release high-level qualifier.
<releaseHighLevelPath> Optional 0 - 1 String (1024), variable Release high-level HFS path.
<releaseImplInst> Optional 0 - 1 String (72), variable Release implementation instructions.
<releaseLibsAged> Optional 0 - 1 String (1) Y = Release libraries are aged.
N = Release libraries are not aged.
<releaseMemoDeleteUserid> Optional 0 - 1 String (8), variable User ID of user who memo-deleted release.
<releaseOtherProblemAction> Optional 0 - 1 String (72) Release other problem description.
<releaseProblemActionCode> Optional 0 - 1 String (1) Action to be taken if a problem occurs when a package is installed. Values: = Hold production and contact analyst. = Back out change and continue production. = Other
Optional 0 - 1 String (8), variable User ID of user who rejected release.
<releaseRequestorDept> Optional 0 - 1 String (8), variable Release requester department.
<releaseRequestorName> Optional 0 - 1 String (25), variable Release requester name.
<releaseRequestorPhone> Optional 0 - 1 String (15), variable Release requester phone number.
<releaseRetrieveMinRule> Optional 0 - 1 Integer (1) Release minimum retrieve rule. Values:
0 = Retrieve allowed from any area (blocked or unblocked).
1 = Retrieve allowed only from unblocked areas.
2 = Must pass entity check (and rule 0).
3 = Rule 1 and rule 2.
<releaseRevertUserid> Optional 0 - 1 String (8), variable User ID of user who reverted release.
<releaseSchedulerCmn> Optional 0 - 1 String (1) Y = Allow CMN internal release scheduler.
N = Do not allow CMN internal release scheduler.
<releaseSchedulerManual> Optional 0 - 1 String (1) Y = Allow manual release scheduler.
N = Do not allow manual release scheduler.
<releaseSchedulerOther> Optional 0 - 1 String (1) Y = Allow other release scheduler.
N = Do not allow other release scheduler.
<releaseReleaseSchedulerType> Optional 0 - 1 String (8), variable Release scheduler type. Values:
CMN = ChangeMan ZMF. The installation jobs are submitted by the ZMF started task at the scheduled install date and time.
MANUAL = Manual. The installation jobs are submitted as soon as the package approvals are completed.
OTHER = Other. The installation jobs are inserted into a third-party scheduler via a batch job.
<releaseStatus> Optional 0 - 1 String (3), variable Release status. Values:
APR = Approved
BAK = Backed out
BAS = Baselined
BLK = Blocked
DEL = Deleted
DEV = In development
DIS = Distributed
INS = Installed
REJ = Rejected
<releaseSyslibOrder> Optional 0 - 1 String (1) Release SYSLIB sort order. Values:
A = Ascending
D = Descending
<releaseTimeApproved> Optional 0 - 1 Time, hhmmss Time that release was approved.
<releaseTimeBackedOut> Optional 0 - 1 Time, hhmmss Time that release was backed out.
<releaseTimeBaselined> Optional 0 - 1 Time, hhmmss Time that release was baselined.
<releaseTimeBlocked> Optional 0 - 1 Time, hhmmss Time that release was blocked.
<releaseTimeCreated> Optional 0 - 1 Time, hhmmss Time that release was created.
<releaseTimeDisReceived> Optional 0 - 1 Time, hhmmss Time that DEV site received all notifications that release was successfully distributed to all remote sites.
<releaseTimeDistributed> Optional 0 - 1 Time, hhmmss Time that release was distributed.
<releaseTimeInstalled> Optional 0 - 1 Time, hhmmss Time that release was installed.
<releaseTimeMemoDeleted> Optional 0 - 1 Time, hhmmss Time that release was memo-deleted.
<releaseTimeRejected> Optional 0 - 1 Time, hhmmss Time that release was rejected.
<releaseTimeReverted> Optional 0 - 1 Time, hhmmss Time that release was reverted.
<releaseToInstallDate> Optional 0 - 1 Date, yyyymmdd Install end date.
<releaseToInstallTime> Optional 0 - 1 Time, hhmmss Install end time.
<releaseWorkChangeRequest> Optional 0 - 1 String (16), variable Release work change request.
<totalReleasePackages> Optional 0 - 1 Integer (5) Total number of packages in release.

...