PH61494: zOSMF fails to start if File and Dataset REGION is set to 32768 in IZUPRMXX

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• zOSMF fails to start if File and Dataset REGION is set to
  32768 in IZUPRMXX.
  

Local fix

• Update IZUPRMXX, set RESTAPI_FILE REGION to 65536
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM z/OS Management Facility    *
  *                 3.1                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: When user upgraded to z/OS 3.1 with     *
  *                      RESTAPI_FILE REGION(32768) in z/OSMF    *
  *                      PARMLIB,                                *
  *                      RESTAPI_FILE ACCT(IZUACCT)              *
  *                      REGION(32768) PROC(IZUFPROC)            *
  *                      the following error messages were       *
  *                      encountered when starting z/OSMF server *
  *                      +ASA008I ERROR IN PARMLIB MEMBER=       *
  *                      IZUPRMJG ON LINE 1, POSITION 35:        *
  *                       144                                    *
  *                       VALUE IS NOT VALID - OUT OF RANGE.     *
  *                       DETECTING MODULE IS IZUIPACT. INPUT    *
  *                       LINE:                                  *
  *                       RESTAPI_FILE ACCT(IZUACCT)             *
  *                       REGION(32768) PROC(IZUFPROC)           *
  *                      +IZUG014E One or more errors found      *
  *                      processing parmlib member               *
  *                      IZUPRMJG:  SYNTAX ERROR FOUND IN        *
  *                      PARMLIB MEMBER.                         *
  ****************************************************************
  In z/OS 3.1, the minimum value of RESTAPI_FILE REGION in z/OSMF
  PARMLIB is 65536.
  RESTAPI_FILE ACCT(IZUACCT) REGION(65536) PROC(IZUFPROC)
  In previous z/OS releases, the minimum value of parameter
  RESTAPI_FILE REGION was 32768, so when user updraded to z/OS 3.1
  with RESTAPI_FILE REGION(32768), the following error messages
  were encountered when starting z/OSMF server
  +ASA008I ERROR IN PARMLIB MEMBER=IZUPRMJG ON LINE 1, POSITION 35
   144
   VALUE IS NOT VALID - OUT OF RANGE.
   DETECTING MODULE IS IZUIPACT. INPUT LINE:
   RESTAPI_FILE ACCT(IZUACCT) REGION(32768) PROC(IZUFPROC)
  +IZUG014E One or more errors found processing parmlib member
  IZUPRMJG:  SYNTAX ERROR FOUND IN PARMLIB MEMBER.
  

Problem conclusion

• In z/OS 3.1, the minimum value of RESTAPI_FILE REGION in z/OSMF
  PARMLIB is 65536.
  RESTAPI_FILE ACCT(IZUACCT) REGION(65536) PROC(IZUFPROC)
  In previous z/OS releases, the minimum value of RESTAPI_FILE
  REGION was 32768, so when user upgraded to z/OS 3.1 with
  RESTAPI_FILE REGION(32768) or less than 65536, the following
  error messages were encountered when starting z/OSMF server:
  +ASA008I ERROR IN PARMLIB MEMBER=IZUPRMJG ON LINE 1, POSITION 35
   144
   VALUE IS NOT VALID - OUT OF RANGE.
   DETECTING MODULE IS IZUIPACT. INPUT LINE:
   RESTAPI_FILE ACCT(IZUACCT) REGION(32768) PROC(IZUFPROC)
  +IZUG014E One or more errors found processing parmlib member
  IZUPRMJG:  SYNTAX ERROR FOUND IN PARMLIB MEMBER.
  
  This APAR restores the minimum value of RESTAPI_FILE REGION to
  32768.
  With this APAR, it's not required to modify z/OSMF PARMLIB in
  order to get around the validation error IZUG014E if a value
  less than 65536 was used for RESTAPI_FILE REGION.
  

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:

  UI97327

Modules/Macros

• IZUCFCJR IZUIPPVT
  

Fix information

• Fixed component name

  Z/OSMF CORE

• Fixed component ID

  5655S28SM

Applicable component levels

• R310 PSY UI97327

     UP24/07/03 P F407

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.