3.2 Session Commands

Some web service WLST commands, such as those that modify repository documents and policy subject commands, need to be executed in the context of a session. Use the WLST commands listed in Table 3-2 to manage a session.


Table 3-2 Session Management WLST Commands

Use this command... To... Use with WLST...

abortWSMSession

Abort the current modification session, discarding any changes that were made during the session.

Online

beginWSMSession

Begin a session to modify a policy subject or the OWSM repository documents.

Online

commitWSMSession

Write the contents of the current session to the OWSM repository.

Online

describeWSMSession

Describe the contents of the current session. This will indicate either that the session is empty or list the name of the document that is being updated, along with the type of update (create, modify, or delete).

Online


3.2.1 abortWSMSession

Command Category: Session

Use with WLST: Online

Description

Aborts the current modification session, discarding any changes that were made during the session. Messages are displayed that describe what was aborted.An error will be displayed if there is no current session.

Syntax

abortWSMSession()

Examples

The following example aborts the current OWSM session.

wls:/wls-domain/serverConfig>abortWSMSession()

3.2.2 beginWSMSession

Command Category: Session

Use with WLST: Online

Description

Begins a session to modify a policy subject, such as a policy set or a Fusion Middleware web service endpoint. A session can act on a single policy subject only. If a session is already in progress, an error is displayed.

Syntax

beginWSMSession()

Example

The following example begins an OWSM session.

wls:/wls-domain/serverConfig>beginWSMSession()

3.2.3 commitWSMSession

Command Category: Session

Use with WLST: Online

Description

Persists the modifications made within the current session. Messages are displayed that describe what was committed. An error will be displayed if there is no current session.

Syntax

commitWSMSession()

Example

The following example commits the current repository modification session.

wls:/wls-domain/serverConfig>commitWSMSession()

3.2.4 describeWSMSession

Command Category: Session

Use with WLST: Online

Description

Describes the current session. For repository operations, it will either indicate that no actions have been performed in the session, or it will list the name of the document that is being updated, along with the type of update, such as create, modify, or delete. For policy subject operations, it will list the subject identifier.

If there is no current session, the following error is displayed:

No actions in session.

Syntax

describeWSMSession()

Examples

The following example describes the current session.

wls:/wls-domain/serverConfig>describeWSMSession()