Skip to Content

Default language.

+CONTROLPREFIX

Related topics

Global parameters (UTLPARMS)

The +CONTROLPREFIX parameter allocates INFO and OUTPUT data sets with the provided prefix string, instead of using the prefix value specified by WORKPREFIX. Using +CONTROLPREFIX allows these two data sets to be in a different SMS pool because they stay on the system for the number of days specified with the parameter OUTPUTAGE, while the other data sets are deleted upon successful completion of the job.

+CONTROLPREFIX is set by the configuration job, usually UBMCCNTL(NGT$GLBL). You can override this parameter in individual utility jobs with the UTLPARMS DD. You can set the value of the +CONTROLPREFIX parameter dynamically at utility runtime by using the XSUTGLOB (global variable definition) automation control point. 

GUID-77C36848-7CDE-4965-92B3-46C03CD98A47-low.png

The value is defined as follows:

HLQ

Any valid MVS high-level qualifier (HLQ) or supported variable. You can use any of the following symbolic variables:

 

Variable

Description

&ATTACH

Db2 group attachment name or Db2 subsystem ID (up to four characters)

&GROUP

Db2 data-sharing group name (up to eight characters)

In a non-data-sharing environment, &GROUP contains the Db2 subsystem ID (up to four characters).

&SSID

The Db2 subsystem name or group name specified on the PARM=name attribute

&VER

The version (for example, 1310) of BMC AMI Utility being executed

&VER3

The first three characters of the version (for example, 131) of BMC AMI Utility being being executed

&VER2

The first two characters of the version (for example, 13) of BMC AMI Utility being executed.

&USER1

The value of the USER1(userVariable) parameter

&USER2

The value of the USER2(userVariable) parameter

The HLQ is appended to a unique timestamp-based identifier, and the data set suffixes.

Information
Example
+CONTROLPREFIX(ADMIN.NGT)

In this example, the data sets should begin with ADMIN.NGT:

  • ADMIN.NGT.tttttttt.uuuuuuuu.INFO001 (information data set for BMC AMI Utilities)
  • ADMIN.NGT.tttttttt.uuuuuuuu.OUT001 (output data set for BMC AMI Utilities)
Warning

Important

For the rules that apply to parameter syntax, see Parameter syntax rules.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Load for Db2 13.1