PH-ALLOCATE

Allocates a port to the Terminal Independent Process Handler (TIPH).

Syntax

PH-ALLOCATE {portNumber}

Syntax Elements

portNumber The number of the port to allocate. This must be a 'real' port; that is, one with a number less than that specified by the MaxPortNum database configuration parameter.

See Port Numbers below for more details.

Prompt

If you do not specify a port number, you are prompted:

PORT TO ALLOCATE ?

Enter the required port number.

Restrictions

SYSMAN and SYSPROG accounts only.

You cannot start a TIPH process on a port that is already in use.

You can only run one TIPH process on each port (but see Port Numbers below).

Port Numbers

A list of port numbers specified for TIPH should be obtained from your system administrator. If you try to allocate an invalid port number, the following message is displayed:
```
ILLEGAL PORT SPECIFIED
```
On UNIX, the port numbers you can allocate to run TIPH are restricted by system port settings preset by the system administrator. For information on how to set up a port to allow it to be allocated to TIPH, refer to the section Allocating TIPH Ports.
On Windows, you can use any free port with a number up to that specified by the MaxPortNum database configuration parameter.
The specified port can be the base of a range defined in the devices file using the OPEN and RANGE keywords. In this case, you can start as many TIPHs on that port as there are ports in the range. Each time a TIPH is started the next free port in the range is used.

Note: In this case, only the base port number is considered a TIPH port. You cannot start a TIPH on any other port in the range.

Comments

When you allocate a port using PH-ALLOCATE, it remains a TIPH port until you issue a PH-DELETE command.

You can use an allocated TIPH port as a normal terminal port when you are not using it to run a TIPH process.

Example

This example allocates port number 4 as a TIPH port.

:PH-ALLOCATE
PORT TO ALLOCATE ? 4