OA58786: NEW FUNCTION: CONSOLE OPERPARM

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function: CONSOLE OPERPARM
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of the TSO CONSOLE command                             *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Support for OPERPARMs on CONSOLE ACTIVATE                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

Temporary fix

Comments

• The CONSOLE command has been updated to allow the issuer to
  specify OPERPARM information when activating a console.
  
  The z/OS TSO/E System Programming Command Reference (SA32-0974),
  CONSOLE command
  syntax and description has been updated with the following:
  
  >> CONSOLE --- ACTIVATE --- (OPERPARM(--->
  >------------------------------------------------------------->
    |--- AUTH(--- INFO --- SYS --- IO ---
         CONS --- ALL --- MASTER---)---|
  >------------------------------------------------------------->
    |                            |
    |--- ROUTCODE( --- n ---) ---|
    |--- ROUTALL ----------------|
    |--- ROUTNONE ---------------|
  >------------------------------------------------------------->
     |                         |
     |--- MSCOPE( sysname ) ---|
     |--- MSCOPEALL -----------|
     |--- MSCOPELOCAL ---------|
  >------------------------------------------------------------->
    |--- STORAGE(n) ---|
  >--------------------------------------------------)---)----><
    |--- AUTO( --------------)---|
               |--- YES ---|
               |--- NO ----|
  
  OPERPARM  Specifies that attributes will be specified for the
  CONSOLE session to be activated. Authority is required to
  specify this keyword.
  
  AUTH  Specifies the list of command authorities for the
  console.  Authorities will be merged together according to the
  same rules as MCSOPER
  
  ROUTCODE - Specifies the list of routing codes in effect for
  the console.  The values can be 1-128.
  
  ROUTALL  Specifies that the console will see all messages
  defined by routing codes.
  
  ROUTNONE  Specifies that routing codes are not used as criteria
  for routing messages to the console.
  
  MSCOPE  Specifies the list of systems from which the console
  will receive messages.  Up to 32 systems can be specified if
  the couple dataset is configured for that many.  The systems
  specified after the 32nd will be ignored.
  
  MSCOPEALL  Specifies the console will receive messages from all
  systems in the sysplex.
  
  MSCOPELOCAL  Specifies the console will see messages from the
  local system.
  
  STORAGE  n is the maximum number of megabytes that will be
  allowed for message queueing.  The range allowed for n is
  1-2048.
  
  AUTO -  Specifies whether or not the console receives messages
  that are eligible for automation. See Specifying console
  attributes in the z/OS MVS Programming:Authorized Assembler
  Services Guide for additional information on these options.
  
  
  
  z/OS TSO/E Messages (SA32-0970) Has been updated to include the
  following new messages:
  
  IKJ55320I THE CONSOLE COMMAND HAS TERMINATED. + USER NOT
  AUTHORIZED TO SPECIFY OPERPARM.
  
  Explanation: You do not have the authority to issue the CONSOLE
  command with the OPERPARM keyword. Your installation must
  authorize use of this keyword.
  
  System action: The CONSOLE command ends with a return code of
  60.
  
  User response: Contact security administrator for assistance.
  
  Module: IKJCNSOL
  
  Audience: CONSOLE user
  
  
  IKJ55328I THE CONSOLE COMMAND HAS TERMINATED. + USER NOT
  AUTHORIZED TO CONSOLE COMMAND AND OPERPARM KEYWORD
  
  Explanation: You do not have the authority to issue the CONSOLE
  command nor to use the OPERPARM keyword. Your installation must
  authorize use of the command and this keyword.
  
  System action: The CONSOLE command ends with a return code of
  60.
  
  User response: Contact security administrator for assistance.
  
  Module: IKJCNSOL
  
  Audience: CONSOLE user
  
  
  
  z/OS TSO/E Customization (SA32-0976) has updated the section
  regarding customizing the CONSOLE command as follows:
  
  Subsection "Parameter descriptions for the activation exit"
  will now note that the OPERPARM area can be passed into the
  exit when OPERPARM is specified on the CONSOLE command.
  The area should only be GETMAINed and FREEMAINed in the exits
  if it was not supplied upon entry to the activation exit or the
  exit wants to replace the entire OPERPARM block. When replacing
  the OPERPARM block the exit should overwrite the pointer with
  the new one.  If the exit needs to update specific incoming
  OPERPARM values, it can overwrite values in the supplied area.
  CONSOLE processing will always handle FREEMAINing the area
  passed to the activation exit, even if it is overwritten.
  
  Subsection "Limiting the use of the CONSOLE and CONSPROF
  commands" will be updated to include:
  To allow users who have authority to the CONSOLE command to
  also specify the OPERPARM keyword, use the RACF RDEFINE command
  to define CONOPER as a RACF resource belonging to the
  TSOAUTH RACF class. Then grant selected users access to the
  CONOPER resource using the RACF PERMIT command.
  
  
  
  z/OS TSO/E System Diagnosis: Data Areas (GA32-0983) has updated
  the mapping of the PSCB with the following:
  
  16 (10) CHARACTER   2 PSCBATR1     A 16 BIT STRING OF USER
                                     ATTRIBUTES
          1... ....     PSCBCTRL     OPERATOR COMMAND USER
          .1.. ....     PSCBACCT     ACCOUNT
          ..1. ....     PSCBJCL      SUBMIT BITS
          ...1 ....     PSCBVMNT     CNTL VOL MOUNT AUTH
          .... 1...     PSCBATTN     LINE DELETE CHAR IS ATTN
          .... .1..     PSCBRCVR     EDIT RECOVER/NORECOVER
          .... ..1.     PSCBRRBA     REPLACE USER RBA AT
                                     LOGOFF TIME
          .... ...1     PSCBCNAU     CONSOLE authority
  17 (11) BITSTRING 1   *            PSCBATR1 BYTE 2
          1... ....     PSCBCNOP     CONSOLE OPERPARM AUTH
  
  
  
  z/OS MVS Planning: Operations (SA23-1390) has been updated to
  include the following regarding authority to the CONSOLE
  command:
  
  In subsection "Allowing a TSO/E user to issue the CONSOLE
  
  command" Add the following at the end of step 4:
  
  
  
  If TAPE1 needs authority to the OPERPARM keyword on the CONSOLE
  
  command, issue RDEFINE to define the authority to the resource
  
  in class TSOAUTH with a universal access (UACC) of NONE:
  
  RDEFINE TSOAUTH CONOPER UACC(NONE)
  
  and also issue RACF PERMIT to authorize TAPE1 to use the
  
  OPERPARM keyword:
  
  PERMIT CONOPER CLASS(TSOAUTH) ID(TAPE1) ACCESS(READ)
  

APAR Information

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

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

  UJ02445 UJ02446

Modules/Macros

• IKJCNMSG IKJEFRAF IKJCNASR IKJCNSOH IKJPSCB  IKJCNSOL
  

Fix information

• Fixed component name

  TSO/E SCHEDULAR

• Fixed component ID

  566528502

Applicable component levels

• R7B0 PSY UJ02445

     UP20/04/01 P F003

• R7C0 PSY UJ02446

     UP20/04/01 P F003

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.