NCP-connected Db2 subsystems

The Advanced Communications Facility/Network Control Program (ACF/NCP) is a product that you can use to generate a network control program load module. The network control program load module is loaded from the host into a communications controller.

The network control program controls the lines and devices attached to it. It transfers data to and from the devices and handles any errors that occur, including retries after line errors.

A communications controller can be locally attached to a host via a channel, or it can be link-attached to another communications controller that is channel-attached.

Our sample definitions are used for the following setup:

Begin figure description. A figure shows SYSTEM1 communicating with NCP. NCP then communicates with SYSTEM2. End figure description.

When you are defining your NCP connections, remember the following:

  • MAXBFRU must be large enough to handle the biggest PIU that is sent to the NCP. In our example, Db2 is sending 4125 bytes per PIU (4096 + a 29-byte network header). Given an IOBUF buffer size of 441 bytes, MAXBFRU must therefore be at least 10 (10 × 441 = 4410, which is greater than 4125).
  • The MAXDATA option must also be large enough to handle biggest PIU (RUSIZE + 29 bytes).

If Db2 is using existing NCP definitions, you should make sure your MAXBFRU and MAXDATA options are large enough. If these values are too small, you get an SNA X'800A' sense code, indicating that the PIU was truncated during transmission.

Figure 1. Network control program (NCP) definitions
***********************************************************************
*        PCCU SPECIFICATION - FOR SYSTEM 1                            *
***********************************************************************
PCCU1    PCCU  CUADDR=C02,         3745 BLOCK CHANNEL                 X
               AUTOSYN=YES,                                           X
               AUTODMP=NO,                                            X
               AUTOIPL=NO,                                            X
               BACKUP=YES,                                            X
               DELAY=0,                                               X
               DUMPDS=DUMPDS,      DUMP DATA SET                      X
               CDUMPDS=CDUMPDS,    CSP DUMP DATA SET                  X
               MDUMPDS=MDUMPDS,    MOSS DUMP DATA SET                 X
               INITEST=NO,         NO 3745 INITIAL TESTS AT LOAD TIME X
               MAXDATA=4302,       = BFRS*TRANSFR - 18                X
               OWNER=HOST1,                                           X
               SUBAREA=3,          HOST SUBAREA                       X
               VFYLM=YES
***********************************************************************
*        PCCU SPECIFICATION - FOR SYSTEM 2                            *
***********************************************************************
PCCU2    PCCU  CUADDR=C02,         3745 BLOCK CHANNEL                 X
               AUTOSYN=YES,                                           X
               AUTODMP=NO,                                            X
               AUTOIPL=NO,                                            X
               BACKUP=YES,                                            X
               DELAY=0,                                               X
               DUMPDS=DUMPDS,      DUMP DATA SET                      X
               CDUMPDS=CDUMPDS,    CSP DUMP DATA SET                  X
               MDUMPDS=MDUMPDS,    MOSS DUMP DATA SET                 X
               INITEST=NO,         NO 3745 INITIAL TESTS AT LOAD TIME X
               MAXDATA=4302,       = BFRS*TRANSFR - 18                X
               OWNER=HOST2,                                           X
               SUBAREA=4,          HOST SUBAREA                       X
               VFYLM=YES
***********************************************************************
*        BUILD MACRO SPECIFICATIONS                                   *
***********************************************************************
ACFNCPBD BUILD BFRS=(240),         NCP BUFFER SIZE,# EP BUFFERS       X
               BRANCH=1000,                                           X
               CATRACE=(YES,10),                                      X
               CSMHDR=27F5C711C3F0405C40C8C4D9405C,                   X
               CSMHDRC=40E3C5E7E3405C5C,                              X
               CSMSG=5C5C40E5E3C1D440E2C8E4E3C4D6E6D540,              X
               CSMSGC=6040C8C1E240C2C5C7E4D5405C5C,                   X
               DIALTO=60,          WAIT 1 MIN FOR AUTOCALL ANSWER     X
               DR3270=NO,          NO DYNAMIC RECONFIG                X
               DSABLTO=3.0,        TIME TO DETECT DSR DROP            X
               ENABLTO=2.2,        TIME TO DETECT DSR AFTER ENABLE    X
               LOADLIB=NCPLOAD,    LIBRARY FOR ACF/NCP LOAD MODULE    X
               LTRACE=8,           UP TO 8 LINES CONCURRENTLY TRACED  X
               MAXSSCP=8,          NUMBER OF SSCPS IN SESSION         X
               MAXSUBA=63,         MUST BE SAME AS IN ATCSTRXX        X
               MEMSIZE=4M,         AMOUNT OF MEMORY                   X
               MODEL=3745,         3745 MODEL 410                     X
               NETID=BCR1,         3745 MODEL 410                     X
               NEWNAME=DDBLC0,     LOAD MODULE NAME                   X
               PUNAME=DDB,                                            X
               NPA=YES,            NPA WILL NOT COLLECT DATA          X
               OLT=NO,             INCLUDE ONLINE TEST FACILITY-OLTEP X
               PRTGEN=NOGEN,       DON'T PRINT ASSEMBLED STATEMENTS   X
               PWROFF=NO,                                             X
               SLODOWN=15,         SLOWDOWN AFTER 15% BUFFERS AVAIL   X
               SUBAREA=26,         NCP SUBAREA                        X
               TRACE=(YES,10),     10-16 BYTE ADDRESS TRACE ENTRIES   X
               TRANSFR=18,         =(4096+51)/BFRS--ROUNDED UP        X
               TRCPIU=2000,        SIZE OF LINE AND SIT TRACE         X
               TYPGEN=NCP,                                            X
               TYPSYS=MVS,         MVS OPERATING SYSTEM               X
               USGTIER=5,          NCP USAGE TIER - REQUIRED          X
               VERSION=V5R3,                                          X
               XBREAK=NONE
**********************************************************************
**                                                                  **
*        SYSCNTRL OPTIONS - REQUIRED BY VTAM                         *
**                                                                  **
**********************************************************************
         SYSCNTRL OPTIONS=(ENDCALL,MODE,RCNTRL,RCOND,RECMD,RIMM,     X
               SESSION,NAKLIM,LNSTAT,SSPAUSE,XMTLMT,BHSASSC,STORDSP)
**********************************************************************
HOST2    HOST  BFRPAD=0,           VTAM REQUIREMENT FOR OS           X
               INBFRS=18,          INITIAL BUFFERS FOR EACH RECEIVE  X
               MAXBFRU=10,         < BASENO IN IOBUF FOR VTAM        X
               SUBAREA=4,                                            X
               UNITSZ=441          = BUFSIZE IN IOBUF FOR VTAM

HOST1    HOST  BFRPAD=0,           VTAM REQUIREMENT FOR OS           X
               INBFRS=18,          INITIAL BUFFERS FOR EACH RECEIVE  X
               MAXBFRU=10,         < BASENO IN IOBUF FOR VTAM        X
               SUBAREA=3,                                            X
               UNITSZ=441          = BUFSIZE IN IOBUF FOR VTAM
**********************************************************************
*             PATH STATEMENTS                                        *
**********************************************************************
          PATH DESTSA=3,           SYS1                              X
               ER4=(3,1),          SYS1

          PATH DESTSA=4,           SYS2                              X
               ER4=(4,1),          SYS2
********************************************************************
*                                                                  *
*   HOST 1 CHANNEL ADAPTER                                         *
*                                                                  *
*   LINE ADDR = 0; PHYSICAL POSITION = 5.                        *
********************************************************************
DDBCA5   GROUP LNCTL=CA,                                             X
               ISTATUS=INACTIVE    STOP VTAM FROM ACT CHAN LINK

DDBL05   LINE  ADDRESS=0,         1ST CA PHYSICAL POSITION 1         X
               CA=TYPE6,          3745 CHANNEL ADAPTER TYPE          X
               CASDL=120,         TIME ALLOWED TO BLOCK INBOUND DATA X
               DELAY=0,           CHAN ATTN DELAY                    X
               DYNADMP=NONE,      NO EP SUBCHANNELS TO DUMP          X
               INBFRS=18,         # BUFS FOR EACH TRANSFER TO HOST   X
               NPACOLL=YES,       NPA WILL COLLECT DATA ON CHANNEL   X
               TIMEOUT=120        INTERVAL BEFORE CHANNEL DISCONTACT

DDBP05   PU    PUTYPE=5,          INTERMEDIATE SUBAREA FUNCTION      X
               TGN=1              MUST BE 1 FOR PUTYPE5
**********************************************************************
*                                                                    *
*   HOST 2 CHANNEL ADAPTER                                           *
*   LINE ADDR = 2; PHYSICAL POSITION = 7.                          *
**********************************************************************
DDBCA7   GROUP LNCTL=CA,                                             X
               STATUS=INACTIVE    ACT CHAN LINK

DDBL07   LINE  ADDRESS=2,         3RD CA PHYSICAL POSITION 3         X
               CA=TYPE6,          3745 CHANNEL ADAPTER TYPE          X
               CASDL=120,         TIME ALLOWED TO BLOCK INBOUND DATA X
               DELAY=0,           CHAN ATTN DELAY                    X
               DYNADMP=NONE,      NO EP SUBCHANNELS TO DUMP          X
               INBFRS=18,         #BUFS FOR EACH TRANSFER TO HOST    X
               NPACOLL=YES,       NPA WILL COLLECT DATA ON CHANNEL   X
               TIMEOUT=120        INTERVAL BEFORE CHANNEL DISCONTACT

DDBP07 PU      PUTYPE=5,          INTERMEDIATE SUBAREA FUNCTION      X
               TGN=1              MUST BE 1 FOR PUTYPE5