GROUP

Use the GROUP option to tell

BMC AMI Copy

whether the spaces specified in the Object List should be treated as a group and, when you specify SHRLEVEL REFERENCE or SHRLEVEL CONCURRENT, share a common consistent point. GROUP enables subtasking. When you specify GROUP YES and SHRLEVEL CONCURRENT to make copies using the

SNAPSHOT UPGRADE FEATURE

, you can also use the STARTMSG keyword to issue a text message when

BMC AMI Copy

/Snapshot initialization is complete.

GROUP syntax diagram

Values of GROUP

Value	Description
GROUP NO	(Default) GROUP NO indicates that the Object List should not be treated as a group.
GROUP YES	GROUP YES indicates that the Object List should be processed as a group and share a common consistent point. GROUP YES is implied when a single COPY command is followed by multiple TABLESPACE or INDEXSPACE option statements or when INDEXES YES is coded. Important When using GROUP YES with SHRLEVEL CHANGE, you must code a QUIESCE BEFORE or QUIESCE AFTER if you want to establish a common point of consistency before or after the copy. BMC AMI Copy processes a group at a time. A new group is not started until the previous one completes. (See TASK for more information.) STARTMSG ‘ text ’ When you use SHRLEVEL CONCURRENT, use STARTMSG to write a message (BMC47497) to the MVS system log when BMC AMI Copy/Snapshot initialization has successfully completed. You can use this feature to trigger the submission of jobs that you want to run concurrently (SHRLEVEL CONCURRENT) with the BMC AMI Copy job. text is a character string of your choice of up to 50 characters and must be enclosed in single quotes. Strings over 50 characters are truncated. No quotes must appear within the text string. The message has the following format: BMC47497 SNAPSHOT STARTED: 'text' STARTMSG is valid only with GROUP YES. See Making-SHRLEVEL-CONCURRENT-copies-Snapshot-Copies for more information about using GROUP and STARTMSG.

Value

Description

GROUP NO

(Default) GROUP NO indicates that the Object List should not be treated as a group.

GROUP YES

GROUP YES indicates that the Object List should be processed as a group and share a common consistent point. GROUP YES is implied when a single COPY command is followed by multiple TABLESPACE or INDEXSPACE option statements or when INDEXES YES is coded.

Important

When using GROUP YES with SHRLEVEL CHANGE, you must code a QUIESCE BEFORE or QUIESCE AFTER if you want to establish a common point of consistency before or after the copy.

BMC AMI Copy processes a group at a time. A new group is not started until the previous one completes. (See TASK for more information.)

STARTMSG ‘ text ’
When you use SHRLEVEL CONCURRENT, use STARTMSG to write a message (BMC47497) to the MVS system log when BMC AMI Copy/Snapshot initialization has successfully completed. You can use this feature to trigger the submission of jobs that you want to run concurrently (SHRLEVEL CONCURRENT) with the BMC AMI Copy job.
text is a character string of your choice of up to 50 characters and must be enclosed in single quotes. Strings over 50 characters are truncated. No quotes must appear within the text string.
The message has the following format:
BMC47497 SNAPSHOT STARTED: 'text'
STARTMSG is valid only with GROUP YES.
See Making-SHRLEVEL-CONCURRENT-copies-Snapshot-Copies for more information about using GROUP and STARTMSG.

GROUP

On this page