PreviousCICS Server Administration and Operation Library Services ConnectivityNext

Chapter 8: Communication Setup Considerations

The information in this chapter is designed to help you configure communications to the Mainframe Access Servers. All the information contained here applies only to that environment.

8.1 VTAM and NCP Entries

MVS
The MVS server optionally operates as a VTAM application. It can be set up to run in a single region or you can create multiple MVS server regions.

If you wish to use VTAM, then you must either generate an APPL definition for each server region since each region is its own VTAM application, or use the sample definition generated for you during the MFA SETUP installation program. Consult your VTAM documentation for details on where to place the APPL definition. The following are the applicable options for an APPL statement:

AUTH=(VPACE) VPACE is required to allow pacing of the intersystem flows.
VPACING=number This is the maximum number of normal flow requests that another logical unit can send before waiting to receive a pacing response.
EAS=number This option specifies the number of network addressable units this region can establish sessions with.
PARSESS=YES This allows LUTYPE6 parallel session support.
SONSCIP=YES This option specifies outage notification (SON) support. This enables MVS, in certain cases, to recover a session without operator intervention.
MODETAB= The name of the NCP Mode table where all the possible mode entries are defined.
ACBNAME= This is the physical node name used by this region.
APPC=YES This is required for all MVS server regions.

8.1.1 Sample MVS APPLID for Node FILESHR2

FILESHR2 APPL  AUTH=(VPACE),VPACING=5,                            X
               EAS=64,PARSESS=YES,SONSCIP=YES,                    X
               MODETAB=SAMPMODE,APPC=YES

An APPLID (Physical node name) can be used by only one MVS server region at a time. If you run multiple server regions, you must create additional node names.

8.1.2 System Mode Entry in MVS Mode Table - SNASVCMG

You must have a mode entry for the SNA Service Manager SNASVCMG. This MODESET is used for allocating/de-allocating and changing session limits. This is unique from the mode defined for each LU6.2 connection.

SNASVCMG MODEENT TYPE=1,  (1 IS A NON-NEGOTIABLE BIND)            X
              LOGMODE=SNASVCMG,                                   X
              FMPROF=X'13',TSPROF=X'07',                          X
              RUSIZES=X'8585',PRIPROT=X'B0',                      X
              SECPROT=X'B0',COMPROT=X'D0B1',                      X
              PSERVIC=X'060200000000000000000300'

For most releases of VTAM this MODESET is supplied.

8.1.3 USER Mode Entry for parallel sessions in VTAM Mode Table

CSILU62  MODEENT TYPE=0,  (0 IS NEGOTIABLE BIND)                  X
               LOGMODE=CSILU62,ENCR=B'0000',                      X
               PRIPROT=X'B0',SECPROT=X'B0',COMPROT=X'50B1',       X
               FMPROF=X'13',TSPROF=X'07',RUSIZES=X'F7F7',         X
               PSERVIC=X'060200000000000000000300'

8.1.4 USER Mode Entry for a dependent LU in VTAM Mode Table

CSILU62S MODEENT TYPE=0,  (0 IS NEGOTIABLE BIND)                  X
               LOGMODE=CSILU62S,ENCR=B'0000',                     X
               FMPROF=X'13',TSPROF=X'07',RUSIZES=X'8787',         X
               PRIPROT=X'B0',SECPROT=X'B0',COMPROT=X'50B1',       X
               SSNDPAC=7,                                         X
               PSERVIC=X'060200000000000000102C00'

There are several pre-defined modes provided by most APPC support vendors. These modes begin with a hash symbol or number sign (#). For the MVS server the mode #INTER is an appropriate choice. When these modes are not available, a mode definition similar to CSILU62 (shown above) is appropriate.

8.2 Workstation Related Definitions

The workstation connections need to be defined to VTAM. This typically consists of a PU (Physical Unit) and one or more LU (Logical Unit) definitions.

8.2.1 Sample VTAM, .NDF, and FHREDIR.CFG Definitions

The VTAM and .NDF definitions presented below represent a direct connection from the workstation to the mainframe. For completeness, a sample FHREDIR.CFG file is also presented.

8.2.1.1 VTAMNODE (VTAMNODE.DEF)

WKSTOKEN VBUILD TYPE=SWNET,MAXGRP=1,MAXNO=1
*---------------------------------------------------------------*
*                                                               *
*        MAINFRAME ACCESS PRODUCT SUITE WORKSTATION DEFINITION  *
*                                                               *
*        NOTES: THE MODETAB= PARAMETER ON THE PU STATEMENT WILL *
*               NEED TO BE MODIFIED FOR YOUR ORGANIZATION.      *
*                                                               *
*               THE IDBLK= AND IDNUM= PARAMETERS ON THE PU      *
*               STATEMENT WILL NEED TO BE MODIFIED TO MATCH     *
*               THOSE OF YOUR WORKSTATION.                      *
*                                                               *
*               THE DLOGMOD= PARAMETER ON THE LU STATEMENTS FOR *
*               THE LU2 CONNECTIONS WILL NEED TO BE MODIFIED    *
*               FOR YOUR ORGANIZATION.                          *
*                                                               *
*               OTHER PARAMETERS MAY NEED TO BE MODIFIED.       *
*                                                               *
*---------------------------------------------------------------*
WKSPU010 PU    MODETAB=CSILOGMD,PUTYPE=2,                        X
               ADDR=01,IDBLK=05D,IDNUM=FFFFF,SSCPFM=USSSCS,      X
               USSTAB=USSNULL,FEATUR2=MODEL2,MAXPATH=1,          X
               MAXDATA=4105
*
*   APPC CONNECTIONS (2)
*
WKSLU010 LU   LOCADDR=00,DLOGMOD=SNASVCMG,RESSCB=8
WKSLU011 LU   LOCADDR=00,DLOGMOD=SNASVCMG,RESSCB=8
*
*   LU2 3270 CONNECTIONS (4)
*
WKSTRM12 LU   LOCADDR=02,DLOGMOD=SNATUBE,USSTAB=USSCSI
WKSTRM13 LU   LOCADDR=03,DLOGMOD=SNATUBE,USSTAB=USSCSI
WKSTRM14 LU   LOCADDR=04,DLOGMOD=SNATUBE,USSTAB=USSCSI
WKSTRM15 LU   LOCADDR=05,DLOGMOD=SNATUBE,USSTAB=USSCSI

8.2.1.2 NDF2HOST (DIR2HOST.NDF)

DEFINE_LOCAL_CP  FQ_CP_NAME(AAINET1.WKSPU010 )
                          CP_ALIAS(WKSPU010)
                          NAU_ADDRESS(INDEPENDENT_LU)
                          NODE_TYPE(EN)
                          NODE_ID(X'05DFFFFF')
                          NW_FP_SUPPORT(NONE)
                          HOST_FP_SUPPORT(YES)
                          HOST_FP_LINK_NAME(HOST0001)
                          MAX_COMP_LEVEL(NONE)
                          MAX_COMP_TOKENS(0);

DEFINE_LOGICAL_LINK  LINK_NAME(HOST0001)
                     FQ_ADJACENT_CP_NAME(AAINET1.MVS001   )
                     ADJACENT_NODE_TYPE(LEN)
                     DLC_NAME(IBMTRNET)
                     ADAPTER_NUMBER(0)
                     DESTINATION_ADDRESS(X'40000000004004')
                     ETHERNET_FORMAT(NO)
                     CP_CP_SESSION_SUPPORT(NO)
                     SOLICIT_SSCP_SESSION(YES)
                     NODE_ID(X'05DFFFFF')
                     ACTIVATE_AT_STARTUP(YES)
                     USE_PUNAME_AS_CPNAME(NO)
                     LIMITED_RESOURCE(USE_ADAPTER_DEFINITION)
                     LINK_STATION_ROLE(USE_ADAPTER_DEFINITION)
                     MAX_ACTIVATION_ATTEMPTS(USE_ADAPTER_DEFINITION)
                     EFFECTIVE_CAPACITY(USE_ADAPTER_DEFINITION)
                     COST_PER_CONNECT_TIME(USE_ADAPTER_DEFINITION)
                     COST_PER_BYTE(USE_ADAPTER_DEFINITION)
                     SECURITY(USE_ADAPTER_DEFINITION)
                     PROPAGATION_DELAY(USE_ADAPTER_DEFINITION)
                     USER_DEFINED_1(USE_ADAPTER_DEFINITION)
                     USER_DEFINED_2(USE_ADAPTER_DEFINITION)
                     USER_DEFINED_3(USE_ADAPTER_DEFINITION);

DEFINE_LOCAL_LU  LU_NAME(WKSLU010)
                 LU_ALIAS(WKSLU010)
                 NAU_ADDRESS(INDEPENDENT_LU);

DEFINE_PARTNER_LU  FQ_PARTNER_LU_NAME(AAINET1.FILESHR2 )
                   DESCRIPTION(MAINFRAME ACCESS MVS SERVER)
                   PARTNER_LU_ALIAS(FILESHR2)
                   PARTNER_LU_UNINTERPRETED_NAME(FILESHR2)
                   MAX_MC_LL_SEND_SIZE(32767)
                   CONV_SECURITY_VERIFICATION(NO)
                   PARALLEL_SESSION_SUPPORT(YES);

DEFINE_PARTNER_LU  FQ_PARTNER_LU_NAME(AAINET1.MFCICSV2 )
                   DESCRIPTION(MAINFRAME ACCESS CICS SERVER)
                   PARTNER_LU_ALIAS(MFCICSV2)
                   PARTNER_LU_UNINTERPRETED_NAME(MFCICSV2)
                   MAX_MC_LL_SEND_SIZE(32767)
                   CONV_SECURITY_VERIFICATION(NO)
                   PARALLEL_SESSION_SUPPORT(YES);

DEFINE_PARTNER_LU_LOCATION  FQ_PARTNER_LU_NAME(AAINET1.FILESHR2 )
                            WILDCARD_ENTRY(NO)
                            FQ_OWNING_CP_NAME(AAINET1.MVS001   )
                            LOCAL_NODE_NN_SERVER(NO);

DEFINE_PARTNER_LU_LOCATION  FQ_PARTNER_LU_NAME(AAINET1.MFCICSV2 )
                            WILDCARD_ENTRY(NO)
                            FQ_OWNING_CP_NAME(AAINET1.MVS001   )
                            LOCAL_NODE_NN_SERVER(NO);

DEFINE_MODE  MODE_NAME(#INTER  )
             COS_NAME(#INTER  )
             DEFAULT_RU_SIZE(NO)
             MAX_RU_SIZE_UPPER_BOUND(4096)
             RECEIVE_PACING_WINDOW(7)
             MAX_NEGOTIABLE_SESSION_LIMIT(8)
             PLU_MODE_SESSION_LIMIT(8)
             MIN_CONWINNERS_SOURCE(4)
             COMPRESSION_NEED(PROHIBITED)
             PLU_SLU_COMPRESSION(NONE)
             SLU_PLU_COMPRESSION(NONE);

DEFINE_DEFAULTS  IMPLICIT_INBOUND_PLU_SUPPORT(YES)
                 DEFAULT_MODE_NAME(BLANK)
                 DEFAULT_LOCAL_LU_ALIAS(WKSLU010)
                 MAX_MC_LL_SEND_SIZE(32767)
                 DIRECTORY_FOR_INBOUND_ATTACHES(*)
                 DEFAULT_TP_OPERATION(NONQUEUED_AM_STARTED)
                 DEFAULT_TP_PROGRAM_TYPE(BACKGROUND)
                 DEFAULT_TP_CONV_SECURITY_RQD(NO)
                 MAX_HELD_ALERTS(10);

START_ATTACH_MANAGER;

8.2.1.3 FHREDIR

*
*   SAMPLE APPC FHREDIR
*
*      WKSLU010 IS THE LOCAL LUNAME
*      #INTER IS THE MODE NAME
*      FILESHR2 IS THE PARTNER ALIAS OR APPLNAME
*      MVSF IS NOT USED BY THE MVS SERVER BUT IS
*           REQUIRED BY CCIAPPC
*
/MA WKSLU010.#INTER /S FILESHR2.MVSF
/CM CCIAPPC
/F CSI01* /S FILESHR2.MVSF
/F SYSOUT* /S FILESHR2.MVSF
/F SYS1.* /S FILESHR2.MVSF

This FHREDIR.CFG file assumes that the prefix for the installed Mainframe Access Product files and libraries is CSI01.


Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
PreviousCICS Server Administration and Operation Library Services ConnectivityNext