IBM z/OS Management Facility

Publications

To obtain the latest documentation, you can download the z/OSMF publications from the IBM Publications Center web site. Search for the publication numbers, using the tables below to identify and download the publications that are correct for your installed level of z/OSMF.

  • - Publications for z/OSMF V2R1 with APAR PM98630 and corequisite APARs applied
    Title Order Number
    Program Directory for z/OS Management Facility GI11-9847-01
    IBM z/OS Management Facility Configuration Guide SA38-0657-01
    IBM z/OS Management Facility Programming SA32-1066-01
    z/OS V2R1 Information Center N/A
  • - Publications for z/OSMF V2R1 without APAR PM98630 and corequisite APARs applied
    Title Order Number
    Program Directory for z/OS Management Facility GI11-9847-00
    IBM z/OS Management Facility Configuration Guide SA38-0657-00
    IBM z/OS Management Facility Programming SA32-1066-00
    Removed -> IBM z/OS Management Facility Messages Messages with an ID in the range IZUG0001 - IZUG0399 are included in the IBM z/OS Management Facility Configuration Guide. All other messages are included in the z/OS Information Center and the z/OSMF online help.
  • - Publications for z/OSMF V1R13 with APAR PM74502 and corequisite APARs applied
    Title Order Number
    Program Directory for z/OS Management Facility GI11-2886-02
    WebSphere Application Server OEM Edition for z/OS Configuration Guide Use the edition of the publication (GA32-0631) for your fixpack level.

    z/OSMF V1R13 requires WebSphere® Application Server OEM Edition for z/OS® 7.0.0.17 or later.
    IBM z/OS Management Facility Configuration Guide SA38-0652-07
    IBM z/OS Management Facility Messages SA38-0654-02
    z/OSMF V1R13 Information Center N/A
  • - Publications for z/OSMF V1R13 without APAR PM74502 and corequisite APARs applied
    Title Order Number
    Program Directory for z/OS Management Facility GI11-2886-02
    WebSphere Application Server OEM Edition for z/OS Configuration Guide (Fix Pack 6) GA32-0631-05
    IBM z/OS Management Facility Configuration Guide SA38-0652-06
    New book -> IBM z/OS Management Facility Messages SA38-0654-01
  • - Publications for z/OSMF V1R12
    Title Order Number
    Program Directory for z/OS Management Facility GI11-2886-01
    WebSphere Application Server OEM Edition for z/OS Configuration Guide GA32-0631-03
    Changed title -> IBM z/OS Management Facility Configuration Guide SA38-0652-04


Errata

  • - IBM z/OS Management Facility Configuration Guide, SA38-0652-07

    In the topic on error categories and the associated error codes for the z/OS jobs REST interface, a number of reason codes were omitted from Table 48 "Category 6 Errors," which appears on pages 263 - 264 of the PDF. The next edition of this publication will add the following reason codes for Error Reporting Category 6, which describes errors produced or detected in the service layer.


    Table 48. "Category 6 errors"
    Return code Reason code Message Description
    4 4 Value of query parameter is not valid The query parameter identified in the message contains incorrect characters or exceeds the allowable length. In the message, the query parameter is owner, prefix, or jobid.
    4 14 Unsupported encoding For a submitted job, the Content-Type request header specified an unsupported character set (charset).
    4 15 DD names are not supported for submitted input For the submitted job, the value of the filename property in the JSON document started with //DD, which is not supported.
    4 16 Data set not found For the submitted job, the data set specified in the JSON document was not found. This error can occur if the data set is not catalogued.
    4 17 Submit input data does not start with a slash For the submitted job, the first character of the input JCL is not the EBCDIC slash character.

    Possible causes include:
    • Content-Type request header is set to text/plain, but a JSON document naming the source of the input job is also used.
    • Input data set or file does not contain EBCDIC data.
    4 18 Submit input filename must be absolute path The z/OS UNIX file specification in the JSON document was not an absolute path.
    4 19 Internal reader mode must be RECORD for data set submission For a job that is submitted from a data set, the internal reader mode, if specified, must be set to RECORD.
    4 22 Internal reader RECFM does not match data set RECFM For a job that is submitted from a data set, the internal reader record format, if specified, must match the record format of the existing data set.
    4 23 Internal reader LRECL does not match data set LRECL For a job that is submitted from a data set, the internal reader logical record length must match the logical record length of the existing data set.
    4 24 Content type not valid for internal reader mode The values specified for Content-Type and internal reader mode are not a supported combination.
    4 31 Request header not supported by primary JES subsystem The request header identified in the message is not supported by the primary JES subsystem.
    4 32 Error parsing JSON input For the submitted job, an exception occurred when the input JSON document was processed.

    Possible causes include the following:
    • JCL stream was provided instead of a JSON document
    • JSON document was malformed
    • Required “file” property was not provided
    • Value for the “recall” property was not valid.
    For more information, see the “stack” property of the JSON error report document.
    4 33 Data set is migrated The z/OS data set specified in the JSON document is migrated. No recall was issued. No job was submitted.
    4 34 Recall issued for migrated data set The z/OS data set specified in the JSON document is migrated. A recall without waiting was issued. No job was submitted.
    8 2 EOF encountered before all requested bytes read Internal read state error. The expected number of bytes were not available to be read before the end-of-file (EOF) was encountered.


Other Information Resources

You can find more information about z/OSMF at the following sites:

  • -z/OS Hot Topics Newsletters
    z/OS Hot Topics Issue z/OSMF-Related Articles
    Issue 21
    • z/OS Simplifies Your Life — An introduction to z/OSMF
    • What's in your (incident) log? An introduction to the z/OSMF Incident Log
    • Setting up Operlog and Logrec for z/OSMF Incident Log
    • Removing the Mystery on using System Logger for z/OSMF
    Issue 23
    • Easy as z/OSMF
    • A new look for z/OSMF
    • Set the cruise control to z/OSMF
    • Incidentally, z/OSMF is moving forward
    Issue 25
    • For immediate deployment: z/OSMF software
    • How to perform z/OSMF software deployment
    • Now performing! RMF XP
    Issue 27
    • A great new look and so much more
    • Perfectly integrated: z/OSMF Performance Monitoring and Management
  • - IBM Technotes
    Technote Number Title
    FQ129014 What is the z/OS® Management Facility and Why is the first release of z/OSMF Release 11?
    PRS4804 z/OS Version 1 Release 13 Technical Update
    T1012682 z/OS Management Facility Incident Data Management
    WP101779 z/OS Management Facility Resource Requirements


Contact IBM

Browse z/OS