Managing the FDR service address space

This topic describes how to manage the FDR service address space (FDRMAIN).

Configure the FDR service address space (FDRMAIN)

You must run the FDR service address space as a started task. You must associate any started task on a z/OS system with a PROTECTED user ID. There are multiple ways for a PROTECTED user ID to be associated with a started task or procedure, and the commands involved vary depending on the ESM (External Security Manager) in use. Therefore, we recommend that you define the FDRMAIN started task to your ESM in a manner consistent with your shop standards and practices.

The FDRMAIN started task requires read access to any data sets specified in the following DD statements:

STEPLIB (if used)

BMCPSWD

Manage the FDR service address space (FDRMAIN)

The FDR service address space (FDRMAIN) runs as a started task and is used by most of the BMC AMI Storage FDR products. This address space provides services and facilitates communication with other FDR service address spaces on other local and remote systems.

Important

FDRMAIN must be started and operational on any system where you run FDR product family related jobs.
Only one FDRMAIN can run on a single system image.

Start FDRMAIN

To start FDRMAIN.

Important

FDRMAIN must be run as a started task. See Create the FDRMAIN startup procedure, for instructions about preparing an FDRMAIN startup procedure.

Verify that the JCL for the FDRMAIN started task procedure exists. Creating the FDRMAIN startup procedure describes the JCL for creating the FDRMAIN started task procedure. By default, the FDRMAIN started task procedure that is created during the installation configuration is called FDRMAIN. Your site might have defined a different FDRMAIN procedure name and library.
From the operator console, enter the START command:
S procname[.id][,REUSASID=YES]
The following console message confirms that FDRMAIN was started successfully:
FDR1000I FDRMAIN Vv.r has been successfully initialized (Build=yyyymmdd-hh.mm,RMID=rmid)

Create the FDRMAIN startup procedure

To create an FDRMAIN startup procedure:

Copy the FDRSAMP member FDRMAIN to SYS1.PROCLIB or another system procedure library and rename this to an appropriate started task procedure name.
Follow the instructions at the top of the member to modify the procedure to your site requirements.
Important
The default started task name for the FDR main task is FDRMAIN, you can rename this name as per your installation standards.
(Optional) Define the FDRMAIN started task procedure to your IPL procedure so that it starts at system initialization.
Important
If you do not define FDRMAIN to start at IPL, see Start FDRMAIN for information about manually issuing a START command for FDRMAIN.
Tip
- We recommend that you modify the COMMNDxx member in SYS1.PARMLIB to add a START command for the FDRMAIN procedure:
COM='S procname'
procname is the name of the FDRMAIN started task procedure.
- During the FDRMAIN execution, we recommend the following:
  - Initiate FDRMAIN as a started task (STC) through a system IPL procedure.
  - Execute only one FDRMAIN per system image.
  - Execute FDRMAIN with a dispatching priority of 255.

FDRMAIN started task procedure statements

The following table describes the list of procedure statements for FDRMAIN started tasks.

Statement	Description
//procname PROC	This statement identifies the started task procedure.
//FDRMAIN EXEC	This statement references a program named FDRMAIN that processes EXEC parameters and performs basic initialization tasks. The REGION parameter specifies the size of the private region that is required by the FDRMAIN. We recommend that you do not restrict the FDRMAIN region size. TIME=1440 defines unlimited processing time for FDRMAIN. We recommend that you do not limit the processing time for FDRMAIN.
//STEPLIB DD	This statement defines the FDRLINK and BBLINK load libraries, which contains load modules for all BMC AMI Storage FDR products. Important: This statement should be deleted if FDRLINK and BBLINK are added to your system link list.
//BMCPSWD DD	This statement defines the BMC product authorization (PASSWORD) Data Set. Important: When you add, modify, or remove licenses in the BMC product authorization data set you must restart FDRMAIN to complete the license installation.

FDRMAIN started task parameter statements

The following table describes the parameter statement for FDRMAIN started tasks.

Statement	Description
USEZIIP=Y\|N	Specifies if eligible CPU processing should be offloaded, USEZIIP=Y, or not offloaded, USEZIIP=N, to zIIP(s) if active zIIP(s) are on the system or PROJECTCPU has been specified in IEAOPTxx. Default - USEZIIP=Y Alias - UZ=