An IBM Resource Link profile (user ID) is needed.$^{31}$ This can be an IBM employee profile or a PWD-approved profile for other users. An IBM employee can go to the following link and follow the Register for an IBM ID link (in the upper right part of the page): 

http://www.ibm.com/servers/resourcelink 

After this preliminary work, the token license can be activated, renewed, or have the lease date extended (these are all essentially the same operation): 

1. Connect the USB hardware key to your zPDT system, using any USB port. (You must have the zPDT software installed already.) Only one token can be connected while doing this task. 

2. Working as root , create a request file using Z1090_token_update, or Z1091_token_update : 

(log in with a normal zPDT userid, such as ibmsys1 ) $ su (change to root) # cd /usr/z1090/bin (must be in this directory) # Z1090_token_update -r myrequest # exit (leave root) 

3. If necessary, move this request file to the computer used to access Resource Link and log on to Resource Link. (Your request file name has .req  added as the name extension.) 

4. On Resource Link, navigate to Tools →  1090 Support → Date Extension  and enter the data from your hardware key tag. Use the last six digits of the 11S field. The serial number (the MTSN field) can be entered with or without the dash; it is not case sensitive. Enter the file name of your request file. Finally, click Submit. 

5. Resource Link creates one or two files and send them to you by e-mail. Receive the files and move them to your zPDT machine, if necessary. The file names are the same name that you sent, but with .upw  and .zip  as the name extensions. 

6. Apply$^{32}$ the file to the Gen1 token: 

# Z1090_token_update -u myrequest.zip or # Z1091_token_update -u myrequest.zip 

After the update is successfully applied, unplug the USB hardware key. Wait 10 - 15 seconds and then reconnect the hardware key. It is now ready for routine zPDT operation. 

## 8.13 Summary of relevant zPDT commands and files 

The following zPDT commands are related to licenses, tokens, license servers, UIM, and UIM servers: 

GLYPH<SM590000> clientconfig  - configures both Gen1 and Gen2 client systems. 

– clientconfig_cli  - provides a non-interactive interface to Gen1 clients to configure a connection to a Gen1 license server. 

GLYPH<SM590000> clientconfig_authority  - provides path to use clientconfig from a non-root Linux userid. 

GLYPH<SM590000> gen2_init  - installs the modules needed to work with Gen2 licenses. 

GLYPH<SM590000> query_license  - displays license usage for Gen2 servers or clients. 

