Job Sub Help

DESKTOP-VIP Job Submittal
2001, 2002 Landmark Graphics Corporation
Part Number 159684 R2003.4

2001, 2002 Landmark Graphics Corporation
All Rights Reserved Worldwide
This publication has been provided pursuant to an agreement containing restrictions on its use. The publication is also
protected by Federal copyright law. No part of this publication may be copied or distributed, transmitted, transcribed,
stored in a retrieval system, or translated into any human or computer language, in any form or by any means,
electronic, magnetic, manual, or otherwise, or disclosed to third parties without the express written permission of:
Landmark Graphics Corporation

Building 1, Suite 200, 2101 CityWest, Houston, Texas 77042, USA
P.O. Box 42806, Houston, Texas 77242, USA
Phone: 713-839-2000
FAX: 713-839-2401
Web: www.lgc.com
Trademark Notice
Landmark, the Landmark logo, 3D Drill View, 3D Drill View KM, 3DVIEW, Active Field Surveillance, Active
Reservoir Surveillance, ARIES, Automate, BLITZ, BLITZPAK, CasingSeat, COMPASS, Contouring Assistant,
DataStar, DBPlot, Decision Suite, Decisionarium, DecisionDesktop, DecisionSpace, DepthTeam, DepthTeam
Explorer, DepthTeam Express, DepthTeam Extreme, DepthTeam Interpreter, DESKTOP-PVT, DESKTOP-VIP,
DEX, DFW, DIMS, Discovery, Drillability Suite, DrillModel, DrillVision, DSS, Dynamic Surveillance System,
EarthCube, EdgeCa$h, eLandmark, EPM, e-workspace, FastTrack, FZAP!, GeoDataLoad, GeoGraphix, GeoGraphix
Exploration System, GeoLink, GES, GESXplorer, GMAplus, GrandBasin, GRIDGENR, I2 Enterprise, iDims,
IsoMap, LandScape, LeaseMap, LMK Resources, LogEdit, LogM, LogPrep, Make Great Decisions, MathPack, Model
Builder, MyLandmark, MyWorkspace, OpenBooks, OpenExplorer, OpenJournal, OpenSGM, OpenTutor,
OpenVision, OpenWorks, OpenWorks Well File, PAL, Parallel-VIP, PetroBank, PetroWorks, PlotView, Point
Gridding Plus, Pointing Dispatcher, PostStack, PostStack ESP, PRIZM, PROFILE, ProMAX, ProMAX 2D, ProMAX
3D, ProMAX 3DPSDM, ProMAX MVA, ProMAX VSP, pStaX, QUICKDIF, RAVE, Real Freedom, Reservoir
Framework Builder, RESev, ResMap, RMS, SafeStart, SCAN, SeisCube, SeisMap, SeisModel, SeisSpace,
SeisVision, SeisWell, SeisWorks, SeisXchange, SigmaView, SpecDecomp, StrataMap, Stratamodel, StratAmp,
StrataSim, StratWorks, StressCheck, STRUCT, SynTool, SystemStart, T2B, TDQ, TERAS, Total Drilling
Performance, TOW/cs, TOW/cs The Oilfield Workstation, Trend Form Gridding, Turbo Synthetics, VIP, VIP-COMP,
VIP-CORE, VIP-DUAL, VIP-ENCORE, VIP-EXECUTIVE, VIP-Local Grid Refinement, VIP-POLYMER, VIPTHERM, WavX, Web OpenWorks, Well Editor, Wellbase, Wellbore Planner, WELLCAT, WELLPLAN,
WellXchange, wOW, Xsection, ZAP!, Z-MAP Plus are trademarks, registered trademarks or service marks of
Landmark Graphics Corporation.
All other trademarks are the property of their respective owners.
Note
The information contained in this document is subject to change without notice and should not be construed as a
commitment by Landmark Graphics Corporation. Landmark Graphics Corporation assumes no responsibility for any
error that may appear in this manual. Some states or jurisdictions do not allow disclaimer of expressed or implied
warranties in certain transactions; therefore, this statement may not apply to you.
Landmark
Desktop VIP Job Submittal Users Guide
Contents
Job Submittal ....................................................................................................................
Overview and Workflow ....................................................................................................
User Interface......................................................................................................................
Conventions .................................................................................................................
Layout of the VIP Job Submittal Window ...................................................................
Host Machine Information .....................................................................................
Remote/Parallel Host List ......................................................................................
Submit Case(s) for Simulation............................................................................................
Queue and Submit Case(s) ...........................................................................................
Stop and Restart the Simulation ...................................................................................
Select Input and Output Files..............................................................................................
File Icon Display Colors ..............................................................................................
File Naming Conventions ............................................................................................
Writing Output to OpenWorks ....................................................................................
Output GRF Option .....................................................................................................
Lock File Prefixes Option ............................................................................................
Include Files .................................................................................................................
Include File Rules ..................................................................................................
Run-Time Selection Procedures ..................................................................................
Define Processor .................................................................................................................
Select Local or Remote Submittal ...............................................................................
Select Serial or Parallel Submittal ...............................................................................
Define Network Type ..................................................................................................
Select Simultaneous or Sequential Runs .....................................................................
Select Low or Normal Priority Runs ...........................................................................
Remote Submittal Tab ........................................................................................................
Windows Network View .............................................................................................
Host View ....................................................................................................................
Rules/Guidelines ..........................................................................................................
Procedures ....................................................................................................................
Using the Host Information Pane .................................................................................
Using the Check Button ...............................................................................................
The VIP Only Checkbox ..............................................................................................
Parallel Submittal Tab ........................................................................................................
Valid Parallel Options ..................................................................................................
Rule/Guidelines ...........................................................................................................
Network Hosts .............................................................................................................
Select Network Type - Procedure ..........................................................................
Open Network Folder to Display Available Nodes ...............................................
Add and Delete Nodes to Network ........................................................................
R2003.4
1
1
2
2
3
4
5
6
6
7
8
8
9
10
10
11
11
12
12
15
15
15
16
16
16
17
18
18
19
19
23
23
24
25
26
26
27
28
28
28
iii
Landmark
Add Node 28
Delete Node 28
Import and Export Hosts ........................................................................................
Export Hosts 29
Import Hosts 30
Nodes ...........................................................................................................................
Select Node ............................................................................................................
Deselect Node ........................................................................................................
Assign Nodes to Grids ...........................................................................................
Change Node Color ...............................................................................................
Grids .............................................................................................................................
Shared Memory ............................................................................................................
Submit Simulation Run(s) ..................................................................................................
Submittal Indicator Light .............................................................................................
Procedures ....................................................................................................................
Submit/Stop a Single Case .....................................................................................
Submit/Stop Multiple Cases ..................................................................................
Exit Job Submittal after a Submission .........................................................................
Job Submittal Error Messages and Recovery ..............................................................
Job Submittal Examples ...............................................................................................
Example 1 - Initialization Case ..............................................................................
Example 2 - Primary Production Case Starting at Time Zero ...............................
Example 3 - Waterflood case starting at time zero ................................................
Example 4 - Waterflood Case Starting After Period of Primary Production .........
Example 5 - Initialization Parallel Case ................................................................
Example 6 - Recurrent Parallel Case .....................................................................
False Card Options..............................................................................................................
False Remote Submittal Path Card ..............................................................................
False Parse Skip Comment Card .................................................................................
Job Status ...........................................................................................................................

OverView............................................................................................................................
Progress Monitor ..........................................................................................................
Status Table ..................................................................................................................
Time Table .............................................................................................................
Data Table ..............................................................................................................
Manipulate Fields in the Status Table ....................................................................
Print the Status Table Display ...............................................................................
Copy Status Table Data to Spreadsheet Format ....................................................
Status Plot ....................................................................................................................
Define Plot .............................................................................................................
Zoom ......................................................................................................................
Change Background Color (Plot Display) .............................................................
Change Background Color and Show All Axes (Plot Scale) .................................
Print ........................................................................................................................
iv
29
30
30
31
31
32
32
33
35
35
35
35
36
37
39
41
41
43
44
45
46
47
48
48
48
51
51
52
52
53
53
53
54
54
55
56
57
57
57
58
R2003.4
Landmark
Analyze the Simulation Report...........................................................................................

Simulation Report (r.out File) ................................................................................
Analyzing the Report .............................................................................................
R2003.4
59
59
60
vi
Landmark
R2003.4
Landmark
Job Submittal
Overview and Workflow
VIP Job Submittal lets you select and submit one or more initialization
and/or restart Cases to the simulator. You can submit any combination
of isothermal black-oil, compositional, or thermal simulations. From
the VIP Job Submittal panel, you can:
Define the input and output file information
Choose to run jobs either locally or remotely
Choose to run jobs serially or in parallel
Monitor the job status
Analyze the simulation report
The job submittal work flow is summarized below.

Edit Input Files (page
Select input/output files for Case (page
Define Processor (page
8)
13)
Edit Output File Formats (page
14)
15)
Select Local or Remote Submittal (page
15)
Complete Remote Submittal Tab

(page 17)
Select Serial or Parallel Submittal (page
15)
Complete Parallel Submittal Tab

(page 25)
Submit VIP Simulation runs (page 35)

Monitor job status (page
Analyze report (page
R2003.4
41)
59)
Job Submittal: Overview and Workflow
Landmark
User Interface
Conventions
Each Job Submittal panel consists of several function-specific panes as
shown below. Typically you specify Job Submittal fields by moving
items from a display pane of available choices into a selection pane.
The application offers several ways to make the selections:
Drag-and-drop. Click on the item in the display panel using the

left mouse button. Continue to hold down the left mouse button
and drag the item to the selection pane.
Double-click. Any drag-and-drop function also lets you doubleclick on the item in the display pane and then click outside the
pane. The item drops into the appropriate selection pane.
Menu options. Most panes have right mouse button pop-up menus
that list options specific to that pane. Typically, any drag-and-drop
function can also be performed from either the main menu or the
right mouse button pop-up menu within the pane.
Drag and Drop (or double click)
Panes with associated menus
In this manual, all procedures will be described using the drag-anddrop method.
Job Submittal: User Interface
R2003.4
Landmark
Layout of the VIP Job Submittal Window

The VIP Job Submittal window is organized into the following general
categories:
Processor options panel

Study and Case Tree Panel
File specifications tab/panel
Remote options tab/panel
Parallel options tab/panel
Job Status tab/panel
When you initially open VIP Job Submittal from the VIP DeskTop, the
File Specifications panel opens as shown below.
Details about the layout and use of the Job Submittal window are
provided on the following pages.
Remote Options tab
File Options tab
Parallel Options Tab

Job Status tab
Access
remote
machine
list
Processor
Options
panel
Input file
icon panel
Open
Cases
Output file
icon panel
Access host machine information
R2003.4
Landmark
Host Machine Information

Click the up and down arrow located at the bottom of any Job
Submittal panel to open and close the Host Machine Information
window as shown below.
Close
Open
Closed Position
First Open Position
Complete Open Position
Click the up arrow once to open the window into the first open position.
Click again to open it completely. Click the down arrow to close the
window. If it is completely open, one down-arrow click will return it to
the first open position. Click again to close it completely
This window provides information about the host machine and
processes running on the machine.
Click the Check button to check the status of the machine and load all
available simulators on the host machine into memory.
Activate the VIP Only toggle to display only simulation processes.
R2003.4
Landmark
Remote/Parallel Host List

This window lets you view the list of available hosts and drag and drop
host selections into the Remote or Parallel panel.
Click the left and right arrow located on the top, right side of the Job
Submittal panel to open and close the Remote/Parallel Host list as
shown below.
Close
Open
Open Position
Click the left (to) arrow to open the list. Click the right (bottom) arrow
to close it.
List only active when Remote or Parallel panel is open
Note that these arrows are only active when you are in the Remote or Parallel
panel.
R2003.4
Landmark
Submit Case(s) for Simulation

When you activate DESKTOP-VIP, all previously selected Cases are
open in the Study/Case Tree Panel. Refer to the Getting Started with
Desktop-VIP manual for details on Study/Case management and
selection.
Once the Cases are active in the Desktop, you can select one or more
for submittal.
Queue and Submit Case(s)

Perform the following steps to queue Cases for submittal.
1.
Select the Case. Double-Click the Case name in the Study/Case

list to activate it.
2.
Select submittal options. At minimum, click the Initialize or

Simulate toggle on the File Options tab. Make any other necessary
changes to the file definitions and remote or parallel definitions.
Once the Case is defined, the Indicator Light on the Desktop turns
green as shown below.
3.
Queue additional Cases (optional). Repeat step 2 above for any

additional Cases you want to queue. Queued Cases are numbered
sequentially on the Desktop as shown below.
Queue numbers
4.
Submit the queued Case(s). Click the green Indicator Light when
you are ready to submit the Cases for simulation. You receive a
message box if your simulation will overwrite existing data.
Job Submittal: Submit Case(s) for Simulation
R2003.4
Landmark
Once the simulation is in process, you will be notified of errors in one

of two ways:
Submittal errors
A message box will open on the Job Submittal window with a

description of the error.
Simulation errors
The output file will open in your default text editor with a
description of the error.
If you have submitted multiple Cases, subsequent jobs will continue to

run until you stop the simulation.
Stop and Restart the Simulation

Once submitted, you can click the red Indicator Light to stop the
submission as shown below.
The dialog box shown below opens.
Click the appropriate button on the dialog box as described below.
R2003.4
Stop the Run

Queue
This option will stop quickly, but will abort the simulation for
the Case in process. You will have to rerun the simulation for
that Case and any subsequent cases in the queue. You will
also have to manually clean up your processes.
Stop Safely
This option will take longer to stop the simulation. But it will
allow you to restart (continue) the simulation in process.
Job Submittal: Submit Case(s) for Simulation
Landmark
Select Input and Output Files

The File Options panel consists of three main panes: input files, output
files, and simulation type.
Input files
Simulation
type and
simulator
version
selection
Output files
Both the Input and Output panes contain icons depicting the necessary
file types.
File Icon Display Colors

File icons are displayed in the File Options panel using the following
colors:
Display Color
File Type
Blue
Initialization file
Red
Restart file
Magenta
Other
Job Submittal: Select Input and Output Files
R2003.4
Landmark
File Naming Conventions

Default input file naming conventions are described below.
Input Files
By convention, file names are keyed off the case name. Initialization
cases have an i appended to the casename and restart runs have an
r appended to the casename. For example, if the casename is case1,
then the job submittal defaults to the following:
VIP-CORE input file:
case1i.dat
VIP-EXEC input file:
case1r.dat
VIP Observed Data

file:
case1.obs
VIP Grid file:
case1i.tts
VIP Well Data File:
case1.wdb
Although the Job Submittal icons will show these default names, a
different input file can be selected.
Output Files
VIP-CORE restart file:
case1i.rst
VIP-EXEC restart file:
case1i.rst or case1r.rst if the Case is a

recurrent restart
SimResults GRF file
case1.grf.
OpenWorks project
study1_case1 (see page 10)
Production analyst
spreadsheet file
case1afs
Text spreadsheet file
case1_field.sss
VIP database file
case1.vdb
Warning -- Changing File Names/Location

VIP default directory and file naming conventions ensure that the correct data is
picked up for each run. You can rename the files or move their location anywhere
on the local computer or remote directories shared on the network. But if you
modify the default hierarchy, you must manage the file dependencies.
R2003.4
Landmark
Writing Output to OpenWorks

When you activate the OpenWorks output icon as shown below, you
can write monthly well production averages interpolated from the
simulation results to an OpenWorks project.
Perform the following steps to write the averages to an OpenWorks

project.
1.
Activate the icon. Click the toggle to activate the OpenWorks icon
in the Output section of the panel.
2.
Open the OpenWorks project selection box. Click on the active

icon. The OpenWorks project selection box opens as shown below.
Menu of valid OpenWorks instances
3.
Select the project. Click the

menu and select the project from a
list of valid OpenWorks instances and select the project to which
you want to write the monthly well production volumes. Then
click OK to close the selection box.
If the simulation run ends successfully, monthly averages are calculated

and written to the selected OpenWorks project after the data is plotted.
Output GRF Option

When you activate the SimResults GRF batch plotting option as shown
below, you can select a GRF script file to run through SimResults after
the simulation.
10
R2003.4
Landmark
This automatically outputs plots to the printer, a MicroSoft Word

document, a Microsoft PowerPoint document, a Microsoft Excel
document, or an HTML file. When this option is active, the SimResults
application will automatically start up after the simulation to produce
the files and then it will automatically close down when finished.
There are several GRF templates for automatically plotting a variety of
properties included in the installation under the path /dtvip/
SimResultsGRF . You can use these templates as a starting point for
producing custom GRF scripts for batch plotting. For a complete
description of the GRF scripting language, please see the online help
within the SimResults application.
Lock File Prefixes Option

The "Lock File Prefixes" option is active by default. It prevents you
from changing output filenames by accident. It also allows easy
changing of the prefixes for all output filenames to a common "Run
Name," which defaults to the Case Name. When enabled, individual
output files cannot be redirected with varying file prefixes.
When disabled, these individual output files can be redirected with
varying file prefixes: Simulation Restart file (r.rst), Grid file (i.tts),
Spreadsheet file (SPRD), Active Field Surveillance file (AFS), and
OpenWorks Case name.
Include Files
Include files (external files with the path/filename specified in the input
file) display as shown below.
If the include file is in the Working Case Directory of the VDB file,
only the filename is displayed in the File Options Panel. If the include
file is not in the Working Case Directory, the entire path is displayed.
R2003.4
11
Landmark
Include File Rules

Be aware of the following rules for using include files in the Job
Submittal process:
A run may use include files from the working Case directory, other
directories on the local or remote computer, or in shared
directories on other computers.
Include file directories are read from the INCLUDE card in their
preceding input data file. You cannot change this location within
the Job Submittal application. The user is responsible for
specifying a proper path for the chosen runs.
If remote Unix runs have include files referenced by NFS path

( /net/export/path/filename.inc ) after the INCLUDE card, Job
Submittal can't parse such files for run information. You can add a
"false card" in addition to the true INCLUDE card, to allow Job
Submittal to parse the same file for run information. Refer to
False Remote Submittal Path Card on page 48 for procedures.
If a remote run is selected and the associated include file does not fit
this criterion, it will display as inactive (dark-gray background).
Run-Time Selection Procedures

Perform the following steps to complete the input and output file
options.
1.
Select Case. In the Case List, click and highlight the Case.
2.
Specify simulation type. Click either the Initial or Restart toggle

located in the center of the panel to specify the simulation type.
If you select Initial, the initialization Input and Output file icons
are enabled. If you select Recurrent, the recurrent Input and
Output file icons are enabled.
3.
12
Specify executable. This pull-down menu is located beneath the

Initial and Restart toggles. It lists all available executables for
each version of the simulator that are loaded on your Local or
R2003.4
Landmark
Remote system. If necessary, click the pull-down menu and select

a different simulator version for the run.
Note Change in VDB Format
Starting with the 2003.4, the format of the VIP Database (VDB) has
changed. As a result, VDBs created using the new format can not be run
using older simulators without using the NOVDB card.
4.
Select non-default input files if necessary. The file type is listed in

the center of each input file icon. The currently-selected file name
is listed beneath each file icon.
File type
Default (or selected)
file name
Include file
If a file does not have the default name, you can select the correct
file:
5.
a.
Open File Selection dialog box. Position your pointer on the

file icon and click MB1. A File Selection dialog box opens.
b.
Filter and select the file in the dialog box. Drag and drop the
file from the network directory tree in the right pane to the
selection list in the left pane. Click OK when the file is
selected. The File Selection dialog box closes and the
selected file name is listed below the icon for the file type.
Edit input file if necessary. Click the right mouse button on the
input file icon and click the edit option as shown below.
Right mouse button menu
The file opens for editing within your default editor. Edit and save
the file.
R2003.4
13
6.
Landmark
Select output files. Click the check box by the output file icons you
want to select as shown below.
Output file
selected
The output file becomes active.

7.
Edit output file formats if necessary. Position your pointer over an

output file icon and click the right mouse button. A menu of output
format options for that file type opens as shown below.
Dot indicates currently
selected format
Right mouse button

output format options
Select the format option on the menu. A summary of right mouse

button output format options is shown below.
Output File Options
14
File
Format Options
Production File (.afs) output rate
Month or Annual
Spreadsheet (.sprd) output rate
As is, Month, or Annual
Database (.vdb) output units
Engineering, Metric, Kg/cm2,

Laboratory
R2003.4
Landmark
Define Processor
The options that let you specify the processors on which to run the jobs
are described below.
Select Local or Remote Submittal

Click either Local or Remote toggle to specify whether the job will run:
Locally, on the machine from which you submit the run, or
Remotely, on another machine that can be accessed over the

network. If you select this option, you must complete the host
information located under the Remote Options tab described on
page 18.
Select Serial or Parallel Submittal

Click either the Serial or Parallel toggle to specify whether the job will
run:
A serial (single processor) simulation, or
A parallel run, which allows you to select multiple hosts or

processors. If you select this option, you must complete the
network information located under the Parallel Options tab
described on page 24.
Submitting parallel jobs to networks other than Windows 2000 SMP
If you are submitting Parallel Jobs to a Network Type other than Windows
2000 SMP, then the Local / Remote option must be set to Remote.
R2003.4
Job Submittal: Define Processor
15
Landmark
If you do not have a Parallel VIP license, this option will not exist
within your display.
Define Network Type

This menu lists all the network types for parallel submission that have
been defined in your .rhosts file. It is typically used in conjunction
with the Parallel Options tab described on page 24.
You can also use the Network Type menu to submit a parallel run
without completing the information on the Parallel Options tab. If you
click and select your network type from the menu, the application will
automatically select the available nodes and assign the grids for parallel
submittal.
Select Simultaneous or Sequential Runs

Click to activate the Simultaneous Runs option if wish the jobs to run at
the same time rather than sequentially. Be sure to deactivate this option
if your machines cannot handle simultaneous runs.
Please note that dependent runs (parent and child) cannot be run
simultaneously Job Submittal should handle such cases
automatically. Also, only as many simultaneous runs can be performed
as your VIP Licenses allow. If your VIP Licenses are all in use, then
Job Submittal will wait until a License becomes free, and then
continue.
Select Low or Normal Priority Runs

VIP Simulation Jobs can be run with lower than normal process
priority. This allows other applications running on the machine to be
used without stalling during a VIP simulation.
This option does not currently work with Remote Windows Runs.
16
Job Submittal: Define Processor
R2003.4
Landmark
Remote Submittal Tab

If you have selected the Remote processor option, click the Remote
Options tab and complete the information about the remote host as
described below.
Drag and Drop
Open/Close
Network View
Network View -Computers and
directory tree
Selected
Host
Host View
Windows Network View
This panel consists of two panes. The right pane (accessible using the
left arrow) is the Windows Network View from which you can drag
information into the host selection fields. The left pane is the Host
View within which you define the remote host information. Each view
is described below.
Multiple Assignments
The options you specify apply to all following Cases you will queue. To change
options for a single Case simply select that Case as the Working Case and change
the desired option(s).
R2003.4
Job Submittal: Remote Submittal Tab
17
Landmark
Windows Network View

The Windows Network View lets you navigate through the possible
host machines on your network. The network tree displays the
following:
Domains
. Only the available network domains will be visible.
Computers . Within the domain, only computers that are

announced on the Windows Network will be visible. While this
should include all Windows-type computers, Unix-type computers
must be announced to the Network using a service such as Samba.
Directories . Only directories that are shared on the Network

will be visible in the View. Only Directories available to the user
will be accessible.
When you double-click the icon preceding a domain name, all the
computers within that domain will be listed. When you double-click on
the icon preceding a computer, all the directories under that computer
will be listed. When you double-click on the icon next to a directory, all
the subdirectories and files within the directory will be listed.
You can use the Network View to drag and drop host machines and
directories to the host parameter selection pane.
The Network View is common to both the Remote Options tab and the
Parallel Options tab.
Host View
Information in the host selection fields defaults to the previous
selection. The Del
button located beside the field can be used to
erase the previous selection.
The Host selection field is the primary field. Each host may have
multiple users and directories available. Other field choices such as
available directories will dynamically change to reflect those of the
currently selected host.
Submitting to multiple remote hosts
Once you have defined the remote host parameters, they are applicable to all
subsequent Cases submitted in the run. However, you can click on a Case in the
Submittal list to change the parameters for that single Case.
18
R2003.4
Landmark
Rules/Guidelines
Be aware of the following rules for remote submittal: (See Also:
Release Notes, Unix/Linux Release Notes)
You must be able to remotely login to the Remote host without

entering a password.
For Remote Parallel Jobs, the Parallel Network type must

correspond to the Remote Host Type.
Procedures
Perform the following steps to complete the remote host information:
R2003.4
1.
Define the host machine. In the Windows Network View directory

tree, drag and drop a computer or one of its shared directories to
the left side of the Remote Options Pane. The selected information
will be transferred to the appropriate entry fields. You can also
type a new Host Name manually.
2.
Define or review the note (optional). Below the Host selection box
is a one-line note display. This field is available to record
information associated with the computer; for example, who owns
it or where it is located. Click in the entry field to record
information, or view the posted information.
3.
Enter your USERID. To perform a Remote Submittal, VIP Job

Submittal must have a valid USERID that can access the Remote
Host from the Local computer. Perform one of the following steps
to enter your USERID:
Accept the default. The default is last USERID used with the
selected host. If the Host is newly created, then the users local
login will be used to create a default USERID.
Select from menu. Click the down-arrow

box and choose a recorded USERID.
next to the selection
19
Landmark
Enter a userid. Click in the entry field and enter a USERID.

Then press the return key.
USERID Warnings
The USERID must be able to remotely login to the Remote host without
entering a password.
The run will fail if the selected USERID does not have access to the Remote
host.
If you click the Check button described on page 23 before submitting the job,
these errors will be detected before the run is submitted.
4.
Specify the remote host type. Click the Windows or Linux/UNIX

toggle to specify the remote host type.
Windows and UNIX use different network communications
protocol, communications programs, and remote utilities to aid the
run, so this option MUST be set correctly or Job Submittal will
fail.
Use the Check button
If you are unsure of the host type, click the Check button described on page 23.
The software will attempt to communicate with the Remote Host using each of
the two communications protocols, and the inquiry that receives the correct
response will determine the Remote Host Type.
Note: this inquiry will be performed correctly only if the USERID is valid.
5.
20
Define the directory. Each remote submittal has a working

directory on the remote machine in which to store utility and data
files. Perform one of the following steps to define the working
directory:
Click the down-arrow

next to the field and select the
directory from the pull-down menu.
In the Windows Network View directory tree, drag and drop a

directory for the currently defined host to the left side of the
R2003.4
Landmark
Remote Options Panel. The selected information will be

transferred to the appropriate entry fields.
Directory is tied to host machine
If you drag and drop the directory, be aware that the directory you select
is tied to the host machine. When you drag a directory, you
automatically define the associated host machine.
Definition of UNC-formatted directories

Remote directories may be UNC-formatted or absolute. UNC
formatting creates a temporarily-shared directory between the local and
host machine. This is the preferable method because the job will run
more efficiently.
If you drag and drop the directory from the Network View, the UNC
format is automatically created. If one has been created previously, it
will be available in the selection list.
If you wish to create a UNC format by entering the directory in the entry
field, you must use the format:
//computername/dir1/dir2
where the computer name matches the selected host and the directories
exist and are shared on the host machine.
6.
Specify whether to copy or remove files. You can copy input and
output files back to your local VDB directory or remove them
from the host machine with or without copying them. There are
two exceptions to this rule:
Any Include Data file that is specified using the UNC-format

after the INCLUDE card will still be accessed across the
network
If Job Submittal is automatically performing Post-Processing,

then necessary remote files will be copied back automatically.
Removing remote files
It is a good idea to remove the remote files after they have been copied in
order to keep the remote directory clean of files from previous runs.
R2003.4
21
Landmark
Use the checkboxes as described in the table below to specify

whether or not to perform a certain copy or remove function on
each type of file.
Protection
The application will not erase the only existing copy of a file.
Functions: The check boxes let you specify:

Copy To
Copy files pointed to in the File Options panel (or in

the Study Directory) to the Remote Directory before
the run.
Copy From
Copy files from the Remote Directory to the locations

pointed to in the File Options panel (or the Study
Directory) after the run.
Remove
Erase files in the Remote Directory after the run.
File Types: Each of the above commands can be applied to any of

the following file types:
VDB
VDB (database) files.
Data
Data files, which are the i.dat and r.dat files, and those
pointed to with a VIP INCLUDE card. For a Windows
run, any Include file that is specified by UNC path will
not be copied.
Restart
Restart files.
Output
Run Output (.out), Map (.map), Plot (.plt), and Spreadsheet (.sss) files.
Other
Miscellaneous files that are created by the Run and are

not empty.
Note All Files option

Note that you can activate the All Files option to apply the Copy or Remove
command universally.
Directory Paths: In the file groups for which "Copy To" is an

option (VDB, Data, Restart), text boxes display the remote path of
relevant file. When Copy To is not enabled, the default path is the
remote directory with the pertinent file name appended, but you
can change this path to another path on the remote machine. When
22
R2003.4
Landmark
Copy To is enabled, this remote path will always be the remote

directory with the pertinent file name appended.
Warning: Remote path must be valid
You must ensure that you enter a valid path and filename. If not, the run will
fail.
Using the Host Information Pane

The Host Information Panel can provide useful information concerning
the Working Casess Host. This Panel is available at the bottom of the
screen within the File Options tab, the Remote Options tab, and the
Parallel Options tab.
The Host Information Panel displays the Working Cases selected

Host when in the File Options and Remote Options tab, while in the
Parallel Options tab it will show information on a Parallel Host selected
in the Parallel Hosts Available Tree.
Using the Check Button

The Check
button on the Host Information Panel can be used to
ensure that your remote settings are valid. For example:
R2003.4
You erroneously selected "Unix/Linux instead of "Windows" as

the machine type. When you click the Check button, a Wait
message will display, and then the correct remote type will be
automatically selected for you.
23
Landmark
Your machine name or USERID is not accepted, the machine type

cannot be determined, or if the Windows 2000 machine is not
running the VIPrshService. When you click the Check button, a
Wait message will display, followed by an error message telling
you that the remote system could not be reached.
The check is successful when you receive the Wait message with no
subsequent corrections or error messages.
Refer to Job Submittal Error Messages and Recovery on page 37 for
more information about job submittal errors.
The VIP Only Checkbox

Normally, the Host Information Panel will display a snapshot (taken at
the time of the Check) of all processes running on the Host. VIP
processes are displayed in red for quick identification. If you wish to
only display the VIP processes, use this checkbox and it will cull
miscellaneous host processes from the list.
24
R2003.4
Landmark
Parallel Submittal Tab

If you have selected the Parallel processor option, click the Parallel
Options tab and complete the information about the parallel network as
described below. If you do not have a license for Parallel VIP, then this
option, along with the Parallel / Serial and Parallel Options tab will not
exist.
Drag and Drop
Drag and Drop Drag and Drop
Open/Close
Network View
Network
Type
Hosts
Available
Nodes
Selected
Grids
Node Assignment
of Grid
This panel lets you view a Master List of the available hosts and set up
a Node Pool that defines the machines to be used for running the
simulation.
For Parallel Core Runs, the Parallel Grid may be nullified, and there is
no need to assign Nodes to Grids.
Multiple Assignments
The hosts you place in the Node Pool are common to all Cases in the Queue.
However, as Grids may be different for each Case, the assignment of Nodes to Grids
can also be different for each Case in the Queue.
R2003.4
Job Submittal: Parallel Submittal Tab
25
Landmark
Valid Parallel Options

Valid parallel machine options are described below.
IBM RS 6000 (AIX)
Processor Option
Run Location
Remote Options
Parallel Options
Serial
Remote
UNIX/Linux
---Not Selectable---
Parallel
Remote
UNIX/Linux
IBM SP
Silicon Graphics (IRIX)

Processor Option
Run Location
Remote Options
Parallel Options
Serial
Remote
UNIX/Linux
Parallel
Remote
UNIX/Linux
SGI Shared Memory
SUN (Solaris)
Processor Option
Run Location
Remote Options
Parallel Options
Serial
Remote
UNIX/Linux
Parallel
Remote
UNIX/Linux
Solaris SMP
Windows 2000
Processor Option
Run Location
Remote Options
Parallel Options
Serial
Local
------------
---Not Selectable ---
Serial
Remote
Windows
---Not Selectable ---
Parallel
Local
------------
Windows 2000 SMP
Parallel
Remote
Windows
Windows 2000 SMP
Rule/Guidelines
Be aware of the following rules for parallel submittal:
26
The first parallel node selected must be:
Your local machine if you are running locally.
The machine you defined as Host on the Remote Tab if you are
running remotely.
R2003.4
Landmark
It is strongly suggested that you have twice as many parallel grids

as processors used.
It is strongly suggested that parallel grids have roughly the same

number of gridblocks.
If you are submitting a Windows2000 parallel job, included data

files must be specified using UNC formatting:
INCLUDE \\computername\sharedDirectory\filepath .
Mapping shared directories under a Windows2000 User's account
and then specifying included data files using the mapped drive will
work if and only if the account under which Patent MPI (and the
account for VIPrshServer if it is a remote run) are running under
an account under which the same remote directory is mapped as
the same drive letter specified in the INCLUDE statement. Please
note that this account must also have Administrative privileges.
For instance:
INCLUDE R:\filepath .
Patent MPI must be set to run under User Account X, where X is
an Administrator, and X has a mapped drive named R: that
references \\computername\sharedDirectory in which filepath
resides.
Network Hosts
The Network Type pull-down menu located under the Processor
Options section of the Job Submittal panel displays all the network
Types defined in the .rhosts file.
Currently the choices for this menu are: IBM SP, SGI Shared Memory,
SUN Solaris Shared Memory (SMP), Linux SMP, and Windows 2000
SMP.
Network type other than Windows 2000 SMP
If you are submitting to a network type other than Windows 2000 SMP, then the
Local/Remote option must be set to Remote and you must have a UNIX/Linux type
remote host (of the correct Parallel Network Type) selected.
R2003.4
27
Landmark
Select Network Type - Procedure

Click and select the Network Type from the menu. Only the hosts of
that type display for selection in the Available Network Hosts Tree in
the Parallel Options tab. The domain folders open to list the available
nodes.
Open Network Folder to Display Available Nodes
Double-click on a domain icon to display the available nodes.
Add and Delete Nodes to Network
The nodes displayed under each available host are those defined in the
.rhosts file. You can add or delete nodes into your parallel network.
Add Node
Perform the following steps if you want to add a node that is not listed
in the Network Hosts portion of the panel:
1.
Enter node name. Click in the Add Node entry field located on the
bottom row of the Network Hosts pane and enter the name of the
node to add.
The node is added to the list of available hosts under the Currently
selected Parallel Network Type.
Delete Node
Perform the following steps if you want to delete a node that is listed in
the Available Network Hosts portion of the panel:
1.
28
Highlight node. In the Network Hosts pane, click to highlight the

node you want to delete.
R2003.4
Landmark
2.
Select delete option. With the host name highlighted, select the
Delete Node option on the right mouse button menu as shown
below.
The node is removed from the list of available network hosts, but
will remain in the .rhosts file unless it is saved by using the
Export Hosts option.
Import and Export Hosts
The available hosts are defined in your .rhosts (or personal rhost)
file. You can export a customized Available Hosts list to a file that will
be saved in the .rhosts format, and that rhost file will be loaded as your
default during future Job Submittal Sessions.
Export Hosts
When you have customized (added nodes to and/or deleted nodes from
the list of available hosts), perform the following steps to export the
list:
1.
Select Export Hosts option. Click the the right mouse button and
select the Export Hosts option from the Network Hosts menu as
shown in the menu illustration on page 27. A File Creation Dialog
should appear.
2.
Name and create export file. After choosing a directory in which to

store the file, enter a name in the File Name entry field for the
rhosts file. Click the Create button to create the file and close the
dialog box.
Naming the file
If the rhosts file has a unique name, it file can be selected for import at any time
or be used as the current users default .rhost file. If you have write permission
to save the file under the name .rhosts, it will become the default for all users.
R2003.4
29
Landmark
The path/filename you created will be saved in the .rhosts format.

Import Hosts
Perform the following steps to import an rhosts-formatted file into your
current session:
1.
Select the Import Hosts option from the right mouse button menu
on the Available Network Hosts portion of the panel. A File
Selection dialog box should appear.
2.
Filter to the directory and select the file. Then click the Open
button to open the file and close the dialog box.
The list of available hosts changes to reflect the content of the file you
selected, and the selected .rhost file will become your default for future
Job Submittal Sessions.
Nodes
The Available Network Hosts portion of the Parallel Submittal tab
displays all nodes currently available in the parallel network. These
nodes are defined in the .rhosts file that was created by the User or
System Administrator when the current version of VIP was installed.
Select Node
Perform the following steps to select a node from the list of available
hosts:
1.
Change network type if necessary. Only hosts for the selected

network type display in the Network Hosts pane. If necessary,
click the Network Type menu in the Processor Options panel and
change the network type. Related hosts display for selection in the
Network Hosts pane.
2.
Select host. Drag and drop a node name from the Network Hosts
pane to the Selected Nodes pane.
The host is added to the Selected Nodes pane and is available for grid
distribution.
30
R2003.4
Landmark
Deselect Node
Perform the following steps if you want to delete a node that is listed in
the Network Hosts portion of the panel:
1.
Highlight node. In the Selected Nodes pane, click to highlight the

node you want to remove.
2.
Select remove option. With the node name highlighted, select the
Remove Node option on the right mouse button menu as shown
below.
The node is removed from the selection list. If it has already been
assigned to grids, those grids are automatically unassigned. You will
have to reassign or redistribute nodes to those grids.
Assign Nodes to Grids
Each node displays in a unique color. When you assign nodes to grids,
associated color is transferred to the grid assignment column.
Drag and Drop
Available Nodes
Grids (root and LGR)
There are two ways to assign nodes to grids:
R2003.4
Distribute evenly among available nodes. Click the Distribute

button located at the bottom of the panel. The grid data will be
distributed evenly (according to active block size) among the
available nodes.
31
Landmark
Manually Specify Nodes. Drag and drop the node from the
Selected Nodes pane to the Node Assignment column of the Grid
pane.
Change Node Color

Perform the following steps to change the grid display color for a
selected node.
1.
Select the node. In the Selected Nodes pane, click and highlight the
node to select.
2.
Open the Color Palette. Select the Change Color option on the
right mouse button menu of the Selected Nodes pane as shown in
the menu illustration on page 30.
The Color Palette opens.
3.
Select the color. Click the color cell in the Palette to select. Or use
the HSB (hue, saturation, black) or RGB (red, green, blue) tab to
enter precise percentages for the color definition. Click OK to
close the Color Palette.
The node and any associated grids redisplay in the new color.
Grids
When loading grids, the Job Submission software looks for a grid file
using the default hierarchy (i.e., a file named <case_name>i.tts in
your working directory). This file was created by VIP-CORE. If this
32
R2003.4
Landmark
information is stored in another file or directory, the Grids pane will be

blank.
Perform the following steps to load the grid file:
1.
Select Load option. Click the right mouse button in the Grids pane
and select the Loads Grid option from the menu as shown below.
The Select Grid File dialog box opens.

2.
Select the grid file. Double-click on the domain, computers, and

directories to filter and select the appropriate grid file. Click the
Open button. The selected grid file displays in the Grid pane of the
Parallel Submittal panel.
Shared Memory
Shared Memory Size: For Windows 2000 parallel runs, there is a
shared memory size window. For Windows 2000 parallel VIP-CORE
runs, the default size is 50 megabytes. For Windows 2000 parallel VIPEXEC runs, the default size is 1 megabyte.
Default for CORE Shared Memory: For Windows 2000 parallel
VIP-CORE runs, the memory size is dependent on the number of
domains in the reservoir model. Based on some models that were used
during testing, a 16-domain model takes approximately 2 megabytes of
shared memory. A 128-domain model takes approximately 300
megabytes of shared memory. The default value of 50 megabytes
should handle most problems.
Default for EXEC Shared Memory: For Windows 2000 parallel VIPEXEC runs, the approximate amount of required memory size will be
calculated automatically. The calculation used is:
Shared Memory Size = Number of Grid Blocks x 150
The minimal shared memory size value allowed is 1 megabyte. For this
calculation to take place, you must perform several steps:
R2003.4
1.
Specify the different nodes
2.
Specify the grids per node
3.
Try to reduce the default amount (1 megabyte) of shared memory.

33
Landmark
The new calculated value should appear in the shared memory window.
Changing Default Memory Sizes
You have the option of changing the default memory sizes. Double click in the
entry field to erase the existing value and enter a new one.
34
R2003.4
Landmark
Submit Simulation Run(s)

You can submit single or multiple Cases to the simulator at once. The
Job Submittal features are shown below.
Submittal Indicator
Light
Queue assignment
number
The Submittal Queue lets you assign multiple cases to the simulator.
Submittal Indicator Light

The green Submittal Indicator light indicates when a selected Case is
ready to begin simulation. A green light does not mean that a job will
not fail, just that all the information is available that is needed to begin
the simulation.
The red Submittal Indicator light (with an error message) lets you know
when a job has failed. When you submit multiple Cases, a red light for
one Case will not prevent other undependent Cases from running.
Procedures
Submit/Stop a Single Case
Perform the following steps to submit a single Case to the simulator:
1.
R2003.4
Select the Case. Click on the Case to select in the Main Menu case
list. The selected case highlights.
Job Submittal: Submit Simulation Run(s)
35
2.
Landmark
Submit the simulation. If the selected case is ready for submission,

the Submittal Indicator Light will be green.
Submittal Indicator Light remains red
If the Submittal Indicator Light remains red when you select the Case, there
is missing information for the file specifications, or for the remote or parallel
submission if applicable.
Click the Indicator Light to submit. You will receive a message

window asking you to confirm the submission. Click OK to
confirm.
3.
Stop the simulation. Click the green Submittal Indicator light at

any point to stop the simulation. Click again to restart.
If the run is not successful, refer to Job Submittal Error Messages and
Recovery on page 37 for error recovery hints.
Submit/Stop Multiple Cases
Perform the following steps to submit multiple Cases to the simulator:
1.
Queue the cases. Perform the steps described above as you would
for queueing a single file. The queue number displays beside the
Case name as shown below:
Queue number
Queue Order
Cases will queue in top-down order, starting with the first (top-most)
Case in the Study/Case Tree panel. This is done partly to maintain Case
pedigree.
2.
36
Dequeue a Case. To dequeue a Case, select it as the Working Case,

and deselect both the Core and Exec Simulator checkboxes.
R2003.4
Landmark
3.
Submit the simulation. If all selected cases are ready to begin, the
Submittal Indicator Light will be green.
Submittal Indicator Light remains grey
If the Submittal Indicator Light remains grey when you have selected
the Cases, there is missing information in at least one Case for the file
specifications, or for the remote or parallel submission if applicable.
Click the green Submittal Indicator Light to submit. You will

receive a message box asking you to confirm the submission.
Click OK to confirm.
4.
Stop the simulation. Click the red Stop Light at any point to stop
the simulation. For a restart file, you can select the Stop with
Restart option, which will resume the simulation when you click
the green Submittal Indicator Light.
If the run is not successful, refer to Job Submittal Error Messages and
Recovery on page 39 for error recovery hints.
Exit Job Submittal after a Submission

You can exit the Job Submittal application after submitting a run. VIP
Job Submittal does not need to be running continuously for a submitted
simulation to complete; it can be closed and re-opened at any time. If
a run had been started before it was closed, the following message box
will display when you open the next Job Submittal session:
You Have Unfinished Jobs. Finish them?
This message does not necessarily mean that the VIP Simulation has
not completed. This message simply means that the Job Submittal has
not fully completed all the operations associated with the Run. Click
one of the following options in the message box:
R2003.4
Click Yes (finish the run) to resume monitoring the run and
continue post-processing options such as copying back remote
files, removing empty files, and/or producing chosen extra output.
If the simulation has completed, Job Submittal will update the
Status Panel, and then perform post-processing. If the simulation
has not yet completed, then Job Submittal will update the Status
Monitor panel to the progress of the run, and then resume normal
job monitoring.
37
38
Landmark
Click No (don't finish the run) to ignore the run. This will not stop
a running simulation. But it will not be monitored within the Job
Status Panel and post-processing selections for the run will not be
performed.
R2003.4
Landmark
Job Submittal Error Messages and Recovery

A summary of error messages and recovery hints is provided below.
R2003.4
Error Message
Recovery
rhost File unreadable, Parallel Option

Disabled
You do not have a valid rhost file. Create

one as prescribed by the VIP Release
Notes.
Selected Network Type has No Nodes
Add valid network host nodes to the rhost

file or select another network type.
File Missing or Unreadable
Make certain that you have indicated the

correct location for this file.
Platform type not recognized
The platform listed in the rhost file is not

recognized. Check for spelling errors and
make certain that the platform is listed in
Parallel VIP documentation.
Interface type not recognized
The network interface listed in the rhost

file is not recognized. Check for spelling
errors and make certain that the interface
is listed in Parallel VIP documentation.
Preference File could not be loaded
A problem was encountered while reading

your user preference settings. Your
settings will be reset to default and a new
user preference file will be created after
this session.
Preference File could not be saved
A problem was encountered while saving

your user preference file. Your next VIP
session will have default or old user
settings.
Could not Open Help
Make certain that Adobe Acrobat is

installed on your system, that its location
is indicated by the VIPAcrobat
environmental variable, and that the VIP
help files have not been deleted from the
doc/help directory.
Could not Open Text Editor
Make certain that Notepad exists on your

system. If not, or if you prefer to use
another text editor application, set an
environmental variable named EDITOR
to point to the location of the editors
executable.
Environment variables not Loaded
VIP was unable to load and parse your

Environment. Please quit and restart VIP.
If this problem persists, please contact
support.
Could not Parse VIP Cases
One or more of your VIP Database (VDB)

files may be damaged.
39
Landmark
40
Could not Convert File
A file that you were attempting to convert

from one format to another may be
corrupt.
Case Not Found
Information concerning a VIP case does

not exist in the specified VIP Database
(VDB). Please specify another VDB or
create such information in the VDB by
running VIP Core or another process.
Could not Create VIP run Template
Please try to run the VIP simulation again.
Simulator Log File will not open
The Simulation should run normally, but a

log (.out) file could not be written. To
attempt to write one, you must run the
simulation again.
Could not start Simulator
The simulator would not start. Please

review the .out file and VIP simulator
documentation for further information.
Could not find Simulator
A valid VIP simulator executable could

not be found. Please make certain that the
VIPHOME environment variable has been
set on the system or in a .viprc script.
Could not start PlotView
The VIP PlotView executable may have

been corrupted.
Remote Process Failed
Check network communication as

outlined in the VIP Release Notes.
Write err
VIP encountered a problem while writing

to a file. Try the attempted process again.
External Process Err
VIP encountered a problem while

attempting to work with the Operating
System. Try the attempted process again.
Then try it on an operating system that
actually has to work for a living.
Could not contact Remote Host
Please check your network connection and

check the settings of the selected remote
host as outlined in the VIP Release Notes.
Selected Remote Host cant support

selected Parallel Run
Please select a Remote Host of the same

Operating System type as your selected
Parallel Platform.
Include Files for Remote Run must be

in study directory or UNC
Please do one of the following:

Select a Local VIP Run.
In your VIP input (.dat) files, specify your
included files with a UNC path and make
certain that path is shared on the network.
Move your non-UNC included files to the
same directory as your study (.vdb) file
and change their references in your VIP
input files.
R2003.4
Landmark
Job Submittal Examples

As an example to show how restarts can be used, consider the
following sequence of VIP simulation runs:
1.
VIP-CORE initialization to create an initial reservoir model
2.
VIP-EXEC run starting at time zero to simulate primary

production
3.
VIP-EXEC run starting at time zero to simulate water injection
4.
VIP-EXEC run starting in the middle of the primary production

simulation in which some of the producers are converted to water
injectors.
VIP allows all these simulations to be stored in a single VDB file.

Again, for illustration purposes, lets specify the following input file
names:
File Description
Example Input File

Name
Vdb file
example.vdb
VIP-CORE initialization
initi.dat
VIP-EXEC primary production run starting at time 0
primaryr.dat
VIP-EXEC waterflood run starting at time 0
h2ofloodr.dat
VIP-EXEC run waterflood run starting after a period of

primary production.
h2oafterprimaryr.dat
The following table shows the specific parameters for submitting this
sequence of simulations.
Example 1 - Initialization Case
Case Options
R2003.4
Study name:
example
Parent case:
(blank)
Case name:
init
Toggle Options
Initialization
41
Landmark
Input Options
VIP-CORE input File:
initi.dat
VIP-EXEC input File:
This field will be grayed out and is unavailable for an initialization run.
Plot Observation file:
Output Options
42
initi.rst
R2003.4
Landmark
Example 2 - Primary Production Case Starting at Time Zero

Case Options
Study name:
example
Parent case:
init
Case name:
primary
Toggle Options
Restart
Input Options
VIP-CORE Input File:
This field will be grayed out and is unavailable for a simulation run.
VIP -EXEC Input File:
primaryr.dat
initi.rst
primary.obs
Output Options
R2003.4
primaryr.rst
43
Landmark
Example 3 - Waterflood case starting at time zero

Case Options
Study name:
example
Parent case:
init
Case name:
h2oflood
Toggle Options
Restart
Input Options
VIP-EXEC Input File:
h2ofloodr.dat
initi.rst
h2oflood.obs
Output Options
44
h2ofloodr.rst
R2003.4
Landmark
Example 4 - Waterflood Case Starting After Period of Primary Production

Case Options
Study name:
example
Parent case:
primary
Case name:
h2oafterprimary
Toggle Options
Restart
Input Options
h2oafterprimaryr.dat
primaryr.rst
h2oafterprimary.obs
Output Options
R2003.4
VIP-EXEC restart file
h2oafterprimaryr.rst
45
Landmark
Example 5 - Initialization Parallel Case

Case Options
Study Name:
example
Parent Case:
(blank)
Case Name:
parallel
Toggle Options
Initialization
Input Options
paralleli.dat
This field will be grayed out and is unavailable for an initialisation run.
VIP-EXEC Restart File:
Plot Observation File:
Input Options
46
VIP-CORE Restart File:
paralleli.rst
R2003.4
Landmark
Example 6 - Recurrent Parallel Case

Case Options
Study Name:
example
Parent Case:
(blank)
Case Name:
parallel
Toggle Options
Restart
Input Options
parallelr.dat
paralleli.rst
Plot Observation File:
parallel.obs
Input Options
R2003.4
VIP-CORE Restart File:
parallelr.rst
47
Landmark
False Card Options

There are two comment card options that can be used within the data
files to define the submittal run. They are called a "false cards" because
they must be preceded by the VIP comment character "C" so that the
VIP Simulator will ignore them.These are described below.
Note MANDATORY Comment Character
The first character on each line must be a comment character (C) so that the
simulator will ignore it.
False Remote Submittal Path Card

Job Submittal will read a UNC-formatted remote submittal path card in
addition to the true INCLUDE card and parse the same file for run
information. The format for this card is:
C UNCPATH //computername/sharedpath/filename.inc
UNCPATH card
Mandatory Comment Character
This allows Job Submittal to parse view, and edit the file, while the true
INCLUDE card using an NFS path allows a remote Unix run to use the
file directly without copying it across the network. Please note that for
this option to work, the file must be accessible over SMB via Samba or
a similar utility
False Parse Skip Comment Card

Job Submittal needs specific information contained in the initialization
and restart files (such as data in the NO VDB, MAP, PLOT, DECOMP,
ENDEC, ENDLGR, and ENDREF cards) that tell it how to set up the
job. It does not need the data arrays that the simulator uses to run the
simulation.
In instances of long data files (such as included CORE file arrays), it is
time-consuming for the Job Submittal application to have to parse all
the data looking for information relevant to the submittal.
48
Job Submittal: False Card Options
R2003.4
Landmark
You can add a comment card to an initialization or restart data file to

tell the Job Submittal application to stop parsing the data. This
comment card is:
C SKIPARSE
Command (alternately SKIPPARSE)
Mandatory Comment Character
This card will cause the Job Submittal application to ignore all
subsequent information for the current file. For example, if it is placed
at the beginning of the file, the entire file will be ignored. If placed in
the middle of the file, data up to the the SKIPARSE card will be parsed.
Using the SKIPARSE Card in Include Files
Using this card in include files (where time-consuming data arrays are most
likely to be), will cause Job Submittal to ignore only the current include file.
It will continue to read the initialization or restart data file that the former
include file references.
R2003.4
49
50
Landmark
R2003.4
Landmark
Job Status
OverView
The Job Status panel lets you dynamically view the status of all active
simulations. You can monitor the jobs and view the output. You can
also load and view data from previous runs. The following illustration
shows how the Job Status window looks during a simulation. Data is
shown in real-time in this window as the simulation progresses.
Status Table
Selected
Case
Progress Monitor
Status Plot
The Job Status Panel displays information for the Case that is currently
selected in the Study/Case Tree panel. When you select a new Case, the
display updates to reflect the new information for that Case.
R2003.4
Job Status: OverView
51
Landmark
The Job Status Panel consists of three main subpanels: the Status
Tables, the Status Plot, and the Progress Monitor. Each is described
below.
Progress Monitor
The Progress Monitor displays real-time feedback on the status of the
simulation run. As VIP-EXEC runs, it writes a report containing
simulation results and error messages, if any. A condensed version of
this information is displayed one line at a time in the Progress Monitor.
The entire report is saved to an output file with the same name as the
case, but with a letter indicating the run type (i or r) and the extension
.out. For example:
case5r.out
If the DESKTOP-VIP Job Submission is used to submit the run then

while the simulation is running the process id number is appended to
the name of the output files. For example:
case5r.out1536
Refer to Analyze the Simulation Report on page 59 for guidelines for

analyzing the simulation report.
Status Table
The Status Table consists of the Time Table and the Data Table.
Time Table
Data Table
You can manipulate the Fields displayed in the Status Table display,
print the display, or copy the data into a spreadsheet.
52
R2003.4
Landmark
Time Table
The Time Table consists of the following columns:
Time step
Absolute date
Number of days from run start
Data Table
The Data Table opens with all available field properties from the run
displayed in separate columns. Since there may be a large number of
different properties to display, the columns typically overflow the Job
Status panel. Use the horizontal scroll bar at the bottom of the display
to move laterally through the display and view all the columns.
Plot display menu options
Plot display menu options are accessed when you right-click on a Data Table
header field as shown below. These options, which let you define the color,
symbol, and labels for the associated plot data. You can also print the tables or
manually reload the status information.
Manipulate Fields in the Status Table

You can do the following to manipulate the fields in the data table:
R2003.4
Resize a field. Click in the field header and drag to increase or

decrease the default display size.
Hide a field. Drag and drop a field header to zero size to hide the
field from display. Hiding a field does not exclude it from display
in the Status Plot, Plotview, or SimResults.
53
Landmark
Move a field. Drag and drop a field header to relocate the column
in the table display.
Print the Status Table Display

Perform the following steps to print the Status Table:
1.
Select the Print option. Right-click on one of the fields in the

Status Table and select the Print Table option on the menu as
shown below. The Print dialog box opens.
2.
Submit the display to the printer. This panel lets you select a scale,
resolution, and page size for the job, and enter the name of the
output file to which the print job will be sent. Select the printer
options as shown below and click OK.
The Status Table prints to the specified printer.

Print Properties
You should not have the change advanced print properties.
Copy Status Table Data to Spreadsheet Format

Perform the following steps to copy fields from the Status Table to a
spreadsheet:
1.
54
Open the spreadsheet application. Open the spreadsheet

application into which you want to copy the Status Table fields.
R2003.4
Landmark
2.
Select columns. Click on a column in the Status to highlight it. Or

drag and drop a series of columns. Alternately, you can click any
column header in the Time Table to select the entire Status Table.
3.
Copy the Status Table field(s). With the selected fields highlighted,
click CONTROL/C to copy the fields to the Clipboard.
4.
Paste the Status Table field(s). Highlight the appropriate number

of fields within the spreadsheet application and use the Paste
option.
The selected Status Table data fields are copied to the spreadsheet
application.
Status Plot
The Status Plot lets you display dynamic plots of selected data as the
simulation progresses.
The following plot display conventions are used:
R2003.4
If multiple Cases are displayed on one plot, the queue number for
the Case is shown to the right of each data point.
If Observed data exists in a text file and has Field data in TIME
(rather than DATE) format, it is plotted on the same Plot as the
simulation data. The letter O is annotated to the right of each
Observed data point.
55
Landmark
Define Plot
Perform the following steps to define the Status Plot as shown below.
In the Progress Monitor Data Table, right click on the data column to
plot and select from the right mouse button menu:
1.
Define data to plot. Select the Graph option and then select Plot
Left or Plot Right from the sub-menu. The selected data plots
within the display with the axis on the designated side.
2.
Define line color. Select the Line Color option. The Color Palette
opens as shown below.
Click swatch
to select
Click on the swatch to select, or click the tabs to define a color

using the Hue/Saturation/Black (HSB) or Red/Green/Blue (RGB)
scales.
3.
56
Define line symbol. Click the Line symbol option and select the
Shape and Size of the symbols from the submenu options. You can
R2003.4
Landmark
also select the Color option to define the symbol color as

described in the above step.
Repeat these steps for each column of data you want to include in the
plot.
In the Progress Monitor Data Table, you can also right click on the data
column and select the following options from the right mouse button
menu:
Select the Remove Plot option to remove the data from the plot.
Select the Plot All Cases option to plot that column of data for all
Cases within the Study.
Zoom
You can zoom in and out of the plot display in two ways. Use the Zoom
buttons located at the bottom corners of the Status Plot. Or right click in
the plot area and select the option from the menu. Zoom levels are
honored when you print a Status Plot.
Zoom in
Zoom out
Change Background Color (Plot Display)

Right-click in the plot area as shown above and select the Color option
from the menu to open the Color Palette.
Change Background Color and Show All Axes (Plot Scale)
Right-click in the plot axis area as shown below and select the Show
All option to expand the axes display. Select the Color option to change
the background color of the axis display.
R2003.4
57
Landmark
Print
Right-click and select the Print Plot option from the menu as shown
above. The standard Print Options dialog box opens. Your current
display settings will be honored in the printed copy (what you see is
what you get). There is one exception: printed copies always have the
Show All axes.
58
R2003.4
Landmark
Analyze the Simulation Report

Simulation Report (r.out File)
The simulation report contains a wide variety of information that
represents the evolution of the reservoir model. Typical data may
include any or all of the following:
R2003.4
Names of other output files used for simulation restart, map data,
plot data, well summaries.
Card images of the data, showing the exact data that was input to
the simulation module.
Dimensions of the model such as number of gridblocks, regions,

wells, perforations, separators, etc.
Program options selected, formulation option, vertical

equilibrium, crossflow, etc.
Echo of the input data for the current reporting time period.
Time step summaries
Detailed iteration summaries.
Production/Injection summaries
Well layer summaries
Separator reports
Fluids in place, including average pressures and average

composition in each region of the reservoir
Well RFT reports
Array summaries giving values of pressure, saturation pressure,

saturations and compositions for each grid block
Job statistics, including total number of gridblocks in each

direction, total active gridblocks, fault connections, a breakdown
of CPU time by program section, and total job run times
Job Status: Analyze the Simulation Report
59
Landmark
Analyzing the Report

You must check this file carefully to make sure that the evolution of the
reservoir model has progressed without any major errors and that all
reservoir parameters are to your liking. The following procedure is
recommended:
1.
Click the right mouse button in the Progress Monitor panel and
select the Print r.out File option on the menu. The file opens in
your default editor.
2.
Use the Search or Find feature in the text editor window to locate
error messages by searching for key words such as ERROR,
WARNING, or TERMINATING.
3.
If you see any error messages, look at the surrounding data to

determine what went wrong. Correct the input data file and rerun
the simulation, if necessary.
4.
If there are no major errors, check how the simulator is running.
Are the timesteps very short?
Are there frequent timestep cuts or convergence failures?
Does the pressure change or saturation change oscillate from

timestep to timestep?
Does reference to one block or a few blocks in particular seem

to reoccur in the timestep summary?
If so you will probably need to spend some time tuning the

performance of the reservoir model.
5.
Check the production/injection rates, average pressure, water cut,

GOR, etc. to determine whether they were what you expected.
6.
For best results, use 2DVIEW or 3DVIEW to view the map files
and thoroughly check the pressures, saturations, and other key
data. Use PLOTVIEW to display plots of well performance and
compare with historical data, if available.
If you see any problems with the data, determine the source of the error,
correct it, and rerun the simulation. When you are satisfied, you are
ready to begin using the model for history match or prediction studies.
60
Job Status: Analyze the Simulation Report
R2003.4
Landmark
Index
A
add and delete nodes to job submittal network 27
analyze the simulation report 59
C
change Status Plot background color 57
copy status table to spreadsheet 54
D
Data Table 53
define status plot 56
E
ed 33
edit input files for job submittal 13
error messages and recovery 39
F
file naming conventions 9
File Options tab 12
H
host information check button 23
host information pane 23
host list
for parallel processing 25
host machine information display 4
I
import and export hosts to/from job submittal network 27
include files 11
input and output file selection 8
input files
select for job submittal 2
J
Job Status Monitor
Progress Monitor 52
Status Table 52
Job Submittal
R2003.4
Index
61

display conventions 2
job submittal
examples 41
job submittal workflow 1
M
manipulate fields in Status Table 53
monitor job submittal status 51
N
network hosts 27
network type for job submittal 16
O
output
from simulation 52
P
parallel host selection window 5
parallel job submission guidelines 26
parallel processing
host list 25
Parallel Submission Tab 25
print status plot 58
priority for job submittal process 16
processor for job submittal 15
Progress Monitor for job submittal status 52
R
remote host selection window 5
remote submittal guidelines 19
remote submittal procedures 19
Remote Submittal Tab 17
reports
output from simulation 52
S
sequential or simultaneous runs 16
shared memory for job submittal 33
simulation
output report 52
simultaneous or sequential runs 16
Status Plot for job submittal status 55
Status Table for job submittal status 52
stop the simulation 7
submit Cases for simulation 6
62
R2003.4
Landmark
submit simulation run 35

submittal indicator light 35
U
user interface conventions 2
V
valid parallel job submission options 26
VIP Only check box 24
Z
zoom in Status Plot 57
R2003.4
63
64
R2003.4

Job Sub Help

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Job Sub Help

Enviado por

Direitos autorais:

Formatos disponíveis

DESKTOP-VIP Job Submittal

2001, 2002 Landmark Graphics Corporation

Part Number 159684 R2003.4

Landmark Graphics Corporation

Desktop VIP Job Submittal Users Guide

Desktop VIP Job Submittal Users Guide

Job Status ...........................................................................................................................

Desktop VIP Job Submittal Users Guide

Analyze the Simulation Report...........................................................................................

Desktop VIP Job Submittal Users Guide

Desktop VIP Job Submittal Users Guide

Define the input and output file information

Choose to run jobs either locally or remotely

Choose to run jobs serially or in parallel

Monitor the job status

Analyze the simulation report

The job submittal work flow is summarized below.

Edit Output File Formats (page

Select Local or Remote Submittal (page

Complete Remote Submittal Tab

Select Serial or Parallel Submittal (page

Complete Parallel Submittal Tab

Submit VIP Simulation runs (page 35)

Job Submittal: Overview and Workflow

Desktop VIP Job Submittal Users Guide

Drag-and-drop. Click on the item in the display panel using the

Panes with associated menus

Job Submittal: User Interface

Desktop VIP Job Submittal Users Guide

Layout of the VIP Job Submittal Window

Processor options panel

Parallel Options Tab

Access host machine information

Job Submittal: User Interface

Desktop VIP Job Submittal Users Guide

Host Machine Information

Complete Open Position

Job Submittal: User Interface

Desktop VIP Job Submittal Users Guide

Remote/Parallel Host List

Job Submittal: User Interface

Desktop VIP Job Submittal Users Guide

Submit Case(s) for Simulation

Queue and Submit Case(s)

Select the Case. Double-Click the Case name in the Study/Case

Select submittal options. At minimum, click the Initialize or

Queue additional Cases (optional). Repeat step 2 above for any

Job Submittal: Submit Case(s) for Simulation

Desktop VIP Job Submittal Users Guide

Once the simulation is in process, you will be notified of errors in one

A message box will open on the Job Submittal window with a

If you have submitted multiple Cases, subsequent jobs will continue to

Stop and Restart the Simulation

The dialog box shown below opens.

Click the appropriate button on the dialog box as described below.

Stop the Run

Job Submittal: Submit Case(s) for Simulation

Desktop VIP Job Submittal Users Guide

Select Input and Output Files

File Icon Display Colors

Job Submittal: Select Input and Output Files

Desktop VIP Job Submittal Users Guide

File Naming Conventions

VIP-EXEC input file: