RLSMAREA SCAN CMP_RLSE

The RLSMAREA SCAN CMP_RLSE message scans the latest version of components in a release concatenation to find those with contents matching a search string. Release area libraries are searched for the current and prior releases, as well as baseline libraries.

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

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

These tags appear in both requests and replies.

RLSMAREA SCAN CMP_RLSE — Request

The following example shows how you might code a request to scan the latest version of components of library type "SRC" that contain the string "SAMCPY1B". Data structure details for the <request> tag follow the example.

Example XML — RLSMAREA SCAN CMP_RLSE Request

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

RLSMAREA SCAN CMP_RLSE <request> Data Structure

Subtag	Use	Occurs	Data Type & Length	Values & Dependencies
<and>	Optional	0 - 1	String (1)	Y = Concatenate <scan1> and <scan2> search strings. N = Do not concatenate search strings.
<applName>	Optional	0 - 1	String (4), variable	Release application name.
<caseMixed>	Optional	0 - 1	String (1)	Y = Search strings, <scan1> and <scan2>, are mixed case. N = Search strings are not mixed case.
<caseSensitive>	Optional	0 - 1	String (1)	Y = Search strings, <scan1> and <scan2>, are case sensitive. N = Search strings are not case sensitive.
<component>	Optional	0 - 1	String (256), variable	Component name to search for.
<libType>	Required	1	String (3)	Component library type.
<listType>	Optional	1	String (1)	Component list type.
<release>	Required	1	String (8), variable	Release name.
<releaseArea>	Required	1	String (8), variable	Release area name.
<scan1>	Optional	0 - 1	String (40), variable	Scan string 1.
<scan2>	Optional	0 - 1	String (40), variable	Scan string 2.

RLSMAREA SCAN CMP_RLSE — Reply

The XML reply to a RLSMAREA SCAN CMP_RLSE request returns zero to many <result> data elements. Each result lists information for a component that matched the search string.

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 SCAN CMP_RLSE Reply

<?xml version="1.0"?>
<service name="RLSMAREA">
    <scope name="SCAN">
        <message name="CMP_RLSE">
            <result>
                <release>BASELINE</release>
                <applName>ACTP</applName>
                <component>SAMSRC1A</component>
                <libType>SRC</libType>
                <package>ACTP</package>
                <matchLine> COPY SAMCPY1B.</matchLine>
                <libName>CMNTP.S4.V711.BASE.ACTP.SRC</libName>
            </result>

...

            <result>
                <release>BASELINE</release>
                <applName>ACTP</applName>
                <component>SAMSRC1A</component>
                <libType>SRC</libType>
                <package>ACTP</package> 
                <matchLine> CALL \&apos;SAMSRS1B&apos; USING SAMCPY1B. </matchLine>
                <libName>CMNTP.S4.V711.BASE.ACTP.SRC</libName>
            </result>
            <response>
                <statusMessage>CMR9572I - Component scan service completed </statusMessage>
                <statusReturnCode>00</statusReturnCode>
                <statusReasonCode>9572</statusReasonCode>
            </response>
        </message>
    </scope>
</service>

...

RLSMAREA SCAN 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	Name of library where component resides.
<libType>	Required	0 - 1	String (3)	Component library type.
<lineNumber>	Required	0 - 1	Integer, Undefined	Line number the text is on.
<matchLine>	Optional	0 - 1	String (256), variable	Matching line in component.
<release>	Required	1 - 1	String (8), variable	Release name.
<releaseArea>	Required	1 - 1	String (8), variable	Release area name.
<sortNumber>	Required	1 - 1	Integer, undefined	Sort number for sorting list.

...