Converting a DASD-only log stream to use a coupling facility

You can upgrade a DASD-only log stream to use a coupling facility structure, without having to delete and redefine the log stream.

  1. Make sure that there are no connections, neither active nor failed, to the log stream.
  2. Use the UPDATE LOGSTREAM request of the MVS™ IXCMIAPU utility. Specify the STRUCTNAME keyword, and let the DASDONLY keyword default to NO. For example:
    Figure 1. Converting a DASD-only log stream to use a coupling facility structure. This example shows the CICS® primary system log stream. The value region_userid is the RACF® user ID under which the CICS address space is running; applid is the CICS region's SNA APPL name, taken from the APPLID system initialization parameter.
    //LOGUPDT  JOB ...
    //LOGUPDT  EXEC PGM=IXCMIAPU
    //SYSPRINT DD SYSOUT=A,DCB=RECFM=FBA
    //****************************************************************
    //*                                                              *
    //* Convert DASD-only log stream to coupling facility log stream.*
    //*                                                              *
    //****************************************************************
    //SYSIN    DD *
      DATA TYPE(LOGR) REPORT(NO)
      UPDATE LOGSTREAM NAME(region_userid.applid.DFHLOG)
                       STRUCTNAME(LOG_DFHLOG_001)
                       STG_DUPLEX(YES) DUPLEXMODE(COND)
  1. To upgrade a DASD-only log stream to a coupling facility log stream that does not use a staging data set, you must explicitly specify STG_DUPLEX(NO), because the DASD-only log stream by definition uses a staging data set; unless you specify STG_DUPLEX(NO), this storage data set is retained by the coupling facility log stream.
  2. You cannot use UPDATE LOGSTREAM to convert a log stream that uses a coupling facility structure to one that uses DASD-only. To do that, you must delete and redefine the log stream.


dfha1kt.html | Timestamp icon Last updated: Sunday, 4 June 2017