Skip to content

RLSMAREA SUMMARY CMP_RLSE

The RLSMAREA SUMMARY CMP_RLSE message lists information for the latest version of each component in a release concatenation.

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

<service name="RLSMAREA">
<scope name="SUMMARY">
<message name="CMP_RLSE">

These tags appear in both requests and replies.

RLSMAREA SUMMARY CMP_RLSE — Request

The following example shows how you might code a request to list information for the latest version of SRC-type components in a release concatenation. Data structure details for the <request> tag follow the example.

Example XML — RLSMAREA SUMMARY CMP_RLSE Request

<?xml version="1.0"?>
<service name="RLSMAREA">
    <scope name="SUMMARY">
        <message name="CMP_RLSE">
            <header>
                <subsys>4</subsys>
                <test> </test>
                <product>CMN</product>
            </header>
            <request>
                <release>S4711010</release>
                <releaseArea>ACCTPAY </releaseArea>
                <applName> </applName>
                <libType>SRC</libType>
                <component> </component>
                <caseMixed> </caseMixed>
            </request>
        </message>
    </scope>
</service>

...

RLSMAREA SUMMARY CMP_RLSE <request> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<applName> Optional 0 - 1 String (4), variable Release application name.
<caseMixed> Optional 0 - 1 String (1) Y = Case is mixed.
N = Case is not mixed.
<component> Optional 0 - 1 String (256), variable Component name.
NOTE: May be masked using asterisk (*) wildcard.
<libType> Required 0 - 1 String (3), variable Release library type.
<listType> Optional 0 - 1 String (1), variable Component list type.
<release> Required 1 String (8), variable Release name.
<releaseArea> Required 1 String (8), variable Release area name.

...

RLSMAREA SUMMARY CMP_RLSE — Reply

The XML reply to a RLSMAREA SUMMARY CMP_RLSE request returns zero to many <result> data elements. Each result contains information for a component/library type.

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 — RLSMAREA SUMMARY CMP_RLSE Reply

<?xml version="1.0"?>
<service name="RLSMAREA">
    <scope name="SUMMARY">
        <message name="CMP_RLSE">
            <result>
                <release>BASELINE</release>
                <applName>ACTP</applName>
                <component>ACPSRCCA</component>
                <libType>SRC</libType>
                <package>ACTP000050</package>
                <releaseAreaToCheckinDate>20120527</releaseAreaToCheckinDate>
                <releaseAreaToCheckinTime>042200</releaseAreaToCheckinTime>
                <likeType>S</likeType>
                <libName>CMNTP.S4.V711.BASE.ACTP.SRC</libName>
            </result>
            <result>
                <release>BASELINE</release>
                <applName>ACTP</applName>
                <component>ACPSRCCC</component>
                <libType>SRC</libType>
                <package>ACTP000050</package>
                <releaseAreaToCheckinDate>20120528</releaseAreaToCheckinDate>
                <releaseAreaToCheckinTime>055000</releaseAreaToCheckinTime>
                <likeType>S</likeType>
                <libName>CMNTP.S4.V711.BASE.ACTP.SRC</libName>
            </result>
            <result>
                <release>BASELINE</release>
                <applName>ACTP</applName>
                <component>ACPSRCCE</component>
                <libType>SRC</libType>
                <package>ACTP000076</package>
                <releaseAreaToCheckinDate>20120827</releaseAreaToCheckinDate>
                <releaseAreaToCheckinTime>135500</releaseAreaToCheckinTime>
                <likeType>S</likeType>
                <libName>CMNTP.S4.V711.BASE.ACTP.SRC</libName>
            </result>
            .
            .

...

            .
            <response>
                <statusMessage>CMR9570I - Component list service completed </statusMessage>
                <statusReturnCode>00</statusReturnCode>
                <statusReasonCode>9570</statusReasonCode>
            </response>
        </message>
    </scope>
</service>

...

RLSMAREA SUMMARY CMP_RLSE <result> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<applName> Optional 0 - 1 String (4), variable Release application name.
<component> Optional 0 - 1 String (256), variable Component name.
<libName> Required 0 - 1 String (44), variable Library name where component resides.
<libType> Required 0 - 1 String (3) Component library type.
<likeType> Optional 0 - 1 String (1) Release application library "like type". Values for all library types:
C = Copy
L = Load
P = PDS
S = Source
N = NCAL
O = Object
K = LCT (link control cards)
X = List
J = JCL/Proc
<package> Optional 0 - 1 String (10) Release package name.
<release> Required 0 - 1 String (8), variable Release name.
<releaseArea> Required 0 - 1 String (8), variable Release area name.
<releaseAreaToCheckinDate> Optional 0 - 1 Date, yyyymmdd Release area checkin to date.
<releaseAreaToCheckinTime> Optional 0 - 1 Time, hhmmss Release area component checkin time.
<sortNumber> Required 0 - 1 Integer Sort number for sorting list.

...