Defining A Log Stream - HP XP P9500 Software User's Manual

If an error occurs when connecting to a log stream for reasons such as the log stream not being
defined, the YKZ217E message (name=IXGCONN) is output to the console upon the first execution
of a CLI command after logging on to TSO/E. If this happens, the Business Continuity Manager
log data will not output while CLI commands are still being processed. To output Business Continuity
Manager log data, you must log onto TSO/E again, after fixing the cause of the problem.
When setting up the system logger service, pay special attention to the following items.
Starting and Stopping System Logger Service
To use the log stream, you need to use one of the following methods to activate the system (system
logger address space). If the system is not active, an error will occur with the connection request
macro (IXGCONN).
Add SUBSYS SUBNAME(LOGR) INITRTN(IXGSSINT) to the IEFSSNxx parmlib member.
Execute the SETSSI ADD,SUBNAME=LOGR,INITRTN=IXGSSINT command.
Use this to dynamically add the system.
Input S IXGLOGRS.
To stop the service, enter FORCE IXGLOGR,ARM.
Setting up LOGR Couple Data Sets
On a Sysplex environment, you need to format the LOGR couple data sets, and define them so that
they are sysplex-compatible.
Setting Access Privileges
If the System Authorization Facility (SAF) can be used, you must make sure that the user executing
Business Continuity Manager commands has the following permissions in order to have the system
perform an SAF authorization check for each request:
CLASS: FACILITY
RESOURCE: MVSADMIN.LOGR
Permissions: ALTER or READ
CLASS: LOGSTRM
RESOURCE: log-stream-name
Permissions: ALTER
For details about log stream names, see
(page 559).
Defining the SMS
When using the system logger service, the area for staging datasets and log datasets is allocated
by referencing the SMS definitions. As a result, to allocate a staging dataset or log dataset to a
particular volume, you must define an SMS storage group, management class, storage class, data
class, and ACS routine for the Business Continuity Manager system logger service and then use
the SMS definition to define the log stream, so that the staging dataset and log dataset are allocated
to the particular volume.

Defining a Log Stream

When a user defines a log stream with the IXCMIAPU utility, a DASD-only log stream named
according to the method described in
(page 559) should be defined before executing a CLI command.
The following is an example of defining a log stream with JCL:
558 Troubleshooting
"Which Parameters to Specify for a Log Stream Definition"
"Which Parameters to Specify for a Log Stream Definition"