COMM-PRO

HNAS V2R4M0 - 2014-201y
MAINTENANCE SUMMARY

(Refresh/Upgrade maintenance is currently available directly from Comm-Pro or their agents)

The individual APAR hyperlink *.ZIP files provide all of the necessary SRC (source) and OBJ (object) updates for the respective PTF.  Most APARs have  PREREQ(S) as designated in the APAR memos (multiple APAR PTF's may be required to install a particular APAR PTF).  If a product refresh or upgrade is required you will need to contact your HNAS support representative to order the appropriate edistribution.  HNAS product edistributions are provided via our ftp server and build as requested (e-mail attachment can also be provided upon special request).  We suggest that you contact your HNAS support representative to request that an FTP userid account be set-up for your organization if you haven't already done so.

HNAS V2R4M0 APAR Summary Matrix

              Please refer to the X.25 HostNAS (HNAS) Product Notices web page
              section HNAS V2R4M0 - Release Status for additional information.

201n-mm-dd  - APAR 240nnnn  (was problem 200n---A ) -or- (was unpublished problem 200n___A)

       APAR:  240nnnn_P  
     STATUS:  PENDING
     
         END: 

2017-03-15  - APAR 2400114

       APAR:  2400114_R  
     STATUS:  CLOSED
  OPEN_DATE:  2017-01-26
 CLOSE_DATE:  2017-03-10
 SERVICE(S):  Virtual Memory Allocation Services
  MANDATORY:  YES, for improved HNAS memory usage
 ORIGIN/REF:  240_CSP
     CPTECH:  SFD
  PTF_CLASS:  STANDARD-APAR
   PTF_TYPE:  REFRESH required
    PTF_LOC:  N/A - Order Refresh or Upgrade edistribution
   COREQ(S):  N/A
  PREREQ(S)   Previous distribution at APAR level 2400113.
 SUPERSEDES:  N/A
  OBJECT(S):  NASUTIL
  SOURCE(S):  N/A

   OVERVIEW:  An 878-10 ABEND can occur in IBM's console modify
              interface service routine (IEE0403D) when it asks
              for workarea memory and none is available below the
              16MB boundary.

    PROBLEM:  Note that this ABEND has occurred only once since HNAS
              was deployed.  It occurred due to an unusual set of
              circumstances at a customer site where the amount of
              memory below the 16MB boundary in subpool 229 was
              depleted because most of it was being used by the HNAS
              trace table.  The customer had coded TRCLMT=256000.

DESCRIPTION:  HNAS uses the IBM Modify Interface (/f hnasname,command)
              to process console commands.  As part of this command
              processing, HNAS hands off execution to the IBM QEDIT
              macro processor (SVC 34) to release the Console
              Information Block (CIB) that is associated with a new
              console command.  The QEDIT service routine attempts
              to allocate a workarea in the z/OS low memory area
              which resides below 16MB.  If the required memory is
              not available, the QEDIT routine ABENDs with 878-10.

   SOLUTION:  HNAS has been modified so that all memory allocation
              will be requested from above the 16MB boundary when
              APFMEMSP=(sp1,...spn) is specified unless the subpool
              memory is unavailable.  Only when >16MG memory is
              unavailable will <16MB memory be used.  Since all HNAS
              virtual memory resides above the 16MB boundary, enough
              memory below 16MB should always be available for the
              QEDIT service routine to prevent the 878-10 ABEND.

CIRCUMVENTION: A workaround for the customer was to code TRCLMT=64000.
               Since the solution to this problem causes all HNAS
               storage areas to be allocated above the 16MB boundary,
               the TRCLMT change is not required.

 APPLY_INFO:  See Chapter 6 (Product Maintenance Installation
              section) from the HNAS Guide and Reference Manual
              for instructions on how to install PTF's (Object,
              Source and ZAPs) or Refresh/Upgrade maintenance.

              Corrective logic included in distributions created
              after CLOSE_DATE.  Otherwise, apply maintenance as
              directed in the APPLY_INFO (PTF).

2015-10-30  - APAR 2400113  (was not assigned a problem number)

       APAR:  2400113
     STATUS:  CLOSED
  OPEN_DATE:  2015-10-27
 CLOSE_DATE:  2015-10-30
 SERVICE(S):  Trace Trap (TRCTRAP), TCPIP Error Message, and DNAS
              Authorization File support
  MANDATORY:  YES, for improved message processing and debugging
 ORIGIN/REF:  240_GAD, CSP_240, 240_CPT
     CPTECH:  SFD
  PTF_CLASS:  STANDARD-APAR with diagnostic ENHANCEMENTs
   PTF_TYPE:  REFRESH required
    PTF_LOC:  N/A - Order Refresh or Upgrade edistribution
              FTP Server Directory /hnas_maint/hnas240m/apars/
              (Complete FIX is contained in the 2400nnn.ZIP file
              for non-SMP/E environments). Individually packaged
              SMP/E PTFs are no longer provided, order a HNAS
              Refresh/Upgrade edistribution to implement.
   COREQ(S):  N/A
  PREREQ(S)   Previous distribution at APAR level 2400107 or above.
 SUPERSEDES:  N/A
  OBJECT(S):  N/A
  SOURCE(S):  N/A

   OVERVIEW:  Trace Trap (TRCTRAP) decoding, TCPIP Error Message
              generation and DNAS Authorization File processing
              modified for improved debugging and troubleshooting.

    PROBLEM1: The ALRMLIST=(msgid/msgdata/msgoff) operand of the
              TRCTRAP CDF operand and the TRCTRAP console command
              did not allow msgdata to be specified as a quoted
              string, i.e., as '...text...'.  APAR 2400108 was
              designed to fix this problem but string parsing that
              was added for the TRCTRAP console command did not
              account for spaces in the quoted string.

DESCRIPTION1: If msgdata contains space characters, they are being
              treated as a delimiter making the data that follows
              being treated as an invalid command suboperand.  This
              causes the entire ALRMLIST value to be ignored and an
              error condition to be set.  For example, when the
              following TRCTRAP console command is entered:

              TRCTRAP ALRMLIST=(NAS3799I/' DIAG=000/195')

              the following error message is issued and the request
              is rejected:

              NASC532E PARAMETER DATA INVALID: S3799I/' DIAG=00...,
                       TRCTRAP  COMMAND ABORTED

              This is occurring because msgdata=' DIAG=000/195'
              contains a space character making the DIAG=000/195 text
              that follows the space treated as extraneous input.
              Since the TRCTRAP command processor does not recognize
              input after a delimiter, the command is rejected.

   SOLUTION1: The TRCTRAP console command processor has been modified
              to accept spaces within quoted string for the msgdata
              suboperand of the ALRMLIST operand.  Now, ALL data
              within a quoted string is treated as a complete
              character string.  For the following TRCTRAP command:

              TRCTRAP ALRMLIST=(NAS3799I/' DIAG=000/195')

              the space at the beginning of the quoted string is no
              longer treated as an operand delimiter but as part of
              the msgdata suboperand.

              Note1: If msgdata does not contain spaces or a forward
                     slash, it does not have to be specified within
                     quotes, but can be if you wish.  ABCDEF and
                     'ABCDEF' are treated the same.

              Note2: msgdata may not include embedded quotes.  For
                     example, ABC'DEF or ABC''DEF or 'ABC'DEF' or
                     'ABC''DEF' are not permitted.

CIRCUMVENTION1: N/A

    PROBLEM2: WTO data can be truncated if it is longer than 105
              characters in length.

DESCRIPTION2: A number of TCPIP WTOs contain data that are as much
              as 123 characters in length.  The WTOXLT subroutine,
              which is called to copy/translate WTO text when the
              ALRMSGTXT=SHORT operand is specified for a WTO and the
              SHOWCMSG start parameter is in effect, uses a workarea
              that is 105 characters in length.  This results in a
              truncated message.  When the SHOWCMSG start parameter
              is not specified, the WTO copy/translate function is
              not performed so that the original WTO is sent as is.

   SOLUTION2: The WTOXLT subroutine has been modified to use a larger
              workarea to perform the copy/translate function.

CIRCUMVENTION2: N/A

    PROBLEM3: When an Authorization Failure occurs at HNAS startup,
              an error message is issued and then HNAS ABENDs before
              a DNAS command can be issued.

DESCRIPTION3: While the ABEND dump will contain the information that
              caused the Authorization Failure, it is much easier to
              diagnose if a DNAS command is executed before the ABEND.

   SOLUTION3: HNAS has been modified to allow the CDF to be scanned
              and the initial DNAS command to be executed before the
              forced ABEND for the Authorization Failure.

CIRCUMVENTION3: N/A

    PROBLEM4: DNAS display output does not provide information as to
              where the edistribution product was actually created.

DESCRIPTION4: Line 4 of the DNAS display output provides the z/OS
              level of the system under which the HNAS product was
              created, which can be a variety of z/OS levels that
              have no effect on the edistribution. We are changing
              the display to reflect the SITEID which provides
              Comm-Pro with more relevant information concerning
              the environment where the edistribution was created.

              New Format:

              HNAS PRODUCT CREATED AT COMM-PRO DEVELOPMENT SITE #2

              Old Format:

              HNAS PRODUCT CREATED UNDER z/OS 01.11.00

   SOLUTION4: DNAS Display message line 4 changed to provide more
              accurate content for Comm-Pro as to where the HNAS
              Product was generated for customer edistributions.

CIRCUMVENTION4: N/A


 APPLY_INFO:  See Chapter 6 (Product Maintenance Installation
              section) from the HNAS Guide and Reference Manual
              for instructions on how to install PTF's (Object,
              Source and ZAPs) or Refresh/Upgrade maintenance.

              Corrective logic included in distributions created
              after CLOSE_DATE.  Otherwise, apply maintenance as
              directed in the APPLY_INFO (PTF).

2014-11-13  - APAR 2400112  (was not assigned a problem number)

       APAR:  2400112
     STATUS:  CLOSED
  OPEN_DATE:  2014-11-07
 CLOSE_DATE:  2014-11-13
 SERVICE(S):  DATAFONO
  MANDATORY:  RECOMMENDED if Datafono resources
 ORIGIN/REF:  240_UBS
     CPTECH:  PRT
  PTF_CLASS:  STANDARD-APAR
   PTF_TYPE:  (OBJ) HNASOBJX
    PTF_LOC:  FTP Server Directory /hnas_maint/hnas240m/apars/
              (Complete FIX is contained in the 2400112.ZIP file)
              SMP/E PTFs are provided via user request because the
              Comm-Pro supplied MCS is unique to each customer.
   COREQ(S):  N/A
  PREREQ(S):  Distribution dated after: 2008-12-12 (2400084)
 SUPERSEDES:  N/A
  OBJECT(S):  CONSDMAP
  SOURCE(S):  N/A

   OVERVIEW:  HNAS SOC4 ABEND occurred after customer replaced the
              HNAS Datafono Translate table XAICDTFT with a newer
              version without ENTRY statements revealing a bug in
              our code.

    PROBLEM:  At a customer site, HNAS ABENDs with 0C4 during startup
              while processing an internal DMAP ALL APAR console
              command.

DESCRIPTION:  During HNAS startup, an internal DNAS ALL APAR console
              command is executed to populate the global APAR table.
              Each executable module in HNAS must start with an XFIDR
              macro call with TYPE=CSECT except XFCNFGWA, XFNASWA and
              and XAICDTFT.  The XFIDR call creates a record at module
              entry that contains (among other things) the module's
              length.  This length is used to locate the module's APAR
              list at the end of the module.  Since the 3 modules just
              mentioned are non-executable, there is no APAR list at
              their ends.  CONSDMAP specifically looks for XFCNFGWA and
              XFNASWA when creating its module decode list table and
              flags these modules as NOT having an XFIDR record at their
              entry.  This prevents the DMAP ALL APAR command processor
              from looking for an APAR list at the module's end.  The
              problem is that CONSDNAS does not also flag XAICDTFT the
              same way and thus it is treated as an executable module.
              Hence, the DMAP display logic attempts to find an APAR
              list at the end of XAICDTFT using, what it thinks, is a
              fullword module length at offset X'28' in XAICDTFT.
              For the XAICDTFT module, offset X'28' is part of a
              translate table.  For the Comm-Pro distributed version
              of XAICDTFT, this length value is 00000000.  At the
              customer site, it is 00030303 because the customer had
              modified the translate table.  This resulted in a segment
              translation exception (ABEND 0C4-10).

   SOLUTION:  CONSDMAP has been modified to test for XAICDTFT when it
              also looks for XFCNFGWA and XFNASWA to it can be flagged
              as a non-executable module.

CIRCUMVENTION: N/A

 APPLY_INFO:  See Chapter 6 (Product Maintenance Installation
              section) from the HNAS Guide and Reference Manual
              for instructions on how to install PTF's (Object,
              Source and ZAPs) or Refresh/Upgrade maintenance.

              Corrective logic included in distributions created
              after CLOSE_DATE.  Otherwise, apply maintenance as
              directed in the APPLY_INFO (PTF).

Last Update - March 20, 2017