| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
The Transfer to Group Job (TFRGRPJOB) command suspends the job that issued the TFRGRPJOB command, and the group job specified by the Group job (GRPJOB) parameter is resumed (if it already exists) or is created (if it does not exist). In both cases, control is transferred to the job specified by the GRPJOB parameter. The job issuing the TFRGRPJOB command remains suspended until control is passed back to it and the job is resumed.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| GRPJOB | Group job | Name, *PRV, *SELECT | Optional, Positional 1 |
| INLGRPPGM | Initial group program | Qualified object name | Optional, Positional 2 |
| Qualifier 1: Initial group program | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| SPCENV | Special environment | *DFT, *INLGRPPGM, *S36, *NONE | Optional |
| RSTDSP | Restore display | *NO, *YES | Optional |
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| Top |
Specifies the group job to which control is transferred.
| Top |
Specifies the qualified name of the job's first group program. This parameter only has meaning when a group job is created. If the group job being transferred to already exists, this parameter is ignored.
Qualifier 1: Initial group program
Qualifier 2: Library
| Top |
Specifies the environment in which the group job starts. This parameter is valid only when this command creates a group job. If control is transferring to an existing group, this parameter is ignored.
| Top |
Specifies whether data being shown at a display device by this display file is saved at the time the file is suspended (made temporarily inactive) so that a different display file can be used to show different data on the same device.
| Top |
Specifies text that describes the group job. This parameter only has meaning when a group job is created. If the group job being transferred to already exists, this parameter is ignored.
| Top |
TFRGRPJOB GRPJOB(GROUPJ1) INLGRPPGM(QGPL/PROGRAM1)
This command suspends running of the current job. If group job GROUPJ1 already exists, it is resumed at the point where it was suspended (the next high-level language command following the TFRGRPJOB request).
If group job GROUPJ1 does not exist, group job GROUPJ1 is created and runs the program PROGRAM1 in library QGPL.
| Top |
*ESCAPE Messages
| Top |