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:
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
In the Code field of the Client Maintenance menu, enter the following command:
RD
Choose ENTER.
A window appears.
In the input field, enter either of the following commands:
C
to create a directory or
M
to modify a directory.
Choose ENTER.
An additional window appears.
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 |
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.
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.
This section contains information on the commands provided on the editor screen of Remote Directory Service maintenance.
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
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.
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.
Choose ENTER.
The block of lines is marked which is indicated by the message:
Block is pending.
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.
Choose ENTER.
The block of lines is copied or moved below or above the specified line.
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. |