tcl.pxpcmd Verb: Access/System Architecture


Command tcl.pxpcmd Verb: Access/System Architecture
Applicable release versions: AP/Unix
Category System Architecture (8)
Description sends a command to a PXP server application.

The server is controlled through the following commands:

'addhost' host

Adds a new host, or edits an existing host. "host" is now a valid host name with which the local PXP server can communicate. This command requests:

Access point: Name of the network Service Access Point to which messages are sent.

Routing: Necessary routing information. On a TCP/IP network, the routing is as follows:

tcp/ip host name ] port number on remote host

Description: Free text.

'addsap' sap

Add a Service Access Point (SAP). A SAP is defined as an access to a network. A SAP can be defined as input, output or both. This command requests:

Description: Free text.

Input device: Name of the input device, if the SAP is to be used to read from a network. On TCP/IP, this would be the port number.

Output device: Name of the output device, if the SAP is to be used to write to a network. On TCP/IP, put an asterisk (*).

Init hook:
Open hook:
Close hook:
Read hook:
Write hook:

These fields define the Pick/BASIC subroutines used to access the SAP. If left empty, the standard Unix system calls will be used, when applicable.

Buffer size: This defines the maximum size that can be transmitted through the SAP in one write, or accepted in one read. Sending data bigger than the specified size causes the output server to cut the data into several pieces, which are put back together by the input server on the destination host.


Edits the list of remote virtual machines allowed to send requests to the local host. If this list is empty, or non-existent, all server, except the ones in the 'deny' list, are allowed in. If both the 'allow' and 'deny' list are empty, all servers are allowed.

'declare' host host2

Declares "host2" to "host". The description of "host2", as defined on the local system, is sent to "host".

'delhost' host

Deletes a host.

'delsap' sap

Deletes a service access point (SAP).


Edits the list of remote virtual machines denied access to the local host. If this list is empty, or non existent, only the servers defined in the 'allow' list are allowed in. If both the 'allow' and 'deny' list are empty, all servers are allowed.


Halt the PXP subsystem. All servers are stopped.

'exec' host TCL.command

Submits "TCL.command" to the specified host. The command is executed synchronously by the remote server. This should be restricted to simple, short commands. The result is displayed on the originating terminal on the local system.


Lists the currently defined hosts.

'hoststatus' [host|*]

Gets status information from "host" or from all currently defined hosts. The response to this command comes back asynchronously on the originating terminal. No response from a remote host within a 'reasonable' time are to be assumed as an 'inactive server'.


Installs the PXP server control file. This command must be run from the 'pxp' account, and is normally run at install time.

'msg' host user text

Sends a Pick message to "user" logged on "host". "user" can be an asterisk.


List all defined Service Access Points (SAP).


Starts the local PXP server subsystem.

'startsap' sap

Starts the Service Access Point (SAP) "sap".

'stop' host

Stops the specified host. "Host" can be remote.

"take" acct file item

Takes an item from the remote host. The operator is prompted for the local destination file name and item-id. A message of acknowledgment is sent back by the remote host.
Syntax pxpcmd command {host {arguments}}
1)  :pxpcmd status

Gets status of the PXP subsystem.

2)  :pxpcmd hoststatus *

Gets status information on all defined hosts.

3)  :pxpcmd exec dev2 compile dm,bp, term

Does a remote compile of the program 'bp term' on the virtual machine 
Related tcl.pxpw