| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
The Change Group Attributes (CHGGRPA) command changes the group attributes of an interactive job. The CHGGRPA command must be used to change an interactive job into a group job before a Transfer to Group Job (TFRGRPJOB) command can be used. The following attributes can be changed:
More information about group jobs is in the Work management topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| GRPJOB | Group job | Name, *SAME, *NONE | Optional, Positional 1 |
| MSGQ | Message queue | Single values: *SAME, *NONE Other values: Qualified object name |
Optional, Positional 2 |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
Specifies the group job name assigned to the job.
| Top |
Specifies the name of a message queue that is associated with a group. This message queue must exist, but it does not necessarily need to be allocated to the job at the time this command is issued.
Single values
Qualifier 1: Message queue
Qualifier 2: Library
| Top |
Specifies up to 50 characters of text that describe the group job. This text appears on the Group Job Selection Display for the Transfer to Group Job (TFRGRPJOB) Command.
| Top |
Example 1: Changing an Interactive Job to a Group Job
CHGGRPA GRPJOB(GROUPJ1) MSGQ(QGPL/GRPMSGQ)
An interactive job is first changed to a group job before it is allowed to create other group jobs at the work station. This command changes a work station job into a group job with the group job name GROUPJ1; a message queue is associated with the group and (as long as it is in break or notify mode in the job issuing a TFRGRPJOB or End Group Job (ENDGRPJOB) command) is allocated to the active job in the group. The group data area (*GDA) is also created.
Example 2: Changing a Group Job to a Nongroup Job
CHGGRPA GRPJOB(*NONE)
Assume that the job in the previous example issues this command. Assume also that the job is the only active job in the group. Group job GROUPJ1 is changed into a nongroup, interactive job. The group job name is removed, and the group data area (*GDA) is deleted. The change from a group job into a nongroup job occurs only if it is the only active job in the group.
| Top |
*ESCAPE Messages
| Top |