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.

...