ICHLQn keyword

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

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

You can use such a prefix when you dynamically allocate an output image copy data set by use of Create Image Copy.

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 ICHLQn 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 in the other ICEIN statements is ignored.
Site default option
Supported
Related keyword
None.
Format
Read syntax diagramSkip visual syntax diagramICHLQ n= hlqn
n
Use ICHLQn to specify the data set name prefix for the nth output image copy data set. n is 3 through 7. For example, use ICHLQ5 to specify the data set name prefix for the fifth output image copy data set.
hlqn
The data set name prefix of the nth output image copy data set for the Create Image Copy function, or sets a value in &ICHLQn.
Default value
None.
Usage notes
  • 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, no data set name prefix is assigned.