Remote Directory Maintenance

#### Search Results

Search

# 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

- Fields on the Editor Screen of a Remote Directory

- Commands for Remote Directory Maintenance

## 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.

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

- Direct Commands and PF Keys

### 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.

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.

### On this page

- Using Remote Directory Maintenance
- Fields on the Editor Screen of a Remote Directory
- Commands for Remote Directory Maintenance