Skip to content

RLSMRLSE PRIOR LIST

The RLSMRLSE PRIOR LIST message lists prior release information.

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

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

These tags appear in both requests and replies.

RLSMRLSE PRIOR LIST — Request

The following example shows how you might code a request to list the prior release information for a release. Data structure details for the <request> tag follow the example.

Example XML — RLSMRLSE PRIOR LIST Request

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

RLSMRLSE PRIOR LIST <request> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<priorRelease> Optional 0 - 1 String (8), variable Prior release name.
<priorReleaseApplName> Optional 0 - 1 String (4), variable Prior release application name.
<release> Required 1 String (8), variable Release name.

...

RLSMRLSE PRIOR LIST — Reply

The XML reply to a RLSMRLSE PRIOR LIST request returns zero to many <result> data elements. Each result lists information for a prior 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 PRIOR LIST Reply

<?xml version="1.0"?>
<service name="RLSMRLSE">
    <scope name="PRIOR">
        <message name="LIST">
            <result>
                <release>S4712COM</release>
                <priorRelease>S4712010</priorRelease>
                <allPriorReleaseAppls>Y</allPriorReleaseAppls>
                <allPriorReleaseLibTypes>Y</allPriorReleaseLibTypes>
                <includeSystemPriorAreas>N</includeSystemPriorAreas>
                <includeSinglePathPriorAreas>N</includeSinglePathPriorAreas>
                <includeAllPriorAreas>N</includeAllPriorAreas>
                <priorReleaseSyslibAscending>Y</priorReleaseSyslibAscending>
                <priorReleaseInstallDate>20121005</priorReleaseInstallDate>
                <priorReleaseLastArea>FINANCE</priorReleaseLastArea>
                <priorReleaseHighLevelNode>CMNTP</priorReleaseHighLevelNode>
                <priorReleaseLibPattern>HRAPL</priorReleaseLibPattern>
                <priorReleaseHighLevelPath>/cmntp</priorReleaseHighLevelPath>
                <allPriorReleaseLibTypes>Y</allPriorReleaseLibTypes>
                <libTypeCount>00000</libTypeCount>
            </result>
            <response>
                <statusMessage>CMR8700I - Prior Release service completed </statusMessage>
                <statusReturnCode>00</statusReturnCode>
                <statusReasonCode>8700</statusReasonCode>
            </response>
        </message>
    </scope>
</service>

...

RLSMRLSE PRIOR LIST <result> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
Optional 0 - 1 String (1) Y = Include all prior release applications.
N = Include only the specified application.
<allPriorReleaseLibTypes> Optional 0 - 1 String (1) Y = Include all library types.
N = Include only the defined library types.
<includeAllPriorAreas> Optional 0 - 1 String (1) Y = Include all release areas of the prior release.
N = Include only the final area of the prior release.
<includeSinglePathPriorAreas> Optional 0 - 1 String (1) Y = Include all single path areas of the prior release.
N = Include only the final single path area of the prior release.
<includeSystemPriorAreas> Optional 0 - 1 String (1) Y = Include all system areas of the prior release.
N = Include only the final system area of the prior release.
<libTypeCount> Optional 0 - 1 String (5) Prior release related library type count.
<priorRelease> Optional 0 - 1 String (8), variable Prior release name.
<priorReleaseApplName> Optional 0 - 1 String (4), variable Prior release application name.
<priorReleaseHighLevelNode> Optional 0 - 1 String (8), variable Prior release high-level qualifier.
<priorReleaseHighLevelPath> Optional 0 - 1 String (73), variable Prior release high-level path name.
<priorReleaseInstallDate> Optional 0 - 1 Date, yyyymmdd Prior release install date.
<priorReleaseLastArea> Optional 0 - 1 String (8), variable Prior release final area name.
<priorReleaseLibPattern> Optional 0 - 1 String (5), variable Prior release dataset name pattern.
<priorReleaseLibType> Optional 0 - 1 String (3) Prior release related library type.
<priorReleaseSyslibAscending> Optional 0 - 1 String (1) Y = SYSLIB build order ascending.
N = SYSLIB build order descending.
<release> Optional 0 - 1 String (8), variable Release name.

...