Skip to content

RLSMAREA IMP LIST

The RLSMAREA IMP LIST message lists the impact data stored in the ERO Db2 impact table.

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

<service name="RLSMAREA">
<scope name="IMP">
<message name="LIST">

These tags appear in both requests and replies.

RLSMAREA IMP LIST — Request

The only required subtag for this request is <sourceRelease>, which will list all of the impact data for a release. The remaining subtags allow you to request specific component relationships.

The 'source' tags refer to the top level of the relationship and the 'target' tags refer to the bottom level. For example, in a source-to-copybook relationship, the 'source' tags pertain to where the source component was generated; the 'target' fields pertain to where the copybook was pulled from. Similarly, for a composite load-to-subroutine relationship, the 'source' is for the composite and the 'target' is for the subroutine. The <toWhat> tag value is the name of the subcomponent (bottom level component, i.e. copybook or subroutine).

The following example shows how you might code a request to list all of the impact data for a release. Data structure details for the <request> tag follow the example.

Example XML — RLSMAREA IMP LIST Request

<?xml version="1.0"?>
<service name="RLSMAREA">
    <scope name="IMP">
        <message name="LIST">
            <header>
                <subsys>4</subsys>
                <test> </test>
                <product>CMN</product>
            </header>
            <request>
                <sourceRelease>S4712COM</sourceRelease>
            </request>
        </message>
    </scope>
</service>

RLSMAREA IMP LIST <request> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<relation> Optional 0 - 1 String (3) Impact relationship. Values:
CPY = Subordinate copybooks.
LOD = Subordinate statically linked subroutines.
<sourceApplName> Optional 0 - 1 String (4), variable Source release application name.
<sourceComponent> Optional 0 - 1 String (256), variable Source release area component name.
<sourceLibraryType> Optional 0 - 1 String (3) Source release component library type.
<sourceRelease> Required 1 String (8), variable Source release name.
<sourceReleaseArea> Optional 0 - 1 String (8), variable Source release area name.
<targetApplName> Optional 0 - 1 String (4), variable Target release application name.
<targetLibraryType> Optional 0 - 1 String (3) Target release component library type.
<targetRelease> Optional 0 - 1 String (8), variable Target release name.
<targetReleaseArea> Optional 0 - 1 String (8), variable Target release area name.
<toWhat> Optional 0 - 1 String (256), variable Target subcomponent of relationship.

RLSMAREA IMP LIST — Reply

The XML reply to a RLSMAREA IMP LIST request returns zero to many <result> data elements. Each result lists impact data for a component relationship.

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 IMP LIST Reply

<?xml version="1.0"?>
<service name="RLSMAREA">
    <scope name="IMP">
        <message name="LIST">
            <result>
                <sourceRelease>S4712COM</sourceRelease>
                <sourceReleaseArea>ACCTPAY</sourceReleaseArea>
                <sourceApplName>COMM</sourceApplName>
                <sourceLibraryType>SRS</sourceLibraryType> <sourceLibraryBun>0000000032</sourceLibraryBun>
                <sourceComponent>COMSRS10</sourceComponent>
                <relation>CPY</relation>
                <targetApplName>COMM</targetApplName>
                <targetLibraryType>CPY</targetLibraryType>
                <targetLibraryBun>0000000028</targetLibraryBun>
                <toWhat>COMCPY10</toWhat>
                <hashToken>8C2DCBB800000080</hashToken>
            </result>
            <result>
                <sourceRelease>S4712COM</sourceRelease>
                <sourceReleaseArea>ACCTPAY</sourceReleaseArea>
                <sourceApplName>ACTR</sourceApplName>
                <sourceLibraryType>SCS</sourceLibraryType>
                <sourceLibraryBun>0000000024</sourceLibraryBun>
                <sourceComponent>ACRSCSCE</sourceComponent>

...

                <relation>CPY</relation>
                <targetRelease>S4712COM</targetRelease>
                <targetReleaseArea>ACCTPAY</targetReleaseArea>
                <targetApplName>ACTR</targetApplName>
                <targetLibraryType>CPY</targetLibraryType>
                <targetLibraryBun>0000000017</targetLibraryBun>
                <toWhat>ACRCPYCE</toWhat>
                <hashToken>8FA76F0000000079</hashToken>
            </result> 
            .
            .
            .
            <response>
                <statusMessage>CMR8700I - Release IMP Table service completed </statusMessage>
                <statusReturnCode>00</statusReturnCode>
                <statusReasonCode>8700</statusReasonCode>
            </response>
        </message>
    </scope>
</service>

...

RLSMAREA IMP LIST <result> Data Structure

Subtag Use Occurs Data Type & Length Values & Dependencies
<hashToken> Optional 0 - 1 String (16) Component hash token for CPY relation.
<package> Optional 0 - 1 String (10) Package name for LOD relation.
<relation> Optional 0 - 1 String (3) Impact relationship. Values:
CPY = Subordinate copybooks.
LOD = Subordinate statically linked subroutines.
<setssi> Optional 0 - 1 String (8) Component SETSSI for LOD relation.
<sourceApplName> Optional 0 - 1 String (4), variable Source release application name.
<sourceComponent> Optional 0 - 1 String (256), variable Source release area component name.
<sourceLibraryBun> Optional 0 - 1 String (10) Source library type BUN number.
<sourceLibraryType> Optional 0 - 1 String (3) Source release component library type.
<sourceRelease> Required 0 - 1 String (8), variable Source release name.
<sourceReleaseArea> Optional 0 - 1 String (8), variable Source release area name.
<targetApplName> Optional 0 - 1 String (4), variable Target release application name.
<targetLibraryBun> Optional 0 - 1 String (10) Target library type BUN number.
<targetLibraryType> Optional 0 - 1 String (3) Target release component library type.
<targetRelease> Required 0 - 1 String (8), variable Target release name.
<targetReleaseArea> Optional 0 - 1 String (8), variable Target release area name.
<toWhat> Optional 0 - 1 String (256), variable Target subcomponent of relationship.

...