Skip to content

RLSMRLSE HST LIST

The RLSMRLSE HST LIST message lists the history residing in the ERO component history table for components in a release. A comprehensive list may be obtained for all components in a release, or a selective list may be obtained by requesting specific fields.

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

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

These tags appear in both requests and replies.

RLSMRLSE HST LIST — Request

The following example shows how you might code a request to list all of the component history for a release. Data structure details for the <request> tag are identical to those for the RLSMAREA HST LIST message except that the <release> subtag is optional - see Example XML — RLSMAREA HST LIST Request.

Example XML — RLSMRLSE HST LIST Request

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

...

RLSMRLSE HST LIST — Reply

The XML reply to a RLSMRLSE HST LIST request returns zero to many <result> data elements. Each result lists a record of history data for a component.

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 are identical to those for the RLSMAREA HST LIST message - see RLSMAREA HST LIST <result> Data Structure.

Example XML — RLSMRLSE HST LIST Reply

<?xml version="1.0"?>
<service name="RLSMRLSE">
    <scope name="HST">
        <message name="LIST">
            <result>
                <release>S4712COM</release>
                <releaseArea>ACCTPAY</releaseArea>
                <package>ACTP000076</package>
                <applName>ACTP</applName>
                <packageId>000076</packageId>
                <componentHistoryType>RLS</componentHistoryType>
                <componentType>CPY</componentType>
                <component>ACPCPYCE</component>
                <updater>KCAMPBE</updater>
                <componentChangeDate>20120827</componentChangeDate>
                <componentChangeTime>135951</componentChangeTime>
                <componentPriorChangeDate>20120827</componentPriorChangeDate>
                <componentPriorChangeTime>135835</componentPriorChangeTime>
                <setssi>630B28C0</setssi>
                <version>01</version>
                <modLevel>02</modLevel>
                <componentHistoryStatus>CKI</componentHistoryStatus>
                <componentPriorHistoryStatus>RTV</componentPriorHistoryStatus>
                <useDb2PreCompileOption>N</useDb2PreCompileOption>
                <forceAssignedBuildProc>N</forceAssignedBuildProc>
                <size>00000003</size>
                <checkinReleaseArea>PACKAGE</checkinReleaseArea>
                <checkinUser>KCAMPBE</checkinUser>
                <releaseAreaCheckinDate>20120827</releaseAreaCheckinDate>
                <releaseAreaCheckinTime>135951</releaseAreaCheckinTime>
                <retrieveReleaseArea>ACCTPAY</retrieveReleaseArea>
                <retrieveUser>KCAMPBE</retrieveUser>

...

                <releaseAreaRetrieveDate>20120827</releaseAreaRetrieveDate>
                <releaseAreaRetrieveTime>135835</releaseAreaRetrieveTime>
                <promotionDate>20121231</promotionDate>
                <promotionTime>000000</promotionTime>
                <componentCheckoutSetssi>630B28C0</componentCheckoutSetssi>
                <componentCheckoutDate>20120827</componentCheckoutDate>
                <componentCheckoutTime>135951</componentCheckoutTime>
            </result>
            <response>
                <statusMessage>CMR8700I - Release HST Table service completed </statusMessage>
                <statusReturnCode>00</statusReturnCode>
                <statusReasonCode>8700</statusReasonCode>
            </response>
        </message>
    </scope>
</service>

...