CL Command Reference - CHGGRPA
CL Command List > CHGGRPA Reference
Description:
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:
. An interactive job can be changed into a group job.
. A group job can be changed into a non-group, interactive job.
. A message queue can be associated with a group.
. A message queue can be disassociated from a group.
. A group jobĄ¯s descriptive text can be changed.
Restrictions:
1. To use this command, you must have:
. use (*USE) authority to the message queue (MSGQ) and execute (*EXECUTE) authority to the library that contains that message queue.
Examples:
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.