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

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.

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.