May the source be with you, but remember the KISS principle ;-)
Home Switchboard Unix Administration Red Hat TCP/IP Networks Neoliberalism Toxic Managers
(slightly skeptical) Educational society promoting "Back to basics" movement against IT overcomplexity and  bastardization of classic Unix

Tivoli wep command

News Recommended Links Redbooks Support cycle Perl Scripts BAROC User Groups
TMF TEC ITM6.1 ITM 5.1 TCM TWC Netview
wlookup odadmin command wchkdb wlsinst      
wbkupdb wtrace winstlcf  Tivoli lcdf daemon Troubleshooting Endpoints    
wlsinst wep command wadminep Postemsg and wpostemsg   IBM humor Etc

Performs actions on endpoint information contained in the endpoint list.



wep ep_label

wep ep_label get {suboptions}

wep help [option]

wep ls [-d delimiter][-g gw_label][-i suboptions]

wep ep_label migrate [-f] gw_label

wep migrate_to_pref {-a | -d|-n} [-f] [-g gw_label]

wep ep_label set {suboptions}

wep set gateway {-e ep_label | -g gw_label}

wep set interfaces {-e ep_label | -g gw_label} gw_label+port [:gw_label+port]...

wep ep_label set_config suboption

wep ep_label set_crypt_mode {DES|NONE}

wep ep_label set_label [-s] new_label

wep ep_label status

wep sync_gateways

wep ep_label upgrade {disable|enable}


Advanced Options

wep boot_method add tag prototype_object method_name ep_oid...

wep boot_method list tag ep_oid...

wep boot_method remove tag ep_oid...

wep boot_method test tag ep_oid...

wep del ep_oid gw_label...

wep view ep_oid gw_label...

Advanced options are described on Advanced Options.


The wep command performs actions on the endpoint information contained in the endpoint list maintained by the endpoint manager. Using this command, you can list the endpoints in a Tivoli management region (Tivoli region) and their assigned gateway, retrieve and set endpoint information, migrate an endpoint from one gateway to another, or update other endpoint data within a Tivoli region.

The wep ep_label get command gets information for the specified endpoint, the wep ls -g gw_label command gets information for the specified gateway and its endpoints, and the wep ls command gets information for all endpoints on multiple gateways.

When specifying the object identifier (OID) of an endpoint, remember to append a plus sign (+) as shown in Examples.



get {suboption,...}
Retrieves specific information from the endpoint list for the endpoint named ep_label. You can specify multiple suboptions by separating each with a comma.
You can shorten an attribute name, but the abbreviation must be unambiguous. For example, you can type last_l for last_login_time, but not last.

Suboptions are as follows:


Gets the network address.


Gets all attributes for the specified endpoint.


Gets the assigned gateway.


Gets the HTTP password. The HTTP password is used to modify endpoint information through a Web browser.


Gets the unique inventory identifier for the specified endpoint.


Gets the interpreter type or operating system running on the specified endpoint.


Gets the endpoint label.


Gets the last login time of an endpoint.


Gets the time of the last method call on an endpoint.


Gets the last time the endpoint migrated.


For Windows operating systems only, displays whether the endpoint is enabled to control distributions using the Mobile Computing console. If the endpoint is operating in mobile mode, the endpoint is enabled. If the endpoint is operating in desktop mode, it is not enabled. This option also displays whether the user can change the endpoint mode.
To change an endpoint mode or to enable a user to change the mode of an endpoint, use the wep ep_label set login_mode command.


Displays the current netload setting.


Displays the object ID of the specified endpoint.


Displays the policy region in which the endpoint resides. If you have not added the endpoint to a policy region, the result of this command is OBJECT_NIL.


Displays the preferred gateway for the endpoint. If there is no preferred gateway for the endpoint, this command results in OBJECT_NIL.


Displays the network protocol used by the endpoint.


Displays whether the endpoint is enabled or disabled for upgrades.


Displays the version number of the endpoint.


help [option]
Displays the usage statement for the wep command. If you specify a wep option, such as wep help get, lists help for the specified option.


ls [-d delimiter][-g gw_label][-i suboption,...]
Lists information for gateways and their associated endpoints. Options are as follows:


-d delimiter
Changes the delimiter used in displaying data with the -i option. The default delimiter is a comma.
The HTTP password field does not contain tabs but can contain commas or other commonly used delimiters.


-g gw_label
Displays information only for the gateway specified by gw_label and its endpoints.


-i {suboption,...}
Retrieves additional information from the endpoint list for gateways and associated endpoints. Use suboptions listed for the wep get option. You can specify multiple suboptions by separating each with a comma. For suboptions and their descriptions, see the wep get option on ***.
You can shorten an attribute name, but the abbreviation must be unambiguous. For example, you can type last_l for last_login_time, but not last.


migrate [-f] gw_label
Migrates an endpoint from its assigned gateway to the gateway specified by gw_label. There is no contact with the endpoint. The endpoint detects that it was migrated the next time that there is communication between the endpoint and a gateway. Specifying the -f option forces the migration of an endpoint even if the gateway is down.


migrate_to_pref {-a | -d|-n}[-f] [-g gw_label]
Migrates endpoints to their preferred gateway if the gateway is available. This migration is similar to the wep migrate command. There is no communication with the endpoint. Only endpoint manager and gateway data are updated.


Causes all endpoints to migrate to their preferred gateway.


Displays a list of endpoints not currently assigned to their preferred gateway, but does not migrate.


Forces migration, even if the preferred gateway is down.


-g gw_label
Restricts migrations to the preferred gateway specified by gw_label.


Causes all nonmobile endpoints to migrate to their preferred gateway.


set {suboptions...}
Sets the following information for the endpoint named ep_label.
You can shorten an attribute name, but the abbreviation must be unambiguous. For example, you can type last_l for last_login_time, but not last.
Suboptions are as follows:


address ep_address
Changes the IP address of an endpoint.


httpd [user:password]
Sets the HTTP password for the specified endpoint. The HTTP password is used to modify endpoint information through a Web browser. You must use the sync_gateways option to synchronize changes between the endpoint, gateway, and endpoint manager after making password changes.


login_mode -m {mobile|desktop} -s {variable|constant}
For Windows endpoints with the Mobile Computing console, sets the operating mode of the endpoint specified by ep_label. Specify the -m mobile option to designate an endpoint as mobile. This option allows a user at the specified endpoint to receive and control MDist 2 distributions through the console. Specify the -m desktop option to disable console functions on the endpoint.
To synchronize changes with the gateway when setting login_mode, use the sync_gateways option.

Use the -s option to allow or prohibit users from changing the login mode of an endpoint. Specify the -s variable option if you want the endpoint to be able to change its login mode. If you specify the -s constant option, changes to the login mode are ignored. For more information about the Mobile Computing console, see the Tivoli Management Framework User's Guide.


preferred_gateway {gw_label|nil}
Sets the preferred gateway field to the specified gateway. Use nil to clear a preferred gateway.


upgrade_mode {enable|disable}
Sets whether the endpoint is upgradable.


set_config suboption
Allows you to set endpoint options from any managed node in the Tivoli region without having to stop and start the endpoint. You can specify only one of the following options on a single wep set_config command:


Specifies whether all communication between the endpoint and its assigned gateway use the configured target port on the endpoint. If set to true, the endpoint and gateway communicate using the target port only. Before endpoint can use proxy upcalls, the endpoint must establish a connection to a proxy-capable gateway. If set to false, the endpoint and its assigned gateway communication as usual. This option modifies the value of the allow_proxy_upcalls in the last.cfg file. The default is false.


Specifies the directory on the identified endpoint where multicast distributions are stored until they are installed. This option modifies the value of depot_dir in the last.cfg file. The default directory is $LCF_DATDIR/depot. If a relative path is specified, the depot directory is relative to $LCF_DATDIR.


Specifies the level of detail written to trace files for the identified endpoint. This option modifies the value of log_threshold in the last.cfg file. The integer value specified can be in the range of 1>=integer<=4, where 1 provides the least level of detail and 4 provides the most. The default logging threshold is 1.


set_crypt_mode {NONE|DES}
Specifies whether the endpoint uses 56-bit DES encryption when communicating with its gateway. When set to DES, the communication is encrypted. When set to NONE, the communication is not encrypted.
To synchronize changes with the gateway when setting set_crypt_mode, use the sync_gateways option.


set gateway {-e ep_label|-g gw_label}
Informs the endpoint of its currently assigned gateway. Use the -e option to update the endpoint specified by ep_label. Use the -g option to update all endpoints assigned to the gateway specified by gw_label.


set interfaces {-e ep_label | -g gw_label} gw_hostname+port gw_IP_address+port [:gw_hostname+port|:gw_IP_address+port]...
Sets the address and port of one or more gateways to which an endpoint can log in. This set of interfaces becomes the gateway list for an endpoint that the endpoint uses when it becomes isolated. Use the -e option to invoke this command on the endpoint specified by ep_label. Use the -g option to invoke this command on all the endpoints assigned to the gateway specified by gw_label. You can specify more than one gateway address. Multiple addresses must be separated by colons.


set_label [-s] new_label
Changes the current label (ep_label) of an endpoint to a new label specified by new_label. Use the -s option to synchronize the gateway and update the endpoint with the new label. This command contacts the endpoint.


Lists the status of the specified endpoint. An status for an endpoint can be either "alive" or "endpoint may be unreachable" if the status could not be determined. This command contacts the endpoint.


Synchronizes the endpoint data stored by the endpoint manager, gateways, and endpoints within a Tivoli region. If you make changes to an HTTP password for the endpoint or policy region, change encryption settings, or decide to use one of the options listed in Advanced Options, you must use this option for updates to take effect. This option is useful in a scheduled job that updates several endpoint data updates at once.
To change the policy region of an endpoint, use the wmv command.


upgrade {disable | enable}
Specifies whether the endpoint is upgradable.


Identifies the endpoint on which other wep suboptions are run. Without suboptions, wep ep_label displays all information for the endpoint in a tabular format.


Advanced Options

If you are not explicitly familiar with the advanced implications of the wep command, call your Customer Support provider before attempting to perform any of the following wep operations:



del ep_oid gw_label
Deletes the endpoint from an epmgr.bdb file. Because there are separate .bdb files for each gateway, it is necessary to specify the endpoint's assigned gateway. gw_label can be found by issuing the wep ls command. The wep del command does not completely delete all references to the endpoint. To delete all references to an endpoint, use the wdelep command.


view ep_oid gw_label
Displays endpoint information stored in the .bdb file associated with the gateway and located in the $DBDIR/epmgr.bdb directory. Unlike the wep ep_label command, the wep view command does not search the endpoint manager's internal cache. gw_label can be found by issuing the wep ls command.

The following commands are used to configure boot methods created by application developers (using Tivoli Application Development Environment [ADE]) to run on an endpoint. Use these options to configure boot methods during the installation of an endpoint or during the distribution of application profiles. These methods run every time an endpoint logs in to a gateway.


boot_method add tag prototype_object method_name ep_oid...
Adds the specified boot method to the endpoint, where:


Specifies the user specified name.


Specifies the prototype OID, which implements the method.


Specifies the name of the method.


Specifies the OID of one of several endpoints on which the method will run. Separate OIDs with spaces.


boot_method list tag ep_oid
Lists the prototype object number and method name of the specified boot method on the endpoint.


boot_method remove tag ep_oid...
Removes the specified boot method from the endpoint.


boot_method test tag ep_oid
Starts the specified boot method on the endpoint.




  1. The following example lists the endpoints assigned to the jadams-gateway:
    wep ls -g jadams-gateway
         1122334455.1.512  jadams-gateway
         1122334455.10.500+ cookU
         1122334455.11.500+ cookA
         1122334455.12.500+ jadams
         1122334455.13.500+ jadamsM
         1122334455.15.500+ jadamsG
  2. The following example returns all information contained in the endpoint list regarding endpoint cookG:
     wep cookG
                   object 1196743040.13.517+#TMF_Endpoint::Endpoint#
                    label ep7612
                  version 41000
                       id 001454ED4C00
                  gateway 1196743040.1.578
             pref_gateway OBJECT_NIL
                  netload OBJECT_NIL
                   interp aix4-r1
               login_mode desktop, constant
                 protocol TCPIP
                   policy OBJECT_NIL
                    httpd tivoli:@+`t<XIr
                    alias OBJECT_NIL
               crypt_mode NONE
             upgrade_mode enable
          last_login_time 2000/11/17-11:11:08
      last_migration_time 2000/11/17-11:11:06
         last_method_time 2000/11/17-11:11:09
  3. The following example returns the network address of endpoint cookG:
    wep cookG get lab,address
  4. The following example returns the randomly generated HTTP password for endpoint cookG:
    wep cookG get httpd



    Represents the user name


    Is the separator


    Represents the password
  5. The following example returns the prototype object and method name of the test18 boot method on endpoint 1802218143.13.500:
    wep boot_method list test18 1802218143.13.500+
    Boot Method(s) for Endpoint 1802218143.13.500+
    TagPrototype ObjectMethod Name
  6. The following example gets the current login mode on endpoint msistrunk:
    wep msistrunk get login_mode
    desktop, constant
  7. The following example clears the preferred gateway on the msistrunk endpoint:
    wep msistrunk set preferred_gateway nil

See Also

wdelep, wmdist, wmv



Groupthink : Two Party System as Polyarchy : Corruption of Regulators : Bureaucracies : Understanding Micromanagers and Control Freaks : Toxic Managers :   Harvard Mafia : Diplomatic Communication : Surviving a Bad Performance Review : Insufficient Retirement Funds as Immanent Problem of Neoliberal Regime : PseudoScience : Who Rules America : Neoliberalism  : The Iron Law of Oligarchy : Libertarian Philosophy


War and Peace : Skeptical Finance : John Kenneth Galbraith :Talleyrand : Oscar Wilde : Otto Von Bismarck : Keynes : George Carlin : Skeptics : Propaganda  : SE quotes : Language Design and Programming Quotes : Random IT-related quotesSomerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose BierceBernard Shaw : Mark Twain Quotes


Vol 25, No.12 (December, 2013) Rational Fools vs. Efficient Crooks The efficient markets hypothesis : Political Skeptic Bulletin, 2013 : Unemployment Bulletin, 2010 :  Vol 23, No.10 (October, 2011) An observation about corporate security departments : Slightly Skeptical Euromaydan Chronicles, June 2014 : Greenspan legacy bulletin, 2008 : Vol 25, No.10 (October, 2013) Cryptolocker Trojan (Win32/Crilock.A) : Vol 25, No.08 (August, 2013) Cloud providers as intelligence collection hubs : Financial Humor Bulletin, 2010 : Inequality Bulletin, 2009 : Financial Humor Bulletin, 2008 : Copyleft Problems Bulletin, 2004 : Financial Humor Bulletin, 2011 : Energy Bulletin, 2010 : Malware Protection Bulletin, 2010 : Vol 26, No.1 (January, 2013) Object-Oriented Cult : Political Skeptic Bulletin, 2011 : Vol 23, No.11 (November, 2011) Softpanorama classification of sysadmin horror stories : Vol 25, No.05 (May, 2013) Corporate bullshit as a communication method  : Vol 25, No.06 (June, 2013) A Note on the Relationship of Brooks Law and Conway Law


Fifty glorious years (1950-2000): the triumph of the US computer engineering : Donald Knuth : TAoCP and its Influence of Computer Science : Richard Stallman : Linus Torvalds  : Larry Wall  : John K. Ousterhout : CTSS : Multix OS Unix History : Unix shell history : VI editor : History of pipes concept : Solaris : MS DOSProgramming Languages History : PL/1 : Simula 67 : C : History of GCC developmentScripting Languages : Perl history   : OS History : Mail : DNS : SSH : CPU Instruction Sets : SPARC systems 1987-2006 : Norton Commander : Norton Utilities : Norton Ghost : Frontpage history : Malware Defense History : GNU Screen : OSS early history

Classic books:

The Peter Principle : Parkinson Law : 1984 : The Mythical Man-MonthHow to Solve It by George Polya : The Art of Computer Programming : The Elements of Programming Style : The Unix Haterís Handbook : The Jargon file : The True Believer : Programming Pearls : The Good Soldier Svejk : The Power Elite

Most popular humor pages:

Manifest of the Softpanorama IT Slacker Society : Ten Commandments of the IT Slackers Society : Computer Humor Collection : BSD Logo Story : The Cuckoo's Egg : IT Slang : C++ Humor : ARE YOU A BBS ADDICT? : The Perl Purity Test : Object oriented programmers of all nations : Financial Humor : Financial Humor Bulletin, 2008 : Financial Humor Bulletin, 2010 : The Most Comprehensive Collection of Editor-related Humor : Programming Language Humor : Goldman Sachs related humor : Greenspan humor : C Humor : Scripting Humor : Real Programmers Humor : Web Humor : GPL-related Humor : OFM Humor : Politically Incorrect Humor : IDS Humor : "Linux Sucks" Humor : Russian Musical Humor : Best Russian Programmer Humor : Microsoft plans to buy Catholic Church : Richard Stallman Related Humor : Admin Humor : Perl-related Humor : Linus Torvalds Related humor : PseudoScience Related Humor : Networking Humor : Shell Humor : Financial Humor Bulletin, 2011 : Financial Humor Bulletin, 2012 : Financial Humor Bulletin, 2013 : Java Humor : Software Engineering Humor : Sun Solaris Related Humor : Education Humor : IBM Humor : Assembler-related Humor : VIM Humor : Computer Viruses Humor : Bright tomorrow is rescheduled to a day after tomorrow : Classic Computer Humor

The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

Copyright © 1996-2021 by Softpanorama Society. was initially created as a service to the (now defunct) UN Sustainable Development Networking Programme (SDNP) without any remuneration. This document is an industrial compilation designed and created exclusively for educational use and is distributed under the Softpanorama Content License. Original materials copyright belong to respective owners. Quotes are made for educational purposes only in compliance with the fair use doctrine.

FAIR USE NOTICE This site contains copyrighted material the use of which has not always been specifically authorized by the copyright owner. We are making such material available to advance understanding of computer science, IT technology, economic, scientific, and social issues. We believe this constitutes a 'fair use' of any such copyrighted material as provided by section 107 of the US Copyright Law according to which such material can be distributed without profit exclusively for research and educational purposes.

This is a Spartan WHYFF (We Help You For Free) site written by people for whom English is not a native language. Grammar and spelling errors should be expected. The site contain some broken links as it develops like a living tree...

You can use PayPal to to buy a cup of coffee for authors of this site


The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

Last modified: March 12, 2019