Chapter 5
Upstream Utilities

There is one upstream utility:

mnupdenial

Establishes the denial message that the upstream packet pump sends to the client device if the Oracle Video Server cannot accommodate a connection request.

mnupdenial

The mnupdenial utility establishes the denial message that the upstream packet pump sends to the client device if the Oracle Video Server cannot accommodate a connection request, for example, if no downstream managers are available.

This utility is only useful if the upstream network in your Oracle Video Server system allows the packet pump to send messages to the client device. With other networks the denial message may be sent by another component of the system such as the Level 1 gateway (L1GW).

Note

This utility is not used in a corporate LAN environment.

Syntax

mnupdenial [-f /path/file | -s "string" | -l]

where:

-f

reads a message from the specified file and establishes it as the denial message. If you omit path, mnupdenial assumes the file is in your current working directory.

-l

returns the currently established denial message.

-s

specifies the denial message in the quoted "string" on the command line.

If you omit -f, -s, and -l, mnupdenial prompts you to type a message at your terminal and terminate it with ^D.

Usage Notes

When you start the upstream packet pump, the denial message defaults to "Service Denied."

The denial message can be no longer than 64 characters.

If you write a denial message containing carriage returns or unprintable characters, mnupdenial removes them from the message.

Examples

Example 1

This example reads a message from the file preshdn.msg in your current working directory and establishes it as the denial message:

% mnupdenial preshdn.msg 

1 upstream managers found

Message now: "System shutting down at 4:00pm; try again later."

This example returns the number of upstream managers running and the new message.

Example 2

This example reads the message "All circuits are busy; try again later." from the command line and establishes it as the denial message:

% mnupdenial -s "All circuits are busy; try again later."

1 upstream managers found

Message now: "All circuits are busy; try again later."

Example 3

This example prompts for a message, receives the message "Loading new movies to disk; try again at 5:00pm PDT.", and establishes this message as the denial message:

% mnupdenial

Enter your denial message.  Type ^D when finished. 

Loading new movies; try again at 5:00pm PDT.

^D

1 upstream managers found

Message now: "Loading new movies; try again at 5:00pm PDT."

Example 4

This example returns the currently established denial message "Service Denied":

% mnupdenial -l

1 upstream managers found

1.0.75.1 Service Denied.

This example also returns the number of packet pumps running and the Oracle Media Net address of each.

---