End Group Job (ENDGRPJOB)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The End Group Job (ENDGRPJOB) command ends a single job within a group and resumes another job within the group. You can specify the following:

Top

Parameters

Keyword Description Choices Notes
GRPJOB Group job Name, * Optional, Positional 1
RSMGRPJOB Group job to be resumed Name, *PRV Optional
LOG Job log *NOLIST, *LIST Optional
Top

Group job (GRPJOB)

Specifies the group job name of the job being ended.

*
The group job that issued this command is ended.
name
Specify the group job name of the job being ended.
Top

Group job to be resumed (RSMGRPJOB)

Specifies the group job name of the job that is resumed after the active job in the group has ended. This parameter is valid only when the job that issues this command is ending itself.

*PRV
The most recently active group job is resumed.
name
Specify the group job name of the job that is resumed after the active job in the group ends.
Top

Job log (LOG)

Specifies whether to produce the job log for the ending group job.

*NOLIST
The information in the job log is not spooled to an output queue.
*LIST
The information in the job log is spooled to an output queue.
Top

Examples

Example 1: Ending Group Job that Issued Command

ENDGRPJOB   GRPJOB(*)  LOG(*LIST)  RSMGRPJOB(GROUPJOB1)

This command ends the job that is currently running. Its job log is spooled to an output file for printing. When the job completes running, group job GROUPJOB1 becomes the active job in the group.

Example 2: Printing Output of Ended Job

ENDGRPJOB   GRPJOB(GROUPJOB2)  LOG(*LIST)

Assume that the job issuing the ENDGRPJOB command is group job GROUPJOB1, which wants to end GROUPJOB2. Group job GROUPJOB2 ends. Its job log is spooled to an output file for printing.

Example 3: Ending a Job That's Part of a Secondary Job Pair

ENDGRPJOB   GRPJOB(*)  LOG(*NOLIST)

Assume that the job issuing the ENDGRPJOB command is the only job in the group and is part of a secondary job pair. The job issuing the command ends. The job's job log is not spooled to an output file. When the job ends, the other job in the secondary job pair is resumed.

Top

Error messages

*ESCAPE Messages

CPF1309
Subsystem cannot complete the &1 command.
CPF1314
Value &1 for parameter &2 not allowed.
CPF1317
No response from subsystem for job &3/&2/&1.
CPF1322
The End Group Job command not allowed at this time.
CPF1323
Group job &1 not ended; parameters do not agree.
CPF1324
Group job &1 not ended; parameters do not agree.
CPF1325
Group job &1 not ended; group job &2 does not exist.
CPF1326
Group job &1 does not exist.
CPF1327
Cannot end group job &1 with ENDGRPJOB.
CPF1351
Function check occurred in subsystem for job &3/&2/&1.
Top