PM41032: OPSTAT ENHANCEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• If no Input Arrival Date/Time is specified, there is no way
  to issue OPSTAT command to complete always the operation
  belonging to the oldest occurrence of the application in CP.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL TWS for z/OS USERs who run OPSTAT.       *
  *                                                              *
  *                 FUNCTION=EM                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: When input arrival time is not          *
  *                      specified as input parameter to         *
  *                      OPSTAT and more operations in the       *
  *                      ready list are eligible to be           *
  *                      selected, having automatically the      *
  *                      oldest one in terms of occurrence       *
  *                      input arrival time is not possible      *
  *                      with existing parameters.               *
  ****************************************************************
  * RECOMMENDATION: APPLY THE PTF FIXING THIS APAR               *
  ****************************************************************
  A solution is needed to have OPSTAT automatically selecting
  the oldest operation, in terms of occurrence IA, among the
  eligible operations of the ready list, when the input
  arrival time is not specified as parameter.
  

Problem conclusion

Temporary fix

Comments

• This apar adds a new keyword, SORTIA, to be specified as
  input parameter to OPSTAT when the workstation name,
  the application name and operation number are specified
  while neither input arrival, nor token are specified in
  OPSTAT. SORTIA will make the code choose the
  oldest operation among the eligible ones in the ready list.
  In all the other cases, keyword SORTIA specified
  as OPSTAT input parameter will be ignored.
  
                           - - -
   THE FOLLOWING TWS FOR ZOS PUBLICATION(S) WILL BE UPDATED:
                           - - -
  +--------------------------------------------------------------+
  |                                                              |
  |TITLE:  TWS for z/OS Managing the Workload      SC32-1263-05  |
  |                                                              |
  |Appendix A. TSO commands                                      |
  |OPSTAT - Usage                                                |
  |After the description of the criteria for the selection of the|
  |most appropriate operation add the following consideration:   |
  |Keyword SORTIA can be specified among OPSTAT input parameters |
  |to automatically choose the oldest eligible operation in the  |
  |ready list in terms of occurrence input arrival time. SORTIA  |
  |is processed and effectively used by the event manager        |
  |when all the following situations occur:                      |
  |- workstation, application name and operation number are all  |
  |  specified as input parameter for OPSTAT                     |
  |- Neither input arrival time nor token are specified as       |
  |  input parameters to OPSTAT.                                 |
  |                                                              |
  |In any different situation the keyword SORTIA will be ignored.|
  |                                                              |
  |OPSTAT - Format                                               |
  |Add the new keyword SORTIA among the parameters to OPSTAT.    |
  |Add also the explanation of the keyword:                      |
  |It makes the code automatically choose  the oldest eligible   |
  |operation in the ready list in terms of occurrence input      |
  |arrival time.                                                 |
  |It applies when both the following situations occur:          |
  |                                                              |
  |- workstation, application name and operation number are all  |
  |  specified as input parameter for OPSTAT                     |
  |- Neither input arrival time nor token are specified as       |
  |  input parameters to OPSTAT.                                 |
  |                                                              |
  |In any different situation the keyword SORTIA will be ignored.|
  |                                                              |
  +--------------------------------------------------------------+
  +--------------------------------------------------------------+
  |                                                              |
  |TITLE:  TWS for z/OS Managing the Workload      SC32-1263-06  |
  |                                                              |
  |Appendix A. TSO commands                                      |
  |OPSTAT - Usage                                                |
  |After the description of the criteria for the selection of the|
  |most appropriate operation add the following consideration:   |
  |Keyword SORTIA can be specified among OPSTAT input parameters |
  |to automatically choose the oldest eligible operation in the  |
  |ready list in terms of occurrence input arrival time. SORTIA  |
  |is processed and effectively used by the event manager        |
  |when all the following situations occur:                      |
  |- workstation, application name and operation number are all  |
  |  specified as input parameter for OPSTAT                     |
  |- Neither input arrival time nor token are specified as       |
  |  input parameters to OPSTAT.                                 |
  |                                                              |
  |In any different situation the keyword SORTIA will be ignored.|
  |                                                              |
  |OPSTAT - Format                                               |
  |Add the new keyword SORTIA among the parameters to OPSTAT.    |
  |Add also the explanation of the keyword:                      |
  |It makes the code automatically choose  the oldest eligible   |
  |operation in the ready list in terms of occurrence input      |
  |arrival time.                                                 |
  |It applies when both the following situations occur:          |
  |                                                              |
  |- workstation, application name and operation number are all  |
  |  specified as input parameter for OPSTAT                     |
  |- Neither input arrival time nor token are specified as       |
  |  input parameters to OPSTAT.                                 |
  |                                                              |
  |In any different situation the keyword SORTIA will be ignored.|
  |                                                              |
  +--------------------------------------------------------------+
  

APAR Information

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

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

  UK73889 UK73890 UK73891 UK73892

Modules/Macros

• DCLEOPT  DCLEXU   EQQEMUSR EQQEVOPX EQQZEVOX
  

Fix information

• Fixed component name

  TIV WRKLD SCHD

• Fixed component ID

  5697WSZ01

Applicable component levels

• R510 PSY UK73889

     UP12/04/04 P F204

• R512 PSY UK73891

     UP12/04/04 P F204

• R600 PSY UK73890

     UP12/04/04 P F204

• R602 PSY UK73892

     UP12/04/04 P F204

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.