|
|
|
|
|
Display the contents of the workgroup directory.
The DIRECTORY displays the contents of the workgroup directory . The workgroup directory command only applies in the \syscontrol\workgroups\ directory. All other directories are not valid Workgroup directories.
General Format
DIRECTORY/WORKGROUP workgroup_name [/qualifiers]
Alternate
lswg 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
/symbol=[prefix_string,format]
/OWNER=owner
/PROTECTION=protection
/MEMBERS=workgroup_members
Examples
Schedule> directory/workgroup \syscontrol\workgroups\workgroup1 /full
\syscontrol\workgroups\workgroup1
Comments =
Type = Distributed_Database
Mode = None_Executable
State = Running
Job Limit = 0
Owner = {PJONES}
Protection = -rwxrw-----
Members = center+1#30%1*center$batch,alpha+1#30%1*alpha$batch
Total of 1 Workgroup
Qualifiers
/COMMENT
The COMMENT option displays any useful description that you may have added.
/CONFIRM
/NOCONFIRM
CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.
/NODE=node_name
The NODE qualifier specifies what node (either local or remote) you want the operation performed on.
/LOG
/NOLOG
The LOG qualifier causes each completed operation to issue a note to the user.
/MEMBERS=workgroup_members
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. The MEMBERS string is formulated as:
node_name+power_rating#job_limit%quorum_votes*batch_queue
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=workgroup_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 |
/PROTECTION:UIC
The OWNER field indicates the owner UIC code for the workgroup.
/PROTECTION
The PROTECTION field specifies the UIC based access rights for the workgroup.
/STATE=workgroup_state
The STATE qualifier determines whether the database is running jobs or paused. The states are:
State |
Description |
not |
All jobs are PAUSED or waiting to run |
run |
All jobs are allowed to RUN |
/symbol[=prefix_string] or [=(prefix string,format)]
The SYMBOL requests that all directory information be output to a group of environmental variables. Every field in the control record is loaded into a single environmental variable. The symbol name is constructed by prefixing the field name with the provide string. If none is provided a default value of SW is used.
The format defines the way that symbols are output. The default output specification is: "$ %s=\" %s\" "" which produces the following format style.
SW_MODE = "Do not run"
Alternate output styles may be created by changing the format field.
/TYPE=workgroup_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 |