Oracle9i Application Server Wireless Edition Developer's Guide Release 1.1 Part Number A86700-01 |
Library | Service | Contents | Index

# B
Runtime System Variables

This document describes the system parameters that are recognized by the Wireless Edition Runtime application. The values of some of these parameters can be referred to explicitly in the result XML as macros.

Each section of this document presents a different topic. These sections include:

- Section B.1, "System Parameters"

- Section B.2, "Macros"

## B.1 System Parameters

The system parameters that are named here are processed by the Wireless Edition Runtime application. Developers can use these parameter names, which are included in the PARAMETERS AttributeCategory in Request, when constructing a URL request.

When these parameter names appear in the code, they should have two underscore characters before and two underscore characters after each parameter name. The system looks for these underscore characters when it parses the code for the parameter names.

Table B-1 Runtime System Defined Request Parameters

Parameter Name | Possible Parameter Value | Description | Example
--- | --- | --- | ---
PAdebug | Any non-null value | Enables the debug option for the current request. | `www.oracle.com/ptg /rm?PAservicepath=/myservice /finance&` `PAsection=getQuote&PAdebug=true`
PAuserid | User's name | The name of the user | `PAuserid=Scott`
PApassword | User's password. | Specifies the user's password duing session login. | `PApassword=tiger`
PAoid | The oid of a service. | Referring a service via its OID. | `PAoid=1234`
PAsection | The name of a PAsection. | The current WIDL adapter supports multiple sections, PAsection identifies which section to run. | `www.oracle.com/ptg/rm?PAservicepath=/myservice/finance&` `PAsection=getQuote`
PAx | Result transformer name. | Specifies the result transformer. The default is the result transformer currently in use by the PAsection parameter. | `PAx=getQuote`
PAlogin | Any non-null value. | Logs in to the current session. | `www.oracle.com/ptg /rm?PAlogin=true`
PAlogoff | Any non-null value. | Logs out of the current session. | `www.oracle.com/ptg /rm?PAlogoff=true`
PAsid | This value is internally generated. | The session ID. | `PAsid=XXXXX`
PAgetPage | A SimpleResult XML page. | Creates a URL to test how a SimpleResult XML is converted to the target markup language. You can imbed this parameter in any service invocation URL to return the transformed result of the given SimpleResult DTD rather than the invoked service. | `www.oracle.com/ptg/rm?PAoid=123&PAgetPage=<SimpleResult> <SimpleText><SimpleTextItem>` `HelloWorld` `</SimpleTextItem></SimpleText> </SimpleResult>`

## B.2 Macros

The result XML can refer to some system-defined parameters using Runtime system variables (macros) which are substituted by the PostProcessor before the final result is returned to the requester.

When these macros appear in the code, they have two underscore characters before and two underscore characters after each macro name. The system looks for these underscore characters when it parses the code for the parameter names.

Table B-2 Runtime Macros

System Value Macro | Description
--- | ---
"_LOGICAL_DEVICE" | The name of the logical device from which the request is being initiated
"_REQUEST_NAME" | The request name
__SESSION__ | The URL to refer to the current session.
__SERVICE_NAME__(*) | The name of the service being invoked by the request.
__SERVICE_NAME_ENC__(*) | The encoded service path of the service being invoked by the request.
__SR_FROM_ADAPTER__ | The service request object in XML form after the adapter invocating, but before applying the result transformer if any.
__SR_FROM_SERVICE__ | The service request object in XML form after the adapter invocating and applying the result transformer if any.
__UserLanguage__ | The accepted languages by the requesting device, can be null.
__PAuserid__ | The name of the user.
__PAservicepath__ | Referring a service via its service path.
__PAoid__ | Referring a service via its OID.
__PAsection__ | The current WIDL adapter supports multiple sections, PAsection is used to identify which section to run.
__userRef__ | The oid of the user who is making the request.
__%PARAM_NAME%__ | Where %PARAM_NAME% is the parameter name including both user and system parameters used in the query string of the URL.

| Copyright © 2001 Oracle Corporation. All Rights Reserved. |
Library | Service | Contents | Index