element_version_pathname


element_version_pathname argument

The  set  thread  command's  -from  option can take the element_version_pathname
argument.  Element version pathnames are  pathnames  recognized  by  the  DOMAIN
system  that  identify  particular  versions  of DSEE elements.  Element version
pathnames allow you to perform many DOMAIN system  functions  from  outside  the
DSEE environment with any existing version of an element.  You can, for example,
read an existing version of a DSEE element using the DM cv  command  (which  you
can issue by pressing <READ>).

To  read  the  most  recent  version on an element's main line of descent, press
<READ> and, at the "Read file:" prompt type the full pathname for  the  element;
for example,

Read file: //graphics/insert_lib/graph.ins.pas

To  read any other version of an element, follow the element name by a slash (/)
and a version specifier.  For example, to read version 5 on  the  main  line  of
descent, type

Read file: //graphics/insert_lib/graph.ins.pas/[5]

To  read  version 5 on a branch line of descent, include the branch path name in
the version specification, and separate the version number from that branch path
name with another slash:

Read file: //graphics/insert_lib/graph.ins.pas/bugs/BL1_bugs/[5]

Formats

Here  are the possible formats for element version pathnames given to the DOMAIN
system.  Please refer to Chapter 3 for the precise meanings  of  the  arguments.
(Spaces  in  the  format lines in this section are for readability only.  Do not
include spaces in element version specifiers.)

To identify a particular version on the main line of descent, use the  following
format  for  the  element version pathname.  If you omit the version_number, the
DOMAIN system assumes that you want the most recent version on the main line  of
descent.

library_directory '/' element_name ['/' ['[']version_number[']']]

Here are some examples of element version pathnames using the above format:

//alligator/libs/jeff_lib/chart.ftn
applications_lib/bind.c/[7]
max/core/dtty.pas/4

To  identify  a  particular  version  on  an  alternate line of descent, use the
following  format  for  the  element  version  pathname.    If  you   omit   the
version_number,  the DOMAIN system assumes that you want the most recent version
on the branch.

library_directory '/' element_name '/' branch_path ['/' ['[']version_number[']']

Here are some examples of element version pathnames using the above format:

//server/libs/source_lib/crt.pas/ver_4_bugs
pdq/inserts/globals.ins.pas/dev_branches/ray_branch/3
~array_lib/drw_quad.ftn/.../my_branch/[12]

To identify a named version, use the following format for  the  element  version
pathname.

library_directory '/' element_name '/' '[' version_name ']'

Here are some examples of element version pathnames using the above format:

arlo/release_notes/cad_pkg.fmt/[baselevel_2]
//master/compiler_libs/parser_lib/syntax.ftn/[sr4]

You  might  find  the  following  rules  of thumb useful in constructing element
version pathnames:

 o The DOMAIN system makes the  same  default  assumptions  as  the  DSEE
   environment:  if  you  don't  specify a branch path, the DOMAIN system
   assumes you want a version on the main line of descent; if  you  don't
   specify  a version name or number, it assumes you want the most recent
   version on the specified line of descent.

 o Slashes separate components of the element version pathname.  A  slash
   separates  the library's pathname from the element name; another slash
   separates a branch path name from an element  name;  and  yet  another
   slash separates a version name or number from the element name or line
   of descent.

 o Square brackets ([]) are optional around version numbers but  required
   around version names.

Syntactic Differences

As  you  may  notice, the syntax for element version pathnames that you use with
the DOMAIN system differs slightly from  the  syntax  you  use  when  specifying
element versions for the DSEE facility.  There are two specific differences:

 o In  DSEE  syntax,  brackets  must always surround version numbers.  In
   DOMAIN element version pathnames,  the  brackets  surrounding  version
   numbers are optional.

 o In DSEE syntax, a bracketed version number or version name immediately
   follows an element or branch  name.    In  a  DOMAIN  element  version
   pathname,  a  version  number  (optionally  enclosed  in  brackets) or
   version name (always enclosed  in  brackets)  is  separated  from  the
   preceding element or branch name by a slash (/).
Museum
