 |
» |
|
|
|
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]]]
[;REC=[recsize][,[blockfactor][,[F
U
V][,BINARY
,ASCII]]]]
[;ENV=envfile] [;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 | |
|
