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.