ICHLQ2 keyword

The ICHLQ2 keyword specifies the data set name prefix for the secondary image copy data set.

If the DSN2 keyword is specified, IMS HP Image Copy refers to the symbolic parameter $ICHLQ2 to assign the data set name prefix. If the DSN2 keyword is not specified, IMS HP Image Copy uses the high-level qualifier (hlq2) that the ICHLQ2 keyword specifies for the prefix of the secondary image copy data set.

You can use data set name prefix when you request dynamic allocation of the output image copy data set.

Functions that support this keyword
  • Image Copy function
  • Create Image Copy function
Statements that support this keyword
If you specify the DSN keyword for a naming template, or if you do not specify the DSN keyword and the output data set is specified by the ICOUT keyword, you can use the ICHLQ2 keyword for the following statements:
  • GLOBAL statement
  • GROUP statement
  • IC/AIC statement
  • CIC/ACIC statement
  • CRC statement
The value specified on the GLOBAL statement can be overwritten by each GROUP, IC, AIC, CIC, ACIC, and CRC statement.
If you do not specify the DSN keyword and the output data set is specified by the STACK keyword, you can use the keyword for the following statement:
  • GLOBAL statement
The value specified on other ICEIN statements is ignored.
Site default option
Supported
Related keyword
None.
Format
Read syntax diagramSkip visual syntax diagramICHLQ2= hlq2
hlq2
The data set name prefix of the secondary output image copy data set for the Image Copy function or the Create Image Copy function, or sets a symbolic value of &ICHLQ2.
Default value
None.
Usage notes
  • The ICHLQ2 keyword cannot be specified with ICHLQ=(hlq1,hlq2).
  • This prefix is used as the high-level qualifier of the data set name.
  • This prefix must conform to the normal data set naming standards; it can include periods but must not end with a period.
  • MVS naming convention requires that a generated data set name contain 44 or fewer characters.
  • If you do not specify the DSN keyword, and if you specify the output data set by using the ICOUT keyword and use the default naming rule with ICNMRULE=N, hlq can be specified as the data set name prefix containing 33 or fewer characters.
  • If you do not specify the DSN keyword, and if you specify the output data set by using the STACK keyword or use the default naming rule with ICNMRULE=Y, hlq can be specified as the data set name prefix containing 7 or fewer characters.
  • If you specify the DSN keyword, hlq can be specified as the data set name prefix containing 44 or fewer characters.
  • If this keyword is left blank, a data set name prefix is not assigned.