Creating Views

The syntax of configure runtime for creating a view is:

ConfigureRuntime.exe /ADDVIEW <ViewName> /S <SystemName>
/H <HostName> /P <RATL_TCPIP|RATL_MSMQ|NOF_OFF_CLI|SOAP_HTTP|SOAP_MSMQ|HUB> 
[/E <true|false>] [/M <MsmqName>] [/U <UserName>] [/UG <UserGreeting>] [/D <DomainName>] 
[/DG <DomainGreeting>] [/PW <Password>] [/PG <PasswordGreeting>] [/EA true|false>]
[/AU <AnonymousUserName>] [/AD <AnonymousDomain>] [/AP <AnonymousPassword>] [/?]

If you pass valid parameters to create a view, a message appears as, "Successfully updated the configuration".

Parameters

Argument

Description

/ADDVIEW <ViewName>

Specifies adding a unique view name for protocol adapters to connect to applications. A View can refer to one or more applications, or different Views might apply to the same application each with different parameters.

Notes:

  • This argument is mandatory and case-sensitive. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid: /ADDVIEW / S /H /P" appears.

  • If an invalid value is passed with this argument, an error message appears as “Missing value for required parameter/s: View Name.

  • If you pass the same view name, an error message appears, prompting that the view name already exists.

For example, if you pass empty quotes ("") as a view name, an error message appears.

ConfigureRuntime.exe /ADDVIEW "" /S Sample /H localhost /P RATL_TCPIP /E TRUE

/S <SystemName>

Specifies the name of the system that this view references.

Notes:

  • This argument is mandatory for adding a view. If you do not pass this argument, the error message "Mandatory Input Missing or Invalid : /ADDVIEW / S /H /P" appears.

  • The system name is case-sensitive. The system name is the name of the Segment or else Alternate Name, if it has been defined.

  • If you do not pass any value or pass an invalid value, an error message appears as, “Missing value for required parameter/s: System Name".

  • If you provide empty quotes, " ", or an invalid system name, an error message appears specifying that the system is not available.

For example, if you do not pass this argument, an error message appears, specifying that mandatory input is missing.

ConfigureRuntime.exe /ADDVIEW Sample /H localhost /p RATL_TCPIP

/H <HostName>

Specifies the name of the machine with which you want to connect.

Notes:

  • This argument is mandatory and case-sensitive. If you do not pass this argument, an error message appears as, "Mandatory Input Missing or Invalid : /ADDVIEW / S /H /P".

  • If no value or an invalid value is passed with this argument, an error message appears as “Missing value for required parameter/s: Server Name".

/P <RATL_TCPIP|RATL_ MSMQ|NOF_OFF_ CLI|SOAP_HTTP|SOAP_ MSMQ|HUB>

Specifies creating a view for the following protocol adapters.

  • RATL_TCPIP: Specify this option to connect to Component Enabler using TCPIP connection.

  • RATL_MSMQ: Specify this option to connect to Component Enabler using MSMQ connection.

  • NOF_OFF_CLI: Specify this option to migrate applications from mainframe hosts to Windows operating system hosts.

  • SOAP_HTTP: Specify this option to enable Web services clients to communicate with an application using HTTP connection.

  • SOAP_MSMQ: Specify this option to enable Web services clients to communicate with an application using MSMQ connection.

  • HUB: Specify this option to allow Agile Business Suite systems to talk to each other and to EAE systems.

Notes:

  • This argument is mandatory. If you do not pass this argument, an error message appears as, "Mandatory Input Missing or Invalid : /ADDVIEW / S /H /P".

  • If no option is passed with this argument, an error message appears as, "Missing value for required parameter/s: Protocol Name".

For example, to successfully create a view, type:

ConfigureRuntime.exe /ADDVIEW Sample /S Sample /H localhost /p RATL_TCPIP

/E <true|false>

You can set this argument to true to enable packet logging for each protocol adapter and vice versa.

For example, to create a view by enabling packet logging for RATL over TCPIP, type:

ConfigureRuntime.exe /ADDVIEW SAMPLE /S NEWSAMPLE /H localhost /p RATL_TCPIP  /E true

/M <MsmqName>

Specifies the message queue name to be used. The default value is null.

Note: This parameter is only valid for RATL over MSMQ and SOAP over MSMQ protocols. If you do not pass the message queue name for RATL over MSMQ or SOAP over MSMQ, an error message appears as, "Mandatory Input Missing or Invalid : /ADDVIEW /S /H /P /M".

For example, to create a view with message queue name for RATL over MSMQ, type:

ConfigureRuntime.exe /ADDVIEW SAMPLE 
/S NEWSAMPLE /H localhost 
/p RATL_MSMQ / m "C:\Program~1\Unisys
\ABSUIT~7.0
\bin\RatlQueue.exe"

/U <UserName>

Specifies the Windows user name. The default value is null.

Note: This parameter is only valid for HUB, RATL over MSMQ, and RATL over TCPIP protocols and returns an error message, if not specified.

For example, to add a view for HUB protocol, type:

ConfigureRuntime.exe /ADDVIEW NewSample /S Sample /H localhost /p HUB /D GTCI-DEV /PW user1 /U appuser

/UG <UserGreeting>

Specifies a message to be displayed above the UserName prompt in the login screen. The default value is null.

Note: This parameter is only valid for RATL over TCPIP and RATL over MSMQ protocols.

/D <DomainName>

Specifies a domain name for use with the user name. The default value is null.

Note: This parameter is only valid for HUB, RATL over MSMQ, and RATL over TCPIP protocols and returns an error message, if not specified.

For example, an error message appears when you do not pass the domain name value while configuring for HUB protocol.

ConfigureRuntime.exe /ADDVIEW NewSample /S Sample /H localhost /p HUB / PW user1 /U appuser

/DG <DomainGreeting>

Specifies a message to be displayed above the DomainName prompt in the login screen. The default value is null.

Note: This parameter is only valid for RATL over TCPIP and RATL over MSMQ protocols.

/PW <Password>

Specifies a password of the user id. The default value is null.

/PG <PasswordGreeting>

Specifies a message to be displayed above the Password prompt in the login screen. The default value is null.

Note: This parameter is only valid for RATL over TCPIP, and RATL over MSMQ protocols.

For example, to use the ConfigureRuntime executable for RATL over TCPIP with user greeting and domain greeting information, type:

ConfigureRuntime.exe /ADDVIEW NEWSAMPLE /S SAMPLE /H localhost /p RATL_TCPIP  /UG "User Name:" /U "AppUser" /DG "Domain Name:" /D GTCI-DEV /PG "Password:" /pw Welcome1

/EA <true|false>

You can set this argument to "true" to enable anonymous login and vice versa. Setting this option allows you to automatically log in to a View without entering a usercode or password.

For example, to enable anonymous user login, type:

ConfigureRuntime.exe /ADDVIEW NEWSAMPLE /S SAMPLE /H localhost /p RATL_TCPIP  /EA true

/AU <AnonymousUserName>

Specifies the name of the existing user account that is to be used for anonymous login.

/AD <AnonymousDomain>

Specifies the domain name of the existing user account that is to be used for anonymous login.

/AP <AnonymousPassword>

Specifies the password of the existing user account that is to be used for anonymous login.

For example, to specify the anonymous user name to allow the user to login, type:

ConfigureRuntime.exe /ADDVIEW Sample /S NewSample /H localhost /p RATL_TCPIP  /EA true  /AD GTCI-DEV /AP user1 /AU appuser

/ADDVIEW /?

Displays command line syntax for creating a view, parameters, and options of the utility. If specified, a usage message displays, and utility exits without starting the configuring process.