Remote Directory Maintenance

The Remote Directory Maintenance function is used to maintain a remote directory in order to connect the client's calling program to a subprogram on a server.

For further information on how to apply the Remote Directory Maintenance function, refer to Specifying RPC Server Addresses (Operating a Natural RPC Environment), Using a Remote Directory Server (RDS) and Natural RPC Terminology described in the Natural Remote Procedure Call (RPC) documentation.

This section covers the following topics:


Using Remote Directory Maintenance

Warning:
If you create a new remote directory by entering code C (see the instructions below), the entries of an existing directory will be overwritten.

Start of instruction set To use the Remote Directory Maintenance function

  1. In the Code field of the Client Maintenance menu, enter the following command:

    RD
  2. Choose ENTER.

    A window appears.

  3. In the input field, enter either of the following commands:

    C

    to create a directory or

    M

    to modify a directory.

  4. Choose ENTER.

    An additional window appears.

  5. Enter an expiration time in seconds (see also Expiration Time below) and choose ENTER.

    An editor screen similar to the example below appears:

      -----------------------------             S 01- ---------------Columns 001 072
       ====>                                                       SCROLL===>  CSR
      ****** NODE      L T    SERVER    L T    LIBRARY   L T    PROGRAM   L T
      ****** ****************************** top of data *****************************
      000001 ETB01     Y B    NRPC2301         SYSTEM           SUB1
      000002                                                    SUB2
      000003                  NRCP2301         SYSTEM           SUB3
      000004                  NRPC2302         SYSTEM           SUB4
      000005                                                    SUB5
      000006                                                    SUB6
      000007 ETB01            NRPC2301  Y      SYSTEM           SUB7
      000008                                                    SUB1      Y
      000009                                                    SUB2
      000010                  NRCP2301         SYSTEM           SUB3
      000011                  NRPC2302         SYSTEM           SUB4
      000012                                                    SUB5
      000013 ETB01     Y      NRPC2301         SYSTEM           SUB6
      000014                                                    SUB1      Y
      000015                                                    SUB2
    
      000016 ETB01     Y      NRPC2301         SYSTEM           SUB3
      Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
            Help        Quit  Save  Find  Chng  Up    Down                    Canc
    

Expiration Time

The remote directory data is loaded at runtime. The expiration time in seconds determines the period of validity of this data. If directory data is requested after the expiration time set, it will automatically be reloaded. If expiration time is set to 0, the remote directory data will not be reloaded.

Note:
If you create a new directory (code C), you invoke an input line by entering the line command I at the beginning of the line top of data. See also Line Commands below.

Fields on the Editor Screen of a Remote Directory

The fields contained in the editor screen of Remote Directory Service maintenance are identical to the fields described in Fields on the Service Directory Screen in the section Service Directory Maintenance. The field L is the equivalent to the field Logon.

In addition to the fields provided on the Service Directory Maintenance screen, the field T (Transport) appears: enter a B for EntireX Broker.

Commands for Remote Directory Maintenance

This section contains information on the commands provided on the editor screen of Remote Directory Service maintenance.

Line Commands

The line commands available on the editor screen can be used to copy, move or delete single or multiple lines that contain field values.

Enter a line command at the beginning of a line, that is, overwrite the sequential number and choose ENTER.

See also To copy or move a block of lines and the direct command RESET.

Line Command Function
A Copies or moves the line(s) marked with C, CC, M or MM below the line in which the command was entered.
B Copies or moves the line(s) marked with C, CC, M or MM above the line in which the command was entered.
C Marks the single line to be copied.
CC Marks the block of lines to be copied.
D(n) Deletes one or n lines beginning with the line in which the command was entered. n can be in the range from 1 to 9.
DD Marks and deletes a block of lines.

Mark the block of lines by entering the command in the first and last line of the block, and choose ENTER to execute the command.

I(n) Inserts one or n empty lines below the line in which the command was entered. n can be in the range from 1 to 9.
M Moves a single line below the line in which the command was entered.
MM Marks the block of lines to be moved.

Start of instruction set To copy or move a block of lines

  1. At the beginning of the line where the block starts, enter either of the following line commands:

    CC

    to copy the block or

    MM

    to move the block.

  2. At the beginning of the line where the block ends, enter either of the following line commands:

    CC

    to copy the block or

    MM

    to move the block.

  3. Choose ENTER.

    The block of lines is marked which is indicated by the message: Block is pending.

  4. At the beginning of the line below or above which you want to place the block, enter either of the following line commands:

    A

    to copy or move the block below the specified line or

    B

    to copy or move the block above the specified line.

  5. Choose ENTER.

    The block of lines is copied or moved below or above the specified line.

Direct Commands and PF Keys

The following direct commands and PF keys are provided on the editor screen:

Direct Command PF Key Function
RESET   Removes the line marks set with a line command (see Line Commands) or with the direct command CHANGE (see below).
TOP   Scrolls to the beginning of the list.
BOT   Scrolls to the end of the list.
FIND string   Scans the editor for a string of characters, for example:  FIND ETB1

Choose PF5 (Find) to scan for the next occurrence.

CHANGE string1 string2   Replaces character string1 by string2, for example: CHANGE ETB1 ETB2.

Choose PF6 (Chng) to replace the next occurrence.

  PF1 Help. Invokes the online help.
  PF3 Quit. Saves any modifications and exits the editor screen.
  PF4 Saves any modifications.
  PF5 Find. Scans for the next occurrence of the character string specified with the direct command FIND (see above).
  PF6 Change. Replaces the next occurrence of the character string specified with the direct command CHANGE (see above).
  PF7 Up. Scrolls one page backward.
  PF8 Down. Scrolls one page forward.
  PF12 Cancel. Exits the editor screen without saving modifications.