HP 3000 Manuals HP 3000 Manuals
SYSTEM
The SYSTEM statement executes an operating system command from HP
Business BASIC/XL.
Syntax
As a statement or command:
[ [{,} ]]
SYSTEM [str_expr [{;} STATUS [=] num_var]]
As a command only:
{str_lit }
:{unquoted_str_lit}
Parameters
str_expr An operating system command, a UDC, a program file name,
or a commandfile. For information on operating system
commands, see the operating system reference manual and
the Console Operator's Guide. If this parameter is not
specified, HP Business BASIC/XL returns control to the
operating system. You can then return to HP Business
BASIC/XL by typing RESUME at the operating system
prompt.
See the MPE XL Intrinsics Manual for information on what
will be selected if commands, UDCs, programs or
commandfiles exist with the same names.
If HP Business BASIC/XL is running from a batch job,
str_expr must be specified.
If str_expr is specified, the SYSTEM command executes
the CICOMMAND intrinsic, accessing the operating system
only to execute the specified command, and return to HP
Business BASIC/XL.
If any error or warning results from the command the JCW
CIERROR will be changed to reflect the error or warning.
num_var If str_expr is specified, num_var returns the operating
system error number. If str_expr is not specified,
num_var returns the interpreter command error number,
which is:
0 No error (if HP Business BASIC/XL is running interactively).
1 Error (if HP Business BASIC/XL is running from a batch job).
NOTE Just as on-line information on HP Business BASIC/XL is available by
typing HELP in response to the ">" prompt, information on operation
system commands is available by typing :HELP.
Examples
10 SYSTEM !Returns to operating system.
20 SYSTEM "LISTF" !Issues the LISTF command.
30 SYSTEM "SETMSG OFF"0 !Issues the SETMSG command.
40 SYSTEM "LISTF"; STATUS=S !Issues the LISTF command and returns status.
50 SYSTEM "LISTF", STATUS S !Same as line 40.