opx25(1M)																 opx25(1M)

NAME

       opx25 - execute HALGOL programs

SYNOPSIS

       scriptname] char] file-descriptor] file-descriptor] string]

DESCRIPTION

       The commands, including are targeted for removal from HP-UX; see the below.

       HALGOL  is a simple language for communicating with devices such as modems and X.25 PADs.  It has simple statements similar to and that are
       described below.

   Options
       recognizes the following options:

	      Causes	     to read script as the input program.  If is not specified, reads the standard input as a script.

	      Causes	     to use char as the first character in the input stream instead of actually reading  it  from  the	input  descriptor.
			     This is useful sometimes when the program that calls is forced to read a character but then cannot ``unread'' it.

	      Causes	     to use number for the output file descriptor (i.e., the device to use for The default is 1.

	      Causes	     to use 'number' for the input file descriptor (ie, the device to use for 'expect'). The default is 0.

	      Causes	     to save this string for use when is encountered in a command.

	      Causes	     to turn on debugging mode.

	      Causes	     to turn on verbose mode.

       An script file contains lines of the following types:

	      (empty)	     Empty lines are ignored.

	      Lines beginning with a slash
			     are ignored (comments)

	      ID	     ID denotes a label, and is limited to alphanumerics or

	      string	     must  be surrounded by double quotes.  The text is sent to the device specified by the option.  Non-printable charac-
			     ters are represented as in C; i.e., as DDD, where DDD is the octal ascii character code.	in a send  string  is  the
			     string that followed the option.

	      Send a break "character" to the device.

	      Here	     number is how many seconds to wait before giving up.  0 means wait forever, but this is not advised.  Whenever string
			     appears in the input within the time allotted, the command succeeds.  Thus, it is not necessary to specify the entire
			     string.   For  example, if you know that the PAD will send several lines followed by an prompt, you could just use as
			     the string.

	      The program    etc.) is run with the args specified.  Do not use quotes here.  Also, the program is invoked directly (using so  wild
			     cards, redirection, etc. are not possible.

	      If the most recent expect or run encountered an error,
			     go to the label ID.

	      Similar to     but does not fork.

	      Similar to     but goes to standard error instead of to the device.

	      Sets the program in debug mode.
			     It  echoes  each  line  to  as  well as giving the result of each expect and run.	This can be useful for writing new
			     scripts.  The command disables this feature.

	      Sends subsequent incoming characters to
			     This can be used in the file as a security measure, because part of the incoming data stream contains the	number	of
			     the  caller.  There is a similar feature in it writes the time and the login name into the same logfile.  The command
			     disables this feature.

	      Similar to     but better in some cases because it sends only digits to the log file, and not other characters.	The  command  dis-
			     ables this feature.

	      Sets a global timeout value.
			     Each  expect uses time in the timeout reservoir; when this time is gone, the program gives up (exit 1).  If this com-
			     mand is not used, there is no global timeout.  Also, the global timeout can be reset any time, and a value of 0 turns
			     it off.

	      Exits with this value.
			     0 is success; anything else is failure.

       To perform a rudimentary test of configuration files, run by hand, using the option followed by the name of the script file.  then sends to
       standard output and expects from standard input; thus you can type the input, observe the output, and use the command to see messages.  See
       the file for a good example of HALGOL programming.

WARNINGS

       Use of commands, including is discouraged because they are targeted for removal from HP-UX.  Use ftp(1) or rcp(1) instead.

AUTHOR

       was developed by HP.

SEE ALSO

       getx25(1), uucp(1).

								  TO BE OBSOLETED							 opx25(1M)