PK89893: EXPORT COMMAND ENTERED CONTAINS AN INVALID KEYWORD. 09/06/26 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The EXPORT command entered contains an invalid keyword,
  RC02000008 and RSN00002028 are returned.
  EXPORT DEFN TARGET(RDDS) RDDSDSN('IMSDEV.RDDS.EXPORT(+0)')
  OPTION(ALLRSP) received the following messages :
  BPE0003E AN ERROR OCCURRED PARSING COMMAND EXP  DEFN
  BPE0003E AT CHARACTER 1
  BPE0003E FAILING TEXT: "TARGET(RDDS) RDD"
  BPE0003E INVALID KEYWORD DETECTED
  *
  This is due to the fact the customer is running IMSPlex with
  mixed IMS Version 10 (one of them have the PK66704 applied,
  the other doesn't).
  In such case, the Grammar picked by OM can be the EXPORT grammar
  before the maintenance.
  

Local fix

• Apply this maintenance to all IMS
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS V10 IMPORT and EXPORT command users.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: If the IMPORT command enabling APAR     *
  *                      (PK66682) and the EXPORT command        *
  *                      enabling APAR (PK66704) are applied     *
  *                      to some V10 IMSs in the IMSplex,        *
  *                      but not all, or if OM is not            *
  *                      recycled after applying the APARs       *
  *                      to each of the V10 IMSs in the          *
  *                      IMSplex, OM may not have the            *
  *                      correct grammar for the IMPORT and      *
  *                      EXPORT commands.  If the IMPORT and     *
  *                      EXPORT commands are entered and OM      *
  *                      has an old version of the grammar,      *
  *                      the commands will fail with a           *
  *                      command syntax error.                   *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  When an IMS comes up in an IMSplex, it registers the grammar
  for the type-1 and type-2 commands it can process with OM.
  OM saves the grammar of the highest level IMS in the
  IMSplex.  The saved grammar is used to parse all commands
  that are issued through OM.  If a new IMS comes up and the
  new IMS is at the same level as the saved grammar, OM
  ignores the passed grammar even though the new grammar may
  be an updated version of the saved grammar.
  
  If the IMPORT command enabling APAR (PK66682) and the EXPORT
  command enabling APAR (PK66704) are applied to some V10 IMSs in
  the IMSplex, but not all, or if OM is not restarted after
  applying the APARs to each of the V10 IMSs in the IMSplex, OM
  may not have the correct grammar for the IMPORT and EXPORT
  commands.  If the IMPORT and EXPORT commands are entered and OM
  has an old version of the grammar OM will reject the commands
  with return code X'02000008', reason code X'00002028', reason
  text "The command entered contains an invalid keyword".
  
  The following are examples of the output displayed by the TSO
  SPOC:
  
  EXPORT DEFN TARGET(RDDS) RDDSDSN(IMS1.NONSYS.RDDS1)
  
  Log for . . : EXPORT DEFN TARGET(RDDS) RDDSDSN(IMS1.NONSYS...)
  
  IMSplex . . . . . : PLEX1
  Routing . . . . . :
  Start time. . . . : 2009.204 11:36:03.48
  Stop time . . . . : 2009.204 11:36:03.49
  Return code . . . : 02000008
  Reason code . . . : 00002028
  Reason text . . . : The command entered contains an invalid ...
  Command master. . :
  
  MbrName  Messages
  -------- -----------------------
  OM1OM    BPE0003E AN ERROR OCCURRED PARSING COMMAND EXP  DEFN
  OM1OM    BPE0003E AT CHARACTER 1
  OM1OM    BPE0003E FAILING TEXT: "TARGET(RDDS) RDD"
  OM1OM    BPE0003E INVALID KEYWORD DETECTED
  
  
  
  IMPORT DEFN SOURCE(RDDS) RDDSDSN(IMS1.NONSYS.RDDS1)
  
  Log for . . : IMPORT DEFN SOURCE(RDDS) RDDSDSN(IMS1.NONSYS.R..)
  
  IMSplex . . . . . : PLEX1
  Routing . . . . . :
  Start time. . . . : 2009.204 11:37:34.54
  Stop time . . . . : 2009.204 11:37:34.56
  Return code . . . : 02000008
  Reason code . . . : 00002028
  Reason text . . . : The command entered contains an invalid ...
  Command master. . :
  
  MbrName  Messages
  -------- -----------------------
  OM1OM    BPE0003E AN ERROR OCCURRED PARSING COMMAND IMP  DEFN
  OM1OM    BPE0003E AT CHARACTER 1
  OM1OM    BPE0003E FAILING TEXT: "SOURCE(RDDS) RDD"
  OM1OM    BPE0003E INVALID KEYWORD DETECTED
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
  A holdcard is being added to explain the process for
  applying the IMPORT command enabling APAR (PK66682) and the
  EXPORT command enabling APAR (PK66704) to the V10 IMSs in an
  IMSplex.
  
  Holdcard Documentation
  ----------------------
  If you have an IMSplex with multiple IMSs and IMS V10 is not
  the highest release of IMS in the IMSplex, the Common
  Service Layer (CSL) Operations Manager (OM) address spaces
  should already have the correct grammar for the IMPORT and
  EXPORT commands.
  
  If you have an IMSplex with multiple IMSs and IMS V10 is the
  highest release of IMS, the IMPORT command enabling APAR
  (PK66682) and the EXPORT command enabling APAR (PK66704)
  must be applied to each of the V10 IMS systems in the
  IMSplex to ensure the OM address spaces obtain the updated
  grammar.  The APARs can be rolled across the V10 IMS
  systems by applying the APARs to one V10 system at a time,
  or they can be applied to all of the V10 IMS systems at
  once, by bringing all of the V10 IMSs down, applying the
  APARs and then bringing all of the V10 IMSs back up.
  
  If the APARs are rolled across the V10 IMS systems, the OM
  address spaces must be recycled after the APARs have been
  applied to all of the V10 IMS systems.  This ensures the OM
  address spaces obtain the updated grammar.  If the OM
  address spaces are not recycled, any IMPORT and EXPORT
  commands that are issued may fail with command syntax
  errors.
  
  If all of the V10 IMS systems in the IMSplex are brought
  down at the same time and then restarted with APARs PK66682
  and PK66704 applied, the OM address spaces do not need to be
  recycled.
  
  Module Changes
  --------------
  DFSRTR20 - Recompile only
  DFSRDD10 - Recompile only
  
  
  Search Strings
  --------------
  CMDEXP CMDIMP EXPORT DEFN IMPORT DEFN EXP DEFN IMP DEFN
  

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:

  UK48863

Modules/Macros

• DFSRDD10 DFSRTR20
  

Fix information

• Fixed component name

  IMS V10

• Fixed component ID

  5635A0100

Applicable component levels

• R010 PSY UK48863

     UP09/08/06 P F908 Ø

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.