Appendices and Other Resources

Allocating Extra Memory for Java

Backing up your jobs

Macintosh OSX Considerations

P3Expeditor Installation Folder

Release Notes

Envelope Size Chart

Paper Weight Conversions

Allocating Extra Memory for Java

Background

The P3Procure and P3Source operates within the Java Virtual Machine (JVM) environment. The JVM environment exists as a subsystem within nearly all computer operating systems (i.e. Windows, Mac OSX, Linux, and many others). This subsystem is oftentimes referred to as the Java runtime environment (JRE). In the case of Macintosh OSX Java is built into the operating system. For Windows the Java runtime environment is installed as an application within Windows. In both cases the operating system provides a default amount of RAM memory for Java to operate within. Typically this is plenty of memory to run the P3Expeditor application. In cases where customer databases are very large, the reporting section of P3Expeditor may require additional memory to operate properly. The rest of this page describes how to adjust your operating system to give Java more memory.

Windows

There are two ways to extend the memory for Java within the Windows environment.

Method 1:

The first is to use the Java control panel within the Windows control panel and add extended runtime parameters to the configuration.

  1. Open the Windows control panel.
  2. Open the Java control panel.
  3. Go to the Java tab pane.
  4. Click the view button. This will display a list of the Java runtime environments (JREs) installed on your computer.
  5. The list of JREs has a column titled runtime parameters this is where you need to put in the parameters for extended memory.
  6. Put the following parameters in that field and save the settings:
-Xms200m -Xmx200m

The parameters listed above will allocate 200 MB of memory for the Java virtual machine. If you wish to allocate more than that simply change the 200 to another number.

Method 2:

The second method for extending memory for Java is to create a batch file to run P3Expediter. In the batch file you can specify runtime parameters for Java.

A batch file is a simple text file ( you can use Windows Notepad to create and edit it), with a ".bat" extension on the file name. When you double-click on am .bat file in Windows the batch file will be executed within a system console window, oftentimes referred to as a DOS window.

The batch file for running P3Expeditor is quite simple. It does two things, it changes the working directory to the folder where P3Expeditor is installed and it issues a command to start Java and open the P3Expeditor application. An example of a batch file is listed below.

cd "C:\Users\Caleb\Documents\P3Expeditor\"
java -Xms200m -Xmx200m -jar p3expeditor.jar
pause

The CD command on the first line changes the working directory to the folder where a P3Expeditor is installed. the past to the working directory for P3Expeditor will be different on each computer. So you will need to find where P3Expeditor is installed on your computer, and substitute that path for the one in my example above.

The second line tells Java to run with three runtime parameters. The parameters are each preceded by "-". The first two indicate memory allocations for Java, the third specifies the name of the file we wish opened. In this case the "p3expeditor.jar" file.

The last line of the batch file with the "pause" statement is optional. It simply tells Windows to keep the system console window open after the Java command is executed.

After you create the batch file it is convenient to save it directly onto your Windows desktop so you can double-click it to start the P3Expeditor application. However, it can be saved and run from any file location you like.

Macintosh OSx

To extend memory for Java under OSx, you need to adjust the runtime parameters in a similar fashion as used in Windows. The Java preferences for OSx can be modified using the Java preferences utility program. This utility program is located in the Applications/Utilities/ folder.

Add these run-time parameters to your Java runtime preferences:

-Xms200m -Xmx200m

A command line Applescript file can also be created to run P3Expeditor. Please see Apple support for more information on Applescript.

Backing Up Your Jobs

For most users, backing up your jobs is no longer necessary because most users are on the NetPlus Cloud Storage system. This allows for your data to be continuously and securely backed up.

It is good practice to back up your P3Expeditor data to protect yourself in the event something bad happens to your computer. How often you should make a backup depends upon your acceptable level of pain you would experience if your computer/hard drive were to "bite-the-dust". It is also highly recommended that you make a backup before you install a software update. Backing up your P3Expeditor is very easy to do! All of the software and data is stored in a single folder, "P3Expeditor Installation Folder". Simply copy all the contents of the P3Expeditor Installation Folder to your backup media.

If you need to restore a backup to a restored system, just recreate a directory or folder and copy the backed up files to the directory.

To restore your desktop shortcut or alias for launching P3Expeditor run the P3Expeditor installer. This will replace the executable file with the latest version of P3Expeditor and create the desktop shortcut or alias.

Macintosh OSX

P3Expeditor Macintosh OSX Issues

Fonts Displaying Improperly

P3Expeditor through JAVA uses the Macintosh default fonts delivered as part of the operating system. From time to time we get calls about inappropriate (i.e. ugly) fonts being used in the P3Expeditor user interface. In most cases the cause is that the user has turned off the default system fonts either directly or indirectly through a font management system (e.g. Extensis Suitcase).

Copy and Paste

Within Macintosh's implementation of JAVA for OSX the default copy and paste keys are Ctrl+C and Ctrl+V instead of the common Cmd+C and Cmd+V. We recently (September 05) added some code that enabled both copy and paste key combinations in most places within the P3Expeditor system.

Application Update Issues

In some cases, after updating P3Expeditor with the automatic update function the desktop alias no longer worked. This issue has been resolved in general. However, if you have this issue, simply delete the existing alias and create a new one pointing to the P3Expeditor.jar file located in the "Applications/P3Expeditor for OSX" folder. Do not move the application file to the desktop as that will cause many problems.

Enterprise Version Network Folder

In Enterprise mode there are two OSX special considerations. First under OSX when searching for the shared job folder mounted network servers appear under "Volumes". Second, the network server must be mounted (connected) before you start using P3Expeditor. Otherwise, P3Expeditor will be unable to see your job files on the server.

P3Expeditor Installation Folder

General Information

This is the folder on the user's local computer where the P3Expeditor application files are installed and user settings data is stored. All data and files related to P3Expeditor that are stored on the local computer are stored in this folder, except the Windows desktop shortcut or Mac OSX alias file. This makes backing up user data and transfering the program to other computers easy.

The default locations for this folder are:

  • MAC - "Macintosh HD/Applications/P3Expeditor OSX Folder"
  • Windows (Installed after 2008) - "My Documents\P3Software\P3Expeditor"
  • Windows (Installed before 2009) - "C:\Program Files\P3Software\P3Expeditor"

What gets stored in the the P3Expeditor Installation Folder?

Always stored in the P3Expeditor Installation Folder:

  • P3Expeditor executables: p3expeditor.jar and update.jar
  • P3Expeditor QuickBooks Integration files: P3ExtCfg.exe, p3extpkg.dll
  • Application update backup files: p3expeditor.old, update.old, P3ExtCfg.old, p3extpkg.old
  • Icon file: p3expeditor.ico
  • User settings: userinfo.p3x
  • Branding Images (.gif or .jpg):
  • Report Images (.gif or .jpg): RFQWOlogo.jpg, PRPINVlogo.jpg, POlogo.jpg, bidrptlogo.jpg

Professional User Data Files:

  • Jobs (.PRJ extensions)
  • Projects (Project_XXXXXXXX.xml)
  • Templates (.tpl extensions)
  • Customers (Clients.p3x)
  • Suppliers (Suppliers)
  • Autonumbering (jobnumber.ajn)
  • Enterprise Data (enterprise.xml and network.xml(old format))

Other:

  • Export files Suppliers and Customers
  • Report files displayed in the browser, MS-Word or MS-Excel

Locating the P3Expeditor Installation Folder

  • Windows non-Vista:
  1. Right click on P3Expeditor Shortcut and select "Properties"
  2. Click Find Target... button
  3. The folder will then open in a new folder window
  • Windows Vista:
  1. Right click on P3Expeditor Shortcut and select "Open File Location"
  2. The folder will then open in a new folder window
  • MAC:
  1. Select the P3Expeditor alias icon on the desktop
  2. Click the File menu and "Show Original" menu item (apple + R works too)
  3. The folder will then open in a new folder window

Envelope Size Chart

US Commercial Envelopes
Number				 Dimension
5				     3 1/16 x 5 1/2
6 1/4				 3 9/16 x 6 
6 3/4				 3 5/8 x 6 1/2
7				     3 3/4 x 6 3/4
7 3/4 (Monarch)      3 7/8 x 7 1/2
8 5/8				 3 5/8 x 8 5/8
9				     3 7/8 x 8 7/8
10				     4 1/8 x 9 1/2
11				     4 1/2 x 10 3/8
12				     4 3/4 x 11
14				     5 x 11 1/2
Data				 3 1/2 x 7 5/8

US Standard Size Colored Wove Envelopes
6 1/4  -  6 3/4  -  9  -  10

US Commercial Window Envelopes
( Poly, Glass, Open )   ( Regular or Side Seam )
6 1/4				3 9/16 x 6
6 3/4				3 5/8 x 6 1/2
7				    3 3/4 x 6 3/4
7 3/4				3 7/8 x 7 1/2
8 5/8				3 5/8 x 8 5/8
9				    3 7/8 x 8 7/8
10				    4 1/8 x 9 1/2
11				    4 1/2 x 10 3/8
12				    4 3/4 x 11
14				    5 x 11 1/2

US Booklet Envelopes
( Flap running the long length of the envelope )
3				    4 3/4 x 6 1/2
4 1/2				5 1/2 x 7 1/2
5			    	5 1/2 x 8 1/8
6				    5 3/4 x 8 7/8
6 1/2				6 x 9
6 3/4				6 1/2 x 9 1/2
6 5/8				6 x 9 1/2
7 1/4				7 x 10
7 1/2				7 1/2 x 10 1/2
9				    8 3/4 x 11 1/2
9 1/2				9 x 12
10				    9 1/2 x 12 5/8
13				    10 x 13

US Booklet Windows
6 1/2				6 x 9

US Catalog Envelopes
1 Scarf				4 5/8 x 6 3/4
3 Scarf				5 x 7 1/2
4 1/4 Scarf			5 1/2 x 7 1/2
6 Scarf				5 1/2 x 8 1/4
7 Glove				4 x 6 3/8
1 Cat				6 x 9
1 3/4 Cat 			6 1/2 x 9 1/2
3 Cat				7 x 10
6 Cat				7 1/2 x 10 1/2
9 3/4 Cat 			8 3/4 x 11 1/4
10 1/2 Cat			9 x 12
12 1/2 Cat			9 1/2 x 12 1/2
13 1/2 Cat			10 x 13
14 1/2 Cat			11 1/2 x 14 1/2
15 Cat				10 x 15
15 1/2 Cat			12 x 15 1/2

US Coin Envelopes
1				2 1/4 x 3 1/2
3				2 1/2 x 4 1/4
4				3 x 4 1/2
4 1/2			3 x 4 7/8
5				2 7/8 x 5 1/4
5 1/2			3 1/8 x 5 1/2
6				3 3/8 x 6
7				3 1/2 x 6 1/2


US Clasp Envelopes
15				4 x 6 3/8
25				4 5/8 x 6 3/4
35				5 x 7 1/2
40				5 1/2 x 7 1/2
55				6 x 9
63				6 1/2 x 9 1/2
68				7 x 10
75				7 1/2 x 10 1/2
87				8 3/4 x 11 1/4
90				9 x 12
93				9 1/2 x 12 1/2
95				10 x 12
97				10 x 13
98				10 x 15
105				11 1/2 x 14 1/2
110				12 x 15 1/2

US Remittance Envelopes
6 1/4			3 9/16 x 6
6 3/4			3 5/8 x 6 1/2
9				3 7/8 x 8 7/8

US Invitation Envelopes
A-2				4 3/8 x 5 3/4
A-6				4 3/4 x 6 1/2
A-7				5 1/4 x 7 1/4

US Policy Envelopes
10				4 1/8 x 9 1/2
11				4 1/2 x 10 3/8
14				5 x 11 1/2

Paper Weight Conversions

North American to GSM Paper Weight Conversion

 Text Weight Conversion Factor = 1.480146482 gsm/# 
 Cover Weight Conversion Factor = 2.704113765 gsm/# 
 Bond Weight Conversion Factor = 3.7597303675 gsm/# 

 Centimeters to Inches Conversion Factor = 0.3937 in./cm
 Inches to Centimeters Conversion Factor = 2.54   cm/in.

 Pounds to Kilograms Conversion Factor = 0.45359237 kg/# 
 Kilograms to Pounds Conversion Factor = 2.20462262 # /kg

Basis Weight Basis Type GSM Weight

Common North American Paper Sizes

Common Metric Paper Sizes Chart