ICEFICO control statement

ICEFICO is the optional input data set that contains the user-specified control statements that define the allocation attribute for the work data set used in the FASTIC=(,DUMP) process.

The FASTIC=(,DUMP) process uses a temporary data set as a work file during the DFSMSdss DUMP command process. IMS HP Image Copy dynamically allocates the data set. When either of the following conditions apply, the temporary data set cannot be used:
  • The temporary data set is allocated as a virtual input/output (VIO) data set by system definition.
  • The TEMPDSN class of RACF® is active.
If either condition applies, use the ICEFICO data set and provide allocation information for the temporary data set in it.

VIO data sets and tape units cannot be used as a temporary output work data set for DFSMSdss. If you specify the ICEFICO DD statement, IMS HP Image Copy allocates a work data set for FASTIC=(,DUMP) by providing allocation information. This data set is then deleted when the process ends. If the ICEFICO data set is not provided, IMS HP Image Copy uses the OS temporary data set for work data set.

The allocated space for the data set is one cylinder.

If you specify the name of the ICEFICO data set name for the DSSTEMP keyword of the GLOBAL statement, IMS HP Image Copy allocates the ICEFICO DD dynamically and uses it. For more information about the DSSTEMP keyword, see DSSTEMP keyword.

Subtopics:

Format

This control 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. BLKSIZE, if coded, must be a multiple of 80.

The following figure shows an example of the control statement in the ICEFICO data set:

//ICEFICO  DD *  
  HLQ=ICSMS1.TESTDS,  
  DATACLAS=DCICSTN,  
  MGMTCLAS=MCICSTN,  
  STORCLAS=SCICSTN
Note: On the control statement, you can code uppercase alphabetic characters, numeric characters, and the following special characters:
  • Asterisk (*)
  • Comma (,)
  • Equal sign (=)
  • Parenthesis ( )

Control statement syntax

The following describes the coding conventions that you must follow when writing control statements in the ICEFICO data set:

  • The parameters must be coded within column 1 and column 72.
  • When more than one option parameter is coded, they must be separated by commas. No blanks are allowed between the option parameters and the commas, or within the option parameters.
  • Option parameters can be continued onto one or more following control statement records.
  • Option parameters are not positional parameters; they can be specified in any order of sequence. A null value is not allowed for any option parameter.
  • Comments can follow the last option parameter on each control statement record separated by at least one blank.
  • A comment line must begin with an asterisk in column 1.

Parameters

Input parameters of ICEFICO are:

  • DATACLAS
  • HLQ
  • MGMTCLAS
  • STORCLAS
  • VOLSER
  • UNIT
DATACLAS
The DATACLAS keyword specifies the name of the data class for the SMS-managed work data set that is dynamically allocated.
HLQ
You can specify a high-level qualifier for the work data set. You can specify up to 22 bytes qualifier. IMS HP Image Copy allocates the data set by using the following naming rule: DSN=hlq.Jnnnnn.Dyyddd.Thhmmss
MGMTCLAS
The MGMTCLAS keyword specifies the name of the management class for the SMS-managed work data set that is dynamically allocated.
STORCLAS
The STORCLAS keyword specifies the name of the storage class for the SMS-managed work data set that is dynamically allocated.
VOLSER
The VOLSER keyword specifies the volume serial number.
UNIT
The UNIT keyword specifies the UNIT parameter of the work data set.