Performing Administrative Tasks in Batch › Define Statements › The Define Approver Group Action › Define Approver Group Syntax

Define Approver Group Syntax

►►─ DEFine APProver GROup ─ group-name ───────────────────────────────────────►

 ►─ TO ─ ENVironment ─ environment-name ─ TITle ─ title-text ─────────────────►

 ►─┬────────────────────────────────┬─────────────────────────────────────────►
   └─ QUOrum SIZe ─ IS ─┬─ 0 ◄ ───┬─┘
                        └─ value ─┘

 ►─┬────────────────────────────────────────────────────────────────────┬─ . ─►◄
   │                         ┌────────────── , ───────────────────┐     │ 
   └─ APProver ─┬─ EQ ─┬─ ( ─▼─ ( ─ id ──, ─┬─ REQuired ─────┬ ) ─┴─ ) ─┘
                └─ = ──┘                    └─ NOT REQuired ─┘

DEFINE APPROVER GROUP group-name

The DEFINE APPROVER GROUP clause identifies the up to sixteen-character name of the approver group you are creating or updating. You can specify a partially or fully wildcarded approver group name. A wildcarded approver group name updates all matching approver group definitions.

TO ENVIRONMENT environment-name

The TO ENVIRONMENT clause identifies the environment to which you are defining the approver group. You must use a fully specified and non-wildcarded environment name.

TITLE title-text

The TITLE clause identifies a 1- to 50-character description of the approver group you are creating or updating. You must specify the TITLE clause if are creating an approver group. The clause is optional if you are updating an approver group. If the text contains imbedded spaces, enclose it in single or double quotation marks.

QUORUM SIZE IS value

The QUORUM SIZE CLAUSE IS clause specifies the minimum number of approvers who must approve a package before it can be executed. The quorum size is optional when both creating and updating an approver group definition. If you specify this clause, the value must between 0 and 16. If you do not specify this clause, the default is 0.

APPROVER EQ = id, REQUIRED/NOT REQUIRED

The APPROVER clause specifies whether the approver ID is required to approve the package. The clause contains two fields, the approver ID field and the REQUIRED or NOT REQUIRED field. If you specify more than one approver ID, enclose the fields in parentheses and separate by commas. For example, to define IDs USER01 and USER02 as required approvers, the APPROVER clause would be specified as:

APPROVER=((USER01,REQUIRED),(USER02,REQUIRED))

When creating or updating an Approver Group definition, the APPROVER clause is optional. If an Approver Group has no approvers, CA Endevor SCM uses external approvers and uses the approver group name as the external security group or profile name.

Example: Define Approver Group SCL

The following is an example of the DEFINE APPROVER GROUP SCL. The example creates an Approver Group named ACCTPAY. This group contains five User IDs. Two of the five User IDs are required for approval. There is a quorum size of three which means that one of the not required users must also approve the package.

DEFINE APPROVER GROUP "ACCTPAY1"
   	  TO ENVIRONMENT "DEVEL"
     	  TITLE "Accounts Payable Approver Group"
   	  QUORUM SIZE IS 3
   	  APPROVER EQ ( (USER001, REQUIRED),
          		    (USER002, NOT REQUIRED),
          		    (USER003, NOT REQUIRED),
          		    (USER004, REQUIRED),
          		    (USER005, NOT REQUIRED) ) .