Google
 

Trailing-Edge - PDP-10 Archives - BB-X595B-BM - dx/ddxins.mem
There is 1 other file named ddxins.mem in the archive. Click here to see a list.


DECdx/TOPS-20


Installation and Information 


Order No. AA-P150A-TM
Copyright


                                                      AA-P150A-TM
                                      First Printing:  April 1984

The information in this document is subject to change without 
notice and should not be construed as a commitment by Digital 
Equipment Corporation.  Digital Equipment Corporation assumes no 
responsibility for any errors that may appear in this document.

The software described in this document is furnished under a 
license and may be used or copied only in accordance with the 
terms of such license.

Digital Equipment Corporation assumes no responsibility for the 
use or reliability of this software on equipment that is not 
supplied by DIGITAL.

         Copyright cO 1984, Digital Equipment Corporation

The following are trademarks of Digital Equipment Corporation:



    L9                   DECdx               RSTS
    DECnet              DIBOL               RSX
    DECsystem-10        MASSBUS             UNIBUS
    DECSYSTEM-20        PDP                 VAX
    DECUS               P/OS                VMS
    DECwriter           Professional        VT
    DECmate             Rainbow             Work Processor
Contents









PREFACE
              
              Purpose                                      v
              Audience                                     v
              Related Documents                            v
              Conventions                                  v


CHAPTER 1     INSTALL DECdx ON TOPS-20

              Introduction                                 1
              DECdx Installation Requirements              1
              Preparing to Install DECdx                   1
              Installing DECdx                             3
                    Errors                                 5
              After Installing DECdx                       5
                    Release Notes                          5
              

CHAPTER 2     USER SUPPORT

              User Support at Start-up                     7
              File Protection Requirements                 7
                    Conversion of DX/TOPS-20 Documents     8
                    Easycom                                8
              Continuing User Support                      8
                    Unlocking Documents                    8
                    Error Tracing                          9
                    Temporary Files                        9
              

CHAPTER 3     NOTES FOR THE SYSTEM MANAGER

              What Is DECdx?                               11
                    Document Transfer                      11
                    Document Compatibility                 12
                    Multiuser Software                     12
                    Supercession                           12
              How DECdx Differs from DX/TOPS-20 V1.0       12
                    New Features                           12
                    Functional Changes                     13


INDEX                                                      17
Preface






PRODUCT:              DECdx

VERSION:              1.0 

OPERATING SYSTEM:     TOPS-20







Purpose

This document explains how to install the DECdx software package 
on a TOPS-20 operating system of a DECSYSTEM-20.

Information in this manual applies to Version 5.1 of the TOPS-20 
operating system.

Keep this manual with your distribution kit.  You will need to 
refer to it again should you receive maintenance updates or 
should you have to reinstall DECdx for other reasons.  This 
manual is also supplied on-line in the file DDXINS.MEM.


Audience

This installation manual is for the system manager or user with 
system manager privileges who wants to install and maintain DECdx 
Version 1.0 on a TOPS-20 system.


Related Documents

    oo   DECdx Getting Started    (AV-P146A-TK)

    oo   DECdx User's Guide    (AA-U153A-TK)

    oo   TOPS-20 Software Installation Guide    (AA-M229A-TM)


Conventions

The manual uses these conventions:

red print     Commands that you type or sample responses to 
              prompts (as distinguished from text or screen 
              prompts).

<RETURN>      Press the RETURN key (usually follows commands in 
              red print).

<CTRL/C>      Hold down the CTRL key and press the indicated key, 
              in this case, C.

<ESC>         Press the ESCAPE key, usually labeled ESC.  TOPS-20 
              responds with more information about the command, 
              in parentheses, which appears in black type in this 
              manual.

UPPERCASE     Commands or utilities.
WORDS
 






                 KEEP THIS MANUAL WITH YOUR MEDIA









                                  1: Install DECdx on TOPS-20










Introduction

This chapter explains how to install DECdx Version 1.0 on a 
TOPS-20 system.  Installation takes about 15 minutes. 






DECdx Installation Requirements

The following are needed to install DECdx:

    oo  A TOPS-20 system with Version 5.1. 

    oo  System manager privileges.

    oo  About 350 pages of disk space during installation and 130 
       pages after installation.

    oo  TOPS-20 Software Installation Guide.

    oo  This installation manual, which is also available on-line 
       in file DDXINS.MEM.

    oo  DECdx Version 1.0 software on magnetic tape, MT9 1600, 
       order number QT709-AM.

The magnetic tape volume is labeled DDX.  Check that your kit 
contains the volume listed in the bill of materials.

To install DECdx on your system, you must also know how to mount 
the magnetic tape in the tape drive.






Preparing to Install DECdx

NOTE:  The instructions in this manual assume that you are using 
the operator's console terminal (CTY), but it is possible to 
perform the installation from another terminal.

To prepare for installation:

1   Type <CTRL/C> to start a job at your terminal.  You get a 
    message and prompt similar to this:

     Installation-test System, TOPS-20 Monitor 4(2644)
     @


2   Log into a privileged account.

     @LOGIN Username password <RETURN>

3   Invoke the OPR program.


     @ENABLE <ESC> (CAPABILITIES) <RETURN>
     $OPR <RETURN>
     OPR>


4   Find a tape drive you can use for mounting the DECdx tape.  
    For example:


     OPR>SHOW STATUS TAPE-DRIVE/ALL <RETURN>
     OPR>
     7:59:33           --Tape Drive Status--
            DRIVE  STATE     VOLID   REQ#   JOB#   USER
            -----  -----     -----   ----   ----   ----
            MTA0:  Unloaded
                   AVR: Yes
            MTA1:  In Use    DEK     31     45     MARTIN
                   AVR: Yes, Write: Yes, Unlabeled
            MTA2:  Loaded
                   AVR: Yes, Write: Yes, Unlabeled
     OPR>


5   Mount the tape containing the files on the magnetic tape 
    drive.  Remember to press the ON LINE button after mounting 
    the tape.


6   Protect the free tape drive from use by timesharing users by 
    making it unavailable.  The following example uses drive 
    number 0, but you can specify any drive that is not in use at 
    the moment.

     OPR>SET TAPE-DRIVE MTA0:  UNAVAILABLE <RETURN>
     Enter text and terminate with ^Z


7   Type a message such as INSTALLING UNBUNDLED SOFTWARE and type 
    <CTRL/Z>.


8   Return to the TOPS-20 command level by using the PUSH 
    command.

     OPR>PUSH <RETURN>

      TOPS-20 Command processor 4(514)
     $





Installing DECdx

1   Assign a magnetic tape drive to your job.  The following 
    example uses drive number 0, but you can use any free drive.

     $ASSIGN <ESC> (DEVICE) MTA0: <RETURN>
     $


    If the drive has already been assigned, return to step 4 of 
    the preparation procedure (above) and locate an alternate 
    device.



2   Use the DUMPER routine to transfer the files from the 
    magnetic tape to a temporary working area.  The following 
    examples assume the working directory is PS:<OPERATOR> and 
    the public directory is PS:<SUBSYS>.  

     $DUMPER <RETURN>
     DUMPER>


3   Tell DUMPER which tape drive to use.  Use the number of the 
    drive you assigned in step 1.

     DUMPER>TAPE <ESC> (DEVICE) MTA0: <RETURN>
     DUMPER>


4   Rewind the tape to the beginning.

     DUMPER>REWIND <RETURN>
     DUMPER>


5   Restore the documents to directory PS:<OPERATOR>.  You may 
    choose a directory other than OPERATOR.  An empty directory 
    is not necessary because the DDXBLD command file 
    automatically deletes the binary relocatable files after they 
    are linked into an executable file, DDX.EXE (see step 10).

     DUMPER>RESTORE <ESC> (TAPE FILES) PS: <ESC> <*>*.*.* (TO)
     PS:<OPERATOR> <RETURN>

     DUMPER TAPE # 1, <DOCUMENTS>, WEDNESDAY, 5-OCT-83 1741
     LOADING FILE(S) INTO PS:<OPERATOR>

     END OF SAVESET
     DUMPER>
    Two files should be loaded at this point:  

    1) DDXINS.MEM, the TOPS-20 Installation and Information 
       manual; and 

    2) DDXRLS.MEM, the TOPS-20 Release Notes.

    If you do not see the message LOADING FILE(S) INTO 
    PS:<OPERATOR>, then no files are being restored from tape.  
    Rewind the tape and try again (steps 4 and 5).  Be sure that 
    you mounted the correct tape and that the tape drive is 
    on-line.  



6   Restore the binary files to PS:<OPERATOR>.  About 75 files 
    will be loaded with this command.  

     DUMPER>RESTORE <ESC> (TAPE FILES) PS: <ESC> <*>*.*.* (TO)
     PS:<OPERATOR> <RETURN>

     DUMPER TAPE # 1, <BINARY>, WEDNESDAY, 5-OCT-83 1743
     LOADING FILE(S) INTO PS:<OPERATOR>

     END OF SAVESET
     DUMPER>


7   Restore the Help files to PS:<HELP> with the RESTORE command:

     DUMPER>RESTORE <ESC> (TAPE FILES) PS: <ESC> <*>*.*.* (TO)
     PS:<HELP> <RETURN>

     DUMPER TAPE # 1, <HELP>, WEDNESDAY, 5-OCT-83 1745
     LOADING FILE(S) INTO PS:<HELP>

     END OF SAVESET
     DUMPER>


8   All the DECdx files are installed at this point.  If you want 
    to install other unbundled software products, go back to step 
    4 of the preparation procedure.  Repeat the procedure, naming 
    the next product to install.  Otherwise, exit the DUMPER 
    routine and return to TOPS-20 command level.

     DUMPER>UNLOAD <RETURN>
     DUMPER>EXIT <RETURN>
     $


9   Deassign the tape drive.

     $DEASSIGN <ESC> (DEVICE) MTA0: <RETURN>
     $


10  Link the binary relocatable file into an executable file:

     @CONN <ESC> (TO DIRECTORY) PS:<OPERATOR> 
     $TAKE <ESC> (COMMANDS FROM) PS:<OPERATOR>DDXBLD.CMD <RETURN>


    The system responds with the following:

     LINK:   Loading

     Exit
       DDX.EXE.1 Saved
       End of DDXBLD.CMD.1
     $


    The command procedure, DDXBLD, deleted the DECdx binary 
    relocatable files from <OPERATOR>, or the directory you 
    specified, and displayed a list of the deleted files.



11  Rename or copy the .EXE file from the working area to the 
    public subsystem area.

     $RENAME <ESC> (EXISTING FILE) DDX.EXE.* <ESC> (TO BE)
      PS:<SUBSYS>DDX.EXE.1 <ESC> !NEW FILE! <RETURN>
      DDX.EXE.1 => <SUBSYS>DDX.EXE.1 [OK]
     $


12  Delete the .EXE file if the file was copied to the public 
    area.

     $DELETE DDX.EXE <RETURN>





Errors

If you get errors using DUMPER, refer to the description of 
DUMPER in the TOPS-20 User Utilities Guide (AA-D850A-TM).  For 
more information on crash recovery, see the TOPS-20 Software 
Installation Guide (AA-M229A-TM).





After Installing DECdx

1   Release the tape drive for use by other users and exit the 
    OPR program.  This example uses device 0; substitute your 
    device number.

     $POP <RETURN>
      OPR> SET TAPE-DRIVE MTA0: AVAILABLE <RETURN>
      OPR> EXIT <RETURN>
     @


2   Remove the tape from the drive, and store it in a safe place 
    for possible future use.




Release Notes

The DECdx/TOPS-20 Release Notes, which were printed during step 5 
of the installation procedure, are on-line in the file 
DDXRLS.MEM.  Please read the Notes for information on 
documentation and software problems.
  
   









                                                  2: User Support








User Support at Start-up

In general, DECdx users are familiar with the WPS menu format.  
To support this user, DECdx uses WPS-like menus as the user 
interface.  User responses to DECdx menus and prompts initiate 
DECdx functions.

The system manager must support the user by:

    oo  Assigning a user name, a password, and an account number.

    oo  Establishing a user directory.

    oo  Supplying WPS communications settings information (baud 
       rate, parity, data/stop bits) so that communication takes 
       place.

    oo  Helping the WPS user with TOPS-20 commands and error 
       messages.

The user will find all necessary information for running DECdx in 
the Getting Started card (AV-P146A-TK).

The DECdx options and their use are described in the DECdx User's 
Guide (AA-U153A-TK).  Information specific to the TOPS-20 
operating system is also provided.

On-line assistance is available by typing H at the DECdx Menu.  
Help for each option consists of the definition, why the option 
is used, how it is used, any shortcuts, and where to get more 
information.






File Protection Requirements

The DECdx index must be protected with group write privileges for 
the documents to be written to or read.

Set up the DECdx index with this default protection code:

    @SET FILE PROTECTION <ESC> (of files) INDEX.DX.* <ESC> (to)   
     777700
     INDEX.DX.1 [OK]
    @


Conversion of DX/TOPS-20 Documents

When users select the ON option, they see this message:

    Old format files will be deleted following successful 
    conversion.
    If you wish to make backup copies, do not proceed with 
    conversion.



This message refers to files created under the previous 
DX/TOPS-20 product (Version 1.0).  The system manager may have to 
help the user by verifying that backups of the files exist, or by 
creating a separate directory for copies of the old-format files.

The DECdx installation procedure does not delete the old WNDX 
file (the DX/TOPS-20 index).  The ON (Old-to-New conversion) 
option uses the WNDX file to assign document names during a 
multiple document conversion process.  After successful multiple 
conversion, the ON option deletes the old WNDX file.

More information on DX/TOPS-20 and Old-to-New conversion is given 
in the DECdx User's Guide (AA-U153A-TK).




Easycom 

Easycom is a command file used by DECmate II systems to automate 
some of the steps required in certain procedures, such as logging 
on and getting to the DECdx Document Transfer Menu.  

The DECdx documentation does not mention any changes to 
procedures that might be modified by Easycom.  If Easycom is used 
to automate DECdx procedures, the system manager must explain the 
changes to users.







Continuing User Support

Once users are familiar with DECdx, they should require very 
little assistance from the system manager.  However, several 
error messages in the on-line assistance direct the user to the 
system manager for help.  Except for the problem of unlocking 
documents (see the next section), the error messages deal with 
system-specific problems such as file protection interference and 
insufficient disk space.




Unlocking Documents

A document may remain locked after the user has finished adding, 
printing, converting (File-to-Document or Old-to-New options), 
deleting or transferring it.  This abnormal locked condition is 
especially likely to occur when the user presses CTRL/C to exit 
the Read, Print or Document-to-File options.  Until the document 
is unlocked, anyone trying to access the document receives this 
error message:

    That document is in use by someone else right now.

The on-line assistance for this error suggests the user see the 
system manager if the document remains locked when no one is 
using it.
To unlock the document follow this procedure:

    1) Check the user's DECdx index.  The word "Locked" should 
       appear in the File Lock column for the document.

    2) Verify that no one is using the document.  

    3) At the user's DECdx Main Menu, type the word CORRECT and 
       the name or number of the locked document.  For example:  

         CORRECT May Claims Mailing List

    4) Check the index to make sure "Locked" has been replaced 
       with "Free".

Note that the CORRECT command is an invisible menu option.  
However, because the system manager may want to restrict its use, 
CORRECT is not documented in the DECdx User's Guide, the Getting 
Started Card, or the on-line assistance.








Error Tracing

DECdx provides an error Traceback feature.  The system manager 
can, immediately after an error occurs, view the messages 
associated with that error by typing TRACE from the DECdx Menu.

The TRACE command displays all messages on the error stack.  The 
system manager can use available RMS documentation to evaluate 
RMS errors.  






Temporary Files

Temporary files are created two ways:

    oo  The user presses CTRL/C to stop a Top, Bottom, or 
       Overwrite procedure. 

    oo  The user exceeds the disk quota in the process of adding 
       text to an existing document.

The following sections explain how to deal with temporary files.


Temporary Files Caused by use of CRTL/C

Temporary files may result when the user presses CTRL/C to exit 
the options Add, FD, and Transfer after choosing Top, Bottom or 
Overwrite.  (Temporary files created by exiting DF are discussed 
later).  If a temporary file is created, the DOCnnn.DX file is 
missing from the user's directory, and the DECdx index has this 
message after the document name: "This document can not be found 
in the current area".
The user's directory has one of these temporary files:  

    oo  TMPnnn.DX if Top or Overwrite was exited                

    oo  BTMnnn.DX if Bottom was exited
                                                                 
To restore the DOCnnn.DX file, rename the temporary file.  The 
original file, plus the new information, is in the temporary 
file, which DECdx did not have time to rename before the user 
pressed CTRL/C.

If the user exited after choosing Top or Overwrite, check the 
directory for a temporary file in the format TMPnnn.DX, where 
"nnn" is the document number of the missing document (see the 
DECdx index for the document number if there are several 
temporary files).  Rename the TMPnnn.DX file to DOCnnn.DX.  For 
example:

    @Rename TMP088.DX DOC088.DX <RETURN>


If the user exited after choosing Bottom, check the user's 
directory for the temporary file, BTMnnn.DX, where "nnn" is the 
document number of the missing document.  Rename the BTMnnn.DX 
file to DOCnnn.DX.  For example:

    @Rename BTM023.DX DOC023.DX <RETURN>


The use of CTRL/C to exit the DF (Document-to-File) option during 
a Top, Bottom or Overwrite Procedure may also result in a 
temporary file of the format TMPnnn.DX.  The TMPnnn.DX file is 
the original file to be converted, together with new information, 
as modified by the Top, Bottom or Overwrite choice.   The 
converted file disappears from the user's directory.  DECdx did 
not have time to rename the file before the user stopped the 
conversion with CTRL/C.  

To reinstate the file, rename the temporary file.  For example:


    @Rename TMP034.DX Status.rpt <RETURN>




Temporary Files Caused by Insufficient Disk Space

If DECdx cannot add text to an existing file using the Top, 
Bottom or Overwrite, options due to insufficient disk space, a 
temporary file is created.  The temporary file, in the format 
TMPnnn.DX, is a partial file that contains whatever text was 
added before the disk quota was exceeded.  

Although the system indicates that the procedure may be resumed 
after files are expunged, this is not the case.  The user has to 
restart the procedure after more disk space is acquired.  The 
temporary file is superseded after successful completion of the 
task.  

The temporary file may be deleted to acquire extra space.  Before 
deleting the file, verify that it is the right temporary file by 
finding the corresponding DOCnnn.DX file, where "nnn" is the same 
in both files.












                                3:  Notes for the System Manager









What is DECdx?

DECdx V1.0 is a layered software product that runs on the TOPS-20 
operating system, Version 5.1.  DECdx provides WPS document 
transmission over point-to-point data communication links between 
DIGITAL word processing systems (WPS) and DIGITAL host systems.  
In addition, DECdx provides options for manipulating WPS 
documents that are on the host.

DECdx allows users to:

    oo  Transfer WPS documents to the host, preserving the WPS 
       formatting.

    oo  Create files on the host and then transfer those files to 
       the WPS for editing.

    oo  Access the data processing and file management 
       capabilities of the host.

    oo  Store large documents on the host.

    oo  Share documents.

For basic information on DECdx, see the DECdx/TOPS-20 Version 1.0 
Software Product Description, SPD 21.36.00.





Document Transfer 

The purpose of DECdx software is to facilitate transfer of 
WPS-format documents to a host and to use those documents on the 
host.  The X option transfers documents by using the DX protocol; 
the Document-to-File (DF) option translates WPS-format documents 
to ASCII-format files.

The WPS system also offers a CX (Character transfer) option that 
has settings such as HD (Host to Document) and DH (Document to 
Host).  The WPS user should choose the CX option when:

    oo  There is no need to preserve the special WPS-format 
       characters in a document, and

    oo  The user does not want to use the special DX 
       error-detecting protocol.

For example, use the WPS CX option with the HD/DH settings to 
move source (program) files from the host to the WPS and vice 
versa.


Document Compatibility

DECdx V1.0 running on TOPS-20 is compatible with DECdx V1.0 
running on:

    oo  VMS
    oo  RSX-11M or RSX-11M PLUS
    oo  RSTS/E
    oo  TOPS-10

DECdx makes WPS documents compatible among the six operating 
systems.  Users can move documents to other host systems by 
magnetic tape and use those documents at the new host with no 
compatibility problems.


Multiuser Software

When more than one user uses the same account, DECdx detects and 
prevents multiple user updates of the same document.  Limited 
access prevents users from losing data due to simultaneous access 
collisions.


Supersession

DECdx Version 1.0 supersedes DX/TOPS-20 Version 1.0.







How DECdx Differs From DX/TOPS-20 V1.0

If the host previously ran DX/TOPS-20 Version 1.0, read this 
section to understand the differences between that older product 
and DECdx.


New Features

    oo  Compatibility -- Documents stored under TOPS-20 using 
       DECdx are compatible with DECdx documents on VMS, RSX-11M 
       and RSX-11M PLUS, RSTS/E, and TOPS-10.

    oo  Multiple users capability -- DECdx controls multiple users 
       access to documents in the same storage area (directory) 
       on TOPS-20.  DECdx also controls document access through 
       the DECdx index function to avoid document-access 
       collisions.

    oo  ON (Old-to-New) conversion option -- The ON option lets 
       users of DX/TOPS-20 V1.0 convert existing documents to 
       DECdx format.

    oo  R (Read) option -- The Read option on the DECdx Menu lets 
       the user display the contents of a document.

    oo  A (Add) option -- The Add option on the DECdx Menu 
       enhances document transfer on the host.  The user can now 
       add WPS documents to his/her own DECdx index from other 
       users on the host.

    oo  F (Finished) option -- The Finished option on the DECdx 
       Menu lets the user exit from DECdx to TOPS-20 command 
       level.

    oo  Traceback (TRACE) feature -- Some error messages direct 
       the user to the system manager for help.  The system 
       manager can use the Traceback feature for more information 
       on the error.  The Traceback feature is described under 
       Error Tracing in Chapter 2.

    oo  CORRECT -- A document may be unlocked by typing the word 
       CORRECT and the document name or number at the DECdx Main 
       Menu.  See the section, Unlocking Documents, in Chapter 2 
       for detailed information.





Functional Changes

Debugging -- DECdx is not supplied as source code, therefore 
DEBUG code is no longer necessary and is not included.


Simpler Interface -- The user does not have to invoke each 
function with a separate command.  The user invokes DECdx (if it 
is defined as a foreign command) with the command DDX and then 
selects the appropriate option from the DECdx Menu.  Most users 
are familiar with DIGITAL WPS menus and should feel comfortable 
using DECdx menus.



Command Line Parser -- DECdx parses command lines passed by 
TOPS-20.  Command line parsing:

    oo  Permits execution of a function from the operating system 
       level.  With DDX defined as a foreign command, the user 
       can specify commands as:

       @DDX <menu option> <parameter1> <parameter2><RETURN>

       For example:
        @DDX FD Q1.RPT First Quarter Results<RETURN>


    oo  Supports "type-ahead" similar to WPS.  User-typed 
       characters are buffered, so that DECdx executes the 
       commands as soon as processing allows.


Document Numbers -- The document numbers now range from 1 to 200, 
rather than from 2 to 999.  



Reserved Extension -- The reserved file extension for DECdx is 
.DX, as opposed to the .W11 extension under DX/TOPS-20.  The DF 
conversion function uses either a null file extension or a 
user-supplied file extension.



H (Help) option -- The Help option offers more extensive on-line 
assistance than was available through DX/TOPS-20.




Error Handling -- For failures within the product (DECdx) or the 
environment (TOPS-20), the DECdx user sees an error message.  By 
typing H and pressing RETURN, the user may read the on-line 
assistance for an explanation.

If the user goes directly to the on-line assistance, DECdx 
terminates the current process.  The user has to return to the 
DECdx Menu and reselect the option.

The system manager can use the Traceback feature for more 
information on errors.  The Traceback feature is described under 
Error Tracing in Chapter 2.




Conversion -- The DF (Document-to-File) and FD (File-to-Document) 
options on the DECdx Menu let the user convert documents from 
ASCII to WPS and WPS to ASCII formats.  These options simplify 
the earlier WFLX program available under DX/TOPS-20.

The FD and DF options have these characteristics:

    oo  Prompt for file name -- The user is always prompted for 
       and must supply the file name first, whether the 
       conversion is a document-to-file or file-to-document 
       conversion.

    oo  Text conversion default -- Under DF, the user is no longer 
       prompted for a file type.  DECdx assumes conversion to a 
       text file.  The user can no longer convert to a BASIC-PLUS 
       or source program file.  The DF conversion function uses 
       either a null file extension or whatever file extension 
       the user defines.

    oo  WPS-format similarity -- Under DX/TOPS-20, the user saw a 
       prompt to change the default ruler during FD conversion.  
       Now the host default ruler is inserted automatically into 
       the converted document without changing the appearance of 
       the original file.  

       Under DF, the prompt for designating tabs or spaces in the 
       converted file has been eliminated.




Index -- The DECdx index now resembles a WPS index.  The 
documents are displayed five at a time, instead of scrolling 
continuously.  The host directory now lists the DECdx index as 
INDEX.DX, rather than DOC001.W11.

The DECdx index is a RMS indexed file of formatted records.  The 
user cannot access the DECdx index as a document and should not 
edit INDEX.DX on the host.  However, the user can print the DECdx 
index by using the PHOTO utility.

The WDNX product used a version number of 0 to indicate a missing 
or delete-protected document.  The DECdx index has the message 
"This document can not be found in the current area" when the 
DECnnn.DX file has been deleted.  Delete-protected files are not 
indicated.  DECdx does not have Version Number or Time Elapsed 
columns in the index.





Delete -- The Delete option (which replaces the WDEL program) now 
closely resembles the WPS deletion procedure.  The user sees the 
first eight lines of the document to confirm the deletion.




Printing -- The Print option (which replaces the WLPT program) 
lets the user print the document without exiting to TOPS-20 and 
issuing the PRINT command.  The document prints immediately 
unless the user specifies PD No.  The new DECdx Print Menu allows 
the user to change settings in a manner similar to WPS, rather 
than in response to prompts, as under DX/TOPS-20.

Also, note these changes to the default print settings:

         Old Setting              New Setting

         EX 0                     DS No
         DD LP                    --
         --                       PD Yes
         --                       SL No

This value range has been changed:

         Old Range                New Range

         CP 1 to 999              CP 1 to 10

Under the Print option, DECdx creates a printable file, 
PRnnn.DAT, where "nnn" is the document number in the DECdx index.  
DECdx deletes the PRnnn.DAT file after the document is printed 
unless the user sets SL Yes.

The DX/TOPS-20 restriction of 60 printable lines per page no 
longer applies.
index


A

A (Add) option, 13
  CTRL/C exit, 8
Access by multiple users, 12
ASCII format conversion, 14
Audience, v


B

BASIC-PLUS, 14
Bottom option, 9
BTMnnn.DX
  renaming, 10


C

Command lines, 13
Compatibility
  document, 12
  host, 12 
Conventions, v
Converting documents
  DF (Document-to-File), 14
  FD (File-to-Document), 14 
  ON (Old-to-New), 12
CORRECT
  unlocking documents with, 9
CTRL/C
  locking documents with, 8
CX (Character Transfer)
  use of, 10


D

D (Delete) option, 14
DDX command, 13
DDXBLD command file, 3, 5
DDXINS.MEM, v
DEBUG code, 13
DECdx
  definition, 11
  document extension, 13
  DX/TOPS-20 comparisions, 12
  disk space requirements, 1
  errors, 14
  index, 14
  installation of, 3 to 5
  supercession, 12
DECdx User's Guide, 6
DF (Document-to-File), 14
  CTRL/C exit, 8
  definition, 14
  temporary files, 10
Differences between DECdx and
  DX/TOPS-20, 12
Disk quota
  exceeding, 10
DECdx requirements, 1
DOCnnn.DX
  file missing, 9
Document
  compatibility, 12
  numbers, 13
Document copying, 13
  (See also Add option)
Document transfer, 11
  between hosts, 12
  using Add option, 13
Documents
  converting DX/TOPS-20, 8
  deleting DX/TOPS-20, 8
  missing, 9, 14
  printing, 15
  unlocking, 8
  updating by multiple users, 12
DUMPER, 3 to 4
DX document extension, 13
DX protocol, 11
DX/TOPS-20                                                              
  converting documents, 12
  DECdx comparisions, 12


E

Easycom, 8
Error handling, 14
  (See also TRACE)
Error messages
  DECdx, 9
  RMS, 9
Errors
  DECdx, 14
  installation, 5
  TRACE command, 9
Exiting DECdx, 13


F

F (Finished option), 13
FD (File-to-Document), 14
  CTRL/C exit, 9
Files
  BTMnnn.DX, 10
  converting DX/TOPS-20, 8
  converting to ASCII format, 14
  converting to WPS format, 14
  DOCnnn.DX missing, 9
  expunging, 10
  partial converted, 10
  protection requirements, 7
  temporary, 9 
  TMPnnn.DX, 10
Functional changes, 13


G

Getting Started Card, 7


H

H (HELP) option, 7
Help files
  restoring, 4


I

Index
  DECdx, 14
  printing, 14
Installation
  deleting files after, 3
  errors during, 5
  file DDXINS.MEM, 1
  preparation for, 1 
  requirements, 1


L

Linking binary file, 4


M

Magnetic tape, 1
Multiple user software, 12


N

Numbering of documents, 13


O

ON (Old-to-New)
  converting documents with, 8
  CTRL/C exit, 8
On-line assistance, 7, 14
  (See also Help Files)
Order numbers
  DECdx media, 1
  documentation, v
OPR program
  exiting, 5
  starting, 2
Overwrite option, 9


P

P (Print option), 15
  locking documents with, 8
PD (Print Delay) option, 15
PHOTO utility, 14
Print settings
  new, 15
PRnnn.DAT file, 15
Protection
  files, 7
PUSH command, 2


R

R (Read) option, 13
  locking documents, 8
Release notes
  printing, 5
  restoring, 4
RESTORE command, 4
Restoring
  binary files, 4
  installation manual, 4
  release notes, 4
RMS (Record Mangement System)
  error messages, 9
RSTS/E compatibility, 12
RSX-11M and RSX-11M PLUS
  compatiblity, 12


S

SL (Save Listing) option, 15
Supersession, 12
System manager
  user support, 7 to 10


T

T-B-O
  exiting menu, 9
Tape drive
  allocation of, 2
  assigning, 3
  deassigning, 4
  mounting, 2
  release, 5
Temporary files
  creating, 9
  deleting, 10
  partial, 10
  renaming, 10
TMPnnn.DX
  renaming, 10
Top option, 9
TOPS-10 compatibility, 12
TOPS-20
  version number, 1
TRACE, 9, 
Traceback feature, 9
Transfer option
  CTRL/C exit, 9


U

UNLOAD command, 4
Unlocking documents, 8
User support
  continuing, 8
  initial, 7

V

VMS compatiblity, 12


W

WDEL, 14
WDNX (DX/TOPS-20 index), 7, 14
WLPT, 15

X

X (Document Transfer) option, 11