ICHLQ keyword

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

You can use data set name prefix when you request dynamic allocation of the output image copy data set by specifying ICDALLOC=Y, ICOUT=*, or the STACK keyword.

Functions that support this keyword
  • Image Copy function
  • Create Image Copy function
Statements that support this keyword
If you specify the DSN keyword for the 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 ICHLQ 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 ICHLQ keyword for the following statement:
  • GLOBAL
The ICHLQ values specified for other ICEIN statements are ignored.
Site default option
Supported
Related keyword
None.
Format
Read syntax diagramSkip visual syntax diagramICHLQ=hlq( hlq1, hlq2)
hlq
The data set name prefix of the output image copy data set for the Image Copy function or the Create Image Copy function, or sets a value in &ICHLQ.
hlq1
The data set name prefix of the primary output image copy data set for the Image Copy function, or sets a value in &ICHLQ.
hlq2
The data set name prefix of the secondary output image copy data set for the Image Copy function, or sets to a value in &ICHLQ2.
Default value
None.
Usage notes
  • The hlq2 parameter and the ICHLQ2 keyword cannot be specified together.
  • The 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 the generated data set name contains 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, data set name prefix is not assigned.