GETSYSNAMS Name
GETSYSNAMS Purpose
Get a list from a file specified by an environmental var.
Category
Calling Sequence
getsysnams, evar, n, lst1, [lst2, lst3]
Inputs
evar = environ var (symbol in VMS) with file name. in
Keyword Parameters
Keywords
ERROR=err 0=ok, 1=no such environmental variable,
2=file not found.
Outputs
n = number of elements in each list. out
lst1, lst2, lst3 = output lists. out
Common Blocks
Notes
Notes: the lines in the file are returned divided into as
many output lists as are requested, with the first line
in the first list, second in second, .... File lines
starting with * are considered comments and are ignored.
This routine is useful for system dependent lists, such
as postscript printers or tape drives.
As an example for printers let the file contain:
*---- Example printers file --------
print/queue=cps_ps
Postscript printer # 1 in room A.
print/queue=cps_ps2
Postscript printer # 2 in room B.
To use:
(1) Set up a systen environmental variable, like
IDL_PSPRINTERS, with the name of the above file.
(2) getsysnams,'idl_psprinters', n, cmds, nams
will give: n = 2, cmds = string array of print
commands, nams = string array of descriptive names
(good for menus).
Modification History
R. Sterner, 22 May, 1990
R. Sterner, 26 Feb, 1991 --- Renamed from get_sysnames.pro
Copyright (C) 1990, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.