DELETESPOOLFILE



DELETESPOOLFILE

     Deletes a spoolfile from disk.  (CM)

SYNTAX

                     {#ONNN}
     DELETESPOOLFILE {#INNN}
                     {LDEV }


PARAMETERS

#ONNN               THE IDENTIFICATION OF A READY OR ACTIVE OUTPUT
                    SPOOLFILE.

#INNN               THE IDENTIFICATION OF A READY, INPUT SPOOLED DATA
                    FILE.

LDEV                THE  LOGICAL DEVICE NUMBER ON WHICH THE SPOOLFILE IS
                    ACTIVE.


OPERATION

     BEFORE DELETING AN ACTIVE SPOOLFILE, YOU SHOULD FIRST TAKE
     THE OUTPUT DEVICE OFFLINE.  THIS ALLOWS YOU TIME TO ENTER
     THE COMMAND AND DETERMINE THAT THE ACTIVE SPOOLFILE
     CORRESPONDS TO THE CORRECT OUTPUT DEVICE.  WHEN MPE/iX
     RETURNS THE COLON PROMPT (), YOU KNOW THAT THE
     DELETESPOOLFILE INSTRUCTION HAS BEEN SENT TO THE SPOOLER
     PROCESS.  IT WILL NOT BE EXECUTED, HOWEVER, UNTIL THE OUTPUT
     DEVICE IS PUT BACK ONLINE.

     YOU MAY NOT USE THE DELETESPOOLFILE COMMAND ON THE
     FOLLOWING FILES:

     o SYSTEM-DEFINED STANDARD INPUT SPOOLFILES ($STDIN).
       DELETE THEM WITH THE ABORTJOB COMMAND.

     o ACTIVE SPOOLFILES WITH DATA INPUT, ENTERED VIA THE
       STREAM COMMAND.  YOU MAY DELETE THESE ONLY WHEN THEY ARE
       READY.  YOU MAY ALSO NOT DELETE THESE FILES WHEN THEY ARE
       OPEN.

     DELETESPOOLFILE WILL DELETE ACTIVE DATA INPUT FILES WHICH
     ARE SUBMITTED ON A SPOOLED DEVICE.  IT CANNOT DELETE SUCH
     FILES WHILE THEY ARE BEING STREAMED.

     THIS COMMAND MAY BE ISSUED FROM A SESSION, PROGRAM, OR IN
     BREAK. IT MAY NOT BE ISSUED FROM A JOB.  PRESSING [BREAK] HAS
     NO EFFECT ON THIS COMMAND.  THIS COMMAND MAY BE USED ONLY
     FROM THE CONSOLE UNLESS IT IS DISTRIBUTED TO USERS WITH THE
     ALLOW OR ASSOCIATE COMMANDS.


EXAMPLE(S)

     TO DELETE THE ACTIVE SPOOLFILE BEING PRINTED ON LDEV 6,
     FIRST TAKE THE PRINTER OFFLINE.  THIS GENERATES A NOT READY
     MESSAGE AT THE CONSOLE, AFTER WHICH YOU  MAY ENTER THE
     DELETESPOOLFILE COMMAND, AS SHOWN BELOW

     1121/7/LDEV#6 NOT READY
     DELETESPOOLFILE 6

     WHEN YOU PUT THE DEVICE BACK ONLINE, THE TRAILER PAGE WILL
     BE PRINTED, AND THE FILE DELETED.  IF YOU HAVE SUPPRESSED
     HEADER/TRAILER OUTPUT WITH THE HEADOFF COMMAND, NO TRAILER
     IS PRINTED BEFORE THE SPOOLFILE IS DELETED.  HOWEVER, THE
     PRINTER WILL SKIP TO THE TOP OF THE NEXT PHYSICAL PAGE.  IF
     THE DEVICE IS A PAGE PRINTER, THE DEFAULT ENVIRONMENT IS
     RELOADED.

ADDITIONAL INFORMATION

Commands:   ALTSPOOLFILE