Document Conventions

Convention

Description

Courier New and Courier New Bold

Code examples, syntax, commands, menu items, screen text, and other keywords recognized by the system. All such text is displayed in Courier New Bold to allow for quick identification when the text is referenced within general descriptive text. Additionally, Courier New Bold is used in code, syntax and screen text boxes to distinguish between typed text and text that is displayed or returned by the system. For example:

Italic

• Variables to be replaced by the value. It can be an actual name, word, or number. For example, file.name might be replaced with CUST.FILE.

• Non-linked references to other documents or topics within this document.

• Emphasis for impact or the first time a word is used. For example, …resources and information make up the state of the application.

n{-m}

The letters n and m represent numbers. Numbers are usually input as a single string without commas. Numbers can also be used to define a range designation. The starting and ending numbers are typed with a hyphen between. For example, n{-m} could be replaced by 10 or by 1-31.

{ }

Braces ( {} ) delimit a mutually exclusive set of options.

on | off

The vertical line or pipe sign ( | ) separates a mutually exclusive set of options.

[0 | line | ?]

Brackets ( [ ] ) indicate optional entries.

D³

Proper name of the DBMS software product that is referred to as D3 throughout this document.

d3

The name can appear as d3 when the name appears in the command language or file names.

Term

Description

log in

This term refers to the Linux log in. A user logs in using the UNIX user name and optional password.

connect

A Linux user establishes a connection with a virtual machine. The default virtual machine name is pick0. If several virtual machines exist on the same system, the user identifies the virtual machine using a symbolic name such as d3_newyork_branch.

Normally, this displays the D3 logon message. As noted elsewhere, the D3 log on and connect steps can be made automatic so a D3 user does not need a Linux login name and password. This is a logical connection, and has nothing to do with the serial port. There is no process-to-process communication or data movement of any kind.

log on

This term refers to logging on to D3. A user logs on by giving a D3 user name, and an optional master dictionary and password. On a turnkey system, this is the only interface the end-user sees.

disconnect

Generally, to disconnect from the D3 environment, execute the exit command. On a default, non-turnkey system, disconnecting releases the user to the UNIX shell and terminates the D3 session. On a turnkey process, disconnecting returns the user to the D3 logon prompt. A user logged on to the D3 virtual machine can disconnect temporarily, dropping to the Linux shell. The user is still logged on to the D3 virtual machine, suspending the D3 environment until they reconnect to the virtual machine and resume activity.

process

Each D3 user process is an operating system process, making data exchange between the D3 environment and the operating system simple and efficient.