Steps for setting up the routing table

Before you begin

You must set up the OPERATOR virtual machine to run CMS (see Step for modifying the OPERATOR's directory entry).

You must log onto MAINT.

About this task

This procedure has you modify the routing table (PROP RTABLE) and add comparison entries for your Linux® virtual servers. A comparison entry is a line in the PROP RTABLE that matches a message sent to the programmable operator to an action, such as logging the message or sending the message to the logical operator. For instance, one comparison entry is designed to send a message to the logical operator if a Linux system abnormally terminates. For more information about the statements in the PROP RTABLE, including comparison entries, see The Routing Table in z/VM: CMS Planning and Administration.

Through this task, the PROP RTABLE you create is used in common by all OPERATOR virtual machines in the SSI cluster. The task creates a single 692 disk (on which the PROP RTABLE resides) used by all instances of the OPERATOR mulitconfiguration virtual machine. Therefore, the PROP RTABLE is common to all OPERATOR instances.

Use this procedure as a model by which to automate other actions for your Linux virtual servers.

Rules: When editing the routing table, you must:

Keep entries in their proper columns.
Right-justify numbers in their columns.

Procedure

Type the following command and press the Enter key:

dirm for operator amdisk 692 devtype autog 1 grplnx label rr label
DVHXMT1191I Your AMDISK request has been sent for processing.               
Ready;                                                                      
 DVHREQ2288I Your AMDISK request for OPERATOR at * has been accepted.        
 DVHSCU3541I Work unit 18124944 has been built and queued for processing.   
 DVHSHN3541I Processing work unit 18124944 as MAINT from ZVMLINUX,          
 DVHSHN3541I notifying MAINT at ZVMLINUX, request 62 for OPERATOR sysaffin   
 DVHSHN3541I *; to: AMDISK 0692 devtype AUTOG 1 GRPLNX       
 DVHBIU3450I The source for directory entry OPERATOR has been updated.       
 DVHDRC3428I Changes made to directory entry OPERATOR have just been         
 DVHDRC3428I placed online.                                                 
 DVHSHN3430I AMDISK operation for OPERATOR address 0692 has finished (WUCF   
 DVHSHN3430I 18124944).                                                     
 DVHREQ2289I Your AMDISK request for OPERATOR at * has completed; with       
 DVHREQ2289I RC = 0.

where devtype is the disk device type of the volume (for instance, 3390) and label is the disk label.

Link to the new OPERATOR 692 disk and access it.
Type the following commands and press the Enter key after each one:
```
link operator 692 nnnn mw
Ready;
acc  nnnn m
Ready;
```
where nnnn is an unused minidisk address.
Example:
```
link operator 692 692 mw
Ready;
acc 692 m
Ready;
```
Copy the sample routing table (PROP RTABLE) file from the CMS 190 minidisk to the newly linked disk (for example, the 692 disk).
Because the PROP RTABLE file is mode 5 (hidden), you must access the 190 disk as C/A to copy the file. Type these commands and press the Enter key after each one:
```
access 190 c/a
DMSACP723I C (190) R/O       
DMSACP725I 190 also = S disk 
Ready;
copyfile prop rtable c = = m1
Ready;
rel c
Ready;
```
Edit PROP RTABLE M1.
Type this command and press the Enter key:
```
xedit prop rtable m
```
1. To assure that your typing is always uppercase, from the XEDIT command line, type this command and press the Enter key:
```
====> set case u
```
2. Set line numbers on. From the XEDIT command line, type this command and press the Enter key:
```
====> set num on
```

Locate the LGLOPR statement.

Replace OPERATOR with LGLOPR.
Remove the string HOSTNODE.

Result:

00001 *        ----- SPECIFY THE PROP CONFIGURATION ----- 
00002                                                     
00003 * IDENTIFY THE LOGICAL OPERATOR                     
00004                                                     
00005 LGLOPR LGLOPR

Delete these lines (26 to 31).

Use the block delete (dd) prefix commands in the prefix area:

dd    /LOGON                     21  26  3 
00027 /LOGOFF$¬FORCED            21  80  3 
00028 /DISCONNECT                21  31  3 
00029 /RECONNECT                 21  30  3 
00030 /DIAL                      21  25  3 
dd    /DROP                      21  25  3

Delete all lines with PROPNODE and NCCF in them.
From the XEDIT command line, type these commands and press the Enter key after each one:
```
====> all/propnode
```
```
====> delete *
```
```
====> all/NCCF
```
```
====> delete *
```
```
====> all
```
Save the file.
From the XEDIT command line, type this command and press the Enter key:
```
====> save
```
Move the current line to the line before SEND ALL OTHER TRAPPED DATA TO THE LOGICAL OPERATOR.
From the XEDIT command line, type these commands and press the Enter key after each one:
```
====> bot
```
```
====> u4
```
```
====> set case mixed
```
SET CASE MIXED instructs XEDIT to keep characters you enter in mixed case.
```
====> input
```

Add these lines.

Remember to keep entries in their proper columns and keep characters in mixed case as shown.

Note: These lines filter many messages. Over time, you might want to remove some if you find you do not use them or want to handle certain messages in other ways, such as logging them.

*------------------------ --- --- -- -------- -------- -------- -------- 
* NOTIFY LOGICAL OPERATOR IF LINUX ABENDS                                
*------------------------ --- --- -- -------- -------- -------- -------- 
/OOPS/                             8                   DMSPOS   LGLOPR   
$DISABLED                          8                   DMSPOS   LGLOPR  
$PSW$                              8                   DMSPOS   LGLOPR  
$psw$                              8                   DMSPOS   LGLOPR  
$disconnected/                     8                   DMSPOS   LGLOPR  
/HCP$                              8                   DMSPOS   LGLOPR  
$FAILURE/                          8                   DMSPOS   LGLOPR  
$failed/                           8                   DMSPOS   LGLOPR  
$Failed/                           8                   DMSPOS   LGLOPR  
$No such/                          8                   DMSPOS   LGLOPR  
$ERROR/                            8                   DMSPOS   LGLOPR  
$error/                            8                   DMSPOS   LGLOPR  
$_MACHINE$                         8                   DMSPOS   LGLOPR  
$cannot open/                      8                   DMSPOS   LGLOPR  
*------------------------ --- --- -- -------- -------- -------- -------- 
* DON'T WORRY ABOUT ANY OTHER SCIF OUTPUT FROM MONITORED USERS           
*------------------------ --- --- -- -------- -------- -------- -------- 
                                   8                                     
*------------------------ --- --- -- -------- -------- -------- --------

Save the PROP RTABLE file.
From the XEDIT command line, type this command and press the Enter key:
```
====> file
```
Release and detach the MAINT's linked disk.
Type the following command and press the Enter key:
```
rel m (det
```

What to do next

Go on to the next procedure.