banner financial aid / hosted services handbook / 8...iv banner financial aid 8.10 january 2011...

92
BANNER FINANCIAL AID HOSTED SERVICES HANDBOOK Release 8.10 January 2011

Upload: others

Post on 20-Apr-2020

1 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

BANNER FINANCIAL AIDHOSTED SERVICES HANDBOOK

Release 8.10 January 2011

Page 2: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

Trademark, Publishing Statement and Copyright NoticeSunGard or its subsidiaries in the U.S. and other countries is the owner of numerous marks, including “SunGard,” the SunGard logo, “Banner,” “PowerCAMPUS,” “Advance,” “Luminis,” “DegreeWorks,” “fsaATLAS,” “Course Signals,” and “Open Digital Campus.” Other names and marks used in this material are owned by third parties.

© 2011 SunGard. All rights reserved.

Contains confidential and proprietary information of SunGard and its subsidiaries. Use of these materials is limited to SunGard Higher Education licensees, and is subject to the terms and conditions of one or more written license agreements between SunGard Higher Education and the licensee in question. This PDF is certified for use with Adobe Reader, version 6.x and higher. Some elements of this PDF may not render properly when viewed using earlier versions of the Acrobat Reader or with other PDF viewing applications.

In preparing and providing this publication, SunGard Higher Education is not rendering legal, accounting, or other similar professional services. SunGard Higher Education makes no claims that an institution's use of this publication or the software for which it is provided will insure compliance with applicable federal or state laws, rules, or regulations. Each organization should seek legal, accounting and other similar professional services from competent providers of the organization’s own choosing.

Prepared by: SunGard Higher Education4 Country View RoadMalvern, Pennsylvania 19355United States of America

Customer Support Center Websitehttp://connect.sungardhe.com

Documentation Feedbackhttp://education.sungardhe.com/survey/documentation.html

Distribution Services E-mail [email protected]

Revision History Log

Publication Date SummaryJanuary 2011 New version that supports Banner Financial Aid software.

Page 3: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

Contents

Banner Financial Aid 8.10Hosted Services Handbook

Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Banner Financial Aid Hosted Services . . . . . . . . . . . . . . . . . . . . . . . 1-1

Chapter 2 FM Need Analysis Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

OC4J of iAS 10.1.3.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Off-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

On-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Object List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Batch Need Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Immediate Processing (Job Submission Process vs. Servlet) . . . . . . . . . . . . 2-3

Off-Premise vs. On-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Configuration Checklists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

Batch Need Analysis (Required) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

Run immediate Need Analysis using the job submission option . . . . . . . . . . 2-5

Run immediate Need Analysis using the servlet option . . . . . . . . . . . . . . . 2-6

Off-Premise Installation (default) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

On-Premise Installation (optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

Redeploying the servlet rnpfmxx.war . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8

Updating finaidfmlogin.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8

Updating finaiddbseed.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9

January 2011 Banner Financial Aid 8.10 iiiHosted Services Handbook

Contents

Page 4: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

Internet Native Banner (INB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10

iAS 10.1.3.x OC4J . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12

On-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21

Loading Certificate to JVM for RNPFM12 . . . . . . . . . . . . . . . . . . . . . . . 2-29

Redeploy Servlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30

Proxy Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32

Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-35

Missing finaidutils.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-35

Unable to connect to servlet rnpfmxx.war . . . . . . . . . . . . . . . . . . . . . . . 2-35

Connection timed out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-36

Proxy not authorized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-36

Unauthorized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-37

Certification path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-37

FAQs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-38

Alternative Install to Full iAS 10.1.3.x . . . . . . . . . . . . . . . . . . . . . . . . 2-41

OC4J install of iAS 10.1.3.x only . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-41

WebLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-43

Appendix A FM Need Analysis Schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-1

iv Banner Financial Aid 8.10 January 2011Hosted Services HandbookContents

Page 5: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

1 Introduction

Banner Financial Aid Hosted Services

This handbook describes the variety of external hosted services offered by SunGard Higher Education in support of the Banner Financial Aid product. Each chapter contains specific installation, configuration, and administrative materials.

Additionally, this handbook also includes other supplemental details in related Appendices.

Descriptions of the following hosted services are provided:

• FM Need Analysis Configuration

2011 Banner Financial Aid 8.10 1-1Hosted Services Handbook

Introduction

Page 6: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

1-2

Banner Financial Aid 8.10 January 2011Hosted Services HandbookIntroduction
Page 7: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

2 FM Need Analysis Configuration

Introduction

This chapter supplies technical details associated with installation and configuration of the hosted FM Need Analysis solution, supported by the SunGard Data System Infinity platform. Configurations are included, both required and optional, as needed for successful 2011-2012 FM Need Analysis calculations FM Need Analysis calculations for release 7.19 and 8.10. Consequently, this chapter is written with references specific to the RNPFM12 object. However, the steps associated with RNPFM12 can also be applied to the older RNPFM11 version of the object.

NoteInformation contained in this chapter supersedes all configuration requirements noted in prior release documentation (specifically, Appendix A, Additional Technical Details, originally included in release 7.18.1/8.8.1).

Requirements

OC4J of iAS 10.1.3.x

The servlet rnpfmxx.war must be installed on an OracleAS Containers for Java (OC4J) version 10.1.3.x. This version of the OC4J is available with the Internet Application Server (iAS) 10.1.3.x. Because, the iAS 10.1.3.x does not contain a Oracle forms server, the OC4J of iAS 10.1.3.x must be installed in addition to the existing OAS 10.1.2.x. The installation of the OC4J of iAS 10.1.3.x can be done on to the same environment as the OAS 10.1.2.x.

2011 Banner Financial Aid 8.10 2-1Hosted Services Handbook

FM Need Analysis Configuration

Page 8: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-2

Off-Premise

If the institution applied for their status to host the Financial Aid Need Analysis as Off-Premise, there are no additional requirements. The web service will be hosted and maintained by Infinity.

On-Premise

If the institution applied for their status to host the Financial Aid Need Analysis as On-Premise, there are additional requirements. The web service must be installed and maintained by the institution on either:

• Windows 2003 server running Internet Information Services (IIS) 6 or 7

OR

• Windows 2008 server running IIS 7

Object List

The following objects are associated with FM Need Analysis:

• finaiddbseed.jar

• finaidfmlogin.jar

• finaidutils.jar

• fm1_sungardhe.cer

• fm2_sungardhe.cer

• rnpfmxx.war

• rnpfm12.jar

• rnpfm12.com

• rnpfm12.pl

• rnpfm12.shl

• rorparm.fmb

• rnpfmxx_plan.dat

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 9: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

Configuration Options

Several options are available for running FM Need Analysis. The following diagrams illustrate the various FM Need Analysis configuration options:

Batch Need Analysis

The most efficient way to process large numbers of students for FM Need Analysis is by using job submission to run the RNPFM12 process. Therefore, this is a required configuration:

Immediate Processing (Job Submission Process vs. Servlet)

There are two configuration options available to perform immediate student processing for FM Need Analysis.

Running immediate FM Need Analysis using the traditional job submission:

Running immediate FM Need Analysis using the servlet:

2011 Banner Financial Aid 8.10 2-3Hosted Services Handbook

FM Need Analysis Configuration

Page 10: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-4

While better performance is noted using the immediate FM Need Analysis configuration using the servlet, this configuration will require more configuration time and requires OC4J version 10.1.3.x.

Off-Premise vs. On-Premise

Institutions may choose where the Financial Aid Need Analysis Calculation Web Service resides.

Off-Premise

This option will use the software-as-a-service (SaaS) supported by SunGard Data System Infinity platform. No additional installation steps are required:

On-Premise

For those institutions that wish to maintain their own Web Services, refer to the step-by-step procedure, On-Premise Installation, later in this document to help configure your system.

NoteTwo separates installation procedures are provided, one each for Windows 2003 and Windows 2008. Only one of the two Web Service options must be implemented if the On-Premise option is chosen.

Configuration Times Processing Time per Student

Job Submission 1 minute 6 - 30 seconds

Servlet Approximately 1 - 2 hours 2 - 6 seconds

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 11: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

Configuration Checklists

This section includes a series of checklist items, based on desired function.

Batch Need Analysis (Required)

1. All FINAID users must grant the banproxy permission to login as a proxy user. Refer to Internet Native Banner, Configure banproxy.

2. The finaidfmlogin.jar must be updated with the institution login credential for Infinity. Refer to the Updating finaidfmlogin.jar procedure.

3. The job submission server must open port 443 to allow the batch process rnpfm12.jar to connect to the Infinity URLs:

https://fm1.sungardhe.com

AND

https://fm2.sungardhe.com

Run immediate Need Analysis using the job submission option

1. In INB, navigate to the RORPARM form.

2. Change the value for parameter USE_JOBSUB to Y and save.

2011 Banner Financial Aid 8.10 2-5Hosted Services Handbook

FM Need Analysis Configuration

Page 12: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-6

Run immediate Need Analysis using the servlet option

1. The finaidutils.jar must be deployed onto the OAS 10.1.2.x Oracle forms server. Refer to Internet Native Banner, Deploying finaidutils.jar.

2. The finaiddbseed.jar must be updated with the institution seed number. Refer to the Updating finaiddbseed.jar procedure.

3. Copy the following four files from <BANNER_HOME>/finaid/java to a temporary location that can be accessed by a web browser:

• rnpfmxx.war

• rnpfmxx_plan.dat

• finaidfmlogin.jar

• finaiddbseed.jar

4. These four files must be deployed on to the OC4J of the iAS 10.1.3.x. Refer to the iAS 10.1.3.x OC4J procedure.

4.1. Create the rnpfmxx OC4J Instance

4.2. Installing the Share Library

4.3. Installing the Servlet

4.4. Creating the Connection Pool and Data Source

5. In INB, navigate to the RORPARM form.

6. Change the value for parameter USE_JOBSUB to N.

7. Change the value for parameter SERVLET_URL with the URL of the servlet that was installed by step 2, above and save.

The servlet URL uses the following format:

• http://<SERVER>:<PORT>/rnpfmxx/FmCalxx

• <SERVER> the name of the Server where rnpfmxx.war is deployed

• <PORT> the port number

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 13: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

8. The environment that is hosting the OC4J must open port 443 to allow the servlet rnpfmxx.war to connect to the Infinity URLs:

https://fm1.sungardhe.com

AND

https://fm2.sungardhe.com

Off-Premise Installation (default)

No additional steps are required.

On-Premise Installation (optional)

If the institution selects the on-premise status then a locally hosted version of the Financial Aid Need Analysis must be installed.

1. Download the latest version of the FinAidNeedAnalysis.xxxxxx.x.zip.

2. Install the web service on to an IIS server. There are two installation guides provided:

• Windows 2003 running IIS 6

• Windows 2008 running IIS 7

3. Choose the appropriate guide for your institution. Refer to the On-Premise procedure.

Redeploying the servlet rnpfmxx.war

Once the servlet rnpfmxx.war has been deployed for the first time, subsequent installations require a redeployment only. Refer to the Redeploy Servlet procedure.

2011 Banner Financial Aid 8.10 2-7Hosted Services Handbook

FM Need Analysis Configuration

Page 14: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-8

Procedures

This section describes individual procedures associated with FM Need Analysis operations. Each procedure provides a stand-alone set of instructions associated with a particular FM Need Analysis function.

This is a reference section only and is not intended to be followed sequentially. Other sections in this chapter point back to this section to reinforce or instruct the user to perform certain necessary steps.

The following procedural information is listed in this section:

• Updating finaidfmlogin.jar

• Updating finaiddbseed.jar

• Internet Native Banner (INB)

• iAS 10.1.3.x OC4J

• On-Premise

• Loading Certificate to JVM for RNPFM12

• Redeploy Servlet

• Proxy Settings

Updating finaidfmlogin.jar

Embedded within the object finaidfmlogin.jar, is a nas.properties file. This file must be modified to allow each institution to connect to the Infinity Financial Aid Need Analysis system. The finaidfmlogin.jar file can be found:

• Under OpenVMS$BANNER_HOME/finaid/java under UNIX, BAN_HOME:[finaid.java]

• Under Windows${banner_home}\finaid\java

1. Use the following command to extract the nas.properties file from finaidfmlogin.jar:

jar xf finaidfmlogin.jar com/sungardhe/finaid/login/nas.properties

2. Open the com/sungardhe/finaid/login/nas.properties file in a text editor.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 15: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

3. Change the user name and password values, the text to the right of the equal sign, for these properties. Be careful not to leave any trailing spaces after the values.

httpusername=

httppassword=

NoteFor off-premise, use the authentication code provided when the institution applied for the off-premise status. For on-premise, if Basic Authentication was used during the install of the Windows IIS, then use the authentication that was setup. Otherwise, no changes are needed.

4. Use the following command to update the finaidfmlogin.jar with the edited nas.properties:

jar uf finaidfmlogin.jar com/sungardhe/finaid/login/nas.properties

Updating finaiddbseed.jar

Embedded within the object finaiddbseed.jar is a seed.properties file. This file must be modified to allow each institution to connect to the Oracle database. The finaiddbseed.jar can be found:

• Under OpenVMS$BANNER_HOME/finaid/java under UNIX, BAN_HOME:[finaid.java]

• Under Windows${banner_home}\finaid\java

1. Use the following command to extract the seed.properties file from finaiddbseed.jar:

jar xf finaiddbseed.jar com/sungardhe/finaid/dbseed/seed.properties

2. Open the com/sungardhe/finaid/login/seed.properties file in a text editor.

3. Using the institution security seed number, change the values, text to the right of the equal sign, for these properties. Be careful not to leave any trailing spaces after the values.

seed1=

seed3=

4. Use the following command to update the finaiddbseed.jar with the edited seed.properties:

jar uf finaiddbseed.jar com/sungardhe/finaid/dbseed/seed.properties

2011 Banner Financial Aid 8.10 2-9Hosted Services Handbook

FM Need Analysis Configuration

Page 16: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-10

Internet Native Banner (INB)

Configure banproxy

A proxy connection must be configured for each FINAID user who will be responsible for running a FM Need Analysis. The INB banproxy user will be configured to act as the proxy user. Appropriate permission is required for each user to allow banproxy to connect to Oracle on that login user’s behalf.

1. As the bansecr userid, open the Oracle/Banner Security Maintenance (GSASECR) form.

2. Select the User ID that will use the proxy connection and click the Alter button.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 17: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

3. The User ID’s credentials are displayed on the Authorize or Create an ORACLE ID window. Check the Authorize BANPROXY checkbox and click the Save button.

Deploying finaidutils.jar

For INB to communicate with the servlet, the finaidutils.jar must be deployed on to the OAS 10.1.2.x forms server.

1. The finaidutils.jar file (<BANNER_HOME>/finaid/java/finaidutils.jar) must be copied to the OAS 10.1.2.x.

2. The file name finaidutils.jar must be appended to the end of the CLASSPATH in the file:

OAS_HOME/forms/server/default.env

NoteThe environment file is the file used to run the INB instance. For example, it may be prod.env.

3. Once the above changes are made, INB must be restarted.

2011 Banner Financial Aid 8.10 2-11Hosted Services Handbook

FM Need Analysis Configuration

Page 18: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-12

iAS 10.1.3.x OC4J

Creating the rnpfmxx OC4J Instance

1. Click the default Application Server that was created with the installation of the iAS 10.1.3.x.

2. Click the Create OC4J Instance button.

3. Enter the following attributes and click Create:

• OC4J instance name = rnpfmxx

• Click the Add to a new group with name radio button and enter the following New Group Name = sghe_group

• Check the Start this OC4J instance after creation checkbox

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 19: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

4. Once created, click the new rnpfmxx.

5. Go to the Administration tab and click Server Properties.

6. Change the following attributes, then click Apply:

• Port = 8860 or a free port number

• Protocol = http

• Maximum heap size = 1024m

• Initial heap size = 512m

2011 Banner Financial Aid 8.10 2-13Hosted Services Handbook

FM Need Analysis Configuration

Page 20: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-14

Installing the Share Library

Before installing the Share Library, make sure modifications have been made to the finaidfmlogin.jar and finaiddbseed.jar. Refer to the following procedures: Updating finaidfmlogin.jar and Updating finaiddbseed.jar.

1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.

2. From the Administration tab, click the Shared Libraries task icon.

3. On the following page, click on the Create button.

4. Make the following attribute changes for the new Shared Library and click Next.

• Shared Library Name = banner_finaid

• Shared Library Version = 1.0

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 21: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

5. Add the following jar files to the library (one at a time):

• finaiddbseed.jar

• finaidfmlogin.jar

6. After adding both files, click Finish.

Installing the Servlet

1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.

2. From the Applications tab, click the Deploy button.

2011 Banner Financial Aid 8.10 2-15Hosted Services Handbook

FM Need Analysis Configuration

Page 22: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-16

3. From the Deploy: Select Archive page, set the following archive attributes:

• Archive Location = rnpfmxx.war

• Deployment Plan = rnpfmxx_plan.dat

• Click Next

4. Click on Next.

5. On the Deploy: Deployment Settings page, click the Configure Class Loading task icon.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 23: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

6. Select the Import checkbox for the banner_finaid Shared Library, followed by the OK button.

7. At the Deployment Settings page, click the Deploy button.

Creating the Connection Pool and Data Source for RNPFMXX

1. From the OC4J: rnpfmxx Instance, under the Administration tab, click the JDBC Resources Services task icon.

2011 Banner Financial Aid 8.10 2-17Hosted Services Handbook

FM Need Analysis Configuration

Page 24: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-18

2. In the Application pull-down box, select rnpfmxx, and click the Create button to create a Connection Pool.

The screen changes to show:

3. On the following page, make the following attribute changes and click the Finished button:

• Name = jdbc:java/banner/finaid

• JDBC URL = jdbc:oracle:thin:@<HOST>:<PORT>:<SERVICE_NAME>

NoteReplace the <HOST>, <PORT> and <SERVICE_NAME> with the appropriate values to make a connection to the desired institution Oracle database.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 25: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

• Username = banproxy

• Cleartext Password = the institution password defined for user banproxy

4. From the Data Sources page, select rnpfmxx from the Application pull-down box, to create a Data Source.

2011 Banner Financial Aid 8.10 2-19Hosted Services Handbook

FM Need Analysis Configuration

Page 26: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-20

The screen changes to show:

5. On the following page, make the following attribute changes and click the Finished button:

• Name = BannerFinaid

• JNDI Location = jdbc:java/banner/finaid

• Connection Pool = jdbc:java/banner/finaid

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 27: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

On-Premise

IIS 6.0 on Windows Server 2003

This installation is only required if the institution applied for an on-premise install status.

Minimum requirements

1. The on-premise install of the Financial Aid Need Analysis is called the EFCService web service and it can only be installed on a Windows Server:

• Windows Server 2003 running IIS 6

• Microsoft.NET Framework 3.5

• IIS configured to run ASP.net 2.0

2. Installing IIS 6.0 on Windows Server 2003

2.1. A detailed set of instructions are available from Microsoft at the following URL:

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/750d3137-462c-491d-b6c7-5f370d7f26cd.mspx?mfr=true

2.2. Click Start->Programs->Administrative Tools->Manage Your Server.

2.3. Click Add or remove a role.

2.4. Use the Wizard to add the Application server (IIS, ASP.NET).

3. Installing EFCService web service:

NoteIf you already have a working EFCService from a prior install, you must stop the service before proceeding.

2011 Banner Financial Aid 8.10 2-21Hosted Services Handbook

FM Need Analysis Configuration

Page 28: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-22

3.1. Unzip latest version of the FinAidNeedAnalysis.xxxxxx.x.zip into the following folder:

C:\inetpub\wwwroot\EFCService.

The structures should include:

..\EFCService\App_Data\Config.xml \bin\EFC.dll

\EFCSoapExtension.dll

\ExceptionHandling.dll

\FederalEFC1011.dll

\FederalEFC.dll

\FinancialAidService.dll

\efc_calculation_messages.xsd

\EFCCalculationService.asmx

\Web.config

NoteIf you already have a working EFCService from a prior install, you can now restart the service and skip to step 4, Test the Web Service.

3.2. Start the Manage Your Server.

3.3. Click Manage this application server.

3.4. From the Application Server, navigate to the Default Web Site.

3.5. Set the ASP.NET version.

3.5.1. Right click on the Default Web Site and select Properties.

3.5.2. On the ASP.NET tab, set the ASP.NET version to 2.0.x. Click Ok.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 29: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

3.6. Create a Virtual Directory

3.6.1. Right click on the Default Web Site and select New->Virtual Directory.

3.6.2. Use the Virtual Directory Creation Wizard:

Alias use EFCService.

Path use the path from step 3.3 above.

On the Virtual Directory Access Permissions check both

• Read

• Run scripts (such as ASP)

4. Test the Web Service:

4.1. Enter and go to the following URL in a web browser:

http://localhost/EFCService/EFCCalculationService.asmx

4.2. If the EFCCalculationService page is displayed, the Web Service test was successful.

5. Configuring the EFCService to use Basic Authentication (optional):

5.1. Navigate back to the Default Web Site on the Application Server (refer to steps 3.4 – 3.5, earlier in this procedure).

5.2. Right click on the Default Web Site and select Properties.

5.3. On the Directory Security tab, edit the Authentication and access control.

5.4. Uncheck Enable anonymous access.

2011 Banner Financial Aid 8.10 2-23Hosted Services Handbook

FM Need Analysis Configuration

Page 30: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-24

5.5. Check Basic authentication and enter the Default domain and Realm.

5.6. Update the user name and password for Banner to make a connection. Refer to the Updating finaidfmlogin.jar procedure.

6. Setup EFCService for SSL (optional).

6.1. SSL requires obtaining and registering a certificate with the Web Server.

6.2. The bit length must be 1024 or 2048.

6.3. A detailed set of instructions are available from Microsoft at the following URL:

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/89c7ef2f-f7d6-483c-8b08-ae0c6584dd4d.mspx?mfr=true

6.4. The client side certificate must be loaded to both JVM. Refer to the Loading Certificate to JVM procedure.

6.4.1. JVM running JAVA processes on the job submission server.

6.4.2. JVM running the OC4J 10.1.3.x which has the servlet rnpfmxx.war deployed.

7. Update INB to recognize the on-premise FM Calculation Web Service.

7.1. Login into INB and navigate to the RORPARM form.

7.2. For both parameters, WS_ENDPOINT and WS_ENDPOINT_ONLINE, replace the default value with URL from step 4 – Test the Web Service.

7.3. Make sure to replace localhost with the correct address of the IIS.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 31: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

IIS 7.0 on Windows Server 2008

This installation is only required if the institution applied for an on-premise install status.

Minimum requirements

1. The on-premise install of the Financial Aid Need Analysis is called the EFCService web service and it can only be installed on a Windows Server:

• Windows 2008 running IIS 7

• Microsoft.NET Framework 3.5

• IIS configured to run ASP.net 2.0.

2. Installing IIS 7.0 on Windows Server 2008

2.1. Detailed instructions are available from Microsoft at the following URL:

http://technet.microsoft.com/en-us/library/cc771209(WS.10).aspx?ppud=4

2.2. Click Start, point to Administrative Tools and then click Server Manager.

2.3. In Roles Summary, click Add Roles.

2.4. Use the Add Roles Wizard to add the Web Server role.

2.5. During the Select Role Services, check to include the following items:

• ASP.NET

• Basic Authentication

3. Installing EFCService Web Service:

NoteIf you already have a working EFCService from a prior install, you must stop the service before proceeding.

2011 Banner Financial Aid 8.10 2-25Hosted Services Handbook

FM Need Analysis Configuration

Page 32: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-26

3.1. Unzip latest version of the FinAidNeedAnalysis.xxxxxx.x.zip into the following folder:

C:\inetpub\wwwroot\EFCService.

The structures should include:

..\EFCService\App_Data\Config.xml

\bin\EFC.dll

\EFCSoapExtension.dll

\ExceptionHandling.dll

\FederalEFC1011.dll

\FederalEFC.dll

\FinancialAidService.dll

\efc_calculation_messages.xsd

\EFCCalculationService.asmx

\Web.config

NoteIf you already have a working EFCService from a prior install, you can now restart the service and skip to step 4, Test the Web Service.

3.2. From the Server Manager, expand Web Server (IIS) and select Internet Information Service (IIS) Manager.

3.3. From the Connection screen, right click the Default Web Site and select Add Virtual Directory.

3.3.1. Fill out the Add Virtual Directory popup. Make sure to use EFCService for the Alias and click OK.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 33: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

3.4. From the Server Manager, expand Web Server (IIS) and select Internet Information Service (IIS) Manager.

3.4.1. From the Connections screen, select Default Web Site and do a Refresh by pressing the F5 function key.

3.4.2. The EFCService Folder is displayed:

3.4.3. Right click the EFCService folder, select Convert to Application from the popup menu and select OK.

4. Test the Web Service:

4.1. Enter and go to the following URL in a web browser:

http://localhost/EFCService/EFCCalculationService.asmx

4.2. If the EFCCalculationService page is displayed, the web service test was successful.

5. Configuring the EFCService to use Basic Authentication (optional):

5.1. Navigate back to the Default Web Site on the Internet Information Service (IIS) Manager.

5.2. With the Features View on, select Authentication.

5.3. Disable Anonymous Authentication.

5.4. Enable Basic Authentication.

2011 Banner Financial Aid 8.10 2-27Hosted Services Handbook

FM Need Analysis Configuration

Page 34: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-28

5.5. Edit Basic authentication and enter the Default domain and Realm.

5.6. The user name and password must be updated for Banner to connect. Refer to the Updating finaidfmlogin.jar procedure.

6. Setup EFCService for SSL (optional).

6.1. SSL requires obtaining and registering a certificate with the Web Server.

6.2. The bit length must be 1024 or 2048.

6.3. A detailed set of instructions are available from Microsoft at the following URL:

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/89c7ef2f-f7d6-483c-8b08-ae0c6584dd4d.mspx?mfr=true

6.4. The client side certificate must be loaded to both JVM. Refer to the Loading Certificate to JVM procedure.

6.4.1. JVM running JAVA processes on the job submission server.

6.4.2. JVM running the OC4J 10.1.3.x which has the servlet rnpfmxx.war deployed.

7. Update INB to recognize the on-premise FM Calculation Web Service.

7.1. Login into INB and navigate to the RORPARM form.

7.2. For parameter WS_ENDPOINT, replace the default value with URL from step 4 – Test the Web Service.

7.3. Make sure to replace localhost with the correct address of the IIS.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 35: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

Loading Certificate to JVM for RNPFM12

When connecting to a HTTPS URL (SSL is enabled on the server side) the connecting JVM may need to load the client side certificate.

Use the following steps to load the client side certificate:

1. Navigate to the following directory of the job submission server:

<JAVA_INSTALL>/bin

2. Copy the following two certificates to this same directory:

• fm1_sungardhe.cer

• fm2_sungardhe.cer

3. Execute the following command:

keytool -import -alias fm1_sungardhe -file fm1_sungardhe.cer -keystore ..\lib\security\cacerts -storepass changeit -noprompt

keytool -import -alias fm1_sungardhe -file fm2_sungardhe.cer -keystore ..\lib\security\cacerts -storepass changeit -noprompt

NoteTo load other certificates unique to the institution, use the following format:

keytool -import -alias <mycert> -file <mycertfile.cer> -keystore ..\lib\security\cacerts -storepass changeit -noprompt

4. Disable Loading of Infinity.keystore. The Infinity.keystore is automatically loaded by the year specific process, rnpfm12.jar. This must be disabled so the new certificate loaded to the JVM can be used.

4.1. Open the appropriate script for the environment in a text editor.

• For UNIX based system use script rnpfm12.shl.

• For VMS based system use script rnpfm12.com.

• For Windows based system use script rnpfm12.pl.

2011 Banner Financial Aid 8.10 2-29Hosted Services Handbook

FM Need Analysis Configuration

Page 36: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-30

4.2. Rename the property

• From:

-Dcert=

• To:

-Dcert_HOLD=

Redeploy Servlet

Once a servlet and its supporting share lib, connection pool, and data source have been deployed, subsequent deployment of the servlet, rnpfmxx.war, only requires a redeployment. The share lib, connection pool, and data source do not need to be redeployed.

1. From the rnpfmxx OC4J instance, under the Applications tab, select the rnpfmxx application and then the Redeploy button.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 37: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

2. On redeployment, ONLY choose the Archive rnpfmxx.war. Do not redeploy the Deployment Plan.

3. Click Next and then Next a second time, followed by Redeploy.

2011 Banner Financial Aid 8.10 2-31Hosted Services Handbook

FM Need Analysis Configuration

Page 38: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-32

Proxy Settings

WarningDo not implement these proxy settings unless it is certain that the institution has a proxy server in place and is required for a connection to the internet. Unnecessarily implementing these steps will create connection problems where none existed.

The servlet rnpfmxx.war and the process rnpfm12.jar and its aid year equivalent require internet access to connect to Infinity. If the institution requires the connection be made through a proxy server, the following steps must be implemented.

Proxy settings for process rnpfm12.jar

Process rnpfm12 comes with two properties, http.proxyHost and http.proxyPort, that can be added to allow the process to navigate through a proxy to connect to the internet.

1. To modify these properties, open the appropriate script for the environment in a text editor.

• For UNIX based system use script rnpfm12.shl.

• For VMS based system use script rnpfm12.com.

• For Windows based system use script rnpfm12.pl.

2. Make the changes by adding the properties and replacing the default values with the appropriate values for your institution. Below the existing property -Dcert, the following properties must be added:

• -Dhttp.proxyHost=my_proxy_host

• -Dhttp.proxyPort=my_proxy_port

NoteReplace the my_proxy_host and my_proxy_port with the appropriate values for your institution’s proxy server.

3. For example, if the host is www-proxy.sct.com and the port is 8080:

For UNIX

. -Dhttp.proxyHost=www-proxy.sct.com \

. -Dhttp.proxyPort=8080 \

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 39: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

Proxy settings for servlet rnpfmxx.war

To change the servlet rnpfmxx.war to use a proxy server to access the internet, changes must be made to the Start-parameters for the rnpfmxx OC4J instance.

1. Navigate to the Server Properties page for the rnpfmxx OC4J instance.

For VMS

"-Dhttp.proxyHost=www-proxy.sct.com " -

"-Dhttp.proxyPort=8080 " -

For Windows

"-Dhttp.proxyHost=www-proxy.sct.com "

"-Dhttp.proxyPort=8080 "

2011 Banner Financial Aid 8.10 2-33Hosted Services Handbook

FM Need Analysis Configuration

Page 40: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-34

2. Add the following two properties under the Start-parameters, then click Apply.

NoteReplace the www-proxy.sct.com and 8080 with the appropriate values for your institution’s proxy server.

3. Restart the rnpfmxx OC4J instance.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 41: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

S

S

S

S

Troubleshooting

Missing finaidutils.jar

Unable to connect to servlet rnpfmxx.war

Related Error Message

java.lang.Exception: java.lang.NoClassDefFoundError:com/sct/banner/forms/ui/HttpPost

Description

ymptom: OAS 10.1.2.x Oracle forms server is missing the finaidutils.jar file

olution: Review: INB-Deploying finaidutils.jar

Related Error Message

Servlet url is invalid.

Description

ymptom: The parameter SERVLET_URL defined on the Project Based Parameter Setup Form (RORPARM) has not been updated with the correct URL.

olution: Review: Run immediate Need Analysis using the servlet (step 5).

2011 Banner Financial Aid 8.10 2-35Hosted Services Handbook

FM Need Analysis Configuration

Page 42: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-36

S

D

S

S

S

Connection timed out

Proxy not authorized

Related Error Message

IOException Connection timed out.

Description

ymptom: A parameter for SERVLET_URL was provided on the Project Based Parameter Setup Form (RORPARM). The URL provided is valid, but the service related to the URL is not responding.

iagnostic Double check the URL and make sure the value specifies the rnpfmxx.war servlet.

Note: The www.sungardhe.com web address is a valid URL. However, its value is not the correct URL for the servlet.

olution: Review: Run immediate Need Analysis using the servlet (step 5).

Related Error Message

java.sql.SQLExceptionORA-28150: proxy not authorized to connect as client

Description

ymptom: The user login into INB is not setup to allow proxy login.

olution: Review: Required installation (step 1).

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 43: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

S

S

S

S

Unauthorized

Certification path

NoteIf this is an on-premise solution and SSL is enabled on IIS, the institution client side certificate must be used rather than the one provided by Sungard Higher Education.

Related Error Message

org.apache.axis2.AxisFault: Transport error: 401 Error: Unauthorized

Description

ymptom: The nas.properties file embedded within the finaidfmlogin.jar must be updated with the correct user name and password to allow a successful login to Infinity.

olution: Review: Required installation (step 3).

Related Error Message

org.apache.axis2.AxisFault: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.

OR

org.apache.axis2.AxisFault: com.ibm.jsse2.util.h: PKIX path building failed: java.security.cert.CertPathBuilderException: PKIXCertPathBuilderImpl could not build a valid CertPath.

Description

ymptom: The JVM does not have the correct certificate loaded to connect to Infinity using HTTPS (SSL enabled).

olution: Review: Loading certificate to JVM. Two certificates need to be loaded, fm1_sungardhe.cer and fm2_sungardhe.cer. Both can be found in the /finaid/java/ directory.

2011 Banner Financial Aid 8.10 2-37Hosted Services Handbook

FM Need Analysis Configuration

Page 44: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-38

FAQs

Q: What if the job submission server must use a proxy server to connect to the internet?A: Refer to the Proxy Settings procedure (Proxy settings for process rnpfm12.jar).

Q: What if the OC4J 10.1.3.x must use proxy server to connect to the internet?A: Refer to the Proxy Settings procedure (Proxy settings for servlet rnpfmxx.war).

Q: Can I install iAS 10.1.3.x on the same computer as the existing OAS 10.1.2.x?A: Yes.

Q: Can I install multiple version of the servlet on the same OC4J instance and each connects to a different Oracle database?A: Yes.

1. Follows the steps to create the rnpfmxx OC4J instance if one does not already exists.

2. Follows the steps to Installing the Share Library, Banner_finaid, if one does not already exists. The same share library can be used by multiple servlets.

3. Follows the steps to Installing the Servlet. In step 4, change the Application Name and the Context Root to make it unique. For example rnpfmxx_test. Finish the rest of the installation.

4. Follows the steps to Creating the Connection Pool and Data Source. In step 2 and step 4 make sure to select the Application to rnpfmxx_test. Finish the rest of the installation.

5. The servlet URL then would be:

http://<SERVER>:<PORT>/rnpfmxx_test/FmCalxx

Q: Where do I deploy the finaidutils.jar?A: The finaidutils.jar must be copied from the <BANNER_HOME>/finaid/java/ over to the Forms OAS 10.1.2.x server <ORACLE_HOME>/forms/java/ directory.

First, edit the <ORACLE_HOME>/forms/server/prod.env or the .env file that is used by INB. Second, add finaidutils.jar into the CLASSPATH environmental variable.

For example:

CLASSPATH=D:/ORACLE/OAS_10/j2ee/OC4J_BI_Forms/applications/formsapp/formsweb/WEB-INF/lib/frmsrv.jar;D:/ORACLE/OAS_10/jlib/repository.jar; D:/ORACLE/OAS_10/jlib/ldapjclnt10.jar;D:/ORACLE/OAS_10/jlib/debugger.jar;D:/ORACLE/OAS_10/jlib/ewt3.jar;D:/ORACLE/OAS_10/jlib/share.jar;D:/ORACLE/OAS_10/jlib/utj.jar;D:/ORACLE/OAS_10/jlib/zrclient.jar;D:/ORACLE/OAS_10/reports/jlib/rwrun.jar;D:/ORACLE/OAS_10/forms/java/frmwebutil.jar;D:/ORACLE/OAS_10/forms/java/finaidutils.jar

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 45: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

Q: Where do I get the seed number to update the seed.properties file within the finaiddbseed.jar?A: If you have enough permission you can use the following SQL statement to retrieve the seed numbers:

SELECT GUBIPRF_SEED1,GUBIPRF_SEED3 FROM bansecr.gubiprf;GUBIPRF_SEED1 GUBIPRF_SEED3------------- -------------12345678 87651234

Q: How do I test my deployment of the servlet rnpfmxx.war outside of Banner?A: From a web browser, connect to the servlet URL:

1. For example

• If the servlet URL is http://mtestcomp.corp.sct.com:8860/rnpfmxx/FmCalxx

• If a valid FINAID user is: faisusr

• In a web browser, go to the following address:

http://mtestcomp.corp.sct.com:8860/rnpfmxx/FmCalxx?debug=Y&user=faisusr

2. If everything is successful, you would get this or the equivalent. If there are failures, the appropriate error messages would show accordingly.

rnpfmxx version: 8.10

Database connection Ok.

Web Service connection Ok.

Q: How do I test my login credential to Infinity for validity?A: You can test the credential from a web browser.

1. From a web browser, go to the following URL:

https://fm1.sungardhe.com/EFCService/EFCCalculationService.asmx

2. In the login popup screen, type in the institution login user name and password.

3. If login is successful an EFCCalculationService web page is displayed.

2011 Banner Financial Aid 8.10 2-39Hosted Services Handbook

FM Need Analysis Configuration

Page 46: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-40

Q: Do I have to install the servlet rnpfmxx.war?A: No.

You can run the immediate Need Analysis using the job submission process rnpfm12 or its aid year equivalent instead. Go to INB and access form RORPARM. Change the parameter value USE_JOBSUB to Y.

NoteThe servlet implementation is a performance enhancement. This represents an improvement from 2 to 6 seconds per calculation using the servlet vs. 6 to 30 seconds using the job submission process.

Q: Where is the log file when running the servlet rnpfmxx.war?A: The servlet rnpfmxx.war does not generate the traditional .log and .lis files like process rnpfm12.jar and its aid year equivalent. Instead, if there are any errors, they will appear as a popup in INB. There is also a continuous log on the OC4J hosting the servlet. Additional information can found here to help debug the deployment of the servlet. The log files can be found here <ORACLE_HOME>/opmn/logs/. An example of the file name is: sghe_group~rnpfmxx~sghe_group~1.log.

Q: There was an additional record introduced for the 7.19/8.10 Winter release in RORPARM called WS_ENDDPOINT. How is this additional record used?

A: No action is required. This record is for future use only.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 47: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

Alternative Install to Full iAS 10.1.3.x

OC4J install of iAS 10.1.3.x only

The full installation of iAS 10.1.3.x suite is not necessary to support FM Need Analysis. A customized installation will allow an institution to install only those components of the suite that are necessary. Only the following two components are required:

• J2EE Server – the OC4J installation

• Web Server – the web enabled administrator.

This section provides the necessary steps to quickly install a minimal working OC4J that can support deployment of the FM Need Analysis sevlet, rnpfmxx.war.

NoteThis installation is based on a Windows 2008 Server with Service Pack 2.

1. Run the setup.exe of the iAS 10.1.3.x.

2. Select the Advanced Install radio button and click Next.

3. Click Yes on the next two Warnings.

2011 Banner Financial Aid 8.10 2-41Hosted Services Handbook

FM Need Analysis Configuration

Page 48: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-42

4. Select the J2EE Server and Web Server radio button and click Next.

5. On the Port Configuration Options, leave the selection on Automatic and click Next.

6. Complete entry on all required fields. Make sure to check the Configure this as an Administration OC4J instance checkbox and click Next.

7. Click Next, followed by the Install option.

8. Once the installation is complete, click Exit.

9. Done.

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration

Page 49: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

WebLogic

Details associated with this sub-section will be supplied in a future release.

2011 Banner Financial Aid 8.10 2-43Hosted Services Handbook

FM Need Analysis Configuration

Page 50: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

2-44

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Configuration
Page 51: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

A FM Need Analysis Schema

The following code represents the current FM Need Analysis Schema:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<!-- edited with XMLSpy v2005 rel. 3 U (http://www.altova.com) by Martin Schwartz (Sungard SCT) -->

<xs:schema xmlns:finaid="urn:sungardhe:enterprise:financial_aid:messages" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="urn:sungardhe:enterprise:financial_aid:messages" elementFormDefault="qualified" attributeFormDefault="unqualified" version="3.1.0">

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<!-- edited with XMLSpy v2005 rel. 3 U (http://www.altova.com) by Martin Schwartz (Sungard SCT) -->

<xs:schema xmlns:finaid="urn:sungardhe:enterprise:financial_aid:messages" xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="urn:sungardhe:enterprise:financial_aid:messages" elementFormDefault="qualified" attributeFormDefault="unqualified" version="3.1.0">

<!-- Input XML - Root Element Structure -->

<xs:element name="GetEFCCalculation">

<xs:complexType>

<xs:sequence>

<xs:element name="ISIR" maxOccurs="unbounded">

<xs:complexType>

<xs:sequence>

<xs:element name="TransactionNumber">

<xs:simpleType>

<xs:restriction base="xs:integer">

<xs:minInclusive value="00"/>

<xs:maxInclusive value="99"/>

<xs:fractionDigits value="0"/>

2011 Banner Financial Aid 8.10 A-1Hosted Services HandbookFM Need Analysis Schema

Page 52: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-2

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element ref="finaid:ExternalRecordID"/>

<xs:element name="AwardYear" type="finaid:AwardYearType"/>

<xs:element ref="finaid:EFCDuration" minOccurs="0"/>

<xs:element name="OverrideRejects" type="finaid:YesNoType" minOccurs="0"/>

<xs:element ref="finaid:Student"/>

</xs:sequence>

</xs:complexType>

</xs:element>

</xs:sequence>

</xs:complexType>

</xs:element>

<!-- Output XML - Root Element Structure -->

<xs:element name="ShowEFCCalculation">

<xs:complexType>

<xs:sequence>

<xs:element ref="finaid:EFCEstimate" maxOccurs="unbounded">

<xs:annotation>

<xs:documentation>1 per ISIR record passed to the service</xs:documentation>

</xs:annotation>

</xs:element>

</xs:sequence>

</xs:complexType>

</xs:element>

<!-- Input XML elements Definitions-->

<xs:element name="ExternalRecordID" type="xs:string"/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 53: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:element name="Student" type="finaid:ISIRStudentType"/>

<xs:complexType name="ISIRStudentType">

<xs:sequence>

<xs:element name="BirthDate" type="finaid:DateBlankType" minOccurs="0"/>

<xs:element name="LastNameExists" type="finaid:NameExistsType" minOccurs="0"/>

<xs:element name="FirstNameExists" type="finaid:NameExistsType" minOccurs="0"/>

<xs:element name="AddressStateProvinceCode" type="finaid:StateProvinceCodeType" minOccurs="0">

<xs:annotation>

<xs:documentation>Contact Address</xs:documentation>

</xs:annotation>

</xs:element>

<xs:element name="CitizenshipStatusCode" type="finaid:CitizenshipStatusCodeType" minOccurs="0"/>

<xs:element name="MaritalStatusCode" type="finaid:StudentMaritalStatusCodeType" minOccurs="0"/>

<xs:element name="MaritalStatusDate" type="finaid:DateBlankType" minOccurs="0"/>

<xs:element name="ResidencyStateProvinceCode" type="finaid:StateProvinceCodeType" minOccurs="0"/>

<xs:element name="HouseholdData" type="finaid:HouseholdDataType" minOccurs="0"/>

<xs:element name="SubmissionInformation" type="finaid:SubmissionInformationType" minOccurs="0"/>

<xs:element name="ProcessedApplicationInformation" type="finaid:ProcessedApplicationInformationType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="HouseholdDataType">

<xs:sequence>

<xs:element name="MembersInFamily" type="finaid:Integer2DigitsWithBlankType" minOccurs="0"/>

2011 Banner Financial Aid 8.10 A-3Hosted Services HandbookFM Need Analysis Schema

Page 54: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-4

<xs:element name="NumberInCollege" type="finaid:Integer2DigitsWithBlankType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="SubmissionInformationType">

<xs:sequence>

<xs:element name="AdditionalStudentData" type="finaid:AdditionalStudentDataType" minOccurs="0"/>

<xs:element name="ParentData" type="finaid:ParentDataType" minOccurs="0"/>

<xs:element name="AidAdministratorData" type="finaid:AidAdministratorDataType" minOccurs="0"/>

<xs:element name="DateApplicationCompleted" type="finaid:DateBlankType" minOccurs="0"/>

<xs:element name="SignatureSourceCode" type="finaid:SignatureSourceType" minOccurs="0"/>

<xs:element name="ApplicationReceiptDate" type="finaid:DateBlankType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="AdditionalStudentDataType">

<xs:sequence>

<xs:element name="FinancialData" type="finaid:FinancialDataType" minOccurs="0"/>

<xs:element name="QuestionnaireResponses" type="finaid:QuestionnaireResponsesType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="FinancialDataType">

<xs:sequence>

<xs:element name="IncomeData" type="finaid:IncomeDataType" minOccurs="0"/>

<xs:element name="AssetData" type="finaid:AssetDataType" minOccurs="0"/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 55: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

</xs:sequence>

</xs:complexType>

<xs:complexType name="IncomeDataType">

<xs:sequence>

<xs:element name="TaxReturnStatusCode" type="finaid:TaxReturnStatusCodeType" minOccurs="0"/>

<xs:element name="TaxFormTypeCode" type="finaid:TaxFormTypeCodeType" minOccurs="0"/>

<xs:element name="Form1040AEZEligibleCode" type="finaid:Form1040AEZEligibleCodeType" minOccurs="0"/>

<xs:element name="AdjustedGrossIncome" type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>

<xs:element name="IncomeTaxPaid" type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>

<xs:element name="ExemptionsClaimed" type="finaid:Integer2DigitsWithBlankType" minOccurs="0"/>

<xs:element name="StudentEarnedIncome" type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>

<xs:element name="SpouseEarnedIncome" type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>

<xs:element name="FathersEarnedIncome" type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>

<xs:element name="MothersEarnedIncome" type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>

<xs:element name="EducationCredits" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="ChildSupportPaid" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="NeedBasedEmployment" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="GrantScholarshipAid" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="CombatPay" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="CoopEarnings" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

2011 Banner Financial Aid 8.10 A-5Hosted Services HandbookFM Need Analysis Schema

Page 56: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-6

<xs:element name="PensionPayments" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="IRAPayments" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="ChildSupportReceived" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="InterestIncome" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="IRADistributions" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="UntaxedPensions" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="MilitaryClergyAllowances" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="VeteranNonEducationBenefits" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="OtherUntaxedIncome" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

<xs:element name="OtherNonReportedMoneyReceived" type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="AssetDataType">

<xs:sequence>

<xs:element name="CashSavingsChecking" type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>

<xs:element name="InvestmentNetWorth" type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>

<xs:element name="BusinessFarmNetWorth" type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="QuestionnaireResponsesType">

<xs:sequence>

<xs:element name="HighSchoolDiplomaOrGED" type="finaid:HighSchoolDiplomaOrGEDType" minOccurs="0"/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 57: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:element name="FirstBachelorsByCutoff" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="SSIBenefits" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="FoodStamps" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="FreeReducedPriceLunch" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="TANFBenefits" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="WICBenefits" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="DislocatedWorker" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="DependencyData" type="finaid:DependencyQuestionnaireResponsesType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="DependencyQuestionnaireResponsesType">

<xs:sequence>

<xs:element name="BornBeforeCutoffIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="MastersOrDoctorateIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="MarriedIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="SupportsChildrenIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="LegalDependentsIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="OrphanWardOfCourtIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="ActiveDutyMilitary" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="EmancipatedMinor" type="finaid:YesNoBlankType" minOccurs="0"/>

2011 Banner Financial Aid 8.10 A-7Hosted Services HandbookFM Need Analysis Schema

Page 58: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-8

<xs:element name="InLegalGuardianship" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="HomelessYouthSchool" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="HomelessYouthHUD" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="HomelessRisk" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="VeteranIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="ParentDataType">

<xs:sequence>

<xs:element name="FatherStepfatherBirthDate" type="finaid:DateBlankType" minOccurs="0"/>

<xs:element name="FatherStepfatherSSNExists" type="finaid:SSNExistsType" minOccurs="0"/>

<xs:element name="FatherStepfatherLastNameExists" type="finaid:NameExistsType" minOccurs="0"/>

<xs:element name="MotherStepmotherBirthDate" type="finaid:DateBlankType" minOccurs="0"/>

<xs:element name="MotherStepmotherSSNExists" type="finaid:SSNExistsType" minOccurs="0"/>

<xs:element name="MotherStepmotherLastNameExists" type="finaid:NameExistsType" minOccurs="0"/>

<xs:element name="MaritalStatusCode" type="finaid:MaritalStatusCodeType" minOccurs="0"/>

<xs:element name="ResidencyStateProvinceCode" type="finaid:StateProvinceCodeType" minOccurs="0"/>

<xs:element name="SSIBenefits" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="FoodStamps" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="FreeReducedPriceLunch" type="finaid:YesNoBlankType" minOccurs="0"/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 59: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:element name="TANFBenefits" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="WICBenefits" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="DislocatedWorker" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="HouseholdData" type="finaid:HouseholdDataType" minOccurs="0"/>

<xs:element name="ParentFinancialData" type="finaid:ParentFinancialDataType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="AidAdministratorDataType">

<xs:sequence>

<xs:element name="EFCAdjustmentCode" type="finaid:EFCAdjustmentCodeType" minOccurs="0"/>

<xs:element name="DependencyOverrideCode" type="finaid:DependencyOverrideCodeType" minOccurs="0"/>

<xs:element name="RejectOverrides" type="finaid:RejectOverridesType" minOccurs="0"/>

<xs:element name="AssumptionOverrides" type="finaid:AssumptionOverridesType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="ParentFinancialDataType">

<xs:sequence>

<xs:element name="IncomeData" type="finaid:IncomeDataType" minOccurs="0"/>

<xs:element name="AssetData" type="finaid:AssetDataType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="RejectOverridesType">

<xs:sequence>

2011 Banner Financial Aid 8.10 A-9Hosted Services HandbookFM Need Analysis Schema

Page 60: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-10

<xs:element name="RejectOverrideCode" type="finaid:RejectOverrideCodeType" minOccurs="0" maxOccurs="18"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="AssumptionOverridesType">

<xs:sequence>

<xs:element name="AssumptionOverrideCode" type="finaid:AssumptionOverrideCodeType" minOccurs="0" maxOccurs="6"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="ProcessedApplicationInformationType">

<xs:sequence>

<xs:element name="DependencyStatusCode" type="finaid:DependencyStatusCodeType" minOccurs="0"/>

<xs:element name="GraduateIndicator" type="finaid:YesNoBlankType" minOccurs="0"/>

<xs:element name="StudentTaxFilingStatusCode" type="finaid:TaxFilingStatusCodeType" minOccurs="0"/>

<xs:element name="ParentTaxFilingStatusCode" type="finaid:TaxFilingStatusCodeType" minOccurs="0"/>

<xs:element name="MotherStepmotherSSNMatch" type="xs:string" minOccurs="0"/>

<xs:element name="FatherStepfatherSSNMatch" type="xs:string" minOccurs="0"/>

<xs:element name="StudentSSNMatch" type="xs:string" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<!-- Output XML elements Definitions -->

<xs:element name="EFCEstimate">

<xs:complexType>

<xs:sequence>

<xs:element name="ResponseHeader">

<xs:complexType>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 61: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:sequence>

<xs:element ref="finaid:ExternalRecordID"/>

<xs:element name="Response" type="xs:string"/>

<xs:element name="EFC" type="xs:int" minOccurs="0"/>

<xs:element name="EFCDate" type="xs:dateTime" minOccurs="0"/>

<xs:element ref="finaid:EFCDuration" minOccurs="0"/>

<xs:element name="IsZeroEFC" type="xs:boolean" minOccurs="0"/>

<xs:element name="FormulaName" minOccurs="0">

<xs:simpleType>

<xs:restriction base="xs:string">

<xs:enumeration value="Dependent"/>

<xs:enumeration value="Independent Without Dependents"/>

<xs:enumeration value="Independent With Dependents"/>

<xs:enumeration value="Simple Dependent"/>

<xs:enumeration value="Simple Independent Without Dependents"/>

<xs:enumeration value="Simple Independent With Dependents"/>

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:element name="IsFederal" type="xs:boolean" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:element name="Assumptions" type="finaid:AssumptionsType" minOccurs="0"/>

<xs:element name="RejectReasons" type="finaid:RejectReasonsType" minOccurs="0"/>

2011 Banner Financial Aid 8.10 A-11Hosted Services HandbookFM Need Analysis Schema

Page 62: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-12

<xs:element name="EFCCalculations" type="finaid:EFCIntermediateValuesType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

</xs:element>

<xs:complexType name="EFCIntermediateValuesType">

<xs:sequence>

<xs:element name="TotalIncome" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="TotalIncomeAllowances" type="finaid:Integer7DigitsType" minOccurs="0"/>

<xs:element name="StateTaxAllowance" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="ParentSocialSecurityTax" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="EmploymentAllowance" type="finaid:Integer7DigitsType" minOccurs="0"/>

<xs:element name="IncomeProtectionAllowance" type="finaid:Integer7DigitsType" minOccurs="0"/>

<xs:element name="AvailableIncome" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="AvailableIncomeContribution" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="DiscretionaryNetWorth" type="finaid:SignedInteger9DigitsType" minOccurs="0"/>

<xs:element name="NetWorth" type="finaid:Integer9DigitsType" minOccurs="0"/>

<xs:element name="AssetProtectionAllowance" type="finaid:Integer9DigitsType" minOccurs="0"/>

<xs:element name="ParentAssetContribution" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="AdjustedAvailableIncome" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="TotalStudentContribution" type="finaid:Integer7DigitsType" minOccurs="0"/>

<xs:element name="TotalParentContribution" type="finaid:Integer7DigitsType" minOccurs="0"/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 63: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:element name="AlternativeTotalParentContribution" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="ParentContribution" type="finaid:Integer7DigitsType" minOccurs="0"/>

<xs:element name="StudentTotalIncome" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="StudentSocialSecurityTax" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="StudentStateTaxAllowance" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="NegativeAdjustableIncomeOffset" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="StudentIncomeAllowances" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="StudentIncomeContribution" type="finaid:Integer7DigitsType" minOccurs="0"/>

<xs:element name="StudentDiscretionaryNetWorth" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="StudentAssetContribution" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="FISAPTotalIncome" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

<xs:element name="NineMonthEFC" type="finaid:SignedInteger7DigitsType" minOccurs="0"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="RejectReasonsType">

<xs:sequence>

<xs:element name="RejectCode" type="finaid:RejectCodeType" minOccurs="0" maxOccurs="32"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="AssumptionsType">

<xs:sequence>

<xs:element name="Assumption" type="finaid:AssumptionType" minOccurs="0" maxOccurs="unbounded"/>

2011 Banner Financial Aid 8.10 A-13Hosted Services HandbookFM Need Analysis Schema

Page 64: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-14

</xs:sequence>

</xs:complexType>

<xs:complexType name="AssumptionType">

<xs:sequence>

<xs:element name="FieldName" type="finaid:FieldNameType"/>

<xs:element name="FieldValue" type="finaid:FieldValueType"/>

</xs:sequence>

</xs:complexType>

<!-- Simple Types-->

<xs:simpleType name="AwardYearType">

<xs:restriction base="xs:int"/>

</xs:simpleType>

<xs:element name="EFCDuration">

<xs:simpleType>

<xs:restriction base="xs:byte">

<xs:minInclusive value="0"/>

<xs:maxInclusive value="12"/>

</xs:restriction>

</xs:simpleType>

</xs:element>

<xs:simpleType name="YesNoType">

<xs:restriction base="xs:string">

<xs:enumeration value="Y"/>

<xs:enumeration value="N"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="CitizenshipStatusCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value=""/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 65: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="StudentMaritalStatusCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

<xs:enumeration value="4"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="MaritalStatusCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

<xs:enumeration value="4"/>

<xs:enumeration value=""/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="TaxReturnStatusCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value=""/>

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

</xs:restriction>

2011 Banner Financial Aid 8.10 A-15Hosted Services HandbookFM Need Analysis Schema

Page 66: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-16

</xs:simpleType>

<xs:simpleType name="TaxFormTypeCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value=""/>

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

<xs:enumeration value="4"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Form1040AEZEligibleCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value=""/>

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="HighSchoolDiplomaOrGEDType">

<xs:restriction base="xs:string">

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

<xs:enumeration value="4"/>

<xs:enumeration value=""/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="DependencyOverrideCodeType">

<xs:restriction base="xs:string">

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 67: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:enumeration value="Requested"/>

<xs:enumeration value="Cancelled"/>

<xs:enumeration value="Failed"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="EFCAdjustmentCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="Processed"/>

<xs:enumeration value="Failed"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="RejectOverrideCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="A"/>

<xs:enumeration value="B"/>

<xs:enumeration value="C"/>

<xs:enumeration value="G"/>

<xs:enumeration value="N"/>

<xs:enumeration value="W"/>

<xs:enumeration value="3"/>

<xs:enumeration value="4"/>

<xs:enumeration value="12"/>

<xs:enumeration value="20"/>

<xs:enumeration value="J"/>

<xs:enumeration value="K"/>

<xs:enumeration value="D"/>

<xs:enumeration value="E"/>

<xs:enumeration value="F"/>

<xs:enumeration value="R"/>

2011 Banner Financial Aid 8.10 A-17Hosted Services HandbookFM Need Analysis Schema

Page 68: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-18

<xs:enumeration value="S"/>

<xs:enumeration value="T"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="AssumptionOverrideCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

<xs:enumeration value="4"/>

<xs:enumeration value="5"/>

<xs:enumeration value="6"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="SignatureSourceType">

<xs:restriction base="xs:string">

<xs:enumeration value="ApplicantOnly"/>

<xs:enumeration value="ApplicantAndParent"/>

<xs:enumeration value="ParentOnly"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="DependencyStatusCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="Dependent"/>

<xs:enumeration value="Independent"/>

<xs:enumeration value="DependentNoEFC"/>

<xs:enumeration value="IndependentNoEFC"/>

</xs:restriction>

</xs:simpleType>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 69: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:simpleType name="SSNExistsType">

<xs:restriction base="xs:string">

<xs:enumeration value="E"/>

<xs:enumeration value="B"/>

<xs:enumeration value="0"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="NameExistsType">

<xs:restriction base="xs:string">

<xs:enumeration value="E"/>

<xs:enumeration value="B"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="StateProvinceCodeType">

<xs:restriction base="xs:token">

<xs:enumeration value="AA">

<xs:annotation>

<xs:documentation>MILITARY-AMERICAS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="AB">

<xs:annotation>

<xs:documentation>ALBERTA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="AE">

<xs:annotation>

<xs:documentation>MILITARY-EUROPE</xs:documentation>

</xs:annotation>

2011 Banner Financial Aid 8.10 A-19Hosted Services HandbookFM Need Analysis Schema

Page 70: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-20

</xs:enumeration>

<xs:enumeration value="AK">

<xs:annotation>

<xs:documentation>ALASKA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="AL">

<xs:annotation>

<xs:documentation>ALABAMA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="AP">

<xs:annotation>

<xs:documentation>MILITARY-PACIFIC</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="AR">

<xs:annotation>

<xs:documentation>ARKANSAS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="AS">

<xs:annotation>

<xs:documentation>AMERICAN SAMOA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="AZ">

<xs:annotation>

<xs:documentation>ARIZONA</xs:documentation>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 71: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="BC">

<xs:annotation>

<xs:documentation>BRITISH COLUMBIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="CA">

<xs:annotation>

<xs:documentation>CALIFORNIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="CO">

<xs:annotation>

<xs:documentation>COLORADO</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="CT">

<xs:annotation>

<xs:documentation>CONNECTICUT</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="CZ">

<xs:annotation>

<xs:documentation>CANAL ZONE</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="DC">

<xs:annotation>

2011 Banner Financial Aid 8.10 A-21Hosted Services HandbookFM Need Analysis Schema

Page 72: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-22

<xs:documentation>DISTRICT OF COLUMBIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="DE">

<xs:annotation>

<xs:documentation>DELAWARE</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="FL">

<xs:annotation>

<xs:documentation>FLORIDA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="FM">

<xs:annotation>

<xs:documentation>FEDERATED STATES OF MICRONESIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="GA">

<xs:annotation>

<xs:documentation>GEORGIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="GU">

<xs:annotation>

<xs:documentation>GUAM</xs:documentation>

</xs:annotation>

</xs:enumeration>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 73: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:enumeration value="HI">

<xs:annotation>

<xs:documentation>HAWAII</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="IA">

<xs:annotation>

<xs:documentation>IOWA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="ID">

<xs:annotation>

<xs:documentation>IDAHO</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="IL">

<xs:annotation>

<xs:documentation>ILLINOIS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="IN">

<xs:annotation>

<xs:documentation>INDIANA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="KS">

<xs:annotation>

<xs:documentation>KANSAS</xs:documentation>

</xs:annotation>

2011 Banner Financial Aid 8.10 A-23Hosted Services HandbookFM Need Analysis Schema

Page 74: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-24

</xs:enumeration>

<xs:enumeration value="KY">

<xs:annotation>

<xs:documentation>KENTUCKY</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="LA">

<xs:annotation>

<xs:documentation>LOUISIANA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MA">

<xs:annotation>

<xs:documentation>MASSACHUSETTS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MB">

<xs:annotation>

<xs:documentation>MANITOBA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MD">

<xs:annotation>

<xs:documentation>MARYLAND</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="ME">

<xs:annotation>

<xs:documentation>MAINE</xs:documentation>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 75: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MH">

<xs:annotation>

<xs:documentation>MARSHALL ISLANDS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MI">

<xs:annotation>

<xs:documentation>MICHIGAN</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MN">

<xs:annotation>

<xs:documentation>MINNESOTA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MO">

<xs:annotation>

<xs:documentation>MISSOURI</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MP">

<xs:annotation>

<xs:documentation>NORTHERN MARIANA ISLANDS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MS">

<xs:annotation>

2011 Banner Financial Aid 8.10 A-25Hosted Services HandbookFM Need Analysis Schema

Page 76: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-26

<xs:documentation>MISSISSIPPI</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="MT">

<xs:annotation>

<xs:documentation>MONTANA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NB">

<xs:annotation>

<xs:documentation>NEW BRUNSWICK</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NC">

<xs:annotation>

<xs:documentation>NORTH CAROLINA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="ND">

<xs:annotation>

<xs:documentation>NORTH DAKOTA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NE">

<xs:annotation>

<xs:documentation>NEBRASKA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NF">

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 77: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:annotation>

<xs:documentation>NEWFOUNDLAND</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NH">

<xs:annotation>

<xs:documentation>NEW HAMPSHIRE</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NJ">

<xs:annotation>

<xs:documentation>NEW JERSEY</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NL">

<xs:annotation>

<xs:documentation>NEWFOUNDLAND AND LABRADOR</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NM">

<xs:annotation>

<xs:documentation>NEW MEXICO</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NS">

<xs:annotation>

<xs:documentation>NOVA SCOTIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

2011 Banner Financial Aid 8.10 A-27Hosted Services HandbookFM Need Analysis Schema

Page 78: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-28

<xs:enumeration value="NT">

<xs:annotation>

<xs:documentation>NORTHWEST TERRITORIES</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NU">

<xs:annotation>

<xs:documentation>NUNAVUT</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NV">

<xs:annotation>

<xs:documentation>NEVADA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="NY">

<xs:annotation>

<xs:documentation>NEW YORK</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="OH">

<xs:annotation>

<xs:documentation>OHIO</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="OK">

<xs:annotation>

<xs:documentation>OKLAHOMA</xs:documentation>

</xs:annotation>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 79: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

</xs:enumeration>

<xs:enumeration value="ON">

<xs:annotation>

<xs:documentation>ONTARIO</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="OR">

<xs:annotation>

<xs:documentation>OREGON</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="PA">

<xs:annotation>

<xs:documentation>PENNSYLVANIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="PE">

<xs:annotation>

<xs:documentation>PRINCE EDWARD ISLAND</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="PR">

<xs:annotation>

<xs:documentation>PUERTO RICO</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="PW">

<xs:annotation>

<xs:documentation>REPUBLIC OF PALAU</xs:documentation>

2011 Banner Financial Aid 8.10 A-29Hosted Services HandbookFM Need Analysis Schema

Page 80: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-30

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="QC">

<xs:annotation>

<xs:documentation>QUEBEC</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="RI">

<xs:annotation>

<xs:documentation>RHODE ISLAND</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="SC">

<xs:annotation>

<xs:documentation>SOUTH CAROLINA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="SD">

<xs:annotation>

<xs:documentation>SOUTH DAKOTA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="SK">

<xs:annotation>

<xs:documentation>SASKATCHEWAN</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="TN">

<xs:annotation>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 81: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:documentation>TENNESSEE</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="TX">

<xs:annotation>

<xs:documentation>TEXAS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="UT">

<xs:annotation>

<xs:documentation>UTAH</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="VA">

<xs:annotation>

<xs:documentation>VIRGINIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="VI">

<xs:annotation>

<xs:documentation>VIRGIN ISLANDS</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="VT">

<xs:annotation>

<xs:documentation>VERMONT</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="WA">

2011 Banner Financial Aid 8.10 A-31Hosted Services HandbookFM Need Analysis Schema

Page 82: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-32

<xs:annotation>

<xs:documentation>WASHINGTON</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="WI">

<xs:annotation>

<xs:documentation>WISCONSIN</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="WV">

<xs:annotation>

<xs:documentation>WEST VIRGINIA</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="WY">

<xs:annotation>

<xs:documentation>WYOMING</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="YT">

<xs:annotation>

<xs:documentation>YUKON</xs:documentation>

</xs:annotation>

</xs:enumeration>

<xs:enumeration value="CN"/>

<xs:enumeration value="FC"/>

<xs:enumeration value="PQ"/>

<xs:enumeration value="MX"/>

<xs:enumeration value=""/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 83: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="TaxFilingStatusCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="TaxFiler"/>

<xs:enumeration value="NonTaxFiler"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="BlankType">

<xs:restriction base="xs:string">

<xs:enumeration value=""/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Integer1DigitType">

<xs:restriction base="xs:integer">

<xs:minInclusive value="0"/>

<xs:maxInclusive value="9"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Integer1DigitWithBlankType">

<xs:union memberTypes="finaid:Integer1DigitType finaid:BlankType"/>

</xs:simpleType>

<xs:simpleType name="Integer2DigitsType">

<xs:restriction base="xs:integer">

<xs:minInclusive value="0"/>

<xs:maxInclusive value="99"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Integer2DigitsWithBlankType">

2011 Banner Financial Aid 8.10 A-33Hosted Services HandbookFM Need Analysis Schema

Page 84: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-34

<xs:union memberTypes="finaid:Integer2DigitsType finaid:BlankType"/>

</xs:simpleType>

<xs:simpleType name="Integer5DigitsType">

<xs:restriction base="xs:decimal">

<xs:minInclusive value="0"/>

<xs:maxInclusive value="99999"/>

<xs:fractionDigits value="0"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Integer5DigitsWithBlankType">

<xs:union memberTypes="finaid:Integer5DigitsType finaid:BlankType"/>

</xs:simpleType>

<xs:simpleType name="Integer6DigitsType">

<xs:restriction base="xs:integer">

<xs:minInclusive value="0"/>

<xs:maxInclusive value="999999"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Integer6DigitsWithBlankType">

<xs:union memberTypes="finaid:Integer6DigitsType finaid:BlankType"/>

</xs:simpleType>

<xs:simpleType name="SignedInteger6DigitsType">

<xs:restriction base="xs:decimal">

<xs:minInclusive value="-999999"/>

<xs:maxInclusive value="999999"/>

<xs:fractionDigits value="0"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="SignedInteger6DigitsWithBlankType">

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 85: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:union memberTypes="finaid:SignedInteger6DigitsType finaid:BlankType"/>

</xs:simpleType>

<xs:simpleType name="SignedInteger7DigitsWithBlankType">

<xs:union memberTypes="finaid:SignedInteger7DigitsType finaid:BlankType"/>

</xs:simpleType>

<xs:simpleType name="Integer7DigitsType">

<xs:restriction base="xs:decimal">

<xs:minInclusive value="0"/>

<xs:maxInclusive value="9999999"/>

<xs:fractionDigits value="0"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="SignedInteger7DigitsType">

<xs:restriction base="xs:decimal">

<xs:minInclusive value="-9999999"/>

<xs:maxInclusive value="9999999"/>

<xs:fractionDigits value="0"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="Integer9DigitsType">

<xs:restriction base="xs:decimal">

<xs:minInclusive value="0"/>

<xs:maxInclusive value="999999999"/>

<xs:fractionDigits value="0"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="SignedInteger9DigitsType">

<xs:restriction base="xs:decimal">

2011 Banner Financial Aid 8.10 A-35Hosted Services HandbookFM Need Analysis Schema

Page 86: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-36

<xs:minInclusive value="-999999999"/>

<xs:maxInclusive value="999999999"/>

<xs:fractionDigits value="0"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="YesNoBlankType">

<xs:union memberTypes="xs:boolean finaid:BlankType"/>

</xs:simpleType>

<xs:simpleType name="RejectCodeType">

<xs:restriction base="xs:string">

<xs:enumeration value="1"/>

<xs:enumeration value="2"/>

<xs:enumeration value="3"/>

<xs:enumeration value="4"/>

<xs:enumeration value="5"/>

<xs:enumeration value="6"/>

<xs:enumeration value="7"/>

<xs:enumeration value="8"/>

<xs:enumeration value="9"/>

<xs:enumeration value="10"/>

<xs:enumeration value="11"/>

<xs:enumeration value="12"/>

<xs:enumeration value="13"/>

<xs:enumeration value="14"/>

<xs:enumeration value="15"/>

<xs:enumeration value="17"/>

<xs:enumeration value="18"/>

<xs:enumeration value="20"/>

<xs:enumeration value="A"/>

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema

Page 87: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

<xs:enumeration value="B"/>

<xs:enumeration value="C"/>

<xs:enumeration value="D"/>

<xs:enumeration value="E"/>

<xs:enumeration value="F"/>

<xs:enumeration value="G"/>

<xs:enumeration value="J"/>

<xs:enumeration value="K"/>

<xs:enumeration value="N"/>

<xs:enumeration value="R"/>

<xs:enumeration value="S"/>

<xs:enumeration value="T"/>

<xs:enumeration value="W"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="FieldNameType">

<xs:restriction base="xs:string">

<xs:maxLength value="50"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="FieldValueType">

<xs:restriction base="xs:string">

<xs:maxLength value="50"/>

</xs:restriction>

</xs:simpleType>

<xs:simpleType name="DateBlankType">

<xs:union memberTypes="xs:date finaid:BlankType"/>

</xs:simpleType>

</xs:schema>

2011 Banner Financial Aid 8.10 A-37Hosted Services HandbookFM Need Analysis Schema

Page 88: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

A-38

Banner Financial Aid 8.10 January 2011Hosted Services HandbookFM Need Analysis Schema
Page 89: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

Index

A

Alternative Install to Full iAS 10.1.3.x 2-41

B

BannerInternet Native (INB) 2-10

banproxyConfigure 2-10

C

CertificateLoading to JVM for RNPFM12 2-29

Certification path 2-37Checklists

Configuration 2-5Configuration

Checklists 2-5FM Need Analysis 2-1Options 2-3

Configurebanproxy 2-10

Connection Pool and Data Source for RNPFMXXCreating 2-17

Connection timed out 2-36Creating

Connection Pool and Data Source for RNPFMXX 2-17

Creating the rnpfmxx OC4J Instance 2-12

D

Deployingfinaidutils.jar 2-11

F

FAQs 2-38

finaiddbseed.jarUpdating 2-9

finaidfmlogin.jarUpdating 2-8

finaidutils.jarDeploying 2-11Missing 2-35

FM Need AnalysisConfiguration 2-1Schema A-1

I

iAS 10.1.3.xAlternative Install to Full 2-41

iAS 10.1.3.x OC4J 2-12IIS 6.0

Windows Server 2003 2-21IIS 7.0

Windows Server 2008 2-25INB

Internet Native Banner 2-10Installing

Servlet 2-15Share Library 2-14

Internet Native Banner (INB) 2-10

L

Loading CertificateJVM for RNPFM12 2-29

M

Missing finaidutils.jar 2-35

N

not authorizedProxy 2-36

2011 Banner Financial Aid 8.10 I-1Hosted Services Handbook

Index

Page 90: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

O

Object List 2-2OC4J of iAS 10.1.3.x 2-1Off-Premise 2-2On-Premise 2-2, 2-21Options

Configuration 2-3

P

Procedures 2-8Proxy not authorized 2-36Proxy Settings 2-32Proxy settings

for process rnpfm12.jar 2-32for servlet rnpfmxx.war 2-33

R

RedeployServlet 2-30

Redeploying the servlet rnpfmxx.war 2-7rnpfm12.jar

Proxy settings for process 2-32rnpfmxx.war

Proxy settings for servlet 2-33Redeploying the servlet 2-7Unable to connect to servlet 2-35

S

SchemaFM Need Analysis A-1

ServletInstalling 2-15Redeploy 2-30

SettingsProxy 2-32

Share LibraryInstalling 2-14

T

timed outConnection 2-36

Troubleshooting 2-35

U

Unable to connect to servlet rnpfmxx.war 2-35

Unauthorized 2-37Updating

finaiddbseed.jar 2-9finaidfmlogin.jar 2-8

W

WebLogic 2-43Windows Server 2003

IIS 6.0 2-21Windows Server 2008

IIS 7.0 2-25

I-2 Banner Financial Aid 8.10 January 2011Hosted Services HandbookIndex

Page 91: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

January

2011 Banner Financial Aid 8.10 I-3Hosted Services Handbook

Index

Page 92: Banner Financial Aid / Hosted Services Handbook / 8...iv Banner Financial Aid 8.10 January 2011 Hosted Services Handbook Contents Internet Native Banner (INB).2-10 iAS 10.1.3.x OC4J.2-12

4 Country View RoadMalvern, Pennsylvania 19355

United States of Americawww.sungardhe.com