+WORKPREFIX

The +WORKPREFIX parameter specifies the data set name prefix for dynamic allocation of VSAM work (temporary) data sets.

You can specify the value of this parameter using the XSUTGLOB-global-variable-definition-automation-control-point.

BMC AMI Utilities create the following data sets during processing:

Information data set for BMC AMI Utilities. The suffix is .INFO001.
Output data set for BMC AMI Utilities. The suffix is .OUT001.
Scratch data set used for general processing. The suffix is .WK00001.
Copy data set for BMC AMI Reorg. The suffix is .RGTS0001.

Important

It is important that you enable extended-addressability for the DASD pool used for the +WORKPREFIX data sets.

The +WORKPREFIX parameter is saved across restarts. You cannot change the +WORKPREFIX value on a restart.

You can use the CONTROLPREFIX parameter to provide a different prefix for the INFO and OUT data sets, enabling these two data sets to be in a different SMS pool because they stay on the system up to the number of days defined by the OUTPUTAGE parameter, while the other two are deleted upon successful completion of the job.

The single value is defined as follows:

workPrefix

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

You can specify up to 15 characters or use the following supported symbolic variables:

Variable	Description
&ATTACH	Db2 group attachment name or subsystem ID
&DA	Current date (in the format MMDDYY)
&DATE	Current date (in the format YYMMDD)
&DATEJ	Current Julian date (in the format YYYYDDD)
&DAY	Current day (in the form DD)
&DT	Current Julian date (in the format YYYYDDD)
&GDATE	Gregorian date (in the format yyyymmdd)
&GROUP	Db2 group name (up to eight characters)
&GRPNM	Db2 data sharing group name or, in a non-data sharing environment, the Db2 SSID
&HO	Current hour (in the form HH)
&HOUR	Current hour (in the form HH)
&JD	Current Julian date (in the form DDD)
&JDATE	Current Julian date (in the form YYDDD)
&JDAY	Current Julian day (in the form DDD)
&JO	JOB name used in the JCL
&JOBNAME	JOB name used in the JCL
&JU	Julian data (in the form YYDDD)
&MEM	Db2 data-sharing member name
&MEMBER	Db2 data-sharing member name
&MIN	Current minute (in the form MM)
&MINUTE	Current minute (in the form MM)
&MO	Current month (in the form MM)
&MONTH	Current month (in the form MM)
&SC	Current second (in the form SS)
&SEC	Current second (in the form SS)
&SECOND	Current second (in the form SS)
&SEQ	Sequence number that increments with each reference You can use it to provide unique output data set names. The sequence number restarts at 1 for each step.
&SS	The Db2 subsystem name or group name specified on the PARM=name attribute
&SSID	The Db2 subsystem name or group name specified on the PARM=name attribute
&ST	STEP name used in the JCL
&STEPNAME	STEP name used in the JCL
&TI	Current time (in the format HHMMSS)
&TIME	Current time (in the format HHMMSS)
&TIME4	Current time (in the format HHMM)
&UID	Job or TSO user ID
&UNIQ	Unique characters (eight characters)
&US	User name
&USER	User name
&USERID	Job user ID
&UT	BMC utility ID
&UTIL	BMC utility ID
&UTILID	BMC utility ID
&UTILNAME	BMC utility name
&UTILPFX	BMC utility ID prefix
&UTILSFX	BMC utility ID suffix
&UQ	Unique characters (eight characters)
&VER	The version (for example, 1210) of BMC AMI Utility being executed
&VER2	The first two characters of the version (for example, 12) of BMC AMI Utility being executed.
&VER3	The first three characters of the version (for example, 121) of BMC AMI Utility being executed
&VERSION	Version of BMC AMI Utilities (four numerical characters, for example, 1210)
&USER1	The value of the USER1(userVariable) parameter
&USER2	The value of the USER2(userVariable) parameter
&YE	Current year (in the form YY)
&YEAR	Current year (in the form YY)

Important

After the variable is resolved, workPrefix cannot exceed 15 characters.

Before resolution, workPrefix including variable names cannot exceed 32 characters.

The entire work data set name, including all qualifiers, cannot exceed 42 characters or IDCAMS errors might result.

An * (asterisk) is substituted with the user ID associated with the JOB.

Example

If you enter *workPrefix, the *(asterisk) is substituted with the user ID associated with the JOB and the value of workPrefix is appended.

An *(asterisk) can only be specified for the first character.

Example

+WORKPREFIX(ADMIN74.NGTJOBS)

In this example, BMC AMI Utilities create the following data sets during processing (where tttttttt.uuuuuuuu represents the unique timestamp-based identifier):

ADMIN74.NGTJOBS.tttttttt.uuuuuuuu.INFO001 (information data set for the utility)
ADMIN74.NGTJOBS.tttttttt.uuuuuuuu.OUT001 (output data set for the utility)
ADMIN74.NGTJOBS.tttttttt.uuuuuuuu.WK00001 (scratch data set for processing)
ADMIN74.NGTJOBS.Ntttttttt.uuuuuuuu.RGTS0001 (copy data set)

Important

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

+WORKPREFIX

On this page