Register

This command declares the Dollar Universe node to UVMS. It calculates a pass-phrase (a password) and sends it to UVMS. UVMS registers the DUAS node and starts the synchronization on that node.

We recommend doing the registration during the installation process. But this command should be used if the registration of Dollar Universe to UVMS could not be done during the Dollar Universe installation procedure.

Dollar Universe must be stopped.

If a parameter is not supplied, its value will be issued from the current DUAS values.xml file.
If a parameter is supplied, its value overrides anything in the values.xml file. The values.xml file is then modified. No cancellations are possible.
This file contains data configuration from the server. It is strongly recommended not to change a parameter manually.

Syntax on Windows / UNIX / VMS

unims -register -login user -pwd password [-pwdfile filename] [-mshost hostname] [-msport port] [-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] [-mgrSAP] [-mgrOAP] [-mgrJEE] [-actSAP] [-actOAP] [-actJEE]

Syntax on OS/400

UNIMSREGIS +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

• -mgrSAP

  The Manager for SAP Solutions is installed but not activated

• -actSAP

  Enables the Manager for SAP Solutions

• -mgrOAP

  The Manager for Oracle Applications is installed but not activated

• -actOAP

  Enables the Manager for Oracle Applications

• -mgrJEE

  The Manager for Java is installed but non-activated

• - actJEE

  Enables the Manager for Java

Examples

Example of registration using the values set during installation:

unims -register -login admin -pwd admin

passphrase=<X[W^xnF[EsXN<?d9qX4n>

10 ports received.

<IO > A = 10603

<BVS> A = 10608

<CDJ> A = 10614

<IO > X = 10600

<BVS> X = 10605

<CDJ> X = 10611

<DQM> X = 10615

<EEP> X = 10604

<SAP> X = 0

<JEE> X = 0

1 UVMS host received.

[FRWPMDEV08:4184]

Registration with UVMS FRWPMDEV08_MgtServer (FRWPMDEV08/4184) successful.

In this example, the Application Area BVS server is configured to start on the TCP port number 10608: installation value by default.

Example of a registration overwriting a predefined value:

unims -register -login admin -pwd admin -Aservers "BVS=10609"

passphrase=<rgB1>ouhbbaHp5NkrAmC>

10 ports received.

<IO > A = 10603

<BVS> A = 10609

<CDJ> A = 10614

<IO > X = 10600

<BVS> X = 10605

<CDJ> X = 10611

<DQM> X = 10615

<EEP> X = 10604

<SAP> X = 0

<JEE> X = 0

1 UVMS host received.

[FRWPMDEV08:4184]

Registration with UVMS FRWPMDEV08_MgtServer (FRWPMDEV08/4184) successful.

In this example, the Application Area BVS Server is set to start on TCP port 10609. This new value overwrites the previous and the values.xml file from the Dollar Universe instance is modified accordingly.

If so an error message is returned.

Errors

• If Dollar Universe is started
• If the node is already registered in UVMS
• If a port number is already used by this host
• If the syntax is not correct