Network Working Group                                          J. Winett
Request for Comments: 452                                            JMW
NIC: 14136                                               8 February 1973


                       TELNET Command at Host LL

   The attached writeup documents the use of the TELNET command at Host
   LL for uses under the CP/CMS time-sharing system.  This command
   provides for use in a HALF DUPLEX or FULL DUPLEX mode and can be used
   with ASCII codes or with EBCDIC codes (i.e., transparent mode).  The
   keyboard conventions allow for entering all ASCII codes using a
   CONTROL character followed by another character for the codes not
   present on an IBM 2741 terminal.  In addition a number of local
   TELNET control commands have been defined which allows the mode of
   operation to be changed, the redefinition of special characters, the
   sending of TELNET control codes, as well as for obtaining input from
   a file instead of from the terminal.  These later features provide
   for a rudimentary file transfer facility.

   This material has not been reviewed for public release and is
   intended only for use with the ARPA network.  It should not be quoted
   or cited in any publication not related to the ARPA network.

   TELNET

   Purpose:

      To access another terminal oriented system on the ARPA network.

   Format:

      TELNET host <tag> RESUME     EBCDIC      HALFDUP
                    1    OPEN       ASCII      FULLDUP

      host - either the hexadecimal code for a foreign network service
              site or a standard mnemonic for a foreign site.  See
              Figure 1.

      tag - the identifier for the local connections to the network.
              The tag is used together with the address of the virtual
              machine descriptor table (UTABLE) to form local socket
              numbers which are used in the network protocol.

      RESUME - used to reactivate communications with a foreign site
              after having previously left the TELNET command leaving
              the connections open.




Winett                                                          [Page 1]


RFC 452                TELNET Command at Host LL           February 1973


      EBCDIC - to communicate with EBCDIC codes.  The default is network
              ASCII.

      HALFDUP - to operate under a half duplex protocol, i.e. with a
              locked keyboard.

              The EBCDIC HALFDUP the protocol assumes that the TELNET
              break code (circle C) will be received to indicate when
              the keyboard should be locked for input.

              In ASCII HALFDUP the keyboard will lock after a line of
              input and will unlock after one or more lines have been
              received for output.  An external interrupt will also
              unlock a locked keyboard.

              The default is full duplex where the keyboard is always
              unlocked for input.  A null line is required to
              temporarily lock the keyboard in order to receive output.

   Usage:

      A number of hosts on the ARPA network provide TELNET service.  A
      Network Virtual Terminal (NVT) has been specified so that using
      sites can write one TELNET program which maps a local terminal
      into the NVT to access any serving site on the network.  Once
      communication has been established between a using site and a
      serving site, keyed input is sent to the serving system and output
      from the serving site, when received, is typed on the local
      terminal.

      The NVT protocol requires that the keyboard be capable of entering
      all of the 128 ASCII codes together with a number of the TELNET
      control codes.  To support an NVT with an IBM 2741 terminal, it is
      necessary to adapt a control convention for entering codes which
      are not associated with single keys on the keyboard.  In addition,
      since CP/CMS processes input from a 2741 on a line at a time
      terminated with a newline, a means must be establish for entering
      a sequence of characters for transmission which is not terminated
      with a newline code.

      When TELNET is initiated the message

                           ENTER CONTROL CHARACTER

      is typed.  A non-blank character should then be entered which
      defines the character which, in combination with another
      character, will be used to enter codes not associated with single




Winett                                                          [Page 2]


RFC 452                TELNET Command at Host LL           February 1973


      keys.  The control character is also used for other special
      control functions as described below.

   Codes:

      The NVT usually requires that characters be transmitted in an
      eight bit ASCII code.  Since the TELNET command is written to
      process EBCDIC codes ASCII codes received are translated into
      ASCII before being sent to a serving site.  Figure 2 gives the
      complete definition of EBCDIC indicating the EBCDIC controls and
      EBCDIC graphics.  Figure 3 gives the codes for the ASCII controls
      and graphics.  The complete mapping between 8-bit EBCDIC codes and
      8-bit network ASCII codes is shown in Figure 4.  The EBCDIC
      newline code (NL) is mapped into the ASCII codes for the pair of
      characters CR-IF.

      The following ASCII/EBCDIC mapping is used for the non-EBCDIC
      graphics:

                        ASCII   EBCDIC

                   TILDE (7E) = (A1) NOT
                     BAR (7C) = (6A) OR
              BACK SLASH (5C) = (EO)
                   CARAT (5E) = (71)
                   GRAVE (6O) = (79)
              LEFT BRACE (7B) = (8B)
             RIGHT BRACE (7D) = (9B)
            LEFT BRACKET (5B) = (AD)
           RIGHT BRACKET (5D) = (BD)

      The ASCII control DC3 (X' 13') maps to the EBCDIC control TM
      (X'13').  The ASCII control NUL (X' oo') is sent to the terminal
      as the EBCDIC code for NULL (X' oo') and is not mapped into an
      IDLE (X'17').

      The TELNET control hide-your-input is mapped into the EBCDIC code
      for bypass (print suppress) and the TELNET control noecho is
      mapped into the EBCDIC code for restore (print restore).  If the
      TELNET control for echo is received, a message is printed and it
      is mapped into an IDLE.  Similarly, if the TELNET control for
      break is received, a message is printed and it is mapped into an
      IDLE unless operation is in EBCDIC HALFDUP mode in which case the
      break is used to indicate that any received characters should be
      printed and the keyboard unlocked for input.  If a data mark or an
      interrupt is received, no action is taken except to print a
      message to notify the user of this occurrence.




Winett                                                          [Page 3]


RFC 452                TELNET Command at Host LL           February 1973


   Input:

      When the control character is entered, the following character is
      mapped into a different code than that which it is normally mapped
      into, except when the following character is a space or a
      character not defined to have a meaning when preceded by the
      control character.  Figure 5 gives the mapping of the characters
      on a 2741 keyboard when preceded by a control character.  The
      following 2741 keyboard characters do not have a different meaning
      when preceded by the control character.

      $ # * % &
      + - = _
      . , : ;
      ! | ? (cent sign)
      SPACE
      BACKSPACE
      TAB

      When a character is mapped into its control code, the control
      character is mapped into the code for IDLE.  If the control
      character is entered as the last character before the newline key
      is entered, the sequence of characters entered is transmitted
      without the newline code.  That is, the newline code is not
      transmitted when it is preceded by the control character.

      When the 2741 keyboard is unlocked for input, characters received
      cannot be typed until the keyboard is locked again.  After a line
      is entered, received characters can then be typed.  When operating
      in full duplex or ASCII half duplex, a null line entered will
      allow received characters to be typed but will not cause the new
      line code to be transmitted.  To cause a null line, i.e., just the
      new line code to be transmitted, the control character should be
      entered as the only character in the input line.  In EBCDIC
      HALFDUP a null line entered will cause a null line to be
      transmitted.

   Output:

      ASCII output received from the NVT is converted into EBCDIC with
      the sequences CR-LF converted into IDLE-NL.  The EBCDIC characters
      are then sent to the terminal.  Note that not all 128 ASCII codes
      when converted to EBCDIC will print on a 2741.  Of the 95 ASCII
      graphics and the 8 ASCII controls which are defined for the NVT
      printer, the following are not visible or audible:






Winett                                                          [Page 4]


RFC 452                TELNET Command at Host LL           February 1973


            CARAT
            GRAVE
            BACK SLASH
            LEFT BRACE
            RIGHT BRACE
            LEFT BRACKET
            RIGHT BRACKET
            ASCII CONTROL BELL (BEL)
            ASCII CONTROL VERTICAL TAB (HT)
            ASCII CONTROL FORM FEED (FF)
            ASCII CONTROL CARRIAGE RETURN (CR)

      Figure 6 shows how the EBCDIC codes from X' 40' through X' FF'
      will appear on a 2741 terminal.  Figure 7 shows how the EBCDIC
      codes will appear when printed with a PN train on the offline
      printer and Figure 8 shows how these codes appear when printed
      with a TN train.

   Controls:

      If the first character in an input line is the control character
      and the next character is a space, the rest of the line is
      interpreted as a TELNET control command.  A control command
      consists of a control word and parameters separated by spaces.
      Controls are defined which permit TELNET controls to be
      transmitted to the serving site, allow input to come from a file
      or output to go to a file, allow CMS functions or transient
      commands to be issued, redefine the control character or TELNET
      mode, close connections or leave the TELNET command with
      connections still open, as well as controls to support a reader,
      punch, and printer with RJS operation.  The controls are described
      below.

   CONTROL x

      Where x is the new control character

   CLOSE

      To close all connections and quit

   QUIT

      To leave TELNET

   EBCDIC

      To go into transparent mode, i.e., no translation



Winett                                                          [Page 5]


RFC 452                TELNET Command at Host LL           February 1973


   ASCII

      To translate input and output to network ASCII

   Break

      To send the TELNET break code

   SYNC

      To send the TELNET data mark code and an interrupt

   AATN

      To send a TELNET break and a SYNC

   HIDE-YOUR-INPUT

      To send the TELNET hide you input code

   NOECHO

      To send the TELNET noecho code

   ECHO

      To send the TELNET echo code

   CMS command arg1...argN

      To issue CMS core resident function or transient command.

   INPUT fn ft
         *  TERMIN
         *  *

      To get input from a file If fn is defaulted, input is reset to
      come from the terminal.  If fn is * file input resumes after the
      last line read.  After an EOF, the next line read will be the
      first line of the file.

      An external interrupt while input is coming from a file will cause
      the line number of the next line to be read from the file to be
      typed and input to be reset to come from the terminal.







Winett                                                          [Page 6]


RFC 452                TELNET Command at Host LL           February 1973


   OUTPUT fn OFF TERM    INPUT    INOUT
          *  ON  NOTERM  NOINPUT  OUTPUT

      To write output to the file "fn TERMOUT".  If fn is defaulted,
      output is reset to go to the terminal.  If fn is *, file OUTPUT is
      resumed with the same options as were last used.

   For Output to the Terminal:

      If the last character is a CR, a line with just the control
      character is typed on the next line (with a NL)

      If the last character is not a NL or a CR, the line is typed
      without a NL (i.e., with TYPE).

   For Output to a File:

      If just a NL is in the line, just the control character is sent to
      the file.

      If the last CHAR is not NL or CR, the control character is added
      after the last character, except if 130 characters must be sent to
      the file.

      If the last CHAR is a CR, it is included in the file.

      OFF causes all output to be discarded.

      ON is the default, and causes output to the terminal.

      TERM causes output to also go to the terminal.

      NOTERM is the default, and causes output to go the file but not to
      the terminal.

      OUTPUT is the default and causes just terminal output to be put to
      the file "FN termout".


      INPUT causes both terminal input but not output to be put to the
      output file.

      NOINPUT is defaulted and causes input to not go to the file.

   PURGE

      To purge all output currently received by the NCP.
      *****NOT YET IMPLEMENTED*****



Winett                                                          [Page 7]


RFC 452                TELNET Command at Host LL           February 1973


   READER fn ft
          * READER

      To send a job to the RJS system at UCLA's CCN.

      If fn and ft are defaulted, input will come from the card reader.

   PRINTER fn ft
           *  PRINTER

   To receive printer output from the RJS system at UCLA's CCN.

   To receive punch output from the RJS system at UCLA's CCN.

   If fn and ft are defaulted, output goes to the printer.

   PUNCH fn ft
         *  PUNCH

      If fn and ft are defaulted, output goes to the punch.

   HOST      SITE      MACHINE   SYSTEM      HOST NUMBER
                                           DEC   OCT   HEX

   NMC       UCLA      SIGNA-7   SEX         1     1    01
   ARC       SRI       PDP-10    NIC         2     2    02
   UCSB      UCSB      360/75    OS/MVT      3     3    03
   UTAH      UTAH      PDP-10    TENEX       4     4    04
   MULTICS   MIT       H-645     MULTICS     6     6    06
   SDC       SDC       370/155   ADEPT       8    10    08
   HARV      HARVARD   PDP-10    4S72        9    11    09
   LL        LL        360/67    CP/CMS     10    12    0A
   CASE      CASE      PDP-10    10/50      13    15    0D
   CMU       CMU       PDP-10    TOPS-10    14    16    0E
   ILLIAC    AMES      360/67    TTS/360    16    18    10
   AMES      AMES      B-6500    ?          15    17    0F
   CCN       UCLA      360/91    OS/MVT     65   101    41
   SRI       SRI-AI    PDP-10    TENEX      66   102    42
   BBNA      BBN       PDP-10    TENEX      69   105    45
   DMCG      MIT       PDP-10    ITS        70   106    46
   RAND      RAND-RCC  PDP-10    TENEX      71   107    47
   TX2       LL        TX-2      APEX       74   112    4A
   BBNB      BBN       PDP-10    TENEX     133   205    85
   MIATI     MIT       PDP-10    ITS       134   206    86

                     Serving Hosts on the APRA Network
                                 Figure 1




Winett                                                          [Page 8]


RFC 452                TELNET Command at Host LL           February 1973


                       [[See Figure 2 in PDF file.]]
          Extended Binary-Coded Decimal Interchange Code (EBCDIC)
                                 FIGURE 2

   and

                       [[See Figure 3 in PDF file.]]
          USA Standard Code for Information Interchange (USASCII)
                                 FIGURE 3


   ASCII    ASCII    ASCII    SYMBOLS    EBCDIC    EBCDIC
   DEC      OCT      HEX                 HEX       DEC

     0        0      (00)      NUL       (00)      00
     1        1      (01)      SOH       (01)      01
     2        2      (02)      STX       (02)      02
     3        3      (03)      ETX       (03)      03
     4        4      (04)      EOT       (37)      55
     5        5      (05)      ENQ       (2D)      45
     6        6      (06)      ACK       (2E)      46
     7        7      (07)      BEL       (2F)      47
     8       10      (08)      BS        (16)      22
     9       11      (09)      HT        (05)      05
    10       12      (0A)      LF        (25)      37
    11       13      (0B)      VT        (0B)      11
    12       14      (0C)      FF        (0C)      12
    13       15      (0D)      CR        (0D)      13
    14       16      (0E)      SO        (0E)      14
    15       17      (0F)      SI        (0F)      15
    16       20      (10)      DLE       (10)      16
    17       21      (11)      DC1       (11)      17
    18       22      (12)      DC2       (12)      18
    19       23      (13)      DC3       (13)      19
    20       24      (14)      DC4       (3C)      60
    21       25      (15)      NAK       (3D)      61
    22       26      (16)      SYN       (32)      50
    23       27      (17)      ETB       (26)      38
    24       30      (18)      CAN       (18)      24
    25       31      (19)      EM        (19)      25
    26       32      (1A)      SUB       (3F)      63
    27       33      (1B)      CTL       (27)      39
    28       34      (1C)      FS        (1C)      28
    29       35      (1D)      GS        (1D)      29
    30       36      (1E)      RS        (1E)      30
    31       37      (1F)      US        (1F)      31
    32       40      (20)      SP        (40)      64
    33       41      (21)      !         (5A)      90



Winett                                                          [Page 9]


RFC 452                TELNET Command at Host LL           February 1973


    34       42      (22)      "         (7F)     127
    35       43      (23)      #         (7B)     123
    36       44      (24)      $         (5B)      91
    37       45      (25)      %         (6C)     108
    38       46      (26)      &         (50)      80
    39       47      (27)      '        (7D)     124
    40       50      (28)      (         (4D)      77
    41       51      (29)      )         (5D)      93
    42       52      (2A)      *         (5C)      92
    43       53      (2B)      +         (4E)      78
    44       54      (2C)      ,         (6D)     109
    45       55      (2D)      -         (60)      96
    46       56      (2E)      .         (4B)      75
    47       57      (2F)      /         (61)      97
    48       60      (30)      0         (F0)     240
    49       61      (31)      1         (F1)     241
    50       62      (32)      2         (F2)     242
    51       63      (33)      3         (F3)     243
    52       64      (34)      4         (F4)     244
    53       65      (35)      5         (F5)     245
    54       66      (36)      6         (F6)     246
    55       67      (37)      7         (F7)     247
    56       70      (38)      8         (F8)     248
    57       71      (39)      9         (F9)     249
    58       72      (3A)      :         (7A)     122
    59       73      (3B)      ;         (5E)      94
    60       74      (3C)      <         (4C)      76
    61       75      (3D)      =         (7E)     126
    62       76      (3E)      >         (6E)     110
    63       77      (3F)      ?         (6F)     111
    64      100      (40)      @         (7C)     124
    65      101      (41)      A         (C1)     193
    66      102      (42)      B         (C2)     194
    67      103      (43)      C         (C3)     195
    68      104      (44)      D         (C4)     196
    69      105      (45)      E         (C5)     197
    70      106      (46)      F         (C6)     198
    71      107      (47)      G         (C7)     199
    72      110      (48)      H         (C8)     200
    73      111      (49)      I         (C9)     201
    74      112      (4A)      J         (D1)     209
    75      113      (4B)      K         (D2)     210
    76      114      (4C)      L         (D3)     211
    77      115      (4D)      M         (D4)     212
    78      116      (4E)      N         (D5)     213
    79      117      (4F)      O         (D6)     214
    80      120      (50)      P         (D7)     215
    81      121      (51)      Q         (D8)     216



Winett                                                         [Page 10]


RFC 452                TELNET Command at Host LL           February 1973


    82      122      (52)      R         (D9)     217
    83      123      (53)      S         (E2)     226
    84      124      (54)      T         (E3)     227
    85      125      (55)      U         (E4)     228
    86      126      (56)      V         (E5)     229
    87      127      (57)      W         (E6)     230
    88      130      (58)      8         (E7)     231
    89      131      (59)      Y         (E8)     232
    90      132      (5A)      Z         (E9)     233
    91      133      (5B)      [         (AD)     173
    92      134      (5C) (cent sign)    (4A)      74  (BACK-SLASH)
    93      135      (5D)      ]         (BD)     189
    94      136      (5E)                (71)     113  (CARAT)
    95      137      (5F)      _         (6D)     109
    96      140      (60)                (79)     121  (GRAVE)
    97      141      (61)      a         (81)     129
    98      142      (62)      b         (82)     130
    99      143      (63)      c         (83)     131
   100      144      (64)      d         (84)     132
   101      145      (65)      e         (85)     133
   102      146      (66)      f         (86)     134
   103      147      (67)      g         (87)     135
   104      150      (68)      h         (88)     136
   105      151      (69)      i         (89)     137
   106      152      (6A)      j         (91)     145
   107      153      (6B)      k         (92)     146
   108      154      (6C)      l         (93)     147
   109      155      (6D)      m         (94)     148
   110      156      (6E)      n         (95)     149
   111      157      (6F)      o         (96)     150
   112      160      (70)      p         (97)     151
   113      161      (71)      q         (98)     152
   114      162      (72)      r         (99)     153
   115      163      (73)      s         (A2)     162
   116      164      (74)      t         (A3)     163
   117      165      (75)      u         (A4)     164
   118      166      (76)      v         (A5)     165
   119      167      (77)      w         (A6)     166
   120      170      (78)      x         (A7)     167
   121      171      (79)      y         (A8)     168
   122      172      (7A)      z         (A9)     169
   123      173      (7B)      {         (8B)     139
   124      174      (7C)      |         (4F)      79  (BAR/OR)
   125      175      (7D)      }         (9B)     155
   126      176      (7E) (broken bar)   (5F)      95  (TILDE/NOT)
   127      177      (7F)      DEL       (07)       7





Winett                                                         [Page 11]


RFC 452                TELNET Command at Host LL           February 1973


   ASCII   ASCII   ASCII    TELNET         EBCDIC     EBCDIC
   DEC     OCT     HEX     CONTROLS        HEX        DEC

   128     100     (80)   DATA-MARK        (80)       128
   129     101     (81)   BREAK            (38)        56
   130     102     (82)   NOP              (17)        23  IDLE
   131     103     (83)   NOECHO           (14)        20  RESTORE
   132     104     (84)   ECHO             (23)        35
   133     105     (85)   HIDE-YOUR INPUT  (24)        36  BYPASS

                        ASCII/EBCDIC Code Mappings
                                 FIGURE 4

   EBCDIC                  EBCDIC ASCII

   CENT    (4A) = ESC             (27)   (1B)

   CTL <   (4C) = LEFT BRACKET    (AD)   (5B)
   CTL >   (6E) = RIGHT BRACKET   (BD)   (5D)
   CTL (   (4D) = LEFT BRACE      (8B)   (7B)
   CTL )   (5D) = RIGHT BRACE     (9B)   (7D)
   CTL /   (61) = BACK SLASH      (4A)   (5C)
   CTL "   (7F) = CARAT           (71)   (5E)
   CTL '  (7D) = GRAVE            (79)   (60)

   CTL 6   (F6) = FS              (1C)   (1C)
   CTL 7   (F7) = GS              (1D)   (1D)
   CTL 8   (F8) = RS              (1E)   (1E)
   CTL 9   (F9) = US              (1F)   (1F)
   CTL _   (6D) = US              (1F)   (1F)

   CTL (broken bar) (5F) = DEL             (07)   (7F)

   CTL @   (7C) = NUL             (00)   (00)
   CTL A   (C1) = SOH             (01)   (01)
   CTL B   (C2) = STX             (02)   (02)
   CTL C   (C3) = ETX             (03)   (03)
   CTL D   (C4) = EOT             (37)   (04)
   CTL E   (C5) = ENQ             (2D)   (05)
   CTL F   (C6) = ACK             (2E)   (06)
   CTL G   (C7) = BEL             (2F)   (07)
   CTL H   (C8) = BS              (16)   (08)
   CTL I   (C9) = HT              (05)   (09)
   CTL J   (D1) = LF              (25)   (0A)
   CTL K   (D2) = VT              (0B)   (0B)
   CTL L   (D3) = FF              (0C)   (0C)
   CTL M   (D4) = CR              (0D)   (0D)




Winett                                                         [Page 12]


RFC 452                TELNET Command at Host LL           February 1973


   CTL N   (D5) = SO              (0E)   (0E)
   CTL O   (D6) = SI              (0F)   (0F)

   CTL P   (D7) = DLE             (10)   (10)
   CTL Q   (D8) = DC1             (11)   (11)
   CTL R   (D9) = DC2             (12)   (12)
   CTL S   (E2) = DC3             (13)   (13)
   CTL T   (E3) = DC4             (3C)   (14)
   CTL U   (E4) = NAK             (3D)   (15)
   CTL V   (E5) = SYN             (32)   (16)
   CTL W   (E6) = ETB             (26)   (17)
   CTL X   (E7) = CAN             (18)   (18)
   CTL Y   (E8) = EM              (19)   (19)
   CTL Z   (E9) = SUB             (3F)   (1A)

        EBCDIC                   EBCDIC ASCII

   CTL 1 (F1) = BREAK          (38)  (81) - CIRCLE C
   CTL 2 (F2) = NOP            (17)  (82) - IDLE
   CTL 3 (F3) = NO ECHO        (14)  (83) - RESTORE
   CTL 4 (F4) = ECHO           (23)  (84)
   CTL 5 (F5) = HIDE YOU INPUT (24)  (85) - BYPASS

   DATA MARK (80) CANNOT BE ENTERED FROM THE KEYBOARD

   THE FOLLOWING 2741 KEYBOARD CHARACTERS DO NOT
   HAVE A MEANING AS A CONTROL:

         $ # * % &
         + - = _
         . , :
         ! | ? (cent sign)
         SPACE
         BACKSPACE
         TAB

                    Keyboard Control Character Mappings
                           FIGURE 5 (CONTINUED)













Winett                                                         [Page 13]


RFC 452                TELNET Command at Host LL           February 1973


   [[See Figure in PDF file.]]
   Hex Code X'xy' for Characters on a 2741 Terminal

   [[See Figure in PDF file.]]
   Decimal Code D 'xxy" for Characters on a 2741 terminal

   HT  X'05' = D'005' Horizontal Tab
   LC  X'06' = D'006' Lower Case
   RES X'14' = D'020' Print Restore
   NL  X'15' = D'021' New Line
   BS  X'16' = D'022' Back Space
   IL  X'17' = D'023' Idle
   BYP X'24' = D'036' Print Bypass
   LF  X'25' = D'037' Line Feed
   UC  X'36' = D'054' Upper Case

   Hex Code X'xy' and Decimal Code D'xxy' for 2741 Control Codes

   [[See Figure in PDF file.]]
   Hex Code X'xy' for Characters on the PN train

   [[See Figure in PDF file.]]
   Decimal Code D'xxy' for characters on the PN train

   [[See Figure in PDF file.]]
   Hex Code X'xy' for Characters on th TN train

   [[See Figure in PDF file.]]
   Decimal Code D'xxy' for Characters on the TN train

          [This RFC was put into machine readable form for entry]
     [into the online RFC archives by Helene Morin, Via Genie,12/1999]



















Winett                                                         [Page 14]

mirror server hosted at Truenetwork, Russian Federation.