Google
 

Trailing-Edge - PDP-10 Archives - BB-W661B-BM_1984 - tools/x29trp.mem
There is 1 other file named x29trp.mem in the archive. Click here to see a list.



                             TOPS-20 PSI
                       X.29 Incoming Call Trap



                            February, 1984





                        Copyright (C) 1983 by
                    Digital Equipment Corporation,
                     Maynard, Massachusetts 01754


THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND  COPIED
ONLY  IN  ACCORDANCE  WITH  THE  TERMS  OF  SUCH  LICENSE AND WITH THE
INCLUSION OF THE ABOVE COPYRIGHT NOTICE.  THIS SOFTWARE OR  ANY  OTHER
COPIES  THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
OTHER PERSON.  NO TITLE TO AND OWNERSHIP OF  THE  SOFTWARE  IS  HEREBY
TRANSFERRED.

THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY DIGITAL EQUIPMENT
CORPORATION.

DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
TOPS-20 PSI X.29 Incoming Call Trap                             Page 2
INTRODUCTION                                                 27 Feb 84


1.0  INTRODUCTION

This document describes the procedures for building  and  running  the
program  X29TRP.  This is an unsupported tool that provides a facility
to trap and reject unwanted X.29 incoming calls.



2.0  INSTALLATION INFORMATION

2.1  Inventory

The program is supplied as source files in the PS:<TOOLS>  saveset  of
the TOPS-20 PSI Version 1.1 distribution tape.  The files are:

      o  X29TRP.BNF
      o  X29TRP.CTL
      o  X29TRP.MAC
      o  X29TRP.MEM
      o  X29TRP.RNO



2.2  Utilities

You need the following software utilities to build the software

      o  MACRO-20 Assembler
      o  CREF Macro Cross Reference program
      o  COMGEN (included in the TOPS-20 PSI tape)



2.3  Assembling And Linking

Submit the file X29TRP.CTL to assemble the MACRO source  file  and  to
build the executable image file.

     $SUBMIT X29TRP.CTL <RET>



2.4  Network Management Information

Edit the grammar file X29TRP.BNF which contains the  template  of  the
NCP  commands.   Supply  the appropriate values of your DECnet network
configuration for the first three parameters:

     <GATEWAY NODE NAME>
     <DECSYSTEM-20 NODE NAME>
     <DECSYSTEM-20 NODE NUMBER>

Run the COMGEN program to produce  the  command  file  which  will  be
processed  by  NCP to set up the Network Management information in the
TOPS-20 PSI gateway node
TOPS-20 PSI X.29 Incoming Call Trap                             Page 3
INSTALLATION INFORMATION                                     27 Feb 84


     $COMGEN <RET>
     *SYSTEM:X29TRP.CMD=X29TRP <RET>
     [Grammar produced 12 products]
     EXIT
     $

Edit the command file X29TRP.CMD to  add  any  appropriate  X25-SERVER
parameters that you wish to use to invalidate the X.29 incoming calls.
See the DECnet-20 System Manager's Guide for  more  information  about
the module X25-SERVER parameters.



3.0  USAGE

3.1  Installing X29TRP

Edit the following commands into the PTYCON.ATO file:

     ^X
     DEFINE ^$TRAP
     CONNECT TRAP
     LOGIN OPERATOR
     ENABLE
     OPR
     TAKE SYSTEM:X29TRP.CMD
     X29TRP

If you choose to create an entry  for  the  destination  TRAP  in  the
module  X25-SERVER  data base at network generation time, you may omit
the command file X29TRP.CMD.

The next time you boot the system, the trap (program X29TRP) is set up
to intercept unwanted X.29 incoming calls.



3.2  Reject Notice

You may choose to inform the user the  reason  the  incoming  call  is
rejected.   The  text  of  the  notice  should  be  stored in the file
SYSTEM:X29REJ.TXT.  The text may be of any length.

If the file SYSTEM:X29REJ.TXT exists, the incoming call  is  accepted,
the text is sent to the terminal and the circuit is cleared.  Thus the
user will be able to view the entire notice, yet unable  to  log  into
the host system.

Otherwise, the incoming call is cleared immediately.