PicLan-IP TCL Commands

This is a listing of PicLan-IP TCL commands within the PicLan-IP account. Not all commands are applicable for all platforms and this is noted with the documentation for each command:

UPDATE-PICLAN

PLIP-LOAD

PLIP-INIT

UPDATE-PICLAN

UPDATE-PICLAN

Native hosts only

This command is used to update a number of items in the PIC-LAN account. You should run this command whenever you initially load the PICLAN-IP account, upgrade the PICLAN-IP account, or upgrade the PIC-LAN account.

After you run the command, you should re-boot your system to load the new PicLan-IP driver. You can then execute PL-STAT to verify the driver version number which is displayed next to the local Pick host's server name.

PLIP-LOAD

PLIP-LOAD

NT hosts only

This command loads the PicLan-IP support DLL into system memory. You must execute this command before using any other PicLan-IP functions. This command may only be executed a single time.

PLIP-INIT

PLIP-INIT

Native hosts only

This command will initialize the native TCP/IP protocol stacks. During this initialization, the following steps are performed:

Memory for TCP/IP connections in allocated based on the CONN=nnn field in the config item
IP addresses, network masks, and routing table information are setup
PicLan IPX ports are converted to TELNET ports
Validates the PicLan-IP authorization and license codes

You may execute this command at any time to change your IP addressing or routing configuration.

PLIP-CLEANUP

This command will clear PicLan-IP work files, rebuild email indexes, and delete stranded TCP and UDP connection control blocks. This command is designed to run during initial system initialization processing.

PLIP-START

PLIP-START (options)

All hosts

This command will actually start the PicLan-IP background processes. Background processes port numbers or phantom assignments are entered in the config item. After the supervisor process is started, the PLIP-MONITOR program is automatically run so that PicLan-IP activity can be viewed.

options

M - do not enter the PLIP-MONITOR program after starting the server processes. This option is usually used during proc that start PicLan-IP upon system bootup.

PLIP-STOP

PLIP-STOP

All hosts

This command will send a stop signal to the PicLan-IP supervisor process. The supervisor process will then send stop signals to each of the thread processes. After the stop signal is sent, the PLIP-STOP program will enter the PLIP-MONITOR program to watch activity until the last thread process logs off.

PLIP-RESTART

PLIP-RESTART

All hosts

This command will send a restart signal to all PicLan-IP thread processes. Restarting PicLan-IP thread processes may be necessary in the following situations:

You have recompiled an external BASIC subroutine and your MultiValue implementation caches BASIC object code.
You need to force the PicLan-IP server to re-initialize.

When you execute this command, each PicLan-IP thread process will complete the current event and then within 10 seconds stop and automatically restart. If you have multiple thread processes running, users will probably not notice the restart event. If you only have a small number of user processes, active users may experience a several second delay in receiving web pages. Existing open connections and active web applications are not lost when you restart the PicLan-IP thread processes.

PLIP-MONITOR

PLIP-MONITOR (options)

All hosts

This command will monitor or watch activity generated by the PicLan-IP supervisor and thread processes. This allows you to watch activity on the PicLan-IP server processes.

Only print statements using the PicLan-IP PL_PRINT ... statement will appear in the PLIP-MONITOR program. Normal PRINT statements, or system messages (such as debugger entries and aborts) will not appear.

You should only run one PLIP-MONITOR program at any one time.

options X - edit the PLIP-MONITOR program after the last server-process is stopped. This option is used internally by PLIP-STOP.

PL-STAT

PL-STAT (options)

All hosts

This command will display the status if PicLan and PicLan-IP connections and connection control blocks (PLCBs).

Native Hosts:

TCP/IP connections and control blocks will be displayed after IPX connections.

NT Hosts:

Only TCP/IP connections will be displayed.

options

These options are defined in the PicLan documentation when used with native hosts. On NT hosts, there are no relevent options.

This command is used to diagnose connection problems.

PL-KILL

PL-KILL

All hosts

This command will first display PicLan IPX and PicLan-IP TCP/IP connections and then give you the option of killing a connection. You should not need to kill connections in normal operation, so this command is intended as an error recovery tool.

PLIP-HTTP

All hosts

PLIP-HTTP url file item {options}

This command will perform an HTTP query using HTTP/1.0 with a GET method. The results of the query will be stored in the specified file.

*url*	The HTTP url for the request. The url is specified in the same manner that a web browser would use. If the first seven characters of the url are not http:// then 'http://' will be prepended to the url. The host name can be either an IP address or a domain name. If a domain name is used then the PLIP-HTTP command will lookup the IP address using the configured DNS (Domain Name Server).
*file*	This is the Pick data file that the result will be stored in.
*item*	This is the Pick data item that the result will be stored in.
*options*	V - verbose. Print extra progress messages

PLIP-HTTP is implemented using the PicLan-IP sockets API. The source code for PLIP-HTTP is included in the PICLAN-IP account

IMPORT-WEB

Native hosts

IMPORT-WEB mvFile DSGName DSGPath {(S)}

NT and Unix hosts

IMPORT-WEB mvFile HostPath {(S)}

The IMPORT-WEB command is used to mass-import web content from a non MultiValue directory structure into a MultiValue data file. With native hosts, you must have a PicLan DOS Services Gateway setup. With hosted platforms, the directory structure must be accessible to the underlying host OS.

Running the IMPORT-WEB function will import all web document files from the specified non MultiValue path into the specified MultiValue data file. All files with extensions that have valid web MIME types will be imported. The IMPORT-WEB function will automatically handle all required format conversions including binary to hex for images, and CRLF to AM for text files.

options S - import subdirectories recursively. Files in subdirectories will be placed in the same import file with the relative path pre-pended to the item-id.

TELNET

All hosts

TELNET Host{:TcpPort}

This command will perform an HTTP query using HTTP/1.0 with a GET method. The results of the query will be stored in the specified file.

*Host*	The name of the remote host to TELNET to. You can specify the name as either an IP address or domain name. If a domain name is used then the TELNET command will lookup the IP address using the configured DNS (Domain Name Server).
*TcpPort*	This is TCP port number to connect to. The default for TELNET is 23.

PLIP-HTTP is implemented using the PicLan-IP sockets API. The source code for PLIP-HTTP is included in the PICLAN-IP account

PLIP-REBUILD-MAIL

All hosts

PLIP-REBUILD-MAIL

This command will rebuild PicLan-IP SMTP/POP3 mail cross-reference information. You should execute this command if the mail cross reference files become corrupted.

PLZ

All hosts

PLZ FILE|HOST|DSG filename (options

This command "compiles" an mv/Web application module. You compile with any of the following syntax's:

PLZ FILE pick_file pick_item (options
PLZ HOST host_path (options
PLZ DSG dsg_name dsg_path (options

Available options are:

(Z - expand includes in-line. This can make debugging easier.