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 User’s 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

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

Analyze the Simulation Report...........................................................................................
Simulation Report (r.out File) ................................................................................
Analyzing the Report .............................................................................................

R2003.4

59
59
60

v

Desktop VIP Job Submittal User’s Guide

vi

Landmark

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

1

Desktop VIP Job Submittal User’s Guide

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.

2

Job Submittal: User Interface

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: User Interface

3

Desktop VIP Job Submittal User’s Guide

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.

4

Job Submittal: User Interface

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: User Interface

5

Desktop VIP Job Submittal User’s Guide

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.

6

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

Desktop VIP Job Submittal User’s Guide

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

7

Desktop VIP Job Submittal User’s Guide

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:

8

Display Color

File Type

Blue

Initialization file

Red

Restart file

Magenta

Other

Job Submittal: Select Input and Output Files

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Select Input and Output Files

9

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Select Input and Output Files

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Select Input and Output Files

11

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Select Input and Output Files

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Select Input and Output Files

13

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Select Input and Output Files

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Remote Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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 user’s 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

Job Submittal: Remote Submittal Tab

19

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Remote Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Remote Submittal Tab

21

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Remote Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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 Cases’s 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 Case’s 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.

Job Submittal: Remote Submittal Tab

23

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Remote Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

---Not Selectable---

Parallel

Remote

UNIX/Linux

SGI Shared Memory

SUN (Solaris)
Processor Option

Run Location

Remote Options

Parallel Options

Serial

Remote

UNIX/Linux

---Not Selectable---

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.

Job Submittal: Parallel Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Parallel Submittal Tab

27

Desktop VIP Job Submittal User’s Guide

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.

Job Submittal: Parallel Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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 user’s 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

Job Submittal: Parallel Submittal Tab

29

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Parallel Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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.

Job Submittal: Parallel Submittal Tab

31

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Parallel Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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.
Job Submittal: Parallel Submittal Tab

33

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: Parallel Submittal Tab

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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.

Job Submittal: Submit Simulation Run(s)

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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.

Job Submittal: Submit Simulation Run(s)

37

Desktop VIP Job Submittal User’s Guide

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.

Job Submittal: Submit Simulation Run(s)

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

Job Submittal Error Messages and Recovery
A summary of error messages and recovery hints is provided below.
Job Submittal Error Messages and Recovery

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 it’s 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 editor’s
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.

Job Submittal: Submit Simulation Run(s)

39

Desktop VIP Job Submittal User’s Guide

Landmark

Job Submittal Error Messages and Recovery

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 can’t 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.

Job Submittal: Submit Simulation Run(s)

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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
Job Submittal: Submit Simulation Run(s)

41

Desktop VIP Job Submittal User’s Guide

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.

VIP-EXEC restart file:

This field will be grayed out and is unavailable for an initialization run.

Plot Observation file:

This field will be grayed out and is unavailable for an initialization run.

Output Options

42

VIP-CORE restart file:

initi.rst

VIP-EXEC restart file:

This field will be grayed out and is unavailable for an initialization run.

Job Submittal: Submit Simulation Run(s)

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

VIP-EXEC restart file:

initi.rst

Plot Observation file:

primary.obs

Output Options

R2003.4

VIP-CORE restart file:

This field will be grayed out and is unavailable for a simulation run.

VIP-EXEC restart file:

primaryr.rst

Job Submittal: Submit Simulation Run(s)

43

Desktop VIP Job Submittal User’s Guide

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-CORE Input File:

This field will be grayed out and is unavailable for a simulation run.

VIP-EXEC Input File:

h2ofloodr.dat

VIP-EXEC restart file:

initi.rst

Plot Observation file:

h2oflood.obs

Output Options

44

VIP-CORE restart file:

This field will be grayed out and is unavailable for a simulation run.

VIP-EXEC restart file:

h2ofloodr.rst

Job Submittal: Submit Simulation Run(s)

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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
VIP-CORE Input File:

This field will be grayed out and is unavailable for a simulation run.

VIP-EXEC Input File:

h2oafterprimaryr.dat

VIP-EXEC restart file:

primaryr.rst

Plot Observation file:

h2oafterprimary.obs

Output Options

R2003.4

VIP-CORE restart file:

This field will be grayed out and is unavailable for a simulation run.

VIP-EXEC restart file

h2oafterprimaryr.rst

Job Submittal: Submit Simulation Run(s)

45

Desktop VIP Job Submittal User’s Guide

Landmark

Example 5 - Initialization Parallel Case
Case Options
Study Name:

example

Parent Case:

(blank)

Case Name:

parallel

Toggle Options

Initialization

Input Options
VIP-CORE Input File:

paralleli.dat

VIP-EXEC Input File:

This field will be grayed out and is unavailable for an initialisation run.

VIP-EXEC Restart File:

This field will be grayed out and is unavailable for an initialisation run.

Plot Observation File:

This field will be grayed out and is unavailable for an initialisation run.

Input Options

46

VIP-CORE Restart File:

paralleli.rst

VIP-EXEC Restart File:

This field will be grayed out and is unavailable for an initialisation run.

Job Submittal: Submit Simulation Run(s)

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

Example 6 - Recurrent Parallel Case
Case Options
Study Name:

example

Parent Case:

(blank)

Case Name:

parallel

Toggle Options

Restart

Input Options
VIP-CORE Input File:

This field will be grayed out and is unavailable for an initialisation run.

VIP-EXEC Input File:

parallelr.dat

VIP-EXEC Restart File:

paralleli.rst

Plot Observation File:

parallel.obs

Input Options

R2003.4

VIP-CORE Restart File:

This field will be grayed out and is unavailable for an initialisation run.

VIP-EXEC Restart File:

parallelr.rst

Job Submittal: Submit Simulation Run(s)

47

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

Job Submittal: False Card Options

49

Desktop VIP Job Submittal User’s Guide

50

Job Submittal: False Card Options

Landmark

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

Job Status: OverView

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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.

Job Status: OverView

53

Desktop VIP Job Submittal User’s Guide

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

Job Status: OverView

Open the spreadsheet application. Open the spreadsheet
application into which you want to copy the Status Table fields.

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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.

Job Status: OverView

55

Desktop VIP Job Submittal User’s Guide

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

Job Status: OverView

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

Desktop VIP Job Submittal User’s Guide

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

Job Status: OverView

57

Desktop VIP Job Submittal User’s Guide

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

Job Status: OverView

R2003.4

Landmark

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide
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

Desktop VIP Job Submittal User’s Guide

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

Desktop VIP Job Submittal User’s Guide

64

R2003.4