Utility control statements for the Initialize function

The utility control statements for the Initialize function define the user description of the GLOBAL command, the INITIALIZE command, and the optional ALLOCATE subcommands, all of which control the Initialize process.

The utility control statements must be specified in the HFPSYSIN data set. This control statement data set usually resides in the input stream. However, it can also be defined as a sequential data set or as a member of a partitioned data set. It must contain 80-byte, fixed-length records. Block size, if coded, must be a multiple of 80.

The following figure shows a sample of how to code the HFPSYSIN data set.

Figure 1. INITIALIZE HFPSYSIN data set

//HFPSYSIN DD * 
  GLOBAL
    DBRC=YES
  INITIALIZE      
    DBD=dbdname      
/*

Subsections:

GLOBAL command keywords
INITIALIZE command keywords
ALLOCATE subcommand keywords

GLOBAL command keywords

For the GLOBAL command, you can specify the keywords that are listed in the following table. For the format of the GLOBAL command, see GLOBAL command.

Table 1. GLOBAL command keywords
Keyword	Required or optional	Description	Topic
DBRC	Optional	Specifies to request or bypass the database recovery control (DBRC) facility process for the database that is specified by the DBD.	DBRC keyword
IMSCATACB_INPUT	Optional	Specifies whether to retrieve the currently active ACB definition or the pending ACB definition from the IMS directory.	IMSCATACB_INPUT keyword
IMSCATHLQ	Optional	Specifies the high-level qualifier of the bootstrap data set of the IMS directory.	IMSCATHLQ keyword
ITKBLOAD	Optional	Specifies the library name of IMS Tools KB.	ITKBLOAD keyword
ITKBSRVR	Optional	Specifies the name of the IMS Tools KB server XCF group.	ITKBSRVR keyword
MSTIMESTAMP	Optional	Specifies whether to include a time stamp in the messages.	MSTIMESTAMP keyword
SCAN	Optional	Specifies to verify the syntax of command, keywords, and parameters in command sets without running FPA. The Scan function also allocates some (but not all) internal resources for running the process function.	SCAN keyword
SITE_DSNAME	Optional	Specifies the data set name for the site default table.	SITE_DSNAME keyword
SITE_MEMBER	Optional	Specifies the member name for the site default table.	SITE_MEMBER keyword

INITIALIZE command keywords

For the INITIALIZE command, you can specify the keywords that are listed in the following table. For the format of the INITIALIZE command, see INITIALIZE command.

Table 2. INITIALIZE command keywords
Keyword	Required or optional	Description	Topic
ALLOCONLY	Optional	Suppresses the initialization of output area data sets.	ALLOCONLY keyword
DBD	Required	Specifies the database description (DBD) that contains the areas to be processed.	DBD keyword
OAREA	Optional	Specifies one or more output areas to process.	OAREA keyword
OCHECK	Optional	Controls the concurrent number of output devices to access.	OCHECK keyword
ODSNMASK	Optional	Specifies the data set name or mask for dynamically allocating cataloged pre-existing output data sets.	ODSNMASK keyword
OTASKCTL	Optional	Specifies the maximum number of output areas to be processed concurrently.	OTASKCTL keyword

ALLOCATE subcommand keywords

The ALLOCATE subcommand dynamically defines a VSAM cluster that is used for the processing of the INITIALIZE command.

For the ALLOCATE subcommand, you can specify the keywords that are listed in the following table. For the format of the ALLOCATE subcommand, see ALLOCATE subcommand.

Table 3. ALLOCATE subcommand keywords
Keyword	Required or optional	Description	Topic
AMSOPT	Optional	Passes optional parameters to the Access Method Services (AMS) to define VSAM clusters.	AMSOPT keyword
ATTRIBUTE	Optional	Requests optional processing related to allocation of a VSAM cluster.	ATTRIBUTE keyword
AVGREC	Optional	Identifies the space requirements of the output data set that is created by dynamic allocation.	AVGREC keyword
DATACLAS	Optional	Specifies the SMS data class of an output data set that is created by dynamic allocation.	DATACLAS keyword
KEYLABEL	Optional	Specifies the key label for encrypting a new VSAM cluster.	KEYLABEL keyword
MGMTCLAS	Optional	Specifies the SMS management class of an output data set that is created by dynamic allocation.	MGMTCLAS keyword
OAREA	Required	Specifies one or more output areas for the process.	OAREA keyword
SPACE	Optional	Specifies the space requirements of an output data set that is created by dynamic allocation.	SPACE keyword
STORCLAS	Optional	Specifies the SMS storage class of an output data set that is created by dynamic allocation.	STORCLAS keyword
VOLSER	Optional	Specifies one or more volume-serial identifiers for the data set that is accessed by dynamic allocation. If this keyword is omitted for an output data set, nonspecific (private) volumes are required.	VOLSER keyword