1 ACCESS

    The ACCESS command is used to display the full expanded
    entry for a given master number.  The ACCESS command takes a
    single parameter, the master number of the entry to be displayed.
    If the master number is not specified, it will be prompted for.

1 BUILD

    The BUILD command is used to build a MAIL distribution file.
    Each time the BUILD command is used it adds the entry indicated
    to the file.  You must do a LOOKUP command prior to using the
    BUILD command.

    The BUILD command takes a single parameter, the entry number.
    This is the number that was printed on the left of the desired
    directory entry in the LOOKUP command.  If you do not specify
    an entry number, it will be prompted for.

    If the LOOKUP display has scrolled off the screen, you can redisplay
    it with the LOOKUP/LAST command.

    The /FILE qualifier is used to indicate the name of the file
    to be created.  If no file name is given, the file will be named
    DOWDIR.DIS.  If the /FILE qualifier  or /NEW qualifier is given
    the current file will be closed and a new one opened.

2 Entry_no

    The ENTRY_NO is the entry number that was printed to the left of the
    directory entry in the LOOKUP command.  It is specified to indicate
    which entry to expand and display. 

2 Qualifiers

/FILE

    /FILE = file_spec

    The /FILE qualifier is used to specify the name of the distribution
    file to write to.  If there is a file currently open, it is closed
    and the new file is opened.  Subsequent BUILD commands will write
    to the new file until either the /FILE or /NEW qualifier is
    specified.

/NEW

    /NEW

    The /NEW qualifier causes the current distribution list file
    to be closed and a new one opened.  If the /FILE qualifier is
    also specified, the new file will be named with the value of
    the qualifier.  If the /FILE qualifier is not given, the new
    file will be named DOWDIR.DIS.

1 DELETE

    The DELETE command is used to remove a directory entry from the
    DOWDIR database.

    The DELETE command always displays the expanded directory entry
    and then asks the user if this is indeed the entry to be deleted.

2 Master_no

    The DELETE command takes a single parameter, the master number
    for the entry that is to be deleted.  If the MASTER_NO is not
    specified, it will be prompted for.

1 EXIT

    The EXIT command exits the DOWDIR program.  A ^Z at the function
    prompt will also exit DOWDIR.

1 FULL

    The FULL command is used to display a fully expanded directory
    entry.  You must do a LOOKUP command prior to doing a FULL command.

    The FULL command takes a single parameter, the entry number. This is
    the number that was printed on the left of the desired directory
    entry in the LOOKUP command.  If you do not specify an entry number,
    it will be prompted for. 

    If the LOOKUP display has scrolled off the screen, you can redisplay
    it with the LOOKUP/LAST command. 

2 Entry_no

    The ENTRY_NO is the entry number that was printed to the left of the
    directory entry in the LOOKUP command.  It is specified to indicate
    which entry to expand and display. 

1 HELP

    DOWDIR is a DOW world-wide MAIL/PHONE directory.  You can use it to
    look up Electronic Mail adresses, phone numbers and other
    information about employees all over the DOW DECnet network. If the
    person you are looking for isn't in DOWDIR, please encourage them to
    add themselves with the UPDATE function. 

    The HELP command displays HELP from the DOWDIR help library. The
    HELP library not only contains explainations of the DOWDIR commands,
    but it also contains the latest release notes, changes and examples.

2 Topic

    Topic

    You can specify a HELP topic to be displayed.  Topics are specified
    just like the DCL HELP command.  For example:

        HELP LOOKUP /LAST

    would display the help on the /LAST qualifier of the LOOKUP command.

2 Qualifiers

/PROMPT

    /PROMPT
    /NOPROMPT

    Normally the HELP command prompts you for new topics and subtopics.
    You can specify /NOPROMPT to have the HELP command return to
    the command level directly after displaying the requested help.


1 LOOKUP

    The LOOKUP command searches the database for users which match a
    given name and/or location.  A brief, one line description of each
    entry found is displayed. 

    The LOOKUP/LAST command redisplays the previous collection of
    entries without searching the database again.  This is handy when
    using the FULL command to expand an entry. The FULL command is used
    to display all the information for a single entry. 

    In the NON-EXPERT mode, all 3 parts of the name will prompted for.
    In the EXPERT mode, name parts which are not specified in the
    command line will not be prompted for.  In either mode, you must use
    the /LOCATION qualifier to specify a location search string. 

2 Examples

    The simplest form of the LOOKUP command is the just "L":

    	Please select a function: L

    The last name can be entered as part of the command:

        Please select a function: L  SMITH

        DOWDIR> L JO

    Add /LAST to redisplay the results of the previous LOOKUP function:

        Please select a function: L/LAST

    Use /LOCATION to specify a location string (which can include
    wildcards, "*" and "%"):

        DOWDIR> L/loc=PL*  JONES


2 Last_name

    The LOOKUP command take one parameter, the last name string to be
    searched for.  This parameter is required for both the EXPERT and
    NON-EXPERT modes.  If it is not specified on the command line, then
    it will be prompted for. 

    The full last name need not be specified.  If only part of the name
    is specified, all entries which match the specified part will be
    displayed. 


2 Qualifiers

/FIRST_NAME

    /FIRST_NAME [ = string ]

    The /FIRST_NAME qualfier can be used to specify a string to match
    first names against.  If a FIRST_NAME is specified, only entries
    which match the given string are displayed. 

    If the /FIRST_NAME qualfier is given, but no value is specified,
    then DOWDIR will prompt you for the search string. 


/INITIALS

    /INITIALS [ = string ]

    The /INITIALS qualfier can be used to specify a string to match the
    first two initials of an entry.  If INITIALS are specified, only
    entries which match the given string are displayed. 

    If the /INITIALS qualifier is given, but no value is specified, then
    DOWDIR will prompt you for the search string. 

/LOCATION

    /LOCATION [ = string ]

    The /LOCATION qualifier can be used to specify a string to match
    against the location field in entries.  If LOCATION is specified,
    only entries which match the given string are displayed. 

    Unlike the parts of the name, the location string can contain the
    wild card characters "*" and "%".  If no wild cards are present,
    then the match is done the same way that name part matches are done.

    In both the EXPERT and NON-EXPERT modes, the /LOCATION qualifier
    must be specified in the command line if location matches are to be
    done.  If the qualifier is given, but no value is specified, then
    DOWDIR will prompt the user for the search string. 

/LAST

    /LAST

    The /LAST qualifier lets you redisplay the results from the last
    LOOKUP.  You can not specify any other qualifiers or a last name in
    a LOOKUP/LAST command. 

    The /LAST qualifier exists so that you can see the entry numbers
    that you need for the FULL command after they have scrolled of the
    screen.

1 New_v2.1_features

    Three new commands are introduced with v2.1 of DOWDIR.  These
    new commands allow users to create a MAIL distribution list,
    display an entry by master number and display the active DOWDIR
    servers.  In addition, a minor change in the FULL command has
    been made for the special case where the previous LOOKUP
    command found only one entry.

2 Access_command

    The new ACCESS command is used to display a full, expanded entry
    given only the master number.  The entry is displayed in the
    same format used by the FULL command.

2 Build_command

    The new BUILD command is used to create a MAIL distribution list
    from the data in DOWDIR.  Like the FULL command, the BUILD command
    requires the entry number of the DOWDIR entry to be added to
    the distribution list.  One entry is written to the list file
    for every BUILD command.

    The /FILE and /NEW qualifiers are used with the BUILD command
    to specify the name of the distribution file to be created and
    to force the current file to be closed and a new one opened.

2 Full_command

    A minor change has been made in the FULL command.  If the previous
    LOOKUP command found one and only one entry, the FULL command
    will not prompt for an entry number.  It will simply display
    the single entry that was found.
    
    However, if an entry number is specified in this particular case,
    it MUST be 1.  Otherwise, the "Illegal entry number" message
    will be displayed.

2 Show_command

    The new SHOW command is used to display the node names and object
    numbers of the currently active DOWDIR servers.  This command
    can be used by system managers to keep their definition of
    DOWDIR_SERVERS up to date.

1 New_v2.0_features

    A number of new features are introduced with V2.0 of DOWDIR.
    Most of these features are the result of suggestions made by
    DOWDIR users from all over the DOW DECnet network.

2 Expert_mode

    DOWDIR is now invoked as a VMS foreign command.  If the /EXPERT
    qualifier is present in the command line that invokes DOWDIR, then
    the EXPERT mode is entered.  Otherwise, the NON-EXPERT mode is used.

    The NON-EXPERT mode is very simular to DOWDIR v1.0.  The user is
    prompted with self explanitory text at every step.  The parameters
    and qualifiers normally used in the EXPERT mode can be used in the
    NON-EXPERT mode as well.  However, missing parameters and qualifiers
    will always be prompted for. 

    The EXPERT mode is a more DCL like interface.  Commands look like
    normal DCL commands, with parameters and qualifiers.  Prompting is
    cut to a minimum. 

2 Control_Z

    The ^Z key no longer aborts the DOWDIR utility.  If entered at the
    main command prompt, it acts like an EXIT command.  If entered at a
    prompt inside of a function (like UPDATE), it simply exits the
    function and returns to the main command prompt.

2 Update_changes

    The UPDATE command now redisplays the updated entry if successful.
    This is done so the the user can confirm that the expected changes
    were indeed made.

    The updated entry that is displayed is actually returned from the
    database server.  There is no need to do a LOOKUP/FULL command to
    confirm that the update was made.

    Note that the database server does reformat some fields. Specificly,
    the first name, last name, initials and location fields are upper
    cased.  The master number is zero filled to 6 digits and the phone
    number is reduced to only digits and hyphens. 

2 Delete_changes

    The DELETE command now displays the full, expanded entry and asks
    the user to confirm that it is indeed the entry to be deleted. If
    you respond with anything other than "Y", the record will not be
    deleted.

2 Lookup_changes

    The LOOKUP command now displays only the name, mail address and
    phone number of any entries which match the selection fields given.
    This allows up to 22 entries to be displayed on a single screen and
    should handle most user requests.

    To display a fully expanded entry, use the new FULL command. The
    entry number required by the FULL command is the number that
    appeared to the left of the last LOOKUP display. 

    If the desired entries of the last LOOKUP display have rolled off
    the screen, they can be redisplayed by using the LOOKUP/LAST
    command.

1 Release_notes

    There are no currently known bugs or restrictions.

    This is version v2.1 of the DOWDIR PAD for VMS.  Please report all 
    bugs and other problems to Bob Graham at LARND1::GRAHAM.  When
    reporting bugs, please indicate whether the EXPERT or NON-EXPERT 
    mode is being used. 

1 SHOW

    The SHOW command displays the node names and object numbers of
    currently active DOWDIR servers.  It is intended as an aid to
    system managers so that they can keep their definitions of
    DOWDIR_SERVERS up to date. 

    NOTE:  In future versions of DOWDIR, the show command may take on
    other functions.  In that case, a parameter will be required to
    indicate what is to be shown.  The current function will then be
    performed by the SHOW SERVERS command. 

1 UPDATE

    The UPDATE command allows you to modify an entry in the DOWDIR
    database.  If an entry doesn't already exist, it will be created. 

    In the NON-EXPERT mode, the user will be prompted for each field in
    an directory entry.  In the EXPERT mode, prompting is only done if
    the master number wasn't specified in the command line. 

    If a new entry would be created, the user will be asked to confirm
    that the new entry is to be created.  The /NEW prompt can be used to
    avoid this prompt. 

    After the entry has been successfully updated, the full, updated
    entry from the database is display.  Note that the database server
    does reformat some fields.  In particular, the name and location
    fields are uppercased.  The master number is zero filled, and the
    phone number is reduced to digits and hyphens. 

2 Master_no

    The UPDATE command takes a single parameter, the master number of
    the entry to be updated.  If the master number is not specified in
    the command line, then it will be prompted for.

2 Examples

    The simplest form of the UPDATE command is just U:

        Please select a function: U

    You can also specify the master number of the entry to updated:

        Please select a function: U 123456

    In the EXPERT mode, use the qualifiers to specify the fields
    to be updated:

        DOWDIR> U 123456/COMMENT="vacation until August"


2 Qualifiers

/LAST_NAME

    /LAST_NAME=string

    The /LAST_NAME qualifier is used to specify the new value for
    the last name.

/FIRST_NAME

    /FIRST_NAME=string

    The /FIRST_NAME qualifier is used to specifiy the new value for
    the first name.

/INITIALS

    /INITIALS=string

    The /INITIALS qualifier is used to specify the new value for
    the first two initials of the persons name.  Note that this is
    not just the middle initial.

/MAIL_ADDRESS

    /MAIL_ADDRESS=string

    The /MAIL_ADDRESS qualifier is used to specify the new value for the
    users' electronic mail address.  This is the address at which they
    receive VAX MAIL, DEC MAIL, etc.  Note, the mail address should
    include both the node name and the username. 

    An example mail address is:    LARND1::GRAHAM


/PHONE

    /PHONE=string

    The /PHONE qualifier is used to specify the new value for the users'
    phone number.  The phone number will be reduced to digits and
    hyphens.  No other characters are allowed.

/BUILDING

    /BUILDING=string

    The /BUILDING qualifier is used to specify the new value for
    the users' office address.  Normally this would be a building
    number, like 2503.  It could also be text, like APB.

/LOCATION

    /LOCATION=string

    The /LOCATION qualifier is used to specify the new value for the
    users' DOW location.  Normally this is the city name followed by the
    state of country.  For example: 

    	PLAQUEMINE, LA
    	SARNIA, CANADA

    are two typical location strings.  If the string contains blanks,
    tabs or other special characters, enclose it in double quotes.  Do
    NOT use double quotes if the field is prompted for. 

/DEPARTMENT

    /DEPARTMENT=string

    The /DEPARTMENT qualifier is used to specify the new value for the
    users department.  If the string contains blanks, tabs or other
    special characters, it must be enclosed in double quotes. Do NOT use
    double quotes if the field is prompted for. 

/COMMENT

    /COMMENT=string

    The /COMMENT qualifier is used to specify the new value for the
    comment field for the user.  This can be used for anything you wish.
    A typical use for the comment field would be to indicate long
    vacations, ex: 

	/COMMENT="vacation until 1-Apr-1986"

    Note: if the string contains spaces, tabs of other special
    characters, it must be enclosed in double quotes.  The double quotes
    are ONLY needed when specifying the value of a qualifier.  They are
    NOT needed if the field is prompted for. 

/NEW

    /NEW

    The /NEW qualifier is used to avoid having DOWDIR ask you to confirm
    that you want to add a new user.  This can be helpful when running
    DOWDIR from a command file. 

