Update

This command allows you to change the Dollar Universe node registration in the list of UVMS nodes and thus change the Dollar Universe instance startup configuration: host name, port numbers and activation of servers, areas, update the passphrase.

This command can be used if the Dollar Universe host name has been changed (unims -update -host NEWHOST) or to create a new passphrase (unims -update -login XXX -pwd YYY –passphrase ZZZ).

Dollar Universe must be stopped.

Syntax on Windows/UNIX/OpenVMS

unims -update -login user -pwd password -passphrase passphrase [-pwdfile filename] [-host hostname] [-label label][-Xservers server=port,server=port] [-Sservers server=port,server=port] [-Iservers server=port,server=port] [-Aservers server=port,server=port] [-areaS] [-areaI] [-areaA]

Syntax on OS/400

UNIMSUPDAT +F4

• -login

  Univiewer user account with « Dollar Universe Node Registration » permissions. (Administrator’s account for example).

• -pwd

  Password. Incompatible with -pwdfile. Mandatory if -pwdfile is not used.

• -pwdfile

  Full name of the file which stores the encoded password. Incompatible with -pwd. Mandatory if -pwd is not used. The file must be generated with the UVMS "uniencryptpwd" command.

• -mshost

  UVMS hostname or IP address

• -msport

  UVMS TCP port number

• -host

  Hostname of the DUAS instance to register

• -label

  Label (in UVMS) of the instance to register

• -Xservers

  Defines the TCP port numbers of servers in the Production area. Syntax: "server=port,server=port,…"

  • server: Server code to configure: IO, BVS, CDJ, DQM, EEP, OAP, SAP, JEE, GSI
  • port: Server TCP port number

  For example: -Xservers "SAP=10633,JEE=10634"

  If a port number is specified for a server with the -*servers option, the corresponding Area is automatically activated. The usage of the -area* option is then not required. Similarly, if a port number is specified for a manager, the manager is automatically activated. The use of option -act* is not required.

• -Sservers

  Defines the TCP port numbers of servers in the Simulation area. Syntax: "server=port,server=port,…"

  • server: Server code to configure: IO, BVS, CDJ
  • port: Server TCP port number

• -Iservers

  Defines the TCP port numbers of servers in the Integration area. Syntax: "server=port,server=port,…"

  • server: Server code to configure: IO, BVS, CDJ
  • port: Server TCP port number

• -Aservers

  Defines the TCP port numbers of servers in the Application area. Syntax: "server=port,server=port,…"

  • server: Server code to configure: IO, BVS, CDJ
  • port: Server TCP port number

• -areaS

  Enables the Simulation area

• -areaI

  Enables the Integration area

• -areaA

  Enables the Application area

Examples

unims -update -label newlabel

This command updates the description associated to the node in the UVMS nodes list.

unims -update -Aservers "IO=12603,BVS=12608,CDJ=12614"

This command updates the TCP ports numbers of the servers in the Application area.

• If login / password are provided, login authentication is made; otherwise, passphrase authentication is used.
• If the command activates an Area, the user must ask for a full synchronization of the node in UVC (administration mode > Nodes > Nodes, select the Dollar Universe node > Display > Full Synchronization).
• Caution: Updating of the servers' TCP port numbers must be carried out carefully. You must make sure that two servers do not have the same TCP port, or one of them will no longer be able to communicate.

UNIMSUPDAT LOGIN('admin') PWD('admin') ASERVERS(11003 11008 11014) AREAA(*YES)

On OS/400, this command updates activates the Application area.

Errors

• If Dollar Universe is started
• If the node is not registered in UVMS
• If the passphrase or the login/password are invalid
• If the syntax is incorrect