IBM z/OS Syslog - System Setup

Initiate the following system-wide actions to use loggers for the Mainframe Logger on IBM z/OS systems:
  1. Set up XCF logger policy, structures and log streams;

    For those who have set up IBM's operations log (OPERLOG), LOGREC and Resource Recovery Services (RRS) functions logging under XCF earlier, the process to set up Mainframe Logger is quite similar.

    Mainframe Logger is set up based on the assumption that customers have set up logger logstream datasets. Datasets are allocated, used to capture data from the XCF structures, rolled-off, and deleted in accordance with installation and retention policies and requirements.

  2. Set up DFSMS processing of logstream datasets for dataset allocation, roll-off and deletion;

    TIBCO documentation is done with the assumption that the dataset management product used to manage logstream datasets will be DFSMS. TIBCO recognizes that the user may use other vendor products to accomplish this. Set up DFSMS (or similar product) policies to allocate, retain, roll-off and delete logstream datasets.

    Specify the following classes in the logstream definition for IBM system logger:
    • A dataset class, specified in LS_DATACLAS;
    • A storage class, specified in LS_STORCLAS;
    • A management class, specified in LS_MGMTCLAS.
    Note: You may use previously defined classes for Mainframe Logger.

    Note: If you are running z/OS v2.2 or later, it's highly recommended that you specify the following parameter when defining the log stream, LS_ALLOCAHEAD(1).

  3. Set up RACF (or similar security product) definitions to support dataset allocation, user access, and system deletion.

    Set up RACF (or similar product) profiles. This allows system tasks to allocate and manage datasets. Create or modify profiles, as required, to provide users the option to print or browse logstream datasets.

    Alternatively, create RACF profiles to allow users to run their own Job Control Language (JCL). This helps to create custom logstream datasets. Accordingly, set up profiles in the RACF LOGSTRM class. For example, to set up a logstream called SXLLOGS.PERM, under dataset high level qualifier (TIBCO), create a generic RACF profile SXLLOGS.* in the LOGSTRM class with ALTER authority. This allows users to create the logstream without granting authority for other-purpose logstreams.

    Assign ALTER authority to DATASET class profile - TIBCO.SXLLOGS.*, to the userid that is assigned to the initiated task. Please note that this function is not performed by the user.