HPlogo Native Mode Spooler Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 4 Commands Reference

FILE

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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

               ,filedomain]

   [;DEV=[ [envname]#][device][,outpri][,numcopies] ]

   [;VTERM][;ENV=envfile[:nodespec]]

   [;option][;access][;disposition]

Syntax for option

   ;REC=[recsize][,[blockfactor][,{F

                                U

                                V}][,{BINARY 

                                      ASCII }]]

   ;DEN=[density];DISC=[numrec][,numextents][,initialloc]

   ;CODE=[filecode][{;RIO   

                     ;NORIO}][{;STD 

                               ;MSG  

                               ;CIR

                               ;KSAMXL

                               ;SPOOL }]

   [;ULABEL=numlabels] [;KEY={^filereference2

                              keyinfo        }]

   [;FIRSTREC=recnum] [{;REUSE

                        ;NOREUSE}]

   [;LANG={langid

           langname}]

Syntax for access

   [{;NOCCTL                              

     ;CCTL  }][{;NOMULTI                              

                ;MULTI

                ;GMULTI }][{;NOMR

                            ;MR  }][{;WAIT

                                     :NOWAIT}]

   [;ACC= [{IN      

            OUT     

            UPDATE  

            OUTKEEP 

            APPEND  

            INOUT  }]]

   [{;BUF=[numbuffers]

     ;NOBUF           }]  [{;LOCK

                            ;NOLOCK}]  [{;COPY

                                         ;NOCOPY}] 

   [;FORMS=formsmsg][{;EXC 

                      ;SHR

                      ;EAR

                      ;SEMI}] 

   [{;NOLABEL

     ;LABEL=[volid][,[{IBM

                      ANS}][,[expdate][,seq]]]}]

   [;FORMID=formid][;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:

IntegerMnemonicMeaning
1515INSPinput spool file
1516OUTSPoutput spool file
1517CHKSPoutput 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 2 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 1 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.

Feedback to webmaster