PQ21120: MSGEQQTX91E ISSUED IF ' EQQSHELL=%COMSPEC% ' IS CODED IN STARTUPPARMS FOR A WINDOWS NT TRACKER AGENT.

APAR status

• Closed as documentation error.

Error description

• Customer setting up a Windows NT tracker agent codes:
  eqqshell=%ComSpec%
  as documented. But this fails with msgEQQTX91E.
  Since the code is Unix oriented, the only way to make a variable
  recognizable is to use $ instead of %, as follows:
  eqqshell=¢comspec
  This needs to be documented.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL USERS OF TRACKER NT                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: The documentation relative to the       *
  *                      parameter eqqshell of the config file   *
  *                      on NT machine is incorrect.             *
  *                      The System variable ComSpec should      *
  *                      be assigned as follows:                 *
  *                      eqqshell = $comspec                     *
  *                      (it is not case sensitive in this case) *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The parameter eqqshell of the configuration file
  of the Tracker NT is erroneously documented.
  The actual documentation, that is eqqshell=%comspec%
  is not correct since the system variable comspec is
  not resolved and the default value for eqqshell is
  substituted at eqqver command run time.
  The correct form is eqqshell=$comspec, that is using
  the dollar sign (5B in hex).
  Documentation will be updated accordingly.
  

Problem conclusion

• The manual mentioned needs to be updated
  with the following informations:
  
   THE FOLLOWING OPC/ESA PUBLICATION(S) WILL BE UPDATED:
                           - - -
  +--------------------------------------------------------------+
  |                                                              |
  |TITLE:  OPERATIONS PLANNING AND CONTROL                       |
  |      Tracker Agents for OS/2 and Windows NT**   SH19-4483-01 |
  |      Installation and Operation Version 2 Release 2          |
  |                                                              |
  |PAGES: 25                                                     |
  |CHAPTER: 3 "Installing and Customizing the Tracker Agent"     |
  |TOPIC: Customizing the Local System                           |
  |PARAGRAPH: customizing the Configuration Parameter File       |
  |CHANGE FROM:                                                  |
  | For NT, ... by %comspec%                                     |
  |TO:                                                           |
  | For NT, the file specification is usually represented by     |
  | $comspec.                                                    |
  +--------------------------------------------------------------+
  

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