pdwsinitports utility: initialize or change the ports used by the InfoPrint Manager Web Server

Syntax

pdwsinitports  [BasePortNumber]
pdwsinitports {-d}
pdwsinitports {-h  |  ?}  

Description

Important: If the UAC is enabled you need to use the “Run as Administrator” option when running the command. To do this, right click on the command prompt and select "Run as Administrator" from the list.

Use the pdwsinitports utility to initialize or change the ports used by the InfoPrint Manager Web Server. This utility either finds a range of ports on this system or you can specify a range of port number on his system for use by the Web server. By specifying a range of port numbers, you can avoid using port numbers that are used by or reserved for other programs. This utility can also be used to display the current port settings.

The pdwsinitports utility does not modify the state of the InfoPrint Manager Web Server. If the web server is stopped before you run the command, it remains stopped. If the web server is running, it continues to run after the command completes. Because InfoPrint Manager automatically initialized port numbers when it is installed, you should not have to run this utility normally.

The pdwsinitports utility initializes the ports used by InfoPrint Manager Web Server by reserving port numbers in the services file. On AIX or Linux systems, see the /etc/services file for the reserved port numbers. On Windows systems, see the %SystemRoot%\system32\drivers\etc\services for reserved port numbers. The pdwsinitports utility will not use port numbers that are used by or reserved for other programs. If InfoPrint Manager cannot reserve port numbers, it will not start the InfoPrint Manager Web Server.

On system upgrades, the ports used by InfoPrint Manager might get removed from the services file. Use the pdwsinitports utility to re-initialize the InfoPrint Manager Web Server ports.

Flags

You can use these flags with the pdwsinitports utility:

-d
Displays the current port setting for the InfoPrint Manager Web Serve and indicates if the port is current active for any process.
-h | -?
Displays help for the pdwsinitports utility.

Argument

The valid argument value for the pdwsinitports utility is:

BasePortNumber
Specifies the base for assigning ports, and it is normally a number that is a multiple of 1000. These ports are assigned:
  • HTTP Transport: BasePortNumber+ 80
  • HTTPS Transport: BasePortNumber+ 443

The default value is 14000.

When no BasePortNumber is specified on AIX or Linux, the pdwsinitports utility starts at 14000 and determines if any of the desired ports are in use by checking etc/services. If any of the desired ports are in use, the pdwsinitports utility increments the range by 1000 and continues searching for a base that has the desired ports available. If the pdwsinitports utility reaches 64000 and no base range is available, an error is generated.

Examples

  • To set the InfoPrint Manager Web Server to use ports in the 7000 area, enter:
    pdwsinitports 7000
  • To set the InfoPrint Manager Web Server to find a set of ports to use, enter:
    pdwsinitports
  • To display the current port settings and determine whether any are currently active, enter:
    pdwsinitports -d

/etc/services

The InfoPrint Manager ports use these names in /etc/services with the getservent system APIs:
Description Service Name
HTTP port iprws_http
HTTPS port iprws_https