Unix Utilities APPENDIX A

 

Two utility programs are provided with the PortMaster software distribution which support Dialnet operations. They are:

 

pmdial

 

This utility allows a UNIX user to request that the PortMaster initial¢ dialing to a Dialnet Manual Dial Location (as found in the PortMaster Location Table). This utility is useful for scheduling network connections to remote sites, to allow users to start network connections, or for custom dial-back applications.

 

Syntax

 

pmdial l-v] portmaster_name password location_name Where:

 

-v - This option causes the PortMaster to display the actual execution of the dial command script to the user.

 

portmaster name - is the name of the PortMaster as shown in the local hosts list.

 

pa*~word - is the PortMaster administration password for the named PortMaster.

 

location_name - is the name of a dial-out location in the PortMaster Location Table.

 

Operation

 

After checking syntax, pmdial establishes a network connection to the PortMaster and issues the command to dial the

 

A-1

 

 

 

specified location. Prodial then monitors the PortMaster to verify that the attempt to dial was successful. Pmdial returns after the dial attempt succeeds, or after the PortMaster times out and fails to complete the connection. Pmdial] displays its results on the standard output.

 

Exit Codas

 

Prodial exits with a 0 return code if the dial attempt succeeded. Otherwise, prodial returns -1.

 

Limitations

 

Prodial uses the TCP administration port of the PortMaster to request and monitor dial operations. Therefore, PMconsole cannot be running at the same time as Pmdial

 

pm reset

 

This utility allows a UNIX user to request that the PortMaster reset an active serial port. This would terminate an active Dialnet connection on that port,

 

Syntax

 

pro reset portmaster_name password portname

 

Where:

 

portmaster name - is the name of the PortMaster as shown in the local hosts file.

 

password - is the PortMaster administration password for the named PortMaster.

 

portname - is the name of the serial or parallel port on the PortMaster (ie S0-S9 or PO).

 

A-2

 

 

 

Operation

 

After checking syntax, pro reset establishes a network connection to the PortMaster and issues the command to reset the specified port. Pro reset displays its results on the standard output.

 

Exit Codes

 

Preset exits with a 0 return code if the reset attempt succeeded. Otherwise, pro reset returns -1.

 

Limitations

 

PMreset uses the TCP administration port of the PortMaster to request the reset operation. Therefore, PMconsole cannot be running at the same time as PMreset.

 

A-3