Market switchover to be performed; data will be delayed

Markets & Operations

OASIS Template Interface Description for S&CP

General

All access to the PJM OASIS requires that the user be registered with PJM and that this registration precedes any login.

Login is required to start a virtual session on the web server. This is necessary in order to provide some continuity to the user without each web request (URL) having to contain a complete username and password and header. The virtual session is maintained on the server side by user, session, and company information stored in an online database. On the client side, the session is maintained by a persistent client state object called a "cookie". Use of cookie filters, browsers or client-side fetch programs which disable or do not support HTTP cookies is not supported.

Effective January 28, 2015 the PJM OASIS has been updated to be compliant with v2.0 of the OASIS Standards and Communication Protocols (S&CP) found in the NAESB WEQ Business Practice Standards Booklet, Version 003. PJM will support previous versions pursuant to applicable requirements. Users are encouraged to reference the new WEQ standards at www.naesb.org.

Login

A PJM OASIS Account is required to begin a session on any Siemen's OASIS node. The session is maintained via the OASIS database on the server end and a HTTP cookie on the client side.

A login is required to begin a Transmission Customer session on a Siemens OASIS node. The session is maintained on the server side by information stored in the OASIS database. The session is maintained on the client side through the use of an HTTP cookie.

The format for the login template is:
https://pjmoasis.pjm.com/OASIS/PJM/data/
login?user={user_name}&passwd=
{user_password}&pprov={provider_alias}

Where
{user_name} is your PJM OASIS username
{user_password} is the password corresponding to your PJM OASIS username
{provider_alias} is the alias for your service's primary provider (i.e. PJM, MISO, etc.)

The response to a successful login request will be the ASCII text: "You are logged in."

After a successful login a HTTP cookie will be returned via the server HTTP response header. The HTTP cookie will have the following form:
Set-Cookie: Siemens_Oasis={value}.

This cookie must accompany each subsequent request as part of the header and in the following form:
Cookie: Siemens_Oasis={value}.

Logout

The format for the logout template is:
https://pjmoasis.pjm.com/OASIS/PJM
/data/logout


Note that the HTTP header must contain the cookie text returned to the client during the login process. The response to the logout request will be the ASCII text: "You are logged out."

Template Requests

Each time you submit a request, your submission will be checked for:
1. Valid session cookie
2. Access to the requested information from the primary provider you logged in under
If either condition is violated, you will receive and ASCII text error message. Otherwise, you will receive the requested information or, in the case of an upload, a status header.

Template requests have the following general format:
https://pjmoasis.pjm.com/OASIS/PJM/data
/{template}?{template_parameters}

Where
{template} is a valid template as defined by S&CP version 2.0.
{template_parameters} are the arguments accepted by {template} as defined by S&CP version 2.0.
Note that the HTTP header must contain the cookie text returned to the client during the login process.

When following the S&CP document for submitting the Transrequest template, please keep these PJM header additions in mind:

PAY_CONGESTION
FTR_REQUESTED


These fields should be entered in this order at the end of the template string.
Note: FTR_REQUESTED field need only contain a value for FIRM products.

Template Examples

Login
https://pjmoasis.pjm.com/OASIS/PJM/data
/login?user=my_username&passwd=my_password
&pprov=PJM 

List
https://pjmoasis.pjm.com/OASIS/PJM/data/list?VERSION=2.0&TEMPLATE=list&OUTPUT_FORMAT=HTML&PRIMARY_PROVIDER_CODE=PJM&PRIMARY_PROVIDER_DUNS=073647877&RETURN_TZ=UT&LIST_NAME=TEMPLATE

Logout
https://pjmoasis.pjm.com/OASIS/PJM
/data/logout

Company Abbreviations

The following are defined for Messages but are not used for transmission or ancillary services at this time:

AE - Atlantic Energy
BGE - Baltimore Gas and Electric
DPL - Delmarva Power and Light
GPU - GPU Energy
PECO - PECO Energy
PEPCO - Potomac Electric Power Company
PPL - PPL Transmission
PSEG - Public Service Electric and Gas
UGI - UGI Utilities Inc

Time Zones

PJM's OASIS accepts all date and time options as a string of 16 characters with the last two designating the time zone.

The PJM OASIS accepts the following time zones:

AD - Atlantic Daylight Time UTC - 3 hours
AS - Atlantic Standard Time UTC - 4 hours
ED - Eastern Daylight Time UTC - 4 hours
ES - Eastern Standard Time (North America) UTC - 5 hours
MD - Mountain Daylight Time UTC - 6 hours
MS - Mountain Standard Time UTC - 7 hours
PD - Pacific Daylight Time UTC - 7 hours
PS - Pacific Standard Time UTC - 8 hours
UT - Universal Coordinated Time UTC