- 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 subsequently
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 you use an ESM such as RACF(R) 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 12 characters. The value must end with 000. If you use fewer than
12 characters, leading zeros are added. The RBA can be obtained from messages
or by printing the log map.
- 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 12 characters. The value must end with FFF. If you use fewer than
12 characters, leading zeros are added.
- 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 you use fewer than 12 characters, leading
zeros are added.
- ENDLRSN=endlrsn
- Gives the LRSN (logical record sequence number) of the last last log
record on the new archive data set.
endlrsn is a hexadecimal
number of up to 12 characters. If you 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.
WebSphere MQ requires
that all archive log data sets on DASD be cataloged. Select CATALOG=YES
if the archive log data set is on DASD.