Adding information about a data set to the BSDS (NEWLOG) on z/OS

We can use the NEWLOG function of CSQJU003 to add information about a data set to BSDS.

The NEWLOG function declares one of the following data sets:

  • A VSAM data set that is available for use as an active log data set.

    Use the keywords DSNAME, COPY1, COPY2, and PASSWORD.

  • An active log data set that is replacing one that encountered an I/O error.

    Use the keywords DSNAME, COPY1, COPY2, STARTRBA, ENDRBA, and PASSWORD.

  • An archive log data set volume.

    Use the keywords DSNAME, COPY1VOL, COPY2VOL, STARTRBA, ENDRBA, STRTLRSN, ENDLRSN, UNIT, CATALOG, and PASSWORD.

    In a queue sharing group environment, we should always supply LRSN information. Run the print log map utility (The print log map utility (CSQJU004) on z/OS) to find RBAs and LRSNs to use for archive log data sets.

A maximum of 310 data sets can be defined for each log copy, either by this NEWLOG function or the MQSC DEFINE LOG command.


NEWLOG

NEWLOG DSNAME = dsname New active logNew archive log,PASSWORD=passwordNew active log,COPY1,COPY2,STARTRBA=startrba,ENDRBA=endrbaTimeTime , STARTIME = startime , ENDTIME = endtime New archive log,COPY1VOL=vol-id,COPY2VOL=vol-id , STARTRBA = startrba , ENDRBA = endrba ,STARTIME=startime,ENDTIME=endtime,STRTLRSN=strtlrsn,ENDLRSN=endlrsn , UNIT = unit-id ,CATALOG=NO,CATALOG=YES


Keywords and parameters

    DSNAME= dsname
    Names a log data set.

    dsname can be up to 44 characters long.

    PASSWORD= password
    Assigns a password to the data set. It is stored in the BSDS and later used in any access to the active or archive log data sets.

    The password is a data set password, and should follow standard VSAM convention: 1 through 8 alphanumeric characters (A through Z, 0 through 9) or special characters (& * + - . ; ' /).

    We recommend that we use an ESM such as RACF to provide your data set security requirements.

    COPY1
    Makes the data set an active log copy-1 data set.

    COPY2
    Makes the data set an active log copy-2 data set.

    STARTRBA= startrba
    Gives the log RBA (relative byte address within the log) of the beginning of the replacement active log data set or the archive log data set volume specified by DSNAME.

    startrba is a hexadecimal number of up to 16 characters. The value must end with 000. If we use fewer than 16 characters, leading zeros are added. The RBA can be obtained from messages or by printing the log map.

    The value of STARTRBA must be a multiple of 4096. (The hexadecimal value must end in 000.)

    A value higher than FFFFFFFFF000 cannot be specified for a version 1 format BSDS.

    ENDRBA= endrba
    Gives the log RBA (relative byte address within the log) of the end of the replacement active log data set or the archive log data set volume specified by DSNAME.

    endrba is a hexadecimal number of up to 16 characters. The value must end with FFF. If we use fewer than 16 characters, leading zeros are added.

    A value higher than FFFFFFFFFFFF cannot be specified for a version 1 format BSDS.

    STARTIME= startime
    Start time of the RBA in the BSDS. This is an optional field. The time stamp format (with valid values in parentheses) is yyyydddhhmmsst, where:

      yyyy
      Indicates the year (1993 through 2099)

      ddd
      Indicates the day of the year (1 through 365; 366 in leap years)

      hh
      Indicates the hour (zero through 23)

      mm
      Indicates the minutes (zero through 59)

      ss
      Indicates the seconds (zero through 59)

      t
      Indicates tenths of a second

    If fewer than 14 digits are specified for the STARTIME and ENDTIME parameter, trailing zeros are added.

    STARTRBA is required when STARTIME is specified.

    ENDTIME= endtime
    End time of the RBA in the BSDS. This is an optional field. For time stamp format, see the STARTIME option. The ENDTIME value must be greater than or equal to the value of STARTIME.

    STRTLRSN= strtlrsn
    Gives the LRSN (logical record sequence number) of the first complete log record on the new archive data set.

    strtlrsn is a hexadecimal number of up to 12 characters. If we use fewer than 12 characters, leading zeros are added.

    ENDLRSN= endlrsn
    Gives the LRSN (logical record sequence number) of the last log record on the new archive data set.

    endlrsn is a hexadecimal number of up to 12 characters. If we use fewer than 12 characters, leading zeros are added.

    COPY1VOL= vol-id
    The volume serial of the copy-1 archive log data set named after DSNAME.

    COPY2VOL= vol-id
    The volume serial of the copy-2 archive log data set named after DSNAME.

    UNIT= unit-id
    The device type of the archive log data set named after DSNAME.

    CATALOG
    Specifies whether the archive log data set is cataloged:

      NO
      The archive log data set is not cataloged. All subsequent allocations of the data set are made using the unit and volume information specified on the function. This is the default.

      YES
      The archive log data set is cataloged. A flag is set in the BSDS indicating this, and all subsequent allocations of the data set are made using the catalog.

      IBM MQ requires that all archive log data sets on DASD be cataloged. Select CATALOG=YES if the archive log data set is on DASD.

Parent topic: The change log inventory utility (CSQJU003) on z/OS