This RESTful web service request can be used to retrieve a list of valid WebFOCUS privileges.

HTTP Method: GET

REST URL Format:

http://host:port/ibi_apps/rs/ibfs?IBIRS_action=privileges

where:

host

Is the name of the system where WebFOCUS is installed.

port

Is the port number used by WebFOCUS.

Response:

A list of privileges is returned in an XML response document. Each privilege is defined within an <item> element tag:

<item type="Privilege" name="PrivilegeName" dummy="false" description="PrivilegeDesc" subsysNameList="Subsystem"
parent="PRIVILEGES" ordinal="159" index="159" class="com.ibi.ibfs.objects.IBFSPrivilegeObject"/>

where:

PrivilegeName

Is the name of the privilege.

PrivilegeDesc

Is the description of the privilege.

Subsystem

Is the subsystem that the privilege pertains to.

Example:

In the following example, a list of WebFOCUS privileges is retrieved.

Request:

http://localhost:8080/ibi_apps/rs/ibfs?IBIRS_action=privileges

Response:

<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<ibfsrpc _jt="IBFSResponseObject" language="EN" name="privileges" returncode="10000" returndesc="SUCCESS" subreturncode="0"
       subsystem="SSYS" type="simple">
 <ibfsparams size="0"/>
 <rootObject _jt="IBFSObject" container="true" description="PRIVILEGES" dummy="true" name="PRIVILEGES" type="unknownType">
    <children _jt="ArrayList" size="180">
	      <item class="com.ibi.ibfs.objects.IBFSPrivilegeObject" description="InfoAssist Personal" dummy="false" index="159"
            name="opInfoAssistPersonal" ordinal="159" parent="PRIVILEGES" subsysNameList="Session" type="Privilege"/>
  		</children>
 </rootObject>
</ibfsrpc>

In this sample response document, the name of the privilege is opInfoAssistPersonal and has a description of InfoAssist Personal. This privilege applies to the Session subsystem.