RLSMAPPR ASCAPPRV LIST

The RLSMAPPR ASCAPPRV LIST message lists the items that are associated with an associated approval entity.

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

<service name="RLSMAPPR">
<scope name="ASCAPPRV">
<message name="LIST">

These tags appear in both requests and replies.

RLSMAPPR ASCAPPRV LIST — Request

The following example shows how you might code a request to list the associated items for an associated approval entity. Data structure details for the <request> tag follow the example.

Example XML — RLSMAPPR ASCAPPRV LIST Request

<?xml version="1.0"?>
<service name="RLSMAPPR">
    <scope name="ASCAPPRV">
        <message name="LIST">
            <header>
                <subsys>4</subsys>
                <test> </test>
                <product>CMN</product>
            </header>
            <request>
                <releaseApprovalEntity>DBA</releaseApprovalEntity>
            </request>
        </message>
    </scope>
</service>

...

RLSMAPPR ASCAPPRV LIST <request> Data Structure

Subtag	Use	Occurs	Data Type & Length	Values & Dependencies
<releaseApprovalEntity>	Required	1	String (8), variable	Release approval entity.

RLSMAPPR ASCAPPRV LIST — Reply

The XML reply to a RLSMAPPR ASCAPPRV LIST request returns one <result> data element, which contains the items that are associated with the approval entity.

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 — RLSMAPPR ASCAPPRV LIST Reply

<?xml version="1.0"?>
<service name="RLSMAPPR">
    <scope name="ASCAPPRV">
        <message name="LIST">
            <result>
                <releaseApprovalEntity>DBA</releaseApprovalEntity>
                <relatedLibTypeCount>00009</relatedLibTypeCount>
                <relatedLibType>DBB</relatedLibType>
                <relatedLibType>DBR</relatedLibType>
                <relatedLibType>PKG</relatedLibType>
                <relatedLibType>SPD</relatedLibType>
                <relatedLibType>SPQ</relatedLibType>
                <relatedLibType>STL</relatedLibType>
                <relatedLibType>STP</relatedLibType>
                <relatedLibType>TRG</relatedLibType>
                <relatedLibType>UDF</relatedLibType>
            </result>
            <response>
                <statusMessage>CMR8700I - Associated Approver service completed</statusMessage>
                <statusReturnCode>00</statusReturnCode>
                <statusReasonCode>8700</statusReasonCode>
            </response>
        </message>
    </scope>
</service>

...

RLSMAPPR ASCAPPRV LIST <result> Data Structure

Subtag	Use	Occurs	Data Type & Length	Values & Dependencies
<relatedApplName>	Optional	0 - 1	String (4), variable	Related application name or mask.
<relatedLibType>	Optional	0 - 195	String (3), variable	Related release library type.
<relatedLibTypeCount>	Optional	0 - 1	String (4), variable	Related library type count.
<relatedRelease>	Optional	0 - 1	String (8), variable	Related release name or mask.
<relatedReleaseArea>	Optional	0 - 1	String (8), variable	Related release area name or mask.
<relatedSiteName>	Optional	0 - 1	String (8), variable	Related site name or mask.
<releaseApprovalEntity>	Optional	0 - 1	String (8), variable	Release approval entity.

...