SERNET Security Group List - SYSTEM SECGROUP LIST

This function lists the RACF groups to which a user is connected.

The Serena XML service/scope/message tags and attributes for a SERNET security group list message are:

<service name="SYSTEM">
<scope name="SECGROUP">
<message name="LIST">

These tags appear in both requests and replies.

SYSTEM SECGROUP LIST — Requests

This function does not accept input data; the request is performed for the user who is running it. The <request> tag itself is required, however, to identify the message as a request rather than a reply.

Note

XML syntax allows both a long form and a short form for empty tags. An empty <request> tag can therefore be coded in one of two ways.

Long form:

<request>
</request>

Equivalent short form:

<request\>

The following example shows how to code the request with an empty <request> tag.

Note

Be sure to code "XCH" in the subtag, which will return security groups for the user. If you code "CMN" in the subtag, you will receive a list of groups to which the started task is connected (because CMN tasks run under the started task's security environment, rather than the user's).

Example XML — SYSTEM SECGROUP LIST Request

<?xml version="1.0"?>
<service name="SYSTEM">
    <scope name="SECGROUP">
        <message name="LIST">
            <header>
                <subsys>8</subsys> 
                <product>XCH</product> 
            </header>
            <request>
            </request>
        </message>
    </scope>
</service>

...

SYSTEM SECGROUP LIST — Replies

This function returns zero to many <result> data elements, listing all of the RACF security groups to which the current user is connected. Following the <result> data structure is the standard <response> data structure, which indicates the success or failure of the XML request and provides a status message. Successful requests have a return code of 00. Unsuccessful requests have a return code of 04 or higher.

Data structure details for the <result> data element appear in Exhibit 12-5.

Exhibit 12-5 SYSTEM SECGROUP LIST <result> Data Structure

Subtag	Use	Occurs	Data Type & Length	Values & Dependencies
<groupName>	Optional	0 - 1	String (7), variable	RACF security group name.

...