HP 3000 Manuals

DISPLAY VERSION [ HP SYSTEM DICTIONARY XL SDMAIN ] MPE/iX 5.0 Documentation


HP SYSTEM DICTIONARY XL SDMAIN

DISPLAY VERSION 

Displays one or more versions.

Syntax 

     DIS[PLAY] V[ERSION] [version-name]
             [;STAT[US] = version-status]
             [;C[OMMON]] = [common-version-name]]
             [;LAST[-ONLY]]
             [;S[COPE-]O[WNER] = scope-owner-name]
             [;NAME[-ONLY]]
             [;NO[SORT]]
             .

Parameters 

version-name          Name of the version to be displayed.

version-status        Status of the version to be displayed.  Valid
                      statuses are:

                           test
                           production
                           archival

common-version-name   Common version linked to the version to be
                      displayed.  You should only use this clause in a
                      local domain, as the common link is always blank in
                      the common domain.  Specifying COMMON without a
                      value requests a match to all versions that do not
                      have a common link.

LAST-ONLY             This flag displays the version last set to each
                      status (or a specific status if indicated).  If
                      specified, only the last version set to the
                      specified status is listed.  If not specified, all
                      versions set to the specified status are listed.

scope-owner-name      Owner of the version to be displayed.  If the
                      current scope does not have secure capability, any
                      qualification other than the current scope causes
                      no versions to be retrieved.

NAME-ONLY             If specified, only the name of the qualifying
                      version is displayed.  If not specified, the name,
                      status, owner, common version, and history of the
                      version are displayed.

NOSORT                Reports on the versions in the unsorted order in
                      which they are retrieved from the dictionary.
                      Otherwise, the versions are sorted alphabetically
                      by the version name.

Description 

When sorting is not required, the use of the NOSORT keyword speeds
processing time.

If the scope does not have secure capability, the scope owner is not
displayed unless the current scope is the owner.

Open Mode:       Read-only, shared-update, or exclusive-update

Scope:           Any

Example 

The following example displays all versions having a status of either
archival or production.

     >DISPLAY VERSION; 
     >>STATUS = Archival or Production. 
     SALES1
        Version-Status : ARCHIVAL
        Scope-Owner : MARKETING
        Common : COMMON1
        History : 02/07/84 10:04 AM  ARCHIVAL
                  02/02/84  3:45 PM  PRODUCTION
                  02/02/84  3:44 PM  TEST
     SALES2
        Version-Status : ARCHIVAL
        Scope-Owner : MARKETING
        Common : COMMON2
        History : 03/01/84  9:56 PM  ARCHIVAL
                  02/07/84 11:03 AM  PRODUCTION
                  02/04/84 10:53 PM  TEST
     SALES3
        Version-Status : ARCHIVAL
        Scope-Owner : MARKETING
        Common : COMMON3
        History : 03/04/84  3:16 AM  ARCHIVAL
                  03/01/84  7:23 PM  PRODUCTION
                  02/20/84  9:34 PM  TEST
     SALES4
        Version-Status : PRODUCTION
        Scope-Owner : MARKETING
        Common : COMMON4
        History : 03/04/84 12:04 AM  PRODUCTION
                  03/01/84 12:53 PM  TEST

        4 Version(s) Retrieved
     >


MPE/iX 5.0 Documentation