APPENDIX A

SAMPLE HOST DEFINITIONS

This appendix presents sample host definitions for IRMA 
WorkStation connections to IBM S/370 (host) systems. The 
samples show configuration values for IRMA WorkStation 
connections of the following kinds:

CONNECTION TYPE     CONNECTION USE      HOST SYSTEM

Token ring          3270 emulation      Virtual Telecommuni-
                                        cations Access 
                                        Method (VTAM)

SDLC switched       3270 emulation      VTAM

SDLC leased         3270 emulation      VTAM

X.25                3270 emulation      VTAM

Any type            LU 6.2              Customer Information 
                                        Control System 
                                        (CICS)

Note:  The VTAM listings in this appendix omit the column 72 
continuation character.

VTAM Sample Definitions for 3270

This section presents sample VTAM definitions (version 
3.2.2) for IRMA WorkStation connections to an IBM 9370 host 
system for 3270 emulation. There are samples for SDLC, for 
token ring, and for X.25 connections.

Token Ring Definition

Table 1 shows a VTAM definition for a connection between 
an IRMA WorkStation and an IBM 9370 host computer across a 
token ring local area network (LAN).

Table 1.  VTAM TOKEN RING DEFINITIONS

NAME        DESCRIPTION   PARAMETERS

LANODE      VBUILD        TYPE=LAN

R01100      PORT          CUADDR=100,MACADDR=400001701100,
                          LANCON=(5,2),MAXDATA=2012,
                          MAXSTN=32,SAPADDR=04

G01100      GROUP         DIAL=YES,ISTATUS=ACTIVE,LNCTL=SDLC

L01100A     LINE          CALL=INOUT

P01100A     PU            MAXLU=254

L01100B     LINE          CALL=INOUT

P01100B     PU            MAXLU=254

SWLAN       VBUILD        TYPE= SWNET,MAXGRP=5,MAXNO=12

SERVER01    PU            ADDR=C1,IDBLK=05D,IDNUM=00001,
                          ANS=CONTINUE,MAXDATA=265,
                          MAXOUT=7,MAXPATH=7,PACING=0,
                          VPACING=0,SSCPFM=USSSCS,
                          LANACK=(0,0),LANCON=(5,2),
                          LANINACT=4.8,LANRESP=(5,2),
                          LANSDWDW=(7,1),LANSW=YES,
                          MACADDR=4000000000FD,PUTYPE=2,
                          DISCNT=(NO),ISTATUS=ACTIVE,
                          SAPADDR=04

E01100A     PATH          DIALNO=0004400001701100,
                          GRPNM=G01100,GID=1,PID=1,USE=YES

T0110000    LU            LOCADDR=002,DLOGMOD=D4C32782

T0110001    LU            LOCADDR=003,DLOGMOD=D4C32782

T0110002    LU            LOCADDR=004,DLOGMOD=D4C32782

T0110003    LU            LOCADDR=005,DLOGMOD=D4C32782

T0110004    LU            LOCADDR=006,DLOGMOD=LU33286S



Table 2 defines key parameters shown in Table 1.

Table 2.  VTAM PARAMETER DESCRIPTIONS FOR TOKEN RING

VTAM        IRMA WORKSTATION
PARAMETER   PARAMETER                 DESCRIPTION

IDBLK=      First three digits of     A three-digit hexa-
            local Node ID (basic      decimal value that
            connection setting)       together with IDNUM,
                                      identifies the IRMA
                                      WorkStation. The 
                                      values 000 and FFF
                                      cannot be used; these 
                                      values are reserved.

IDNUM=      Last five digits of       A five-digit hexa-
            Local Node ID (basic      decimal value that 
            connection setting)       together with IDBLK,
                                      identifies the IRMA
                                      WorkStation. The 
                                      value 00000 cannot be
                                      used; this value is 
                                      reserved.

MAXDATA=    Max BTU Length            The maximum length of
(in the PU  (advanced 802.2           a basic transaction 
definition  setting                   unit (BTU) sent or 
for SERVER01)                         received. BTUs are 
                                      also known as I-
                                      frames. Max BTU Length
                                      should be less than or
                                      equal to MAXDATA.

MACADDR=     Remote Network           The media acccess 
in the       Address (basic 802.2     control address, a 12-
PORT         setting)                 hexadecimal address.
definition                            
                                      The remote Network
                                      Address (MACADDR) 
                                      shown in Table 1 is
                                      400001701100.

SAPADDR=     Remote SAP Address       The system access 
in the PU    (advanced 802.2          point, a two-digit
definition   setting                  hexadecimal number, a
                                      multiple of 4, between 
                                      04 and EC.

                                      The Remote SAP Address 
                                      shown in Table 1 is 
                                      04, the default value. 
                                      This value is 
                                      recommended for most 
                                      installations.

LOCADDR=      LU Number               The LU local address 
in the LU                             at the PU.  For in-
definition                            dependent LUs that
                                      communicate with a 
                                      host, the LOCADDR 
                                      parameter must be set
                                      to 0. For dependent 
                                      LUs with VTAM, the 
                                      LOCADDR must be at 
                                      least 2. Also, for 
                                      dependent LUs, the LU
                                      Numbers set in IRMA 
                                      WorkStation must match 
                                      the LOCADDR values on
                                      the host.

                                      The LU Numbers range
                                      from 002 to 006 in 
                                      Table 1.


The GRPNM value shown in the sample in Table 1 is a group 
name; group names must match the label of a VTAM group 
definition. The DLOGMOD values shown in the sample are the 
logon mode table entries from the mode table. For 
descriptions of the group macros used in these samples, and 
a complete listing of default mode table entries, see the 
documentation for your IBM product.

SDLC Definition (for Switched and Leased Lines)

Table 3 shows a sample IBM 9370 VTAM definition for four 
SDLC lines. The LLGROUP label shows the VTAM definitions for 
lines B80 and BB0 of a leased group. The SNAGROUP label 
shows the VTAM definitions for lines B90 and BA0 of a 
switched group.

Table 3.  VTAM DEFINITION FOR FOUR SDLC LINES    

LABEL       OPERATION     OPERANDS

IBMLINE     VBUILD        TYPE=CA

LLGROUP     GROUP         LNCTL=SDLC,DIAL=NO,ACTIVTO=10

L01B80      LINE          ADDRESS=B80,PAUSE=0.4,REPLYTO=2.0,
                          RETRIES=7

P01B80A     PU            ADDR=C1,DISCNT=NO,PASSLIM=7,
                          PUTYPE=2,MAXOUT=7,USSTAB=AUSSTAB

T01B8002    LU            LOCADDR=002,DLOGMOD=D4C32792

T01B8003    LU            LOCADDR=003,DLOGMOD=D4C32792

T01B8004    LU            LOCADDR=004,DLOGMOD=D4C32792

L01BB0      LINE          ADDRESS=BB0,PAUSE=0.4,REPLYTO=2.0,
                          RETRIES=7

P01BB0A     PU            ADDR=C1,DISCNT=NO,PASSLIM=7,
                          PUTYPE=2,MAXOUT=7,USSTAB=AUSSTAB

T01BB000    LU            LOCADDR=002,DLOGMOD=D4C32792

T01BB001    LU            LOCADDR=003,DLOGMOD=D4C32792

T01BB002    LU            LOCADDR=004,DLOGMOD=D4C32792

T01BB003    LU            LOCADDR=005,DLOGMOD=D3C32792

T01BB004    LU            LOCADDR=006,DLOGMOD=LU33286S

SNAGROUP    GROUP         LNCTL=SDLC,DIAL=YES,MAXLU=20

L01B90      LINE          ADDRESS=B90,PAUSE=0.4,REPLYTO=2.0,
                          RETRIES=7

P01B90A     PU

L01BA0      LINE          ADDRESS=BA0,PAUSE=0.4,REPLYTO=2.0,
                          RETRIES=7

P01BA0A     PU



Table 4 shows the sample IBM 9370 VTAM switched definition 
for the SNAGROUP label in Table 3.


Table 4.  VTAM SWITCHED DEFINITION FOR SNAGROUP

LABEL      OPERATION       OPERANDS

SWNODE     VBUILD          TYPE=SWNET,MAXGRP=0,MAXNO=0

SWPU1      PU              ADDR=C1,IDBLK=017,IDNUM=DC006,
                           DISCNT=NO,PASSLIM=2,PUTYPE=2,
                           MAXDATA=265,MAXOUT=2,
                           USSTAB=MSUSSTAB

T01BA000   LU              LOCADDR=2,DLOGMOD=D4C32782

T01BA001   LU              LOCADDR=3,DLOGMOD=D4C32782

T01BA002   LU              LOCADDR=4,DLOGMOD=D4C32782

T01BA003   LU              LOCADDR=5,DLOGMOD=D4C32782

T01BA004   LU              LOCADDR=6,DLOGMOD=LU33286S


Table 5 describes key parameters shown in Tables 3 and 4.

Table 5.  VTAM PARAMETER DESCRIPTIONS FOR SDLC

VTAM          CORRESPONDING
PARAMETER     IRMA WORKSTATION      
              PARAMETER             DESCRIPTION

ADDR=         Poll Address          A two-digit hexa-
              (advanced SDLC        decimal value that
              setting)              identifies the control
                                    unit that the host uses 
                                    to poll.

IDBLK=        First three digits    A three-digit hexa-
              Local Node ID (basic  decimal value that,
              connection setting)   together with IDNUM,
                                    identifies the IRMA
                                    WorkStation. The 
                                    values 000 and FFF
                                    cannot be used; these 
                                    values are reserved.

IDNUM=        Last five digits of   A five-digit hexa-
              Local Node ID (basic  decimal value that,
              connection setting)   together with IDBLK,
                                    identifies the IRMA
                                    WorkStation. The 
                                    value 00000 cannot be
                                    used; this value is 
                                    reserved.

MAXDATA=      Max BTU length        The maximum length of a
(in the PU    (advanced SDLC        basic transmission unit
definition    setting)              (BTU) sent or received; 
for SWPU1)                          BTUs are also known as
                                    I-frames.

LOCADDR=      LU Number             The LU local address at 
                                    the PU. For independent
                                    LUs that communicate 
                                    with a host, the LOCADDR
                                    parameter must be set to 
                                    zero. For dependent LUs 
                                    with VTAM, the LOCADDR
                                    must be at least 2.
                                    Also, for dependent LUs,
                                    the LU Numbers set in 
                                    IRMA WorkStation must
                                    match the LOCADDR 
                                    values on the host.


The DLOGMOD values shown in the example are the logon mode 
table entries from the mode table. For a complete listing of 
default mode table entries, see the documentation for your 
IBM product.

X.25 Definition

Table 6 shows a sample IBM 9370 VTAM definition for X.25 
circuits. The X25GROUP label shows the VTAM definitions for 
switched virtual circuits 001 through 006.

Table 6.  VTAM DEFINTION FOR X.25 CONNECTION

LABEL     OPERATION  OPERANDS

X25NODE   VBUILD     TYPE=PACKET

PORTA00   PORT       CUADDR=(A00,A08),NETTYPE=1,
                     CHARGACC=YES,CHARGE=NO,
                     VCALLS=(,,001,006,,),DIALNO=31370023061
                     MAXOUT=7,NETLEVEL=80,PMOD=8,
                     PLENGTH=256,PWINDOW=3,REPLYT0=3,
                     RETRIES=7

VCPA00    VCPARMS    LC=(1,6),PWINDOW=3,PLENGTH=256

X25GROUP  GROUP      DIAL=YES,LNCTL=SDLC,CALL=INOUT,
                     ISTATUS=ACTIVE

L01A00A   LINE       ADDRESS=001,AUTO=001,
                     ISTATUS=ACTIVE

P01AOOA   PU         MAXLU=32

L01A00B   LINE       ADDRESS=002,ISTATUS=INACTIVE,
                     AUTO=002

P01AOOB   PU         MAXLU=32

L01A00C   LINE       ADDRESS=003,ISTATUS=INACTIVE,
                     AUTO=003

P01AOOC   PU         MAXLU=32

L01A00D   LINE       ADDRESS=004,ISTATUS=INACTIVE,
                     AUTO=004

P01AOOD   PU         MAXLU=32

L01A00E   LINE       ADDRESS=005,ISTATUS=INACTIVE,
                     AUTO=005

P01AOOE   PU         MAXLU=32

L01A00F   LINE       ADDRESS=006,ISTATUS=INACTIVE,
                     AUTO=006

P01AOOF   PU         MAXLU=32



Table 7 shows the sample IBM 9370 VTAM switched definition 
for the X25GROUP label in Table 6.

Table 7.  VTAM SWITCHED DEFINTION FOR X25GROUP

LABEL    OPERATION     OPERANDS

X25      VBUILD        TYPE=SWNET,MAXGRP=5,MAXNO=12

USER01   PU            ADDR=C1,IDBLK=05D,IDNUM=00025,
                       ANS=CONTINUE,MAXDATA=265,
                       MAXOUT=7,MAXPATH=0,PACING=0,
                       VPACING=0,SSCPFM=USSSCS,
                       IRETRY=YES,USSTAB=MSUSSTAB,
                       PUTYPE=2,DISCNT=YES,ISTATUS=ACTIVE

T01A0002  LU           LOCADDR=002,DLOGMOD=D4C32792

T01A0003  LU           LOCADDR=003,DLOGMOD=D4C32792

T01A0004  LU           LOCADDR=004,DLOGMOD=D4C32792

T01A0005  LU           LOCADDR=005,DLOGMOD=D4C32792

T01A0006  LU           LOCADDR=006,DLOGMOD=LU33286S


Table 8 defines key parameters shown in Tables 6 and 7.

Table 8.  VTAM PARAMETER DESCRIPTIONS FOR X.25 

              CORRESPONDING
VTAM          IRMA WORKSTATION
PARAMETER     PARAMETER                 DESCRIPTION

IDBLK=        First three digits of     A three-digit hexa-
              Local Node ID (basic      decimal value, that
              connection setting)       together with IDNUM,
                                        identifies the IRMA 
                                        WorkStation. The 
                                        values 000 and FFF
                                        cannot be used;
                                        these values are
                                        reserved.

IDNUM=        Last five digits of       A five-digit hexa-
              Local Node ID (basic      decimal value that,
              connection setting)       together with IDBLK,
                                        identifies the IRMA
                                        WorkStation. The 
                                        value 00000 cannot
                                        be used; this value
                                        is reserved.

DIALNO= in    Remote X.25 Address       An address that 
the PORT                                identifies an X.25
definition                              system.  The address
                                        consists of from 1
                                        through 15 hexa-
                                        decimal digits. If a 
                                        15-digit address is 
                                        used, the final 3 
                                        digits are used for
                                        routing between 
                                        stations with the 
                                        same 12-digit 
                                        address.

MAXDATA=      Max BTU length            The maximum length 
(in the PU    (advanced X.25 setting)   of a BTU sent or 
definition                              received.
for USER01)

LOCADDR=      LU Number                 The LU local address 
                                        at the PU. For in-
                                        dependent LUs that 
                                        communicate with a 
                                        host, the LOCADDR 
                                        parameter must be 
                                        set to 0. For de-
                                        pendent LUs with 
                                        VTAM, the LOCADDR
                                        must be at least 2. 
                                        Also, for dependent 
                                        LUs, the LU Numbers 
                                        set in IRMA Work-
                                        Station must match 
                                        the LOCADDR values
                                        on the host.

                                        The LU numbers range 
                                        from 002 to 006 in 
````````````````````````````````````````Table 7.


CICS and VTAM Sample Definitions for LU 6.2

This section presents sample definitions for CICS (version 
1.6) and VTAM (version 3.2) for IRMA WorkStation connections 
to an IBM host system for LU 6.2 operation.

To configure a CICS host system for LU 6.2 operation with an 
IRMA WorkStation system, you configure the following 
information at the host:

* The remote systems with which CICS is able to communicate.
* The name used by VTAM to communicate with each remote 
system.
* The transaction programs (TPs) available on the CICS 
system.
* The programming language (PL/I, COBOL, or Assembler) in 
which each program is written.

This information is configured in CICS and VTAM tables. This 
section provides sample definitions that show how to 
configure CICS for LU 6.2 using these CICS and VTAM tables.

CICS Tables

CICS uses the following tables to define LU 6.2 information:

* Terminal Control Table (TCT) - defines the remote systems 
to CICS.
* Program Control Table (PCT) - defines the local TPs to 
CICS.
* Program Processing Table (PPT) - defines the load module 
characteristics to CICS.

The following paragraphs describe these tables, and include 
sample definitions to illustrate how they are used.

Note:  These samples assume there are four TPs residing on 
CICS written in PL/I with the following names: TRAN0, TRAN1, 
TRAN2, and TRAN3.

Terminal Control Table

The Terminal Control Table (TCT), Table 9, defines the 
remote systems to CICS.  Each remote system is specified 
using a DFHTCT definition, which includes both the name by 
which CICS knows the system (the SYSIDNT field), and the 
name by which VTAM knows the system (the NETNAME field).


Table 9.  SAMPLE TERMINAL CONTROL TABLE ENTRIES          

LABEL        DEFINITION     OPERANDS

TP11         DFHTCT         TYPE=SYSTEM ACCMETH=VTAM,
                            FEATURE=SINGLE,TRMTYPE=LUTYPE62,
                            NETNAME=TPLU6207,SYSIDNT=DC11,
                            MODENAM=LU62,CONNECT=AUTO,
                            BUFFER=256,RUSIZE=256,
                            TRMSTAT=(TRANSCEIVE)

TP12         DFHTCT         TYPE=SYSTEM ACCMETH=VTAM,
                            FEATURE=SINGLE,TRMTYPE=LUTYPE62,
                            NETNAME=TPLU6208,SYSIDNT=DC12,
                            MODENAM=LU62,CONNECT=AUTO,
                            BUFFER=256,RUSIZE=256,
                            TRMSTAT=(TRANSCEIVE)

TP13         DFHTCT         TYPE=SYSTEM ACCMETH=VTAM,
                            FEATURE=SINGLE,TRMTYPE=LUTYPE62,
                            NETNAME=TPLU6209,SYSIDNT=DC13,
                            MODENAM=LU62,CONNECT=AUTO,
                            BUFFER=256,RUSIZE=256,
                            TRMSTAT=(TRANSCEIVE)

TP14         DFHTCT         TYPE=SYSTEM ACCMETH=VTAM,
                            FEATURE=SINGLE,TRMTYPE=LUTYPE62,
                            NETNAME=TPLU620A,SYSIDNT=DC14,
                            MODENAM=LU62,CONNECT=AUTO,
                            BUFFER=256,RUSIZE=256,
                            TRMSTAT=(TRANSCEIVE)


Program Control Table

The Program Control Table (PCT), Table A.10, defines the 
local TPs to CICS.  Each TP is specified using a DFHPCT 
definition, which includes the name by which the TP is 
invoked (the TRANSID field), and the corresponding load 
module name from the CICS library of TPs.

Table 10.  SAMPLE CICS PROGRAM TABLE ENTRIES 

TP LABEL     DEFINITION    OPERANDS

TRAN0        DFHPCT        TYPE=ENTRY PROGRAM=TRAN0000,
                           TWASIZE=1000,SPURGE=NO,TPURGE=NO,
                           RSL=00,RSLC=NO,MODENAM=NORMAL,
                           TRANSID=TRAN0

TRAN1        DFHPCT        TYPE=ENTRY PROGRAM=TRAN0001,
                           TWASIZE=1000,SPURGE=NO,TPURGE=NO,
                           RSL=00,RSLC=NO,MODENAM=NORMAL,
                           TRANSID=TRAN1

TRAN2        DFHPCT        TYPE=ENTRY PROGRAM=TRAN0002,
                           TWASIZE=1000,SPURGE=NO,TPURGE=NO,
                           RSL=00,RSLC=NO,MODENAM=NORMAL,
                           TRANSID=TRAN2

TRAN3        DFHPCT        TYPE=ENTRY PROGRAM=TRAN0003,
                           TWASIZE=1000,SPURGE=NO,TPURGE=NO,
                           RSL=00,RSLC=NO,MODENAM=NORMAL,
                           TRANSID=TRAN3

* ****** * PROFILE TO BE USED IN LU6.2 ALLOCATE * ****** *

             DFHPCT        TYPE=PROFILE, PROFILE=DFHCICSA,
                           INBFMH=ALL,MODENAME=LU62


Program Processing Table

The Program Processing Table (PPT), Table 11, defines the 
load module characteristics to CICS.  Each load module is 
defined using the DFHPPT definition, which includes the name 
of the load module (the PROGRAM field), and the language in 
which the module has been written, for example, PL/I, 
Assembler, or COBOL (the PGMLANG field).

Table 11.  SAMPLE CICSL PROGRAM PROCESSING TABLE ENTRIES   

DEFINITION          PROGRAM NAME          LANGUAGE

DFHPPT TYPE=ENTRY   PROGRAM=TRAN0000      PGMLANG=PL/I

DFHPPT TYPE=ENTRY   PROGRAM=TRAN0001      PGMLANG=PL/I

DFHPPT TYPE=ENTRY   PROGRAM=TRAN0002      PGMLANG=PL/I

DFHPPT TYPE=ENTRY   PROGRAM=TRAN0003      PGMLANG=PL/I


VTAM Definitions

Each remote system must be defined to VTAM in its table of 
Network Addressable Units, called NAUs, using LU definitions 
(see Table 12).Note that if a LOGAPPL parameter is specified 
on the LU definition naming the CICS system, CICS will 
attempt to establish a session to that LU whenever it 
becomes active. This is necessary if TPs residing in CICS do 
not use the ALLOCATE verb with 
RETURN_CONTROL=WHEN_SESSION_ALLOCATED to establish sessions. 
There must also be a VTAM mode table definition present for 
LU 6.2, although CICS does not use the values specified 
here.

Table 12.  SAMPLE VTAM NETWORK CONTROL PROGRAM (NCP) 
DEFINTION FOR LU 6.2   

LABEL      OPERATION    OPERANDS

TPPU62     PU           ADDR=C1,IBLK=03E,IDNUM=01A1A,
                        IRETRY=YES,DISCNT=NO,ISTATUS=ACTIVE,
                        MAXDATA=265,SSCPFM=USSSCS,
                        MODETAB=MRNDS,USSTAB=USSNDN1,
                        MAXOUT=7,PASSLIM=7,PUTYPE=2

TPLU6207   LU           LOCADDR=7,DLOGMOD=LU62,
                        USSTAB=USSNOMSG

TPLU6208   LU           LOCADDR=8,DLOGMOD=LU62,
                        USSTAB=USSNOMSG

TPLU6209   LU           LOCADDR=9,DLOGMOD=LU62,
                        USSTAB=USSNOMSG

TPLU620A   LU           LOCADDR=A,DLOGMOD=LU62,
                        USSTAB=USSNOMSG

***********  VTAM Mode table definition  ***********

LU62       MODETAB      MODEENT LOGMODE=NORMAL,
                        MODEEND,END


TP Coding Requirements

To work with CICS, TPs must be coded to specify a SYSID 
parameter on the ALLOCATE request that matches the defined 
SYSIDNT parameter configured in the DFHTCT tables. This 
request must be in the following format: EXEC CICS ALLOCATE 
SYSID('DC11')

The SYSID field must match the SYSIDNT field specified for a 
CICS program by the DFHTCT definition in the TCT. The TCT 
then uses the NETNAME parameter to refer to a specific LU in 
the VTAM table of NAUs for use by the TP to communicate with 
the remote system.

