HP 3000 Manuals HP 3000 Manuals
FILE
Declares the file attributes to be used when a file is opened. This
declaration, informally known as a file equation, may be used to override
programmatic or system default file specifications. With the addition of
shared parameters from the NS3000/XL AdvanceNet subsystem, the
declaration may specify a formal file designator that may be used to
access a remote file or device in a subsequent command or intrinsic.
NS3000/XL AdvanceNet is not part of the 900 Series HP 3000 fundamental
operating system and must be purchased separately.
Syntax
FILE formaldesignator=*formaldesignator
=$NULL
=$NEWPASS
=$OLDPASS
=$STDIN
=$STDINX
=$STDLIST
=filereference[:nodespec ] [;DEV=[[envname]#][device][,outpri][,numcopies]]
[,filedomain]
[;VTERM][;ENV=envfile[:nodespec]] [;option][;access][;disposition]
Syntax for option
[ [ {F}] ]
;REC=[recsize][,[blockfactor][,{U}][,{BINARY}]]
[ [ {V}][ {ASCII }]]
;DEN=[density];DISC=[numrec][,numextents][,initialloc]
[{;STD }]
[{;MSG }]
;CODE=[filecode][{;RIO }][{;CIR }] [;ULABEL=numlabels]
[{;NORIO}][{;KSAMXL}]
[{;SPOOL }]
[;KEY={^filereference2}] [;FIRSTREC=recnum] [{;REUSE }]
[ {keyinfo }] [{;NOREUSE}]
[;LANG={langid }]
[ {langname}]
Syntax for access
[ [{IN }]]
[{;NOMULTI}] [ [{OUT }]]
[{;NOCCTL}][{;MULTI }][{;NOMR}][{;WAIT }] [;ACC= [{UPDATE }]]
[{;CCTL }][{;GMULTI }][{;MR }][{:NOWAIT}] [ [{OUTKEEP}]]
[ [{APPEND }]]
[ [{INOUT }]]
[{;EXC }]
[{;BUF=[numbuffers]}][{;LOCK }][{;COPY }] [;FORMS=formsmsg][{;SHR }]
[{;NOBUF }][{;NOLOCK}][{;NOCOPY}] [{;EAR }]
[{;SEMI}]
[{;NOLABEL }]
[{;LABEL=[volid][,[{IBM}][,[expdate][,seq]]]}] [;FORMID=formid]
[{ [ [{ANS}] ]}]
[;PRIVATE]
Syntax for disposition
[{;DEL }]
[{;TEMP }]
[{;SAVE }]
[{;SPSAVE}]
Enhancements
filecode The filecode parameter specifies a particular kind
of file. This code is recorded in the file label
and is available to processes accessing the file
through the FFILEINFO or FGETINFO intrinsics.
Although you can specify a positive integer ranging
from 0 to 32767 or a mnemonic name for filecode,
certain reserved integers and mnemonics have
particular system defined meanings. The native
mode spooler file codes are the following:
------------------------------------------------------------------------------------------
| |
| Integer Mnemonic Meaning |
| |
------------------------------------------------------------------------------------------
| |
| 1515 INSP input spool file |
| |
| 1516 OUTSP output spool file |
| |
| 1517 CHKSP output spool file checkpoint |
| file |
| |
------------------------------------------------------------------------------------------
SPOOL The SPOOL option specifies an output spool file
that is not linked to the spool file directory
(SPFDIR) and, therefore, will not be printed
automatically. No spooling attributes are
initialized. If the output spool file is ever
linked to the SPFDIR by using the SPOOLF...;PRINT
command, all attributes are set at that time
according to the rules of the command. If you
specify ;SPOOL, a file code of 1516 (output spool
file) is forced.
formid The formid parameter applies only to output spool
files. It is a string of up to 8 alphanumeric
characters, beginning with a letter, that uniquely
identifies a special form to mount.refer to chapter
3 for a discussion about formid.
PRIVATE The PRIVATE option generates a spool file that can
be accessed in privileged mode only. Private spool
files may not be saved or copied. They may only be
purged, printed, or (within limits) altered by
using the SPOOLF command. The PURGE and COPY
commands do not work on private spool files. Refer
to the SPOOLF command in this chapter and to
chapter 5 for information about private files.
SPSAVE If you use this parameter, the output spool file is
not purged after the last copy of it has printed.
The OUT.HPSPOOL account retains the spool file.
You cannot use the SPSAVE parameter with a private
spool file.