DB2 Server for VM: System Administration


Installing and Removing the DRDA Code

Installing the DRDA code is an optional customization step that follows either installation or migration. You install it:

You can remove the DRDA code if it is no longer required.

When the DRDA code is installed on the application server, access from DB2 Server for VM and non-DB2 Server for VM application requesters is allowed.

Do not install the DRDA code unless it is specifically required, as the additional code required for distributed communications requires a significant amount of storage. For details on virtual storage requirements, see Appendix A, Virtual and Real Storage Requirements.

Steps to Install or Remove the DRDA Code

To install (or remove) the DRDA code, perform the following steps on the database machine and installation user ID:

  1. Log on to the database machine (SQLMACH).
  2. Stop the application server using your normal operating procedures.
  3. Ensure that the database machine production disk and service disk are linked in write mode. If not, enter:
         LINK machid 195 195 W
         LINK machid 193 193 W
    
  4. Access the production disk with file mode Q and the service disk with file mode V.
         ACCESS 195 Q
         ACCESS 193 V
    

    If you are using SFS directories instead of minidisks, access them with file modes Q and V.

  5. Run the ARISDBMA EXEC to identify whether you want application server or application requester DRDA code installed on your production disk. Its syntax is:



    >>-ARISDBMA----DRDA(-+-ARAS-+--=-+-Y-+--)----------------------><
                         +-AR---+    '-N-'
                         '-AS---'
     
    

    Specify any of the following combinations of parameters:

    ARAS=Y
    Install the DRDA code for both the application server and application requester (this is the default).

    ARAS=N
    Remove the DRDA code from both the application server and application requester.

    AR=Y
    Install the DRDA code for the application requester.

    AR=N
    Remove the DRDA code from the application requester.

    AS=Y
    Install the DRDA code for the application server.

    AS=N
    Remove the DRDA code from the application server.

    For example, to identify that you want to install the DRDA code on the application server and remove it from the application requester, type:

         ARISDBMA DRDA(AS=Y)
         ARISDBMA DRDA(AR=N)
    
  6. Log off the database machine.
  7. Log on to the DB2 Server for VM installation user ID, 5697F42S

    You should have read access to the VMSES/E code (MAINT 5E5 disk) and read/write access to the Software Inventory disk (MAINT 51D) or SFS directory.

  8. Establish the access order.
    vmfsetup 5697F42S {DB2VM|DB2VMSFS}
    

    5697F42S is the PPF that was shipped with the product. If you have your own PPF override, substitute that name for 5697F42S shown in this command. You also need to substitute your PPF name in the VMSES/E commands in any subsequent steps.

    Use DB2VM for installing on minidisks or DB2VMSFS for installing in Shared File System directories.

  9. Rebuild DB2 Server for VM ARISQLLD LOADLIB.
    1. Rebuild the ARISQLLD LOADLIB.
      vmfbld ppf 5697F42S {DB2VM | DB2VMSFS} ARIBLLLD (all
      vmfview build
      

      Use DB2VM for installing on minidisks or DB2VMSFS for installing in Shared File System directories.

      ARIBLLLD is the name of the VMSES/E build list used to build the ARISQLLD LOADLIB.

      Review the build message log ($VMFBLD $MSGLOG). If necessary, correct any problems before you continue. Use the PF2 key, ALL, to review all of the messages.

      Notes:

      1. The following message is normal if you are NOT running DB2 Server for VM with the CHANGE TO PERFF:
        VMFLLB2074I Part xxxxxxx TXT in object ARISQLDS
                    in build list ARIBLLLD
                    EXEC will be ignored
        

      2. The following message is normal if you are NOT running DB2 Server for VM with the DRDA application server support:
        VMFLLB2074I Part xxxxxxx TXT in object ARIXRDS
                    in build list ARIBLLLD
                    EXEC will be ignored
        

      3. The following message is normal if you are NOT running DB2 Server for VM with the DRDA application requester support:
        VMFLLB2074I Part xxxxxxx TXT in object ARIRVMRM
                    in build list ARIBLLLD
                    EXEC will be ignored
        
    2. Build the related files.
      vmfbld ppf 5697F42S {DB2VM | DB2VMSFS} (serviced
      vmfview build
      

      Use DB2VM for installing on minidisks or DB2VMSFS for installing in Shared File System directories.

      Review the build message log ($VMFBLD $MSGLOG). If necessary, correct any problems before you continue.

  10. Link and access the database machine user ID production and service disks or SFS directories.
    link SQLMACH 195 295 MR
    acc 295 l
    link SQLMACH 193 293 MR
    acc 293 m
    

    You will be prompted for the password to the disks.

    Substitute your minidisk addresses, if different. Substitute in the appropriate SFS directory names. You also need to substitute your minidisk address and SFS directory names in the VMSES/E commands in any subsequent steps.

  11. Copy the new ARISQLLD LOADLIB to SQLMACH's production and service disk or directory.
    1. If installing on minidisks, enter the following commands:
      access 195 i
      vmfcopy arisqlld L* i = = l (prodid 5697F42S%DB2VM olddate replace
      access 193 j
      vmfcopy arisqlld L*  j = = m (prodid 5697F42S%DB2VM olddate replace
      

      The VMFCOPY command updates the VMSES PARTCAT file on the production disk (195) and the service disk (193).

    2. If installing using Shared File System, enter the following commands:
      access 5697F42S.sql.production i
      access SQLMACH.sql.production l
      vmfcopy arisqlld L*  i = = l (prodid 5697F42S%DB2VM olddate replace
      access 5697F42S.sql.service j
      access SQLMACH.sql.service  m
      vmfcopy arisqlld L*  j = = m (prodid 5697F42S%DB2VM olddate replace
      

      The VMFCOPY command updates the VMSES PARTCAT file.

  12. If you previously stored any DB2 Server for VM components in saved segments, you should resave them (refer to Step 11. Prepare to Build the DB2 Server for VM Segments through Step 15. Create a Bootstrap Package in Chapter 8, Saved Segments). In Step 14. Build the DB2 Server for VM Segments on the VMFBLD command, use the "(add" option rather than the "(serviced" option.

    The sizes of the resource adapter and RDS increase with the DRDA code installed. If you need to increase the size of any of the saved segments, you must run VMFSGMAP to redefine the segment (see Step 4. Prepare to Add DB2 Server for VM Segment Definitions).

  13. Log off the installation user ID.
  14. You must define a CMS communications directory to access a remote application server through the VTAM product. For more information, see Setting Up the CMS Communications Directory.
  15. Log on the database machine and restart the application server in multiple user mode with the required PROTOCOL parameter.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]