HP XP Racks - Manual (Page 721)

If a log dataset (YKLOG01 or YKLOG02) becomes full and the Business Continuity Manager log
output destination is switched, the YKZ291I message or the YKZ292I message is output to the
console. If this happens, the name of the log dataset that has become full is displayed in the
YKZ291I
message, and both the job name and the DD names of the log (YKLOG01 or YKLOG02)
before and after the switchover are displayed in the YKZ292I message.
To acquire a backup of the Business Continuity Manager logs:
1.
If the YKZ291I or YKZ292I message is output, temporarily stop script operations.
2. If the logs displayed in the YKZ292I message from before and after the switchover differ,
acquire a backup of the log dataset displayed in the YKZ291I message.
If the same log dataset from both before and after the switchover is indicated , then it is also
possible that an error has occurred in one of the log datasets. If this is the case, a backup
cannot be acquired, because the log dataset from before the switchover has been overwritten.
3. Start script operations again after the backup has been acquired or after the cause of the
error has been removed.
The YKZ292I message is also output when the output destination for the Business Continuity
Manager logs switch when a log dataset (YKLOG01 or YKLOG02) I/O error occurs.
For details on the YKZ291I and YKZ292I messages, see the HP XP7 for Business Continuity
Manager Messages.
Obtaining Log Data When the YKWATCH Command Is Executed from the ISPF Panel
If you execute the YKWATCH command from the ISPF panel, and then execute multiple jobs in
parallel, the second job might stop while waiting for the log dataset. As a result, when outputting
logs to sequential datasets, you need to specify either DUMMY or SYSOUT=* in the YKLOGnn DD
statement of the YKWATCH (YKWPROC) command.
The following is an example specification:
//YKLOG01 DD DUMMY
//YKLOG02 DD DUMMY
//YKLOG01 DD SYSOUT=A
//YKLOG02 DD SYSOUT=A
Business Continuity Manager Log Data Formats
The log data format in Business Continuity Manager is defined as follows:
•
The record size, severity level, record identifier, and capacity identity information are added
in binary format to the beginning of each log record. Note that if the system logger service
is being used, the time-stamp is added by the system logger service. In all other cases, Business
Continuity Manager will add the time stamp.
•
The format for each event log record depends on the record type. Message and command
parameters are output in text format, while table data is output in binary format.
Business Continuity Manager Log Data Output Tool
The Business Continuity Manager log data output function sends the Business Continuity Manager
log data accumulated in the log stream of the system logger service to an external dataset specified
in an OUTLOG DD statement, using the YKLOGCP program provided by Business Continuity
Manager. The function outputs all log data, including the data to be deleted. Log data that has
been output is not deleted.
The maximum length of a record that can be output is 8,192 bytes. If the log data exceeds 8,192
bytes, it will be divided before being output. The maximal block size is 32,760 bytes.
Collecting Logs 721