OA66824: INCREASE SUPPORTED LENGTH FOR MSGID IN MRT AND PIPE EDIT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The maximum length supported for MSGID in the message revision
  table (MRT) and PIPE EDIT is 12 characters and needs to be
  increased.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IBM Z NetView 6.4 users of the following *
  *                 functions:                                   *
  *                 * The MSGID EDIT orders of the following:    *
  *                   * The PIPE EDIT stage                      *
  *                   * Automation Table ACQUIRE                 *
  *                   * Automation Table EDIT                    *
  *                   * Sample CNMSELTE                          *
  *                   * The WHEN and REVISE statements of the    *
  *                     Message Revision Table                   *
  *                 * The WHEN, REVISE, and WTO statements of    *
  *                   the Command Revision Table                 *
  *                 * The MSGID and PREFIX keywords of the       *
  *                   Message Revision Table UPON statement      *
  *                 * The CMDVERB EDIT order of the WHEN,        *
  *                   REVISE, and WTO statements of the Command  *
  *                   Revision Table                             *
  *                 * The CMDVERB and CMDSQZD keywords of the    *
  *                   Command Revision Table UPON statement      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Currently, the MSGID EDIT order, the    *
  *                      MSGID and PREFIX keywords of the        *
  *                      Message Revision Table UPON statement,  *
  *                      the CMDVERB EDIT order, and the CMDVERB *
  *                      and CMDSQZD keywords of the Command     *
  *                      Revision Table UPON statement are all   *
  *                      limited to a length of 12 characters.   *
  ****************************************************************
  The MSGID and CMDVERB EDIT orders will read the first blank- or
  comma-delimited word of a message or command string,
  respectively, up to a maximum length of 12 characters. To
  complement this, the MSGID and PREFIX keywords of the Message
  Revision Table UPON statement, and the CMDVERB and CMDSQZD
  keywords of the Command Revision Table UPON statement, allow for
  a delimited string length of up to 12 characters. However,
  several non-IBM products can issue messages whose IDs are
  potentially much longer.
  

Problem conclusion

Temporary fix

Comments

• The functions described previously are all being changed to
  allow for a maximum length of 32 characters.
  
  The following parts are being updated to implement this change:
  Macro (included in compiled parts): DSIRVTBL
  Modules: CNMCPCMW, CNMCRVCE, CNMCRVMG, DSIPIED
  Modules (recompile only): CNMCPCMR, CNMCRRVR, CNMCRSET,
    CNMCRVCM, CNMCRVED, CNMCRVLD, DSIMSSI, DSIPIRVR, DSIRVMC,
    DSIRVRPT, DSIRVSET, DSIRVSPS, DSIRVSVC, DSIRVSVD, DSIRVTC,
    DSIRVTL
  The description of the PIPE EDIT command is being updated in the
  English and Japanese versions of part EUYPIEXE to reflect what
  is described below for the IBM Z NetView Programming: Pipes
  publication.
  
  The following changes should be made to the IBM Z NetView 6.4
  documentation:
  IBM Z NetView 6.4 Automation Guide, SRL SC27-2846-06
  ----
  * Chapter: Message Revision Table
    * Section: What Is the Message Revision Table?
      Subsection: Elements of Message Revision Table Statements
      - Remove this bullet point (OTHERWISE is covered by WHEN in
        a later point):
        "Use the OTHERWISE statement ("OTHERWISE Statement" on
        page nnn) to provide for NetView program automation, but
        suppress display, logging, and sysplex routing."
    * Section: UPON Statement
      - This bullet point:
        "MSGID, which can be in the range of 1 - 12 characters"
        Should read:
        "MSGID, which can be in the range of 1 - 32 characters"
      - This bullet point:
        "PREFIX, which can be in the range of 1 - 12 characters"
        Should read:
        "PREFIX, which can be in the range of 1 - 32 characters"
  * Chapter: Command Revision Table
    * Section: Command Revision Table Statements
    * Subsection: UPON Statement
      - Reword the first part of the section (up to the sentence
        "The UPON statement uses the following syntax:") to read
        as follows:
  -
  An UPON statement is a top-level conditional statement that
  introduces each section. There are five types of conditions:
  * CMDCONS, which can be in the range of 1 - 8 characters
  * CMDVERB, which can be in the range of 1 - 32 characters
  * CMDSQZD, which can be in the range of 1 - 32 characters
  * OTHERCMDS
  * ALLCMDS
  They are tested in the order listed here and the CMDCONS,
  CMDVERB, and CMDSQZD conditions are always compared with a
  literal. Longer CMDSQZD strings are examined before shorter
  ones.
  Examples of the conditions are listed as follows:
  UPON(CMDCONS = 'ROOT')
  UPON(CMDVERB = 'M' | CMDVERB = 'MOUNT')
  UPON(CMDSQZD = '$PJQ')
  -
      - Below the syntax diagram, the description of the following
        keywords should read as follows:
        CMDVERB = 'first_token'
          Value of the first token delimited by a blank or comma,
          which can be in the range of 1 - 32 characters.
        CMDSQZD = 'initial_string'
          The first part of the command with all blanks, commas,
          equal signs, and left and right parentheses removed is
          compared with the specified string. The string may be
          from 1 - 32 characters in length.
          SQUEEZE is a synonym for CMDSQZD.
      - Reword Usage Note #8 to read as follows:
          "SQUEEZE is a synonym for CMDSQZD. OTHERCMD is a synonym
          for OTHERCMDS. ALLCMD is a synonym for ALLCMDS."
    * Subsection: Edit Orders
      - Add the following edit order to the table titled "Edit
        Orders":
        Edit Order    Description
        CMDVERB       Inputs the first token of the command text
                      delimited by a blank or comma, up to 32
                      characters.
    * Section: Command Revision Table Example
      - Reword the first line:
        "This is an example of a CRT (CNMSCRT1 sample):"
        to the following:
        "This is an example of a CRT:"
  * Chapter: Automation Table
    * Section: Condition Items
      - After the table titled "If Condition Items for Messages
        and MSUs", under statement "This is an alphabetical list
        of the condition items."
        Under the "TEXT [(pos [len])]" description, this sentence:
        "Specifies the text of the received message. TEXT is a
        1-25 character string that contains the entire message
        text, including the MSGID."
        Should be changed to:
        "Specifies the text of the received message. TEXT is a
        1-255 character string that contains the entire message
        text, including the MSGID."
  
  IBM Z NetView 6.4 Programming: Pipes, SRL SC27-2859-08
  ----
  * Chapter: Pipeline Stages and Syntax
    * Section: PIPE EDIT
      - In the Input Order syntax diagram, add an item for
        CMDVERB.
      - In the table titled "Input Order Summary", add an entry
        for CMDVERB:
        Input Order   Task Performed
        CMDVERB       The first token delimited by a blank or
                      comma, up to 32 characters.
      - In the table titled "Supported environments for EDIT
        orders", add an entry for CMDVERB, and place an X in the
        column titled "CRT REVISE and WHEN".
    * Subsection: Input Orders
      - Under item "msgattr (input order)"
        Under the MSGID description, the first sentence:
        "The message identifier of the received message. MSGID is
        a character ID of up to 12 characters."
        Should be changed to:
        "The message identifier of the received message. MSGID is
        a character ID of up to 32 characters."
      - Add a description for CMDVERB:
        CMDVERB (input order)
          Inputs the first token of the command text delimited by
          a blank or comma, up to 32 characters.
  

APAR Information

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

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

  UJ96405 UJ96406 UJ96407

Modules/Macros

• CNMCPCMR CNMCPCMW CNMCRRVR CNMCRSET CNMCRVCE CNMCRVCM CNMCRVED
  CNMCRVLD CNMCRVMG DSIMSSI  DSIPIED  DSIPIRVR DSIRVMC  DSIRVRPT
  DSIRVSET DSIRVSPS DSIRVSVC DSIRVSVD DSIRVTC  DSIRVTL  EUYPIEXE
  

Fix information

• Fixed component name

  NETVIEW FOR Z/O

• Fixed component ID

  5697NV600

Applicable component levels

• R40B PSY UJ96405

     UP24/12/10 P F412

• R40E PSY UJ96406

     UP24/12/10 P F412

• R40J PSY UJ96407

     UP24/12/10 P F412

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.