 |
 |
 |
 |
UNIPASSWD
unipasswd - Change a user password on a CorporateTime database.
SYNTAX
- unipasswd [-e entry | -sysop | -cwsop] [-n node-ID] [-host hostname] [-p sysOpPsw]
- unipasswd -v
- unipasswd -h
DESCRIPTION
unipasswd changes the password of the SYSOP, the CWSOP, or a specific user on a given node. By default, the SYSOP password is changed. Note that the -e, -sysop and -cwsop options are all mutually exclusive.
unipasswd can only be run if the CorporateTime Server is up.
OPTIONS
-cwsop
Change the password of the CWSOP.
-e
Change a user password (search filter). See FORMAT OF THE entry ARGUMENT for details on how to specify entry.
-host
Specify the host on which the operation is to be performed. The default is the local host.
-n
Specify the node on which the password is to be changed. Required if more than one node exists.
-p
Provide the SYSOP password. Required if -e option is used and a SYSOP password is set. If this is required and it is not supplied on the command line, prompting for it will occur.
-sysop
Change the password of the SYSOP.
-v
Print the current version number of unipasswd.
-h
Print a usage message explaining how to run unipasswd.
FORMATS
FORMAT OF THE entry ARGUMENT
The entry argument is a string of the form "key=value/key=value/...", where "key" is one of those listed below, and "value" is any string. Both "key" and "value" are case insensitive. The "value" string may be terminated by a wild card symbol (*). If a forward slash "/" is to be included in a string, it should be escaped with the character "\" to prevent it from being interpreted as a key-value pair delimiter - i.e. "S=Hoopla/OU1=R\/D".
If, in a UNIX environment, a shell will be processing the string (e.g. the string is provided on the command line or is passed as an argument to the utility), the string should be enclosed in quotation marks. Furthermore, if characters meaningful to the shell are included in the string, they should be escaped (i.e. preceded by the escape character "\") to prevent the shell from interpreting them.
EXAMPLES
Change the SYSOP password on node 20 on the remote host "jupiter":
% unipasswd -host jupiter -n 20Change the password of the local user "Jean Leblanc" on node 10:
% unipasswd -e "S=Leblanc/G=Jean" -n 10Change the local CWSOP password where only one node is configured:
% unipasswd -cwsop
WARNINGS
Modification of Password
This utility uses the "adm_moduserpassword" key-value pair in the [UTL] section of the unison.ini file to determine whether or not it can modify the user password. If this value is set to FALSE, then the user password cannot be modified by this utility. If this key-value pair does not appear in the file, the utility assumes it CAN modify the password.
Directory Server Warning
It is important to understand the implications of the directory server configuration for CorporateTime utilities. In a supplier-consumer configuration, the scheduling of updates between the consumer and supplier may result in temporary differences between the two. This may mean that a CorporateTime utility is reading from a consumer directory server that has not yet been synchronized with its supplier.
EXIT STATUS
UNIREQDUMP
unireqdump - View, and optionally delete, requests in the queue of the Corporate-Wide Services (CWS) daemon.
SYNTAX
- unireqdump [-chunk n] [-delete] [-excl filter] [-incl filter] [-item itemnum] [-remotenode node-ID] [-prompt] [-reqid ID] [-trcode code] [-n node-ID] [-p sysOpPsw]
- unireqdump -v
- unireqdump -h
DESCRIPTION
unireqdump outputs the set of requests currently in the queue of the Corporate-Wide Services daemon/service, unicwsd. The utility is also used to delete requests from the queue (using the -delete option).
By default, all requests in the queue are output. The -excl, -incl, -item, -remotenode, -reqid, and -trcode options allow you to select requests satisfying specific criteria. These options are applied successively so each of the requests in the output must meet the combined criteria for all of the options specified.
Numeric arguments can be either decimal or hexadecimal values (where hexadecimal values are prefixed by "0x"). The single exception is the ID argument to the -reqid option, where a hexadecimal value is always assumed, even if the "0x" prefix is not present.
unireqdump can only be run if the CorporateTime Server is up.
OPTIONS
-chunk
Transfer selected requests from unicwsd to unireqdump in chunks of at most n requests. As the chunk size is increased, fewer network transactions (i.e. communications between unicwsd and unireqdump) are required, but more memory (for buffers) is needed by both unicwsd and unireqdump. The default value is 50, and should not need to be changed.
-delete
Enable the deletion option. After each request is output, the user will be prompted to confirm whether or not they wish to delete it. The -prompt option may be used along with this option to tell unireqdump to automatically delete ALL of the requests in the output, without prompting for confirmation.
-excl
Set an exclusion filter; requests matching this filter are excluded from the output. The possible filters are:
-incl
serviced Requests already serviced notserviced Requests not yet serviced unserviced Synonym for "notserviced" cantservice Requests that cannot be serviced
Set an inclusion filter; requests matching this filter are included in the output. The possible filters are listed under the -excl option.
-item
Select only requests matching the specified item number. itemnum is the numeric ID of the item; it can be obtained by using a client to log onto the CorporateTime Server as the item, and then displaying the 'About Connection' box.
-n
Specify the node from which the request originated. Required if more than one node exists on the server running unireqdump. The SYSOP password unireqdump requires is the one for this node.
-p
Provide the SYSOP password. If the password is not supplied on the command line, prompting for it will occur.
-prompt
Used with the -delete option to tell unireqdump to automatically delete all of the requests in the output, without prompting for confirmation. Use this option with care!
-remotenode
Select only requests destined for the specified remote node.
-reqid
Select the request with the specified ID. ID is a hexadecimal value (it is not necessary to prefix the value with "0x", though doing so causes no harm).
-trcode
Select requests with the specified transaction code. The transaction code may be expressed numerically (the numeric values are available in the documentation for the calendar programming interface), or as one of the following strings:
agendagetPrint the current version number of unireqdump.
-h
Print a usage message explaining how to run unireqdump.
EXAMPLES
Select all requests in the queue which originate in node 10:
unireqdump -n 10 -p sysOpPswOutput all requests in the queue which originate in node 10, and interactively prompt for confirmation to delete each one:
unireqdump -delete -n 10 -p sysOpPswOutput all requests in the queue except those already serviced (a single node exists on this server so the -n option is unnecessary):
unireqdump -excl serviced -p sysOpPswOutput all unserviced requests with the "eventattend" transaction code, orginating in node 10 and destined for the remote node 20, and interactively prompt for confirmation to delete each one:
unireqdump -delete -excl serviced -remotenode 20 -trcode eventattend -n 10 -p sysOpPsw
EXIT STATUS
UNIRES
unires - A utility to list, add, or delete CorporateTime resources, or to modify the information associated with them.
SYNTAX
Listings
- unires -ls [res] [-format format] -n node-ID [-p sysOpPsw]
- unires -format format -n node-ID [-p sysOpPsw]
Addition
- unires -add res [-s sections] -n node-ID [-p sysOpPsw]
Deletion
- unires -del res [-y] -n node-ID [-p sysOpPsw]
- unires -desdel res -n node-ID [-p sysOpPsw]
- unires -grpdel res -n node-ID [-p sysOpPsw]
Modification
- unires -mod res -s sections | -m modifier -n node-ID [-p sysOpPsw]
Multiple additions, deletions, modifications
- unires -ex filename [-s sections] [-k] -n node-ID [-p sysOpPsw]
Other
- unires -s [sections] -n node-ID [-p sysOpPsw]
- unires -info
- unires -v
- unires -h
DESCRIPTION
unires is used to list, add, or delete CorporateTime resources, and to modify the information associated with them. Resources are identified by their names so each must be unique. Details on how to specify the res argument are given in the FORMAT OF THE res ARGUMENT section below. Note that the -ls, -add, -del, and -mod options are all mutually exclusive.
The information associated with a resource is a combination of the key-value pairs described in the FORMAT OF THE res ARGUMENT below and that contained in the resource.ini file (which includes the resource preferences, security, personal group, admin group membership, and the list of users permitted to work as a designate for the resource).
uniuser is the complementary utility for users.
unires can only be run if the CorporateTime Server is up.
OPTIONS
-add
Create a new resource. If the resource already exists, an error is reported. The information associated with the new resource is a combination of what is specified in the res argument, and the default values contained in the GEN section of the resource.ini file. The -s sections option may be used to apply default values from particular sections of the resource.ini file. If more than one resource is to be created, the -ex option must be used.
For directory servers, the DID (Directory ID) must be specified in the res argument.
-del
Delete the specified resource. unires will prompt for confirmation before actually performing the deletion unless the -y option is used. If more than one resource is to be deleted, the -ex option must be used.
-desdel
Delete the list of designates for the specified resource. If more than one resource matches res, the command will fail.
-edit
This option exists only under UNIX. It allows you to first output the list of existing CorporateTime resources to a file, then edit the file to make desired modifications, and finally input the changes back into the node. The following sequence of commands is performed:
% unires -ls -n node-ID > filePerform the additions, deletions and/or modifications specified in filename. Each line of the file must begin with one of the characters '.', '#', 'A', 'a', 'D', 'd', 'M', 'm', 'S' or 's'. This initial character specifies the action to take, as follows:
`.' or `#' | the line is ignored
`A' or `a' | the resource is added
`D' or `d' | the resource is deleted
`M' or `m' | the resource is modified.
'S' or 's' | the resource settings are updated from resource.ini.
The initial character must be followed by a space and a resource specification. In the case of a modification, the ID for the resource must be supplied; it is used to identify the resource, while the other key-value pairs specified along with it are applied as the modifications. See EXAMPLES.
For each deletion specified in the file, unires will prompt for confirmation before performing the deletion. The -y option may be used to automatically provide confirmation.
One way to create this file is to save the output of unires -ls to a file. This can then be edited and input to unires -ex.
The -s sections option may be used with -ex to set the corresponding resource information to the default values contained in the specified sections of the resource.ini file.
For directory servers, the DID can be followed by data in X.400 format. Note that the ability to modify the name of a resource (the R key) depends on the directory server.
-format
This option is used to select resource information fields and customize the format of the output. The -info option lists the parameters that can be used to specify the customized format. These are also listed in the FORMAT OF THE res ARGUMENT section below. If this option is not used, all resource information fields are output, and a default presentation is used. See EXAMPLES.
-grpdel
Delete the specified resource from all admin groups. A single resource must match res or the command will fail.
-info
List the format parameters used with the -format option.
-k
Used with the -ex option to force unires to process all lines in the file even if it encounters an error. Errors are sent to standard output; file redirection may be used to capture these to a file.
-ls
If a resource is specified, -ls lists that resource (in the specified node). Each output line contains a period (`.'), a space, the resource description, and the ID of the resource. If no resource is specified, all resources in the node are listed. The -format option can be used with -ls to configure the presentation of the output (see EXAMPLES).
-m
Specify a modification to be made to the resource information. The modifier is a string of the same form as the res argument with the following exceptions: the ID key may NOT be specified, and the PSW key MAY be specified.
-mod
Modify the information associated with the specified resource. This option is used with either the -s sections or the -m modifier option. When used with the -s sections option, it sets the corresponding information for the resource to the values contained in the specified sections of the resource.ini file. When used with the -m modifier option, modifications are made to the key-value pairs listed in the FORMAT OF THE res ARGUMENT. In the case of a directory server, the ability to modify the name of a resource (the R key) may depend on the directory server.
-n
-p
Provide the SYSOP password for the specified node. If this option is not used, prompting for the password will occur.
-s
Evaluate all or some of the contents of the resource.ini file and output information from it to standard output. By default, all sections of the resource.ini file are evaluated, and all section names along with their respective "info" key-value pairs are listed.
The sections argument restricts the evaluation to only the specified sections. In this case all key-value pairs of the specified sections are output, along with any errors. The sections argument is a list of one or more section names, each separated by a forward slash (e.g. "GEN/GR1/GR2" specifies the sections GEN, GR1 and GR2). Evaluation is done from right to left. Thus, in the above example, GR2 would be evaluated first, GR1 second, and GEN last. Where the same key appears in more than one section, the value of the first instance evaluated takes precedence.
-y
Used with the -del and -ex options to auto-confirm the deletion(s).
-v
Print the current version number of unires.
-h
Print a usage message explaining how to run unires.
FORMATS
The res is a string of the form "key=value/key=value/...", where "key" is one of those listed below, and "value" is any string. Both "key" and "value" are case insensitive. For all keys except the ID key, the "value" string may be terminated by a wild card symbol (*). If a forward slash "/" is to be included in a string, it should be escaped with the character "\" to prevent it from being interpreted as a key-value pair delimiter - i.e. "S=Hoopla/G=James\/Jim".
If, in a UNIX environment, a shell will be processing the string (e.g. the string is provided on the command line or is passed as an argument to the utility), the string should be enclosed in quotation marks. Furthermore, if characters meaningful to the shell are included in the string, they should be escaped (i.e. preceded by the escape character "\") to prevent the shell from interpreting them.
Note that if the ID key-value pair is specified in the res argument, all other key-value pairs specified along with it are ignored. Also note that the PSW key may not be specified in the res argument.
The format parameters listed in the third column below are used with the -format option to configure the presentation of a listing (see EXAMPLES).
EXAMPLES
LISTINGS
List all resources in node 12 with "HPLaser" in their name:
% unires -ls "R=HPLaser*" -n 12. R=HPLASER dorian/S=Wilde/G=Oscar/ID=438
. R=HPLASER sula/S=Morrison/G=Toni/ID=512
List all resources in node 12 with "HPLaser" in their name; output the resource name, the name and surname of the contact person, and separate each field by a colon:
% unires -ls "R=HPLaser*" -format "%r Contact: %g %s" -n 12HPLASER dorian Contact: Oscar Wilde
HPLASER sula Contact: Toni Morrison
List all resources in node 12; output the resource name, the name and surname of the contact person, and separate each field by a colon:
% unires -format "%r: %g %s" -n 12HPLASER dorian: Oscar Wilde
Olivetti Typewriter: Dashiell Hammett
ADDITION
Add the oak-panelled conference room to node 12:
% unires -add "R=oakroom" -n 12
Perform the same addition for a directory server:
% unires -add "DID=cn=oakroom,o=Acme,c=US" -n 12
DELETION
Delete the resource "Olivetti Typewriter" from node 12:
% unires -del "R=Olivetti Typewriter" -n 12
MODIFICATION
Modify the capacity of the oak-panelled conference room in node 12 to "15":
% unires -mod "R=oakroom" -m "CA=15" -n 12MULTIPLE ADDITIONS, DELETIONS, MODIFICATIONS
Multiple additions, deletions, modifications are done using the -ex option. In this example two new resources will be added (a BetaCam and a VCR; the contact for the BetaCam will be specified at the same time as the add is being done), the capacity of an existing resource will be modified, and an existing resource will be deleted. A directory server is being used.
% vi multiple.datA DID=cn=betacam,o=Acme,c=US/S=Fellini/G=Fred
Note that in the case of the modification, the resource is the one which has ID=441; the capacity of the resource will be modified to "25".
% unires -ex multiple.dat -n 12unires: added "cn=betacam,o=Acme,c=US"
unires: added "cn=vcr1,o=Acme,c=US"
FILES
unires.ini
This file specifies possible CorporateTime resource configurations. See /users/unison/man/man4/unires.ini for details.
WARNINGS
Directory Server Warning
It is important to understand the implications of the directory server configuration for CorporateTime utilities. In a supplier-consumer configuration, the scheduling of updates between the consumer and supplier may result in temporary differences between the two. This may mean that a CorporateTime utility is reading from a consumer directory server that has not yet been synchronized with its supplier.
Modification of Key-Value Pairs
This utility uses the "adm_modres<field>" key-value pairs in the [UTL] section of the unison.ini file to determine whether or not it can modify the corresponding resource key-value pairs. For example, if "adm_modrescapacity" is set to FALSE, then the value associated with the CA key cannot be modified by this utility.
If no corresponding "adm_modres<field>" for a particular key appears in the file, the utility assumes it CAN modify it.
EXIT STATUS
SEE ALSO
unires.ini explains the format of the resource.ini file; UNIUSER is the complementary utility for users
UNIRMOLD
unirmold - A utility to remove old events and tasks from agendas in a CorporateTime database.
SYNTAX
- unirmold [user] [-event | -task] [-n numOfDays] [-y] node-ID [-p sysOpPsw]
- unirmold -res [-n numOfDays] [-y] node-ID [-p sysOpPsw]
- unirmold -v
- unirmold -h
DESCRIPTION
unirmold removes events and tasks that are more than a specified number of days old from agendas in a CorporateTime database.
By default, unirmold deletes all tasks and events from user agendas, and all events from resource agendas. The -res option restricts the deletion to all events in resource agendas. The user argument restricts the deletion to all events and tasks in the agendas of specified users. For details on how to specify user, see FORMAT OF THE user ARGUMENT below.
unirmold can only be run if the CorporateTime Server is up.
OPTIONS
-event
Delete only old events. By default both events and tasks are deleted from the user agenda.
-n
Delete events and tasks that are more than numOfDays days old from the agenda. The default value is 90 days; the minimum value allowed is 30 days.
-p
Provide the SYSOP password for the node. If this option is not used, prompting for the password will occur.
-res
Remove all events in resource agendas only.
-task
Delete only old tasks from the user agenda. By default both events and tasks are deleted.
-y
Eliminate prompting for confirmation of any deletions.
-v
Print the current version number of unirmold.
-h
Print a usage message explaining how to run unirmold.
FORMATS
FORMAT OF THE user ARGUMENT
The user argument is a string of the form "key=value/key=value/...", where "key" is one of those listed below, and "value" is any string. Both "key" and "value" are case insensitive. The "value" string may be terminated by a wild card symbol (*). If a forward slash "/" is to be included in a string, it should be escaped with the character "\" to prevent it from being interpreted as a key-value pair delimiter - i.e. "S=Hoopla/OU1=R\\/D".
If, in a UNIX environment, a shell will be processing the string (e.g. the string is provided on the command line or is passed as an argument to the utility), the string should be enclosed in quotation marks. Furthermore, if characters meaningful to the shell are included in the string, they should be escaped (i.e. preceded by the escape character "\") to prevent the shell from interpreting them.
EXAMPLES
Delete all events more than 30 days old from the agenda of the user with surname "Wembley" in node 10:
% unirmold "s=wembley" -event -n 30 10
Delete all events more than 30 days old from all resource agendas in the node 10:
% unirmold -res -n 30 10
EXIT STATUS
UNIRNSYNCH
unirnsynch - A utility to propagate deletions in the local information of one node to another node in the network.
SYNTAX
- unirnsynch -rn node-ID [-rhost hostname] [-rp remote-sysop-password] -n node-ID [-host hostname] [-p sysop-password]
- unirnsynch -v
- unirnsynch -h
DESCRIPTION
unirnsynch is used to propagate deletions in the local information of one node to another node in the network. Each node in a node network contains both local information and remote node information, where:
local information is a list of the users and resources belonging to that node
remote node information is a list of the users and resources belonging to each of the other nodes in the node network.
The remote node information of a given node is constructed from the local information of each of the other nodes in the node network.
Changes to the local information of a node are normally automatically propagated to the remote node information of all other nodes in the network. However, if for any reason discrepancies do occur, the remote node information can be updated using unirnsynch and/or uninode. uninode (using the -apply option) may be used to add missing entries while unirnsynch is used to delete entries which no longer exist in the local information.
uninode -cws all may be used to determine whether or not discrepancies exist (see the IMPORT-DIR field of the output).
The CorporateTime Server must be up to run unirnsynch.
OPTIONS
-host
Specify the host where the node that has had deletions to local information resides.
-n
Specify the node-ID of the node that has had deletions to its local information.
-p
Provide the SYSOP password of the node that has had deletions to its local information.
-rhost
Specify the host where the node that is to have its remote node information updated resides. Default is the local host.
-rn
Specify the node-ID of the node that is to have its remote node information updated.
-rp
Provide the SYSOP password of the node that is to have its remote node information updated.
-v
Print the current version number of unirnsynch.
-h
Print a usage message explaining how to run unirnsynch.
EXAMPLES
Propagate deletions to entries in node 30 on host "pepper" to the remote node information of node 20 on host "salt":
% unirnsynch -rn 20 -rhost salt -rp <remote-sysop-password> -n 30 - host pepper -p <sysop-password>
EXIT STATUS
SEE ALSO
UNINODE
UNISIZEOF
unisizeof - a utility to compute the size of the CorporateTime Server installation.
SYNTAX
- unisizeof [-db | -n node-ID]
- unisizeof -v
- unisizeof -h
DESCRIPTION
unisizeof computes the size of a CorporateTime Server installation. The default action is to determine the size of the contents of the /users/unison directory, including all database nodes and the CorporateTime Server (executables, *.ini files, etc.). The -db and -n options can be used to determine the size of a single database node.
unisizeof can be run if the CorporateTime Server is up or down.
OPTIONS
-db
Compute the size of the default database, (i.e. the node for which "name = N1" in the /users/unison/misc/unison.ini file).
-n
Compute the database size of the specified node.
-v
Print the version number of unisizeof.
-h
Print a usage message explaining how to run unisizeof.
EXAMPLES
Determine the size of the CorporateTime Server installation:
% unisizeofunisizeof: total size of the calendar server 44216K
Determine the size of the default node database:
% unisizeof -dbunisizeof: database size for nodeid [10] is 940K
Determine the size of the database for node 10:
% unisizeof -n 10unisizeof: database size for nodeid [10] is 760K
FILES
Used to determine the default node (i.e. the node for which "name = N1" in this file) when unisizeof is used with the -db option.
EXIT STATUS
UNISLICE
unislice - A utility for extracting information from CorporateTime Server log files.
SYNTAX
- unislice logFile(s) [-s starttime] [-e endtime]
- unislice -v
- unislice -h
DESCRIPTION
unislice extracts information from the specified log file(s) and sends it to standard output. This utility is used by unisnapshot to gather information contained in log files. The logFile(s) argument is a list of one or more log files; each must be a fully-specified pathname separated from the others by a space.
unislice can be run whether the CorporateTime Server is up or down.
OPTIONS
-e
Set an end time. Only log file information with time stamps prior to this time will be included in the output. Thus, if an end time of January 1 is set, no information from the 1st of January will be included. See FORMAT OF starttime, endtime ARGUMENTS below for details on how to specify these arguments.
-s
Set a start time. Only log file information with time stamps on or after this time will be included in the output. See FORMAT OF starttime, endtime ARGUMENTS below for details on how to specify these arguments.
-v
Print the current version number of unislice.
-h
Print a usage message explaining how to run unislice.
FORMATS
FORMAT OF starttime, endtime ARGUMENTS
Each of these arguments can take one of the forms:
is either the full name of the month or one of the following abbreviations: jan, feb, mar, apr, aug, sep, sept, oct, nov, dec (month is case-insensitive);
is specified using four digits; and
is in the form HH:MM or HH:MM:SS (HH is an integer between 0 and 23).
EXAMPLES
Output the full contents of the uniengd log file:
% unislice /users/unison/log/eng.logOutput all uniengd messages logged on February 7th 1995:
% unislice /users/unison/log/eng.log -s 7 feb 1995 -e feb 8 1995Output all eng.log messages after 1 PM, July 7:
% unislice /users/unison/log/eng.log -s july 7 13:00Output all eng.log messages before 9 AM, October 15, 1995:
% unislice /users/unison/log/eng.log -e oct 15 9:00 1995Output all eng.log messages logged in a 45-second period starting at 10 AM, January 30:
% unislice /users/unison/log/eng.log -s jan 30 10:00:00 -e jan 30 10:00:46
EXIT STATUS
UNISNADD
unisnadd - A utility for adding serial numbers to a CorporateTime node.
SYNTAX
- unisnadd serialNumber [-c comment] node-ID [sysOpPsw]
- unisnadd -f filename [-c comment] node-ID [sysOpPsw]
- unisnadd -v
- unisnadd -h
DESCRIPTION
This utility adds a serial number to a CorporateTime node. Serial numbers are issued by the supplier of the CorporateTime Server software, and permit more users to be added to the node, up to a fixed limit. If the SYSOP password (sysOpPsw) is not provided on the command line, prompting for it will occur.
unisnadd can only be run if the CorporateTime Server is up.
OPTIONS
-f
Specify a file containing multiple serial numbers. Each serial number can have a comment attached to it. Each serial number and comment pair should be a string of the form "serialNumber;comment". Each serial number must begin on a new line. If the -c option is used with this option, the specified comment will be applied to each serial number in the file; any comments in the file itself will be ignored.
-c
Associate a comment with a serial number. If spaces are to be included in the comment, the whole argument should be enclosed in quotation marks to prevent the shell from splitting the string in pieces. A blank comment will remove any old comments.
-v
Print the current version number of unisnadd.
-h
Print a usage message explaining how to run unisnadd.
EXAMPLES
Add the serial number "ABCD123456789" to node 20:
% unisnadd "ABCD12356789" 20
Add the serial number "ABCD987654321" with the comment "SalesGroup" to node 20:
% unisnadd "ABCD987654321" -c "SalesGroup" 20
Use the file "serialFileName" to add the serial number
"ABCD543216789" with the comment "Marketing" to node 20:
% cat serialFileName% unisnadd -f serialFileName 20
We could have altered the comment "Marketing" by using the following command:
% unisnadd -f serialFileName -c "Customer Support" 20
EXIT STATUS
UNISNAPSHOT
unisnapshot - A utility to compile CorporateTime Server information for diagnostic purposes.
SYNTAX
- unisnapshot [date] [-nolog]
- unisnapshot [-s starttime] [-e endtime] [-nolog]
- unisnapshot -v
- unisnapshot -h
DESCRIPTION
unisnapshot assembles information used by support staff to diagnose most CorporateTime Server problems. Should a problem ever arise, only this file need be supplied to support staff.
Output is written to the snapshot.log file in the /users/unison/log directory. unisnapshot can be restricted to include log file information logged during a single day, or during a specified time period. This reduces the amount of irrelevant information in the output.
See FORMAT OF THE date ARGUMENT below for details on how to specify date.
unisnapshot can be run whether the CorporateTime Server is up or down.
OPTIONS
-e
Set an end time. Only log file information with time stamps prior to this time will be included in the output of unisnapshot. Thus, if an end time of January 1 is set, no information from the 1st of January will be included. endtime is a string of the same format as date.
-nolog
Prevents unisnapshot from including log file information in its output.
-s
Sets a start time. Only log file information with time stamps on or after this time will be included in the output of unisnapshot. starttime is a string of the same format as date.
-v
Print the current version number of unisnapshot.
-h
Print a usage message explaining how to run unisnapshot.
FORMATS
FORMAT OF THE date ARGUMENT
The date argument takes one of the forms:
is either the full name of the month or one of the following abbreviations: jan, feb, mar, apr, aug, sep, sept, oct, nov, dec (month is case-insensitive);
is specified using four digits; and
is in the form HH:MM or HH:MM:SS (HH is an integer between 0 and 23).
If no year is specified, the default is the current year.
EXAMPLES
% unisnapshotAssemble all information except that contained in the log files:
% unisnapshot -nologAssemble all information about February 7th 1998:
% unisnapshot 7 feb 1998Assemble all information about the period after 1 PM, July 7:
% unisnapshot -s july 7 13:00Assemble all information about the period before 9 AM, October 15, 1998:
% unisnapshot -e oct 15 9:00 1998
Assemble all information about the 45-second period starting at 10 AM, January 30:
% unisnapshot -s jan 30 10:00:00 -e jan 30 10:00:46
FILES
/users/unison/log/snapshot.log
This is the file where unisnapshot writes its output. If a previous file exists at the time unisnapshot is invoked, it will be overwritten.
EXIT STATUS
WARNING
unisnapshot may take some time to complete.
UNISNCDUMP
NAME
unisncdump - Retrieve statistics from the CorporateTime Server's unisncd daemon/service.
SYNTAX
- unisncdump [-host hostname] [-n node-ID] [-p sysOpPsw] [-screen]
- unisncdump -v
- unisncdump -h
DESCRIPTION
unisncdump retrieves statistics from the unisncd daemon and writes them to the /users/unison/log/unisncdump.log file. Included are the number of configured and available connections for each service.
OPTIONS
-host
Specify the host on which the unisncd is located.
-n
Specify the CorporateTime node. Required if more than one node exists.
-p
Provide the SYSOP password. If this option is not used, prompting for the password will occur.
-screen
Display the output on the screen instead of writing it to the log file.
-v
Print the version number of unisncdump.
-h
Print a usage message explaining how to run unisncdump.
EXAMPLES
Dump the unisncd statistics for node 11 on host oregano to the screen (the node network contains two nodes: 11 and 12).
% unisncdump -screen -n 11 -host oregano-----------------------------------------------
DATE = Mon Sep 28 14:50:08 1998
FILES
/users/unison/log/unisncdump.log
The file unisncdump writes to by default.
EXIT STATUS
UNISTART
unistart - A utility to start up the CorporateTime Server.
SYNTAX
- unistart [-bypass] [-nocws | -cws] [-nosnc | -snc] [-das ][-r] [-w secs] [-c] [-n] [-s]
- unistart -v
- unistart -h
DESCRIPTION
unistart starts the CorporateTime Server. The default action is to start all 5 CorporateTime Server daemons/services: uniengd, unilckd, unicwsd, unisncd and (if a Directory Server is being used) unidasd.
Note: -bypass, -c, -cws, -das, -n, -nosnc, -s, -snc and -w are all UNIX-only options.
OPTIONS
-bypass
By default, unicheck is run before the daemons/services are started. This option causes unistart to execute without running unicheck.
-c
Same as -cws. Included for backwards compatibility.
-cws
Starts only unicwsd, the corporate-wide services daemon/service, provided that the unilckd and uniengd daemons/services are up.
-das
Starts only unidasd, provided that the other daemons/services are up. Note that this daemon is used only with directory servers.
-n
Same as -nocws. Included for backwards compatibility.
-nocws
By default, unicwsd is started if the "enable" keyword in the [CWS] section of the unison.ini file is set to "TRUE". This option overrides this setting and prevents unicwsd from being started. If this option is used under NT, unicwsd can be brought up later by simply running unistart again without this option.
-nosnc
By default, unisncd is started if the "enable" keyword in the [SNC] section of the unison.ini file is set to "TRUE". This option overrides this setting and prevents unisncd from being started.
-r
Removes the log files act.log, cws.log, das.log, dbv.log, eng.log, lck.log, and snc.log from the /users/unison/log directory. Note that new log files are immediately created for cws.log, das.log, eng.log, lck.log, and snc.log.
-s
Same as -w. Included for backwards compatibility.
-snc
Starts only unisncd, provided that the unilckd and uniengd daemons/services are up.
-w
When a process is started there is a short delay before a ps(1) command will acknowledge the existence of the process. It is therefore appropriate to sleep until a ps(1) will verify that the process is running. The default period is 2 seconds. This option can be used to override this default; the secs parameter specifies the number of seconds to sleep.
-v
Print the current version number of unistart.
-h
Print a usage message explaining how to run unistart.
EXAMPLES
Start the CorporateTime Server without running unicheck; remove the old log files at the same time:
% unistart -bypass -rStart the CorporateTime Server; do not run the Corporate-Wide Services daemon/service:
% unistart -nocws
Start the Corporate-Wide Services daemon/service at some later point:
% unistart -cws
EXIT STATUS
UNISTAT
unistat - A utility to produce a report on a CorporateTime node.
SYNTAX
UNIXNT
- unistat [-l | -p] [-s | -g] [-m] [-sn] node-ID
- unistat -v
- unistat -h
- unistat [-l | -p] [-s | -g] [-m] [-sn] -n node-ID
- unistat -v
- unistat -h
DESCRIPTION
unistat produces a report for the specified node and sends it to standard output. The user will be prompted to supply the SYSOP password for the node. The following information is included in the report:
- For each user: the X.400 name, the X.400 Organizational Units, the number of events, instances, and attendees owned by the user, the size (in bytes) of any attached files, the size (in bytes) of any event descriptions, and the size (in bytes) of the user's agenda.
- For each resource: the resource identifier, the number of events, instances, and attendees owned by the resource, the size (in bytes) of any attached files, the size (in bytes) of any event descriptions, and the size (in bytes) of the resource's agenda.
- A list of public groups and their owners.
- The size (in bytes) of the database.
- The number of users, events, instances, and attendees in the database.
The CorporateTime Server must be up for unistat to run.
NoteThe -l and -p options are mutually exclusive, as are the -s and -g options.
OPTIONS
-g
Print the list of public groups.
-l
Print the report in 128 characters per line mode. If this option is not used, the default is 80 characters per line.
-m
Print the members of the public groups.
-n
Generate statistics for the specified node.
NoteThe node-ID must be introduced with -n for NT, but not for UNIX.
-p
Create a PostScript report. File redirection should be used to capture this to a file.
-s
-sn
-v
Print the current version number of unistat.
-h
Print a usage message explaining how to run unistat.
EXIT STATUS
UNISTATS
unistats - A utility to display summary statistics of the data in a CorporateTime stats file.
SYNTAX
- unistats [-s starttime] [-e endtime] [-f filename] [-server version] [-client entry] [-n node-ID] [-user name | -res resource | -ruser] [-all]
- unistats -v
- unistats -h
DESCRIPTION
A utility to display summary statistics of the data in a CorporateTime Server stats file. By default the /users/unison/log/unistats.log file is used. Filters (i.e. the -server, -client, -n, -user, -res, -ruser options) may be used to compile statistics from a subset of the information in the stats file.
The default output is a summary for each unique CorporateTime client. Different versions of the same client are treated as separate clients, and a summary is output for each. The -all option will display a summary incorporating all clients. All output is displayed in 122-character-wide format. A complete list of all output fields is given in the OUTPUT section below.
OPTIONS
-all
Display summary incorporating all interface clients.
-client
Display summary statistics on a specific CorporateTime client. entry is the name and version of that client. See FORMAT OF THE entry, name, AND resource ARGUMENTS below for details on how to specify entry.
-e
Specify end time for statistics. If this option is not used, the default is the current time of the current day of the current month of the current year. See TIME ARGUMENT FORMAT below for details on how to specify endtime.
-f
Specify the file to be used. This file must be in the same format as the default file used by unistats, /users/unison/log/unistats.log. This option is commonly used where a file has been created from an existing unistats.log file and will be supplied as input to unistats.
-n
Display summary statistics on a specific node. node-ID is a CorporateTime Server node-ID.
-res
Display summary statistics on a specific resource. resource is the name and/or identification number of the resource. See FORMAT OF THE entry, name, AND resource ARGUMENTS for details on how to specify resource.
-ruser
Display summary statistics on all reserved users (ex.: SYSOP).
-s
Specify start time for statistics. If this option is not used, the default start time is "Jan 1 1991 00:00:00". See TIME ARGUMENT FORMAT below for details on how to specify starttime.
-server
Display summary statistics on a specific CorporateTime Server. version is the version number of that server (e.g. A.02.80).
-user
Display summary statistics on a specific user. name is some combination of the surname, given name, and organizational units of the user. See FORMAT OF THE entry, name, AND resource ARGUMENTS below for details on how to specify name.
-v
Print the current version number of unistats.
-h
Print a usage message explaining how to run unistats.
FORMATS
FORMAT OF THE entry, name, AND resource ARGUMENTS
Each of the arguments entry, name, and resource is a string of the form "key=value/key=value/...", where "key" is one of those listed below, and "value" is any string. Both "key" and "value" are case insensitive. The "value" string may be terminated by a wild card symbol (*). If a forward slash "/" is to be included in a string, it should be escaped with the character "\" to prevent it from being interpreted as a key-value pair delimiter - i.e. "S=Hoopla/OU1=R\\/D".
If, in a UNIX environment, a shell will be processing the string (e.g. the string is provided on the command line or is passed as an argument to the utility), the string should be enclosed in quotation marks. Furthermore, if characters meaningful to the shell are included in the string, they should be escaped (i.e. preceded by the escape character "\") to prevent the shell from interpreting them.
Some example specifications are:
-client "N=Windows CorporateTime - 32 Bit/V=version 4.1"
TIME ARGUMENT FORMAT
The starttime and endtime arguments may be expressed as either:
is either the full name of the month or the first three letters (e.g. jan, feb, mar, etc.) (month is case-insensitive);
must be 1991 or higher and must be specified using four digits; and
is in the form HH:MM or HH:MM:SS (HH is an integer between 0 and 23, MM is an integer between 0 and 59, and SS is a number between 0 and 59).
The order of the individual elements in the argument is unimportant. What is important is that either day and month be specified, or time be specified. The following are all valid examples:
Default values for day, month, year, and time are current day, current month, current year and current system time respectively.
Any missing field in time (HH, MM, or SS) will be replaced with the current HH, MM, or SS value. E.g. if the current date and time is March 12 1998 10:41:34, and only HH:MM are specified in the argument, the SS will become "34":
-e 12:41 -> March 12 1998 12:41:34
-s 12:41 -> March 12 1998 12:41:34
If none of the time fields are specified, starttime defaults to the first minute of the day, and endtime defaults to the last minute of the day:
-s feb 22 -> feb 22 1998 00:00:00
-e feb 22 -> feb 22 1998 23:59:59
OUTPUT
All output fields displayed by unistats are explained here, in the order in which they will be seen:
EXAMPLES
Get the summary statistics of the data from the default file (/users/unison/log/unistats.log):
% unistats
Get the summary statistics of all "window" clients from the file myfile.log:
% unistats -client "N=window*" -f myfile.log
Get the summary statistics of user "Don Martin" from server "A.02.80" only:
% unistats -user "s=martin/g=don" -server "A.02.80"
Get summary statistics of the resource "projector" from "motif" clients only:
% unistats -res "R=projector/ID=901" -client "N=Motif"
Get summary statistics for July 19:
% unistats -s jul 19 -e jul 19
Get summary statistics for all users of all clients:
% unistats -all -user "S=*"
Get summary statistics of all reserved users in node 70:
% unistats -ruser -n 70
FILES
/users/unison/log/unistats.log
By default, unistats obtains its information from this file. The "stats" parameter in the [ENG] section of the unison.ini file must be set to "TRUE" to enable logging to this file.
EXIT STATUS
UNISTATUS
unistatus - A utility to determine the status of the CorporateTime Server.
SYNTAX
- unistatus [-f] [-d] [-s] [-q] [-n] [-e]
- unistatus -v
- unistatus -h
DESCRIPTION
By default unistatus determines which of the CorporateTime Server daemons/services are running and prints their current status to standard output. The -d, -f, -n, -q, and -s options do not currently function under NT.
unistatus will run whether the CorporateTime Server is up or down.
OPTIONS
-d
Under UNIX, this produces a report for daemon processes only.
-e
This option alters the default exit status values as described in EXIT STATUS below.
-f
Under UNIX, this option produces an extensive ps-like report, taking into account the distinction between daemons and servers. The CorporateTime Server may have the following daemons and servers running:
-n
runs if remote-node services are enabled and/or a directory server is being used
Suppress the printing of the messages "CORPORATE-WIDE SERVICES are down" or "REMOTE-NODE SERVICES are down" when the unilckd and uniengd daemons/services are running but the unicwsd or unisncd daemons/services are not.
-q
Force the quiet version of the command which does not produce the usual status message.
-s
Produce a report for server processes (UNIX only).
-v
Print the current version number of unistatus.
-h
Print a usage message explaining how to run unistatus.
EXAMPLES
% unistatusProduce a full report on all CorporateTime daemons and servers on a UNIX system.
Produce a report on CorporateTime Server processes under UNIX.
Produce a report on CorporateTime daemon processes under UNIX.
EXIT STATUS
EXIT STATUS
0 ... 127 success with the sum of the following values:
1 if any uniengd servers are running
2 if the unicws daemon is running
4 if the uniengd daemon is running
8 if the unilckd daemon is running
16 if the unisncd daemon is running
32 if the unidasd servers are running
UNISTOP
unistop - A utility to shut down the CorporateTime Server.
SYNTAX
- unistop [-y] [-bypass] [-ser] [-cws] [-snc] [-das] [-dass] [-w secs] [-l level] [-cl level]
- unistop -v
- unistop -h
DESCRIPTION
unistop will shut down all or part of a running CorporateTime Server. By default, all daemons/services are shut down: unicwsd, unisncd, unidasd (if a directory server is being used), uniengd, and unilckd. If any users are currently signed-on, unistop will prompt for confirmation before proceeding with the shutdown.
The -bypass, -cl, -das, -dass, -l, -ser, -snc, -w, and -y options are all UNIX-only. The -l and -cl options are mutually exclusive.
unistop can only be run if the CorporateTime Server is at least partially up (i.e. one or more daemons/services are running).
OPTIONS
-bypass
Allow unistop to execute even if another unistart or unistop process is running.
-cl
Allow cycling of shutdown levels from 0 up to the specified level, when the current level fails. Thus, levels 0, 1, 2, & 3 are tried until either the specified level is reached or the shutdown is successful. The user is NOT prompted for any confirmation.
Warninga shutdown at level 3 may corrupt the CorporateTime Server database. See the -l option for more information.
-cws
Shut down only the corporate-wide services daemon/service (unicwsd). The unilckd and uniengd daemons/services must be running for this option to succeed.
-das
Stop only the unidasd daemons and servers. These are used only with a directory server.
-dass
Stop only the unidasd servers. These are used only with a directory server.
-l
The shutdown levels are 0, 1, 2 and 3, with the normal level (and the default) being 0. The higher the number, the more severe the shutdown. You should always begin with 0 and only in the rare event that this fails should you proceed to 1, then 2 and finally 3.
WarningA level 3 shutdown is guaranteed to succeed but it may corrupt the CorporateTime database. Contact qualified support staff before performing a shutdown at this level. unistop prompts for confirmation before proceeding with a level 3 shutdown.
-ser
Shut down only the uniengd servers. The unilckd and uniengd daemons must be running for this option to succeed. Each uniengd server is associated with a signed-on CorporateTime user; the uniengd daemon is always present when the CorporateTime Server is running. If this option is not used, both uniengd daemons and servers are shut down.
-snc
Shut down only the unisncd daemon. The unilckd and uniengd daemons must be running for this option to succeed.
-w
When a process is stopped there is a short delay during which the ps(1) command continues to acknowledge the existence of the process. It is therefore necessary to sleep for a short period of time until a ps will verify that the process is no longer running. The default delay is 4 seconds. This option overrides the default; the secs parameter specifies the number of seconds to sleep.
-y
By default, if there are any users signed onto the CorporateTime Server, a prompt is issued to confirm that a shutdown is desired. This option causes unistop to automatically proceed with the shutdown even if there are users signed on. The shutdown of each of the active uniengd servers proceeds in such a way as to ensure the integrity of the database.
-v
Print the current version number of unistop.
-h
Print a usage message explaining how to run unistop.
EXAMPLES
Shut down the CorporateTime Server.
% unistopShut down the Corporate-Wide Services daemon.
% unistop -cwsShut down only the directory server daemons and servers under UNIX.
% unistop -dasExecute a level 1 shutdown under UNIX after a level 0 shutdown has failed.
% unistop -l 1
EXIT STATUS
UNITZINFO
unitzinfo - print information about a CorporateTime Server time zone.
SYNTAX
- unitzinfo [-c] [-l] [-t timezone] [-node node-ID] [-y year]
- unitzinfo -v
- unitzinfo -h
DESCRIPTION
Extracts information from the CorporateTime Server time zone table found in the /users/unison/misc/timezone.ini file. By default, only the information for the configured time zone and the current year used by the CorporateTime Server is printed in an 80-character-wide format.
unitzinfo can be run whether the CorporateTime Server is up or down.
OPTIONS
-c
List the time zone information by country. Time zones within a country are listed in sequence. The printed fields are:
-l
Print the information in 132-character-wide ("large") output format.
-node
Specify the node. This option causes the information for the time zone configured for the node to be output.
-t
Specify the name of the time zone to print. If timezone has the value "all", the complete list of time zones will be printed.
-y
Specify the year for which the time zone information will be output (e.g. to view the DST period for that year). year must be specified using four digits. The default is the current year.
-v
Print the current version number of unitzinfo.
-h
Print a usage message explaining how to run unitzinfo.
EXAMPLES
Display the time zone information associated with node 20:
% unitzinfo -node 20EST5EDT Eastern Standard Time, Eastern Daylight Time
U.S.A. (Eastern), Canada (Eastern), Bahamas,
Daylight Saving Time : -4h (Apr 4,1999 - Oct 30,1999)
FILES
/users/unison/misc/timezone.ini
This file contains the time zone descriptions used by the CorporateTime Server.
EXIT STATUS
UNIUSER
uniuser - A utility to list, add, or delete CorporateTime users, or to modify the information associated with them.
SYNTAX
Listings
- uniuser -ls [user] [-format format] -n node-ID [-p sysOpPsw]
- uniuser -format format -n node-ID [-p sysOpPsw]
Addition
- uniuser -add user [-s sections] -n node-ID [-p sysOpPsw]
Deletion
- uniuser -del user [-y] -n node-ID [-p sysOpPsw]
- uniuser -desdel user -n node-ID [-p sysOpPsw]
- uniuser -grpdel user -n node-ID [-p sysOpPsw]
Modification
- uniuser -mod user -s sections | -m modifier -n node-ID [-p sysOpPsw]
Multiple additions, deletions, modifications
- uniuser -ex filename [-s sections] [-k] -n node-ID [-p sysOpPsw]
- uniuser -edit -n node-ID [-p sysOpPsw]
Other
- uniuser -s [sections] -n node-ID [-p sysOpPsw]
- uniuser -info
- uniuser -v
- uniuser -h
DESCRIPTION
uniuser is used to list, add, or delete CorporateTime users, and to modify the information associated with them. Details on how to specify the user argument are given in the FORMAT OF THE user ARGUMENT section below. Note that the -ls, -add, -del, and -mod options are all mutually exclusive.
The information associated with a CorporateTime user is a combination of the key-value pairs described in the FORMAT OF THE user ARGUMENT below, and that contained in the user.ini file. This includes user preferences, security, administrative rights, X.400 information, personal group, admin group membership and the list of persons permitted to work as a designate for the user.
The CorporateTime Server must be up to run uniuser.
unires is the complementary utility for resources.
OPTIONS
-add
Create a new CorporateTime user. The information associated with the new user is a combination of what is specified in the user argument and the default values contained in the [GEN] section of the user.ini file. The -s sections option may be used to apply default values only from particular sections of the user.ini file. If more than one user is added, the -ex option must be used.
For external directories, the user must already exist in the directory server. The DID (Directory ID) for the user must be specified, and it must be in DN (Distinguished Name) format. This can be followed by data in X.400 format. See EXAMPLES.
-del
Delete the specified CorporateTime user. uniuser will prompt for confirmation before performing the deletion unless the -y option is used. If more than one user is to be deleted, the -ex option must used.
-desdel
Delete the list of designates for the specified user. If more than one user matches user, the command will fail.
-edit
This option only exists under UNIX. It allows you to first output the list of existing CorporateTime users to a file, then edit the file to make desired modifications, and finally to input the changes back into the node. The following sequence of commands is performed:
% uniuser -ls -n node-ID > file
Perform the additions, deletions, and/or modifications specified in the file filename. Each line of the file must begin with one of the characters '.', '#', 'A', 'a', 'D', 'd', 'M', 'm', 'S' or 's'. This initial character specifies the action to take, as follows:
`.' or `#' | the line is ignored
`A' or `a' | the user is added
`D' or `d' | the user is deleted
`M' or `m' | the user is modified
'S' or 's' | the user settings are updated from user.ini
The initial character must be followed by a space and a user specification. In the case of a modification, the ID must be specified; it alone is used to identify the user, while the other key-value pairs specified along with it are applied as the modifications. See EXAMPLES.
For each deletion specified in the file, uniuser will prompt for confirmation before performing the deletion. The -y option is used to automatically provide confirmation.
One way to create this file is to save the output of uniuser -ls to a file. This can then be edited and input to uniuser -ex.
The -s sections option may be used with -ex to set the corresponding user information to the default values contained in the specified sections of the user.ini file.
For directory servers, the most common way of adding many CorporateTime users is to first use unidssearch to output the list of all non-CorporateTime users to a file. This file can then be modified (if necessary), and input to uniuser using the -ex option. unidssearch outputs in the same "key=value/key=value/...." format that uniuser requires for input. See EXAMPLES.
-format
This option is used to select user information fields and to customize the format of the output. The -info option lists the parameters that can be used to specify the customized format. These are also listed in the FORMAT OF THE user ARGUMENT section below. If this option is not used, all user information fields are output, and a default presentation format is used. See EXAMPLES.
-grpdel
Delete the specified user from all admin groups. A single user must match user or the command will fail.
-info
List the format parameters used with the -format option.
-k
Used with the -ex option to force uniuser to continue processing all lines in the file even if it encounters an error. Errors are sent to standard output; file redirection may be used to capture these to a file.
-ls
If a user is specified, -ls lists that user (in the specified node). If no user is specified, all users in the node are listed. The -format option can be used with -ls to configure the presentation of the output (see EXAMPLES).
-m
Specify a modification to be made to the user information of a particular user. The modifier is a string of the same form as the user argument with the following exceptions: the ID key may NOT be specified, and the PSW key MAY be specified.
-mod
Modify the information associated with the specified user. This option is used with either the -s sections or the -m modifier option. When used with the -s sections option, it sets the corresponding information for the user to the values contained in the specified sections of the user.ini file. When used with the -m modifier option, modifications are made to the user's X.400 information.
-n
-p
Provide the SYSOP password for the specified node. If this option is not used, prompting for the password will occur.
-s
Evaluate all or some of the contents of the user.ini file and output information from it to standard output. By default, all sections of the user.ini file are evaluated, and all section names along with their respective "info" key-value pairs are listed.
The sections argument restricts the evaluation to only the specified sections. In this case all key-value pairs of the specified sections are output, along with any errors. The sections argument is a list of one or more section names, each separated by a forward slash (e.g. "GEN/GR1/GR2" specifies the sections GEN, GR1, and GR2). Evaluation is done from right to left, so in the above example, GR2 would be evaluated first, GR1 second, and GEN last. Where the same key appears in more than one section, the value of the first instance evaluated will take precedence.
-y
Used with the -del and -ex options to auto-confirm the deletion(s).
-v
Print the current version number of uniuser.
-h
Print a usage message explaining how to run uniuser.
FORMATS
FORMAT OF THE user ARGUMENT
The user argument is a string of the form "key=value/key=value/...", where "key" is one of those listed below, and "value" is any string. Both "key" and "value" are case insensitive. For all keys except the ID key, the "value" string may be terminated by a wild card symbol (*). If a forward slash "/" is to be included in a string, it should be escaped with the character "\" to prevent it from being interpreted as a key-value pair delimiter - i.e. "S=Hoopla/OU1=R\\/D".
If, in a UNIX environment, a shell will be processing the string (e.g. the string is provided on the command line or is passed as an argument to the utility), the string should be enclosed in quotation marks. Furthermore, if characters meaningful to the shell are included in the string, they should be escaped (i.e. preceded by the escape character "\") to prevent the shell from interpreting them.
NoteIf the ID key-value pair is specified in the user argument, all other key-value pairs specified along with it are ignored. Also note that the PSW key may not be specified in the user argument.
The format parameters listed in the third column below are used with the -format option to configure the presentation of a listing (see EXAMPLES).
EXAMPLES
LISTINGS
List all users in node 23 whose last names begin with "W":
% uniuser -ls "s=W*" -n 23. S=Whitman/G=Walt/ID=154/C=US
. S=Winterson/G=Jeannette/ID=114/C=England
List all users in node 23 whose last names begin with "W"; output only their surname and given name, separated by a colon:
% uniuser -ls "s=W*" -format "%s:%g" -n 23Whitman:Walt
List all users in node 23; output their surname and given name, separated by a colon:
% uniuser -format "%s:%g" -n 23Brossard:Nicole
ADDITION
Add the user "Maya Angelou" to node 24.
% uniuser -add "S=Angelou/G=Maya" -n 24
Perform the same addition on a directory server.
% uniuser -add "DID=cn=Maya Angelou, o=Acme, c=US" -n 24
DELETION
Delete the user "Eeva Kilpi" from node 24:
% uniuser -del "S=Kilpi/G=Eeva" -n 24
MODIFICATION
Modify Milan Kundera's entry to reflect recent changes to the [GEN] section of the user.ini file (Milan Kundera exists in node 23). Look at the values in the GEN section of the user.ini file and ensure they are all valid:
% uniuser -s "GEN" -n 23Proceed with the modification:
% uniuser -mod "S=Kundera/G=Milan" -s "GEN" -n 23
Modify Milan Kundera's OU1 value to "authors":
% uniuser -mod "S=Kundera/G=Milan" -m "ou1=authors" -n 23
MULTIPLE ADDITIONS, DELETIONS, MODIFICATIONS
Multiple additions, deletions, and modifications are done using the -ex option. In this example, three new CorporateTime users will be added, one will be modified, and one will be deleted. A directory server is being used.
Output all users in the directory server who are not currently CorporateTime users:
% unidssearch > multiple.datA DID=cn=Italo Calvino,o=Acme, c=US
A DID=cn=Herman Hesse,o=Acme, c=US
A DID=cn=Doris Lessing,o=Acme, c=US
A DID=cn=Anja Kauranen,o=Acme, c=US
Modify the data in the file: change the country for Italo Calvino to Italy; add the modification to Walt Whitman's first name; add the deletion of Nicole Brossard.
% vi multiple.datA DID=cn=Italo Calvino,o=Acme, c=US/C=Italy
A DID=cn=Herman Hesse,o=Acme, c=US
A DID=cn=Doris Lessing,o=Acme, c=US
A DID=Anja Kauranen,o=Acme, c=US
In the case of the modification, the ID will be used to find the user, and the given name will be modified to "Walter".
% uniuser -ex multiple.dat 23uniuser: added "cn=Italo Calvino,o=Acme, c=US"
uniuser: added "cn=Herman Hesse,o=Acme, c=US"
uniuser: added "cn=Doris Lessing,o=Acme, c=US"
uniuser: added "cn=Anja Kauranen,o=Acme, c=US"
uniuser: modified "Whitman,Walt"
uniuser: deleted "Brossard,Nicole"
Note that if this example did not use a directory server, the input file would contain the following:
% cat multiple.dat
FILES
user.ini
The /users/unison/misc/user.ini file specifies possible CorporateTime user configurations. See uniuser.ini for details.
EXIT STATUS
WARNINGS
Modification of Key-Value Pairs
This utility uses the "adm_moduser<field>" key-value pairs in the [UTL] section of the unison.ini file to determine whether or not it can modify the corresponding key-value pairs for the user. For example, if "adm_modusersurname" is set to FALSE, then the value associated with the S key cannot be modified by this utility.
If no corresponding "adm_moduser<field>" for a particular key appears in the file, the utility assumes it CAN modify it.
Directory Server Warning
It is important to understand the implications of the directory server configuration for CorporateTime utilities. In a supplier-consumer configuration, the scheduling of updates between the consumer and supplier may result in temporary differences between the two. This may mean that a CorporateTime utility is reading from a consumer directory server that has not yet been synchronized with its supplier.
SEE ALSO
uniuser.ini explains the format of the user.ini file and how to make modifications to it; UNIRES is the complementary utility for resources.
UNIVERSION
universion - A utility to verify the version of the CorporateTime Server.
SYNTAX
- universion [-all] [-nowarn]
- universion -v
- universion -h
DESCRIPTION
universion displays the version number of the CorporateTime Server and checks all scripts and binaries to see if their versions are up to date.
universion can be run whether the CorporateTime Server is up or down.
OPTIONS
-all
Display version number for each component of the CorporateTime Server.
-nowarn
-v
Print the current version number of the CorporateTime Server.
-h
Print a usage message explaining how to run universion.
EXAMPLES
Display the version number of the CorporateTime Server and check that all of its components are up to date:
% universion
Display the version number of the CorporateTime Server and each of its components; check that all components are up to date:
% universion -all
EXIT STATUS
UNIWHATOS
uniwhatos - A utility to determine whether the CorporateTime Server package will run under the current operating system.
SYNTAX
- uniwhatos
- uniwhatos -v
- uniwhatos -h
DESCRIPTION
uniwhatos determines whether the current operating system is the one the CorporateTime Server package is intended to run under. If a discrepancy exists, uniwhatos outputs the operating system(s) the package will run under.
uniwhatos can be run whether the CorporateTime Server is up or down.
OPTIONS
-v
Print the current version number of uniwhatos.
-h
Print a usage message explaining how to run uniwhatos.
EXAMPLES
An example of uniwhatos finding no discrepancy between the actual and expected operating systems:
% uniwhatos
HP-UX 10.x
An example of uniwhatos finding a discrepancy between the actual and expected operating systems:
% uniwhatosuniwhatos: package for wrong OS installed
EXIT STATUS
UNIWHO
uniwho - A utility to display information on signed-on CorporateTime users.
SYNTAX
- uniwho [-a] [-t] [-j] [-x] [-f] [-p pattern]
- uniwho -v
- uniwho -h
DESCRIPTION
This utility allows the system manager to determine who is using the CorporateTime Server, where they are signed-on from, and the process-ID associated with their session. The options allow the display of various combinations of process-id, network address, node-ID, and user information.
This information is essential in certain situations. For example, when a user has done an abnormal shutdown of a client (say a powerdown while their client is active) the associated server process for that client will continue to remain active for a fixed period of time. If the CorporateTime Server was configured (via the "max_userlogons" parameter of the [ENG] section of the unison.ini file) to limit the number of sessions per user to 1, this user would not be able to log on again until their server process had terminated. uniwho allows the system manager to find the process-ID of the session and terminate it.
uniwho can only be run if the CorporateTime Server is up.
OPTIONS
-a
Display the alias associated with the default network address.
-f
Display telephone, job-title and X.400-address when available.
-j
Display job-title when available.
-p
Display information for sessions which contain pattern in their information. For example, the pattern "128.192.64.96" would result in the display of session information for those logged on from this Internet address. Matching is performed on all fields (network address/alias, telephone number, job-title, X.400 address), regardless of which of these may have been specified on the command line.
-t
Display telephone number when available.
-x
Display X.400 address when available.
-v
Print the current version number of uniwho.
-h
Print a usage message explaining how to run uniwho.
EXAMPLES
Display the list of all signed-on CorporateTime Server users; display the machine alias rather than the network address in the output:
% uniwho -a PID ALIAS NODEID XITEMID USER 2120 ark.boat.com 12 12,2 CWSOP,na 24091 sail.boat.com 12 112,316 Barnes,Pat,B 24298 row.boat.com 12 12,311 Beck,Tom,V Display the list of all signed-on CorporateTime Server users in "Quality Assurance":
% uniwho -p Quality PID ADDRESS NODEID XITEMID USER 24298 199.88.48.81 12 2,311 Beck,Tom,V Display full information for all of the signed-on CorporateTime Server users:
EXIT STATUS
NOTES
uniwho starts a CorporateTime Server process. If activity logging has been enabled (via the "activity" parameter of the [ENG] section of the unison.ini file), the start-up and shutdown of this process will be logged.
| Corporate Software & Technologies http://www.cst.ca Voice: (514) 733-8500 Fax: (514) 733-8878 info@cst.ca |
| |
|
|
|