GROUPID parameter - IBM-JCL

Parameter Type

Keyword, optional, JES2 only

Purpose

Use the GROUPID parameter to specify that the sysout data set belongs to an output group. The data sets in an output group are processed together in the same location and time. Data sets to be grouped should have similar characteristics: the same output class, destination, process mode, and external writer name.

Note: GROUPID is supported only on JES2 systems.

1.Syntax

GROUPID=output-group

2.Subparameter Definition

output-group
Specifies the name of an output group. The output-group is 1 through 8 alphanumeric characters and is selected by the programmer to define an output group for this job. The name is not installation-defined.

3.Relationship to Other Control Statements
If you code FREE=CLOSE on a sysout DD statement that references an OUTPUT JCL statement containing a GROUPID parameter, JES2 will not group the data sets into one output group. Instead, JES2 produces one copy of the sysout data set for each OUTPUT JCL statement that the DD statement references.

4.Examples of the GROUPID Parameter

Example

In this example, the DD statements RPTDLY and RPTWK implicitly reference the default OUTPUT JCL statement OUTRPT. JES2 creates two output groups:

  1. Group RPTGP is created because of the GROUPID parameter in the OUTPUT JCL statement. It contains the two reports from the sysout DD statements RPTDLY and RPTWK and is printed at the destination TDC. The programmer named this group RPTGP.
  2. The other group is named by JES2. It contains the system-managed data set for the job’s messages.

Example

This job causes JES2 to produce five sets of output:

  • 1.1.1, containing the system-managed data sets. This set is specified through the JOB statement MSGCLASS parameter.
  • SUMM.1.1, containing a copy of the data set defined by DD statement RPT1. This set is specified through the second OUTPUT subparameter: *.JOBOUT. It is for output class A.
  • SUMM.2.1, containing a copy of the data set defined by DD statement RPT2. This set is specified through the second OUTPUT subparameter: *.JOBOUT. Because it is for output class B, it is in a separate subgroup from the SUMM.1.1 subgroup.
  • 4.1.1, containing a copy of the data set defined by DD statement RPT1. This set is specified through the first OUTPUT subparameter: *.OUT1.
  • 5.1.1, containing a copy of the data set defined by DD statement RPT2. This set is specified through the first OUTPUT subparameter: *.OUT2.

All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM-JCL Topics