|
|
|
|
|
Create a new workgroup.
The CREATE command will add a new workgroup to the database. Create workgroups in the \syscontrol\workgroups\ directory. All other directories are not valid Workgroup directories and you will not be allowed to create the Workgroup.
General Format
CREATE/WORKGROUP workgroup_name [/qualifiers]
Alternate
mkwg workgroup_name [-qualifiers]
Qualifier Summary
General qualifiers:
/[NO]LOG
/[NO]CONFIRM
/NODE = target_node
Workgroup qualifiers:
/COMMENTS=comment
/TYPE=database_type
/MODE=execution_mode
/STATE=status
/OWNER=owner
/PROTECTION=protection
/MEMBERS=workgroup_members
Examples
Schedule> create/workgroup \syscontrol\workgroup\new_wg
created \syscontrol\workgroup\new_wg
Qualifiers
/COMMENT:"any text string"
The COMMENT field is any useful description that you may want to add. This is an 80 character option.
/CONFIRM
/NOCONFIRM
CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.
/NODE=target_node
The NODE qualifier specifies what NODE (either local or remote) you want the operation performed on. /HOSTNAME may be substituted for /NODE.
/JOIN=member_string
The JOIN qualifier adds a node to thethe Workgroup and the Power rating, job limit and Quorum Votes that the node will have. Some example of member strings are
This result of this is that node1 is appended to the current member list. (The /member qualifier overwrites any previous member list).
/LOG
/NOLOG
The LOG qualifier causes each completed operation to issue a note to the user.
/MEMBERS=member_string
The MEMBERS qualifier sets the nodes that are in the Workgroup and the Power rating, job limit and Quorum Votes that the node will have. Some example of member strings are:
/members=node1+power_rating.#job_limit%quorum_votes*batch_queue
OR
/members=(node1+power_rating#job_limit%quorum_votes*batch_queue,node2+power_rating#job_limit%quorum_votes*batch_queue,…)
OR
/members=(node1,node2,node3)
Order is not important with respect to the portions of the string after the node.
where:
Members |
Description |
node_name |
Name of the node to be added to the Workgroup |
power_rating |
Rated power level of the node in the Workgroup |
job_limit |
Number of jobs that will be allowed to run on that node at one time |
quorum_votes |
Number of votes that the node will have in case other nodes fail |
batch_queue |
Batch queue that all jobs in the Workgroup will be submitted to |
/MODE=execution_mode
The MODE qualifier determines how the workgroups will execute job submissions. The possible modes are:
Mode |
Description |
all |
Run on ALL nodes in the Workgroup |
roundrobin |
Run in the nodes in a round-robin fashion |
failover |
Run on the first accessible node on the workgroup |
least |
Run on the least busy node in the workgroup |
none |
No jobs can run in the workgroup |
/OWNER:UIC
The OWNER field indicates the owner UIC code for the workgroup.
/PROTECTION:(s:rwedc,o:rwedc,g:rwedc, w:rwedc)
The PROTECTION field specifies the UIC based access rights for the workgroup.
/STATE=execution_state
The STATE qualifier determines whether the database is running jobs or paused. The states are:
State |
Description |
not_running |
All jobs are PAUSED or waiting to run |
run |
All jobs are allowed to RUN |
/TYPE=execution_type
The TYPE qualifier determines how the database will be distributed throughout the Workgroup, whether it be through clustering or replication. The types are:
Type |
Description |
limited |
The database is shared using a limited cluster system |
full |
The database is shared using a fully clustered system |
distributed |
The database is distributed between nodes |
replicated |
The database is distributed and replicated among nodes |