HP XP Racks - Manual (Page 719)

Due to the restrictions of the system logger service, deleting a log stream while an application is
connected to the log stream results in an error. To delete a log stream, CLI command execution
should be suspended temporarily.
Confirming a Log Stream
The following JCL confirms the definition of a log stream, and the allocation of a log dataset.
//LIST1 EXEC PGM=IXCMIAPU
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DATA TYPE(LOGR) REPORT(YES)
LIST LOGSTREAM NAME(log_stream_name) DETAIL(YES)
/*
For details on the log stream name (log_stream_name) to be confirmed in JCL, see “Which
Parameters to Specify for a Log Stream Definition” (page 716) , and apply modifications in
accordance with the environment.
Business Continuity Manager Log Output Method
Using System Logger Service
The system logger service uses one log stream.
A log is output using an API provided by the system logger service. Buffering is performed by the
system logger service. Buffering is not performed in Business Continuity Manager. Instead, a system
logger service API is called from the modules in Business Continuity Manager for each log that
needs to be output.
Since this log format is not a general-purpose log format, use the YKLOGCP program to output the
log to an external dataset. For details about the YKLOGCP program, see
“Business Continuity
Manager Log Data Output Tool” (page 721) .
When the log dataset becomes full, use YKLOGCP to output all the log data to an external dataset,
and then delete the Business Continuity Manager log stream by specifying the DELETE LOGSTREAM
NAME(log_stream_name)
parameter in the IXCMIAPU utility.
To merge Business Continuity Manager log data that was generated by multiple operating systems
in a SIMPLEX environment, you must output the log for each operating system to an external dataset,
transfer the files to a computer, and then put the multiple files in chronological order.
Not Using System Logger Service
To obtain logs, use a DD statement to allocate two sequential log datasets to each job.
Secure capacity for log datasets are as follows:
•
The amount of capacity for log datasets is not fixed, and can be estimated based on the
frequencies at which CLI commands are issued or errors occur. At the very least, HP
recommends securing enough capacity for output until the time that the volume of a log dataset
output to one sequential dataset can be backed up. For details about the amount of log data,
see the HP XP7 for Business Continuity Manager Installation Guide.
•
For the log dataset, specify only the amount allocated at initialization. Any specified additional
allocation will be disregarded. As a result, if you need to specify additional allocation, HP
recommends that you use the system logger service.
The log dataset formats are as follows:
•
RECFM: VB
•
LRECL: 8196
•
BLKSIZE: 8200
Collecting Logs 719