II14037: INFO APAR FOR MQLISTENER R810 DB2 INSTALL/MIGRATION <IMPORTANT>

APAR status

• INTRAN

Error description

• --------------------------------------------------------------
  IMPORTANT :  If you are not interested in using MQListener, you
  can EXCLUDE the installation of UQ96672 (PQ80526) and UQ96674
  (PQ79716).
  .
  Please apply UQ96672(PQ80526) before you apply UQ96674(PQ79716).
  After you apply UQ96672(PQ80526), it will create 3 new parts.
  The parts are : (DSNDDEFL, DSNLSMKDand DSNLMKDR)
  ******
  .
  1. Information for PQ80526 :
  Please see section (2) if you are installing MQListener feature
  for the first time. If you have already installed MQListener,
  you may want to look into section (3) for additional
  information.
  .
  2. First time users installing MQListener
  2.1. Create DDDEF Entry
  Edit and submit sample job DSNDDEFL to create DDDEF entry for
  MQListener. If you decide to install the MQListener feature into
  alternate install directory, you will need to modify job
  DSNDDEFL to specify your '-PathPrefix-'. Consult the
  instructions in the sample job for more information.
  .
  2.2. <Recommended> Allocate HFS dataset
  It is recommended that you install MQListener into a newly
  allocated file system instead of installing it into the default
  file system (which may or may not be ROOT file system depending
  upon your site, please see section (4) for more information).
  You can use the following sample JCL to allocate an HFS data
  set. Add a job card and modify the parameters db2mqhlq,
  dasdvol, dunit, and storclas to uppercase values to meet your
  site's requirements before submitting
  .
  //ALLOCHFS    EXEC PGM=IEFBR14
  //SYSPRINT DD SYSOUT=*
  //SDSNHFS  DD DSN=db2mqhlq.SDSNMQL,
  //         DISP=(NEW,CATLG,DELETE),
  //         VOL=SER=dadsvol,UNIT=dunit,
  //         SPACE=(CYL,(11,1,1)),
  //         DSNTYPE=HFS,STORCLAS=storclas
  //*
  .
  where
  db2mqhlq is the high level data set qualifier used for
  MQListener
  dasdvol is the volume serial of the DASD device where the data
  set will reside
  dunit is the DASD unit type of the volume
  storclas is an appropriate SMS storage class defined on your
  system.
  NOTE : It is highly recommended to install MQListener in a new
  file system.
  .
  2.3. Create the Hierarchical File System Structure
  Before SMP/E can install MQListener you have to create the
  directory skeleton in your HFS.
  " Using the TSO MKDIR command, create the following directory:
  DB2 V7 :
  TSO MKDIR '-PathPrefix-/usr/lpp/db2mql710'
  MODE(7 5 5)
  .
    DB2 V8 :
    TSO MKDIR '-PathPrefix-/usr/lpp/db2mql810'
    MODE(7 5 5)
  .
  * NOTE :
  1. The spaces in MODE(7 5 5 ) are important.
  2. If you are installing into the default installation
  directory, do not specify a value for '-PathPrefix-'. Ensure
  that the HFS path '/usr/lpp' already exists. If not, you have to
  create /usr/lpp directory first before issuing the above MKDIR
  command.
  3. If you are installing into alternate installation directory,
  specify the value for -PathPrefix- (ex. /u/USER). Ensure that
  the HFS path '-PathPrefix-/usr/lpp' already exists. If not, you
  have to create '-PathPrefix-/usr/lpp' directory first before
  issuing the above MKDIR command.
  .
  2.3.1. <Recommended> Mount the file system for MQListener
  If you have decided to install MQListener into a separate file
  system instead of installing into the default file system, mount
  the new HFS data set created in step 2.2  (<Recommended>
  Allocate HFS dataset), to the MQListener HFS install mount
  point. Issue the following command (it must be on one line ) :
  .
  DB2 V7 :
  TSO MOUNT FILESYSTEM('db2mqhlq.SDSNMQL')
  MOUNTPOINT('-PathPrefix-/usr/lpp/db2mql710') TYPE(HFS)
  .
  DB2 V8 :
  TSO MOUNT FILESYSTEM('db2mqhlq.SDSNMQL')
  MOUNTPOINT('-PathPrefix-/usr/lpp/db2mql810') TYPE(HFS)
  .
  where
  db2mqhlq is the high level data set qualifier used in step 2.2
  -PathPrefix- is the value you have chosen for your alternate
  installation directory. If you have chosen the default
  installation directory, do not specify a value for -PathPrefix-.
  After mounting the new HFS dataset, it is necessary to re-apply
  the directory permission bits. This may be accomplished using
  the following TSO command :
  .
  DB2 V7 :
  TSO OSHELL chmod 755
  -PathPrefix-/usr/lpp/db2mql710
  .
  DB2 V8:
  TSO OSHELL chmod 755
  -PathPrefix-/usr/lpp/db2mql810
  NOTE : You should update the appropriate BPXPRMxx member in your
  system parmlib to contain the mount from step(2.3.1). This
  ensures that the mount will still be effective after an IPL.
  .
  2.4. Create MQListener HFS directory structure
  Edit and submit job DSNLSMKD to create the MQListener
  installation HFS directory structure. If you decided to install
  the MQListener feature into an alternate install directory, you
  will need to modify job DSNLSMKD to specify your -PathPrefix-.
  Consult the instructions in the sample job for more information.
  DSNLSMKD must be run by a USERID that is UID=0, or is the owner
  of MQListener install directory
  .
  DB2 V7 : '-PathPrefix-/usr/lpp/db2mql710'
  DB2 V8 : '-PathPrefix-/usr/lpp/db2mql810'
  .
  Expected Return Codes and Messages : DSNLSMKD should complete
  with return code 0.
  .
  3. Existing users who have previously installed MQListener
  You may have installed MQListener in default or alternate
  install directory, but it is important to check the file system
  under which MQListener physically resides. If MQListener is
  installed in default file system (which may or may not be ROOT
  file system depending upon your site, please see section (4) for
  more information), then you may consider moving the MQListener
  install into a separate file system.
  .
  Please follow the following steps to move MQListener from
  default file system to a new file system :
  .
  3.1. Allocate HFS data set
  You can use the following sample JCL to allocate an HFS data
  set. Add a job card and modify the parameters db2mqhlq, dasdvol,
  dunit, and storclas to uppercase values to meet your site's
  requirements before submitting.
  //ALLOCHFS    EXEC PGM=IEFBR14
  //SYSPRINT DD SYSOUT=*
  //SDSNHFS  DD DSN=db2mqhlq.SDSNMQL,
  //         DISP=(NEW,CATLG,DELETE),
  //         VOL=SER=dadsvol,UNIT=dunit,
  //         SPACE=(CYL,(11,1,1)),
  //         DSNTYPE=HFS,STORCLAS=storclas
  //*
  where
  db2mqhlq is the high level data set qualifier used for
  MQListener
  dasdvol is the volume serial of the DASD device where the data
  set will reside
  dunit is the DASD unit type of the volume
  storclas is an appropriate SMS storage class defined on your
  system.
  .
  3.2. Create a temporary directory
  Using the TSO MKDIR command, create the following temporary
  directory :
  .
  TSO MKDIR '/tmpmql' MODE(7 5 5)
  .
  3.3. Mount the new file system for MQListener to a temporary
  point
  Mount the new HFS data set created in step 3.1  (Allocate HFS
  dataset), to the temporary HFS install mount point. Issue the
  following command (it must be on one line ) :
  TSO MOUNT FILESYSTEM('db2mqhlq.SDSNMQL')
  MOUNTPOINT('/tmpmql') TYPE(HFS)
  where
  db2mqhlq is the high level data set qualifier used in step 3.1
  .
  3.4. Copy the complete MQListener directories, sub-directories
  and files to the temporary directory
  Issue the following TSO command :
  TSO OSHELL /samples/copytree source-directory /tmpmql
  where
  source-directory is the complete HFS path where MQListener is
  currently installed
  .
  Example : If MQListener is installed under default directory
  /usr/lpp/db2mql710, then invoke the command as :
  .
  TSO OSHELL samples/copytree /usr/lpp/db2mql710 /tmpmql
  .
  3.5. Delete all the files/sub-directories under the directory
  where MQListener is currently installed
  IMPORTANT : Ensure that the copytree command was successful in
  step 3.4 and that all the files/sub-directories have been copied
  to the /tmpmql directory.
  .
  Issue the following command to open a USS session :
  TSO OMVS
  .
  At the USS prompt, issue the following command to change the
  current working directory to the path where MQListener is
  currently installed :
  cd source-directory
  where
  source-directory is the complete HFS path where MQListener is
  currently installed.
  .
  Example : If MQListener is installed under default directory
  /usr/lpp/db2mql710, then invoke the command as :
  cd /usr/lpp/db2mql710
  .
  At the USS prompt, issue the following command to ensure that
  you are in correct working directory :
  pwd
  .
  WARNING : Make sure that you are in correct working directory
  before you issue the following command to delete all the
  files/sub-directories :
  rm -ir source-directory/*
  .
  This command will remove the contents of the directories
  recursively and will ask permission before removing anything.
  Review the file name that is being deleted and answer 'y' to the
  prompt.
  Example : If MQListener is installed under default directory
  /usr/lpp/db2mql710, then invoke the command as :
  cd /usr/lpp/db2mql710
  rm -ir /usr/lpp/db2mql710/*
  .
  At the USS prompt, issue the following command to close the USS
  session :
  exit
  .
  3.6. Change the temporary mount point to the correct MQListener
  mount point
  .
  1. Issue the following TSO command to UNMOUNT the HFS dataset
  mounted at temporary mount point :
  TSO UNMOUNT FILESYSTEM('db2mqhlq.SDSNMQL')
  .
  2. Issue the following TSO command to MOUNT the HFS dataset to
  the mountpoint where MQListener was installed
  TSO MOUNT FILESYSTEM('db2mqhlq.SDSNMQL')
  MOUNTPOINT('source-directory') TYPE(HFS)
  .
  where
  source-directory is the complete HFS path where MQListener is
  installed.
  .
  Example : If MQListener is installed under default directory
  /usr/lpp/db2mql710, then invoke the command as :
  TSO MOUNT FILESYSTEM('db2mqhlq.SDSNMQL')
  MOUNTPOINT('/usr/lpp/db2mql710') TYPE(HFS)
  .
  NOTE : You should update the appropriate BPXPRMxx member in your
  system parmlib to contain the mount from step(2). This ensures
  that the mount will still be effective after an IPL.
  .
  3.7. Delete the temporary directory
  Issue the following command to delete the temporary directory
  created during step 3.2 :
  TSO OSHELL rmdir /tmpmql
  .
  4. ROOT file system
  It is important to note that all directories and files that are
  created in ROOT file system are lost whenever maintenance is
  applied to change the base level of the z/OS operating system.
  It is therefore always advisable to install HFS features in
  non-root file system to prevent data loss stemming from
  operating system level changes.
  .
  Follow the following instructions to determine the file system
  (HFS data set) where the specified directory/file physically
  resides :
  1. Open a ISHELL command window. ISHELL invokes the z/OS ISPF
  shell, a panel interface that helps you to set up and manage
  z/OS UNIX System Services functions. Issue the following command
  TSO ISHELL
  2. Type in the complete pathname of the directory/file you are
  interested to determine the file system where it resides. For
  example, you can type in "/" to determine the ROOT file system.
  To determine the file system for MQListener, type in the
  complete path where MQListener is installed. Example : If
  MQListener is installed in default install path, type
  /usr/lpp/db2mql710
  .
  3. Expand the 'File' pulldown and select option 15 'File
  System(U)'. It displays the attributes of the file system the
  file system the specified directory/file is in
  .
  Use the above approach to verify that MQListener is not
  installed in ROOT file system
  COMPID 5740XYR00 DB2 MQL
  

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels