HP 3000 Manuals HP 3000 Manuals
FILE
This' command enables you to create a file equation that overrides
programmatic or system default file specifications.
Syntax
FILE formaldesignator=[*formaldesignator]
[filereference ]
[;DEV=[#] [device][,[outpri][,numcopies]]]
[ [ [ [F] ]]]
[;REC=[recsize][,[blockfactor][,[U][,BINARY]]]] [;ENV=envfile]
[ [ [ [V][,ASCII ]]]]
[;ACC=[APPEND]] [;FORMS=formsmsg] [;FORMID=formid] [;NOCCTL]
[;CCTL ]
Parameters
formal- designator The formal file designator, interpreted according
to MPE-escaped semantics formaldesignator, can be
either an MPE file (i.e., one that uses MPE syntax)
or it can be a POSIX file name beginning with a dot
or a slash. For example, you can use the escaped
pathname /SYS/PUB/FILE since it is equivalent to
the MPE name FILE.PUB.SYS.
If the file designator follows MPE syntax, it must
use this format:
filename[.groupname[.accountname]][:envid]
The filename, groupname and accountname identifiers
may each contain up to eight uppercase alphanumeric
characters. The envid has two valid forms:
node[.domain[.organization]]
envname[.domain[.organization]]
If formaldesignator is not equated to another file,
the parameter specifies the name of an actual file.
*formal- designator Specifies a backreference to a formal file
designator defined in the FILE command. Note that
this backreferenced form is valid only if it
appears to the right of the equal sign (=).
filereference The actual file designator of the file, interpreted
according to MPE-escaped semantics. filereference
can be either an MPE file (i.e., one that uses MPE
syntax) or it can be a POSIX file name beginning
with a dot or a slash. For example, you can use
the escaped pathname /SYS/PUB/FILE since it is
equivalent to the MPE name FILE.PUB.SYS.
If the file designator follows MPE syntax, it must
use this format:
filename[/lockword][.groupname[.accountname]][:envid]
The filename, groupname and accountname identifiers
may each contain up to eight uppercase alphanumeric
characters. The envid has two valid forms:
node[.domain[.organization]]
envname[.domain[.organization]]
If you include this command in a job and
filereference includes a lockword that you omit
from the command line, MPE/iX will not open the
file. In a session, MPE/iX prompts you for a
lockword as necessary.
DEV Specifies a parameter with one or more of three
parameter options: device, outpri, or numcopies.
If you use DEV, you must include at least one of
these parameters or the # symbol, which specifies
the default device class of DISC.
You can use a previously defined environment
identifier for the DEV parameter, but you cannot
use the domain and organization qualifiers.
Descriptions of the parameter options are as
follows:
device Specifies the logical device
class name or logical device
number of a device, such as a
disk, tape, printer, or a
terminal. The default is
DISC.
outpri Specifies the output priority
requested for an output spool
file, which can range from 1
(the lowest priority) to 13
(the highest priority).
numcopies Specifies the number of
copies requested for an
output spool file. The
maximum number is 127.
REC Specifies a parameter with the following parameter
options:
recsize Indicates the record size.
If you do not use the DEV
parameter, the default is
DISC with 1023 records.
A positive number indicates
words; a negative number
indicates bytes. For
fixed-length files, recsize
is the logical record size.
For undefined-length files,
recsize is the maximum record
size. For variable-length
files, recsize is the maximum
logical record size if the
blockfactor is 1.
Only this parameter option
applies to $STDIN, $STDINX,
or $STDLIST. If you specify
other parameter options for
these files, the FILE command
returns an error.
blockfactor Specifies the number of
logical records per physical
block for new files. The
maximum size is 255.
F, U, or V Defines the format of the
records of the file. A
file can contain
fixed-length records (F),
undefined-length records (U),
or variable-length records
(V). The default is F for
disk files.
BINARY or ASCII Specifies the type of
records. BINARY indicates
binary-coded records and is
the default. ASCII indicates
ASCII-coded records.
ENV Specifies the name of a file, envfile, containing
printer environment information, which controls the
print output formats on the printer. Not all
printers support this feature of accepting
environment information. The envfile can be an
actual file designator, or it can be a formal file
designator preceded by an asterisk (*).
The information in the envfile can contain
specifications for page size, character fonts,
forms, and other printer requirements to be used
with the HP laser printing system. The file must
be in a suitable form for downloading to the
printer.
For example, to specify the environment file
ACCTENV.HPENV.SYS to be used when printing, enter:
FILE ACCTLIST;DEV=ACCTPP;ENV=ACCTENV.HPENV.SYS
For information on creating an environment file for
your printer, refer to your printer documentation.
ACC Specifies only append access to any file.
FORMS Provides an operator message requesting that
certain forms be mounted. The message must appear
and be replied to at the console before the output
data can print on a line printer.
The message can consist of a string of 49 or fewer
ASCII characters terminated by a period. You can
use this parameter to send control characters for
bells and inverse video. If you attempt to send
other control characters, however, blanks and the
associated control character letter may appear.
FORMID Identifies a special form to be mounted. This
parameter only applies to output spool files. The
parameter consists of a string of up to eight
alphanumeric characters, beginning with a letter,
that uniquely identifies the special form.
A message displaying the formid prints on the
console or $STDLIST of the associated user of the
spooled device. The spooler process then waits for
verification that the special forms are mounted
before printing the file for which the formid was
specified.
NOCCTL or CCTL Indicates whether or not you are specifying
carriage-control characters. NOCCTL, the
default, indicates that you are not specifying
carriage-control characters in writes to the file.
CCTL indicates that you are specifying
carriage-control characters in writes to the file.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Pressing Break does not affect this command.
* Requirements
To use this command for a file, you must specify a valid, formal
file designator, which is the name by which your program
recognizes the file. The formal file designator enables commands
and code outside your program to reference the file.
* Command duration
The FILE command remains in effect for the entire job or session
unless you cancel it by using the RESET command or you enter
another FILE command for the same formal file designator.
Examples
* To run the program MYPROG that does the following:
* references two files by the file names (formaldesignators)
SOURCE and DEST
* uses two existing disk files, INX and OUTX, as the actual
files for the program
Enter:
:FILE SOURCE=INX
:FILE DEST=OUTX
:RUN MYPROG
* To send output to a new file, FILEX, that has 64-word fixed-length
records and two records per block in ASCII code, enter:
:FILE DEST=FILEX,NEW;REC=64,2,F,ASCII
:RUN MYPROG
Note that the file equation only modifies the specified items.
Related Commands
BUILD
LISTEQ
RESET