HP 3000 Manuals

Parameters within Syntax (cont..) [ Using Your System The User's Guide ] MPE/iX 5.0 Documentation


Using Your System The User's Guide

Parameters within Syntax (cont..) 

Positional parameters (cont.) 

SPOOLER 

The SPOOLER command enables you to do the following:

   *   Show the status of the spooling process

   *   Enable or disable spooling for a specified logical device, device
       name, or all devices of a device class

   *   Start, stop, suspend, and resume spooler printing processes

   *   Release files from the spooler process

Syntax 

              {ldev    }
SPOOLER [DEV=]{devclass}
              {devname }

Plus one of the following options:

Status option: 

{;SHOW}

Enable/Disable option: 

{;OPENQ}[;SHOW]
{;SHUTQ}
Start option: 

{;START}[;OPENQ][;SHOW]
        [;SHUTQ]
Stop option: 

{;STOP}[;FINISH][;OPENQ][;SHOW]
       [;NOW   ][;SHUTQ]
Suspend option: 

{;SUSPEND}[;KEEP  ][;FINISH][;OPENQ][;SHOW]
          [;NOKEEP][;NOW   ][;SHUTQ]
Resume option: 

{;RESUME}[;OPENQ][;SHOW]
         [;SHUTQ]
Release option: 

{;RELEASE}[;OPENQ][;SHOW]
          [;SHUTQ]
Parameters 

DEV                   Specifies the spooler device in one of the
                      following forms:

                      ldev                  Specifies the logical device
                                            number of the spooled device.

                      devclass              Specifies the device class
                                            name of the spooled devices.
                                            The devclass must begin with
                                            a letter and consist of eight
                                            or fewer alphanumeric
                                            characters.

                      devname               Specifies the device name of
                                            the spooled device.  The
                                            devname must begin with a
                                            letter and consist of eight
                                            or fewer alphanumeric
                                            characters.  A device class
                                            name and a device name cannot
                                            be the same.  If you enter an
                                            alphanumeric character
                                            string, the command searches
                                            the device class list first,
                                            then the device name list.

Status option: 

SHOW                  Displays the status of the spooling process(es)
                      associated with the specified device(s).  This
                      parameter reflects the updated state of the
                      process(es) when the command finishes executing.

Enable/Disable option: 

OPENQ                 Enables spooling for ldev, devclass, or devname.
                      This enables users to generate spool files on the
                      device(s).  This parameter is the default for the
                      START option.

SHUTQ                 Disables spooling for ldev, devclass, or devname.
                      This prevents users from generating spool files on
                      the device(s).  This parameter is the default for
                      the STOP option.

SHOW                  For information about this parameter, refer to SHOW
                      for the STATUS option.

Start option: 

START                 Creates and activates a new spooler process to own
                      and manage the device and print spool files
                      destined for the device.  If a class is specified,
                      a spooling process is created and activated for
                      each device in the class.  If you do not specify
                      either the OPENQ or SHUTQ option, OPENQ is the
                      default.

OPENQ                 For information about this parameter, refer to
                      OPENQ for the Enable/Disable option.

SHUTQ                 For information about this parameter, refer to
                      SHUTQ for the Enable/Disable option.

SHOW                  For information about this parameter, refer to SHOW
                      for the Status option.

Stop option: 

STOP                  Terminates the spooling process associated with the
                      specified device.  If you specify a class, spooling
                      processes terminate for all devices in the
                      specified class.  When you specify this parameter,
                      the following message appears:

                           Output spooler, LDEV #ldev: Stopped.

                      If you do not specify either the FINISH or NOW
                      parameters, NOW is the default.  If you do not
                      specify either the OPENQ or SHUTQ parameter, SHUTQ
                      is the default.

                      Because large amounts of data are buffered in the
                      file system and the device, an output device may
                      continue to print, appearing as though the STOP
                      parameter has not affected printing.  This happens
                      because the spooler stops sending data to the
                      device when the command is received, but must wait
                      until all buffered data has been printed before
                      stopping.  Depending on both the content of the
                      data and the amount of buffering, this may require
                      a significant part of a page or even several pages.

                      If you stop the spooler while it is printing a
                      file, the spooler saves the page number of the last
                      complete page that was printed.  Whenever any
                      spooler subsequently selects the file for printing,
                      output resumes at the page number following the
                      saved page number.

FINISH                Directs the spooler to finish printing the
                      currently active spool file and then stop.

NOW                   Directs the spooler to immediately stop printing
                      the currently active spool file.  This is the
                      default for the STOP option.

OPENQ                 For information about this parameter, refer to
                      OPENQ for the Enable/Disable option.

SHUTQ                 For information about this parameter, refer to
                      SHUTQ for the Enable/Disable option.

SHOW                  For information about this parameter, refer to SHOW
                      for the Status option.

Suspend option: 

SUSPEND               Suspends output to one or more spooled devices so
                      that the spooler devices become inactive.  When you
                      specify this parameter, the following message
                      appears:

                           Output spooler, LDEV #ldev: Suspended.

                      If you do not specify either the FINISH or NOW
                      parameters, NOW is the default.  If you do not
                      specify either the KEEP or NOKEEP parameter, KEEP
                      is the default.

                      Because large amounts of data are buffered in the
                      file system and the device, an output device may
                      continue to print, appearing as though the SUSPEND
                      parameter has not affected printing.  This is
                      because the spooler stops sending data to the
                      device when the command is received, but must wait
                      until all buffered data has been printed before
                      stopping.  Depending on both the content of the
                      data and the amount of buffering, this may require
                      a significant part of a page or even several pages.

                      If you suspend the spooler while it is printing a
                      file and the spooler does not retain the file, the
                      spooler saves the page number of the last complete
                      page that was printed.  Whenever any spooler
                      subsequently selects the file for printing, output
                      resumes at the page number following the saved page
                      number.

KEEP                  Directs the device to retain ownership of the spool
                      file that it is currently processing.  This is the
                      default.  This parameter is valid only under the
                      following conditions:
                         *   The spooler is actively processing a file or
                             is suspending.
                         *   You do not specify the FINISH parameter.

NOKEEP                Directs the spooler to close the spool file that it
                      is currently processing.  This parameter is valid
                      only under the following conditions:
                         *   The spooler is actively processing a file or
                             is suspending.
                         *   You do not specify the FINISH parameter.

                      The spooler does the following when you include the
                      NOKEEP parameter:
                         *   stops sending data after the current record
                         *   ejects a page
                         *   saves the last completely printed page
                         *   prints a trailer with (INCOMPLETE) on it if
                             trailers are enabled
                         *   returns the file to the ready state

                      Whenever any spooler subsequently selects the file
                      for printing, output resumes at the page number
                      following the saved page number.  The file's header
                      and trailer include (RESUMED) if printing starts
                      anywhere other than the first page.

FINISH                For information about this parameter, refer to
                      FINISH for the STOP option.

NOW                   For information about this parameter, refer to NOW
                      for the STOP option.

OPENQ                 For information about this parameter, refer to
                      OPENQ for the Enable/Disable option.

SHUTQ                 For information about this parameter, refer to
                      SHUTQ for the Enable/Disable option.

SHOW                  For information about this parameter, refer to SHOW
                      for the Status option.

Resume option: 

RESUME                Resumes a suspended spooler process.  In order for
                      this parameter to function, the spooler must be in
                      the SUSPEND state.  Output resumes where it was
                      suspended.

OPENQ                 For information about this parameter, refer to
                      OPENQ for the Enable/Disable option.

SHUTQ                 For information about this parameter, refer to
                      SHUTQ for the Enable/Disable option.

SHOW                  For information about this parameter, refer to SHOW
                      for the Status option.

Release option: 

RELEASE               Directs a suspended output spooler to close
                      (release) a currently retained spool file.  The
                      spool file was retained because you previously
                      specified the SUSPEND;KEEP parameters.

                      When the spooler releases the file, the spooler
                      saves the page number of the last complete page
                      that was printed.  Whenever any spooler
                      subsequently selects the file for printing, output
                      resumes at the page number following the saved page
                      number.

OPENQ                 For information about this parameter, refer to
                      OPENQ for the Enable/Disable option.

SHUTQ                 For information about this parameter, refer to
                      SHUTQ for the Enable/Disable option.

SHOW                  For information about this parameter, refer to SHOW
                      for the Status option.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Except for the status option, pressing Break does not
       affect this command.

       You can only enter this command from the console; however, you can
       enter this command from your terminal if your system administrator
       has used the ALLOW command to enable you to enter the command.

       Anyone can use the status option; however, all other options are
       only available to console users or allowed users.

   *   Selective device errors 

       This command affects more than one process if applied to all
       devices in a class.  Consequently, errors can occur for some of
       the devices, but not others.

       For example, class LP consists of LDEVs 6, 11, and 19, and a
       spooler process already owns LDEV 11.  The command SPOOLER
       LP;START would create and activate spooler processes for LDEVs 6
       and 19, but would also generate the message DEVICE 11 IS ALREADY
       SPOOLED.

Example 

   *   To show the status of device name LP, enter:

            :SPOOLER LP;SHOW 

            LDEV   DEV        SPSTATE    QSTATE    OWNERSHIP      SPOOLID

             6     LDEV6      IDLE       OPENED    OUT SPOOLER
            14     LDEV14    *SUSPEND    OPENED    OUT SPOOLER    #0237
            15     LDEV15     ACTIVE     OPENED    OUT SPOOLER    #O264
            19     LDEV19                OPENED    NO  SPOOLER

       The asterisk beside LDEV14 indicates that the SUSPEND state is
       pending.

Related Commands 

     LISTSPF
     OPENQ
     SHOWDEV
     SHUTQ
     SPOOLF

SPOOLF 

The SPOOLF command enables you to alter, print, or delete spool files.

Syntax 

Alter option: 

SPOOLF [IDNAME=]{spoolid               }
                {(spoolid[,spoolid]...)}
        [     {ldev    }]
{;ALTER}[;DEV={devclass}][;PRI=outpri][;COPIES=numcopies]
        [     {devname }]

[;SPSAVE][;DEFER  ][;SHOW]
         [;UNDEFER]

Print option: 

SPOOLF [IDNAME=]{fileset               }
                {(fileset[,fileset]...)}

        [     {ldev    }]
{;PRINT}[;DEV={devclass}][;PRI=outpri][;COPIES=numcopies]
        [     {devname }]

[;SPSAVE][;DEFER  ][;SHOW]
         [;UNDEFER]

Delete option: 

SPOOLF [IDNAME=]{spoolid               } {;DELETE}[;SHOW]
                {(spoolid[,spoolid]...)}
Parameters 

Alter Option: 

IDNAME                Specifies one or more spool file IDs, spoolid, in
                      the form of #Onnn.  The spooling subsystem assigns
                      the IDs when the spool files are created.  The #
                      and the O are optional and are assumed if you do
                      not supply them.  As a shortcut, you can use O@ to
                      specify all output spool files.

                      If you have system manager (SM) or system
                      supervisor (OP) capability, O@ affects all output
                      spool files on the system.  If you have account
                      manager (AM) capability, O@ affects all output
                      spool files created by users in the same account.
                      If you do not have any of these capabilities, you
                      are limited to alter only files that you have
                      created.

ALTER                 Alters the characteristics of specified spool
                      files.  The DEFER, DEV, and SPSAVE parameters
                      affect the ALTER option as follows:

                         *   If you use DEFER or DEV for a spool file
                             currently printing, the spooler process
                             interrupts the printing.  The spooler
                             process saves the page number of the last
                             complete page that was printed.  The next
                             time any spooler selects the file for
                             printing, output resumes at the saved page
                             number.

                         *   Because large amounts of data are buffered
                             in the file system and the device, an output
                             device may continue to print, appearing as
                             though DEFER and DEV have not affected
                             printing.  This is because the spooler stops
                             sending data to the device when the command
                             is received, but must wait until all
                             buffered data has been printed before
                             releasing the spool file.  Depending on both
                             the content of the data and the amount of
                             buffering, this may require a significant
                             part of a page or even several pages.

                         *   You cannot alter the attributes of spool
                             files in the SPSAVE state.

DEV                   Specifies the device, which may have one of the
                      following values:

                      ldev                  Specifies the logical device
                                            number of the spool file's
                                            new destination device.  If
                                            the spool file is in the
                                            print state, it returns to
                                            the ready state.  It can
                                            immediately enter the print
                                            state on ldev if it meets all
                                            requirements.

                                            The system interrupts spool
                                            file printing only if the
                                            newly specified target ldev 
                                            differs from the previous
                                            target ldev.

                      devclass              Specifies the new destination
                                            device class name for the
                                            spool file.  If the spool
                                            file is in the print state,
                                            it returns to the ready
                                            state.  It can immediately
                                            enter the print state on a
                                            device in devclass if it
                                            meets all requirements.

                                            The devclass parameter must
                                            begin with a letter and
                                            consist of eight or fewer
                                            alphanumeric characters.  The
                                            system does not allow the
                                            same name to be configured as
                                            a device class name and a
                                            device name.

                                            The system interrupts spool
                                            file printing only if the
                                            newly specified target
                                            devclass differs from the
                                            previous target devclass.

                      devname               Specifies the device name of
                                            the spool file's new
                                            destination device.  If the
                                            spool file is in the print
                                            state, it returns to the
                                            ready state.  It can
                                            immediately enter the print
                                            state on devname if it meets
                                            all requirements.  This
                                            occurs even if devname is the
                                            same as the device currently
                                            printing the file.

                                            The devclass parameter must
                                            begin with a letter and
                                            consist of eight or fewer
                                            alphanumeric characters.  The
                                            system does not allow the
                                            same name to be configured as
                                            a device class name and a
                                            device name.

                                            The system interrupts spool
                                            file printing only if the
                                            newly specified target
                                            devname differs from the
                                            previous target devname.

PRI                   Specifies the output priority of the designated
                      spool files, where 0 is the lowest priority and 14
                      is the highest priority.  You can specify an outpri 
                      of 14 only from the console or if you have system
                      supervisor (OP) capability; otherwise, the highest
                      priority is 13.

COPIES                Specifies the number of copies, numcopies, of the
                      designated spool files to be printed.  The
                      allowable range is from 1 through 65535.

SPSAVE                Specifies that the selected spool files are not to
                      be deleted after the last copies have printed.
                      Instead, the spool files are retained in the
                      HPSPOOL account in the SPSAVE state until you
                      manually delete them.  You cannot, however, save
                      private spool files.

                      When a file enters the SPSAVE state, the system
                      sets the priority to 8 and the number of copies to
                      1.

DEFER                 Changes the spool file's state to DEFER. If the
                      spool file is currently in the print state, its
                      spooler is notified and printing stops.  The spool
                      file's priority remains unchanged.  If you use this
                      parameter with the PRINT option, the system copies
                      the spool file to OUT.HPSPOOL and links it to the
                      spooling system, but the state of the spool file is
                      DEFER. The spool file does not print until you
                      enter a subsequent SPOOLF...;UNDEFER.

                      If you use the DEFER parameter for any file in the
                      CREATE state (open for original creation), the
                      spool file only enters the DEFER state after it is
                      completed (closed for the last time).

UNDEFER               Changes a spool file's state from DEFER to READY
                      and causes a spooler to start printing the spool
                      file if the spool file is qualified to be printed
                      by an idle printer.  The spool file's priority
                      remains unchanged.

SHOW                  Displays the results of the SPOOLF command.  When
                      you enter a SPOOLF command string, all parameters
                      process before the SHOW parameter.

Print Option: 

IDNAME                Specifies the set of files, fileset, to be printed.
                      This parameter has the following form:

                      filename[/lockword[.groupname[.accountname]]]

                      If the file name or set is not fully qualified, the
                      default is the user's current logon group and
                      account.  In batch mode, if any file in the set has
                      a lockword, you must supply it with the command;
                      therefore, the file cannot be part of a set that
                      contains wildcards.  This restriction does not
                      apply in interactive mode, because the system
                      prompts you for each required lockword.  If you do
                      not provide the correct lockword for either mode,
                      the print option fails for the file and the command
                      continues to process the remaining files.

PRINT                 Copies the specified file sets to the HPSPOOL
                      account and links the new output spool files into
                      the spool queues for printing.  This parameter is
                      especially useful for generating additional copies
                      of a spool file in the SPSAVE state.

                      You must have nonshareable device (ND) capability
                      to use the PRINT option.  You cannot print private
                      files using this option.

DEV                   For information about this parameter, refer to DEV
                      for the ALTER option.

PRI                   For information about this parameter, refer to PRI
                      for the ALTER option.

COPIES                For information about this parameter, refer to
                      COPIES for the ALTER option.

SPSAVE                For information about this parameter, refer to
                      SPSAVE for the ALTER option.

DEFER                 For information about this parameter, refer to
                      DEFER for the ALTER option.

UNDEFER               For information about this parameter, refer to
                      UNDEFER for the ALTER option.

SHOW                  For information about this parameter, refer to SHOW
                      for the ALTER option.

Delete Option: 

IDNAME                For information about this parameter, refer to
                      IDNAME for the Alter option.

DELETE                Purges all specified private or nonprivate spool
                      files that you can access from the system.

                      If a spool file is not in use (opened by a user, or
                      being printed or stored), it is purged immediately.
                      If it is in use, the system places it in the DELPND
                      state.  The printer spooler process is notified,
                      and printing stops at that point.

                      Because large amounts of data are buffered in the
                      file system and the device, an output device may
                      continue to print, appearing as though the DELETE
                      option has not affected printing.  This is because
                      the spooler stops sending data to the device when
                      the command is received, but must wait until all
                      buffered data has been printed before stopping.
                      Depending on both the content of the data and the
                      amount of buffering, this may require a significant
                      part of a page or even several pages.

                      The DELETE option can delete all output spool files
                      in the READY, PRINT, DEFER, SPSAVE, or PROBLM
                      states.  The DELETE option cannot delete $STDIN
                      files.  Use the ABORTJOB command for these files.

SHOW                  Refer to SHOW for the Alter option for information
                      about this parameter.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, or in
       break mode.  Any user can enter this command; however the user's
       capabilities determine which files the user can alter, print, or
       delete.

   *   Altering private spool files 

       With certain limitations, you can alter private spool files.  You
       can only use the PRI, DEFER, UNDEFER, and DELETE parameters.  If
       you have system manager (SM) capability, you can also use the DEV
       parameter.

   *   Problem state spool files 

       You can use the ALTER option on problem state spool files to alter
       the device attribute so that the spool file becomes ready again.
       Generally, the spool file is in the problem state because the
       target device of the spool file is invalid.

Example 

   *   To change the priority of all output spool files to 8 and show the
       results, enter:

            :SPOOLF O@;ALTER;PRI=8;SHOW 

            SPOOLID JOBNUM FILEDES  PRI  COPIES  DEV    STATE  RSPFN  OWNER
            #414    J5     $STDLIST   8       1  16     READY         ALIX.MKT
            #416    J7     HOTSTUFF   8       2  16     READY         JACK.SALES

Related Commands 

     ABORTJOB
     ALTSPOOLFILE
     DELETESPOOLFILE
     LISTFILE
     LISTSPF
     PRINT
     PURGE
     SPOOLER

STORE 

The STORE command enables the system administrator to copy one or more
disk files onto a magnetic tape.  The system volume set(s) for the disk
file(s) must be mounted before using the command.  The administrator can
recover copied files using the RESTORE command.

Syntax 

STORE [[filesetlist][;[storefile][;option[;option[...]]]]]

where option is:

[;SHOW[=showparmlist]] [{;DATE<=accdate}] [;PURGE][;PROGRESS [=minutes]]
                       [{;DATE>=moddate}]

[;DIRECTORY]

Parameters 

filesetlist           Specifies the set of files to be stored.  The
                      default is @ (all files in the logon group)
                      regardless of capabilities.  The form of this
                      parameter is as follows:

                           filesetitem[,filesetitem[...]]

                      where filesetitem can be ^indirectfile or fileset.

                      indirectfile          Consists of a file that
                                            contains the files to be
                                            stored along with STORE
                                            options.  If you specify
                                            options, you can only list
                                            them after the first
                                            semicolon (;) on each line.

                                            An option that you specify on
                                            one line operates on all
                                            files in the indirect file.
                                            For instance, specifying
                                            ...;PURGE...  purges all
                                            files in the indirect file.

                                            If you use the ;DATE option,
                                            you can only specify it on
                                            one line.  If ;DATE appears
                                            on more than one line, the
                                            last occurrence is used and
                                            an error message is
                                            generated.

                      fileset               The set of files to be stored
                                            and, optionally, the files to
                                            be excluded in the form:

                                                 filestostore[-filestoexclude[-filestoexclude[-...]]]

                                            The system stores any file
                                            that matches filestostore 
                                            unless the file also matches
                                            filestoexclude, which
                                            specifies files to be
                                            excluded from tape storage.
                                            The maximum number of
                                            filestoexclude is nine.

                                            Both filestostore and
                                            filestoexclude may be fully
                                            qualified in the form:

                                                 filename[.groupname[.accountname]]

                                            You can specify a
                                            lockword for files to be
                                            stored in the form
                                            filename/lockword.group.account.

                                            You can use the following
                                            wildcard characters to
                                            specify file, group, or
                                            account names.  Each wildcard
                                            character applies toward the
                                            eight-character limit for
                                            group, account, and file
                                            names.

                                            @                     Zero or
                                                                  more
                                                                  alphanumeric
                                                                  characters
                                                                  (8
                                                                  maximum).

                                            #                     One
                                                                  numeric
                                                                  character.

                                            ?                     One
                                                                  alphanumeric
                                                                  character.

                                            [ ]                   A range
                                                                  of
                                                                  characters.

                                            You can use these characters
                                            to specify sets of files:

                                            n@               All files
                                                             beginning
                                                             with the
                                                             character
                                                             "n."

                                            @n               All files
                                                             ending with
                                                             the
                                                             character
                                                             "n."

                                            n@x              All files
                                                             beginning
                                                             with the
                                                             character
                                                             "n" and
                                                             ending with
                                                             the
                                                             character
                                                             "x."

                                            n##...#          All files
                                                             starting
                                                             with the
                                                             character
                                                             "n" followed
                                                             by as many
                                                             digits as
                                                             there are
                                                             "#" marks
                                                             (maximum 7).
                                                             This is
                                                             useful for
                                                             restoring
                                                             all
                                                             EDIT/3000
                                                             temporary
                                                             files
                                                             (K#######).

                                            ?n@              Any file
                                                             whose second
                                                             character is
                                                             "n."

                                            n?               All
                                                             two-character
                                                             files that
                                                             begin with
                                                             the
                                                             character
                                                             "n."

                                            ?n               All
                                                             two-character
                                                             files that
                                                             end with the
                                                             character
                                                             "n."

                                            [A-C]@           All files
                                                             that begin
                                                             with the
                                                             letters "A,"
                                                             "B," or "C."

                                            myset[e-g1]      All files
                                                             that begin
                                                             with the
                                                             name "myset"
                                                             and end in
                                                             "e," "f,"
                                                             "g," or "1."

                                            myset[d-e 1-6]   All files
                                                             that begin
                                                             with the
                                                             name "myset"
                                                             and end in
                                                             "d" or "e,"
                                                             or "1," "2,"
                                                             "3," "4,"
                                                             "5," or "6."

                                            You can enter a file set in
                                            any of the following formats:

                                            file.group.acct       One
                                                                  particular
                                                                  file in
                                                                  one
                                                                  particular
                                                                  group
                                                                  in one
                                                                  particular
                                                                  account.

                                            file.group            One
                                                                  particular
                                                                  file in
                                                                  one
                                                                  particular
                                                                  group
                                                                  in the
                                                                  logon
                                                                  account.

                                            file                  One
                                                                  particular
                                                                  file in
                                                                  the
                                                                  logon
                                                                  group
                                                                  and
                                                                  account.

                                            @.group.acct          All of
                                                                  the
                                                                  files
                                                                  in one
                                                                  particular
                                                                  group
                                                                  in one
                                                                  particular
                                                                  account.

                                            @.group               All of
                                                                  the
                                                                  files
                                                                  in one
                                                                  particular
                                                                  group
                                                                  in the
                                                                  logon
                                                                  account.

                                            @.@.acct              All of
                                                                  the
                                                                  files
                                                                  in all
                                                                  of the
                                                                  groups
                                                                  in one
                                                                  particular
                                                                  account.

                                            @                     All of
                                                                  the
                                                                  files
                                                                  in the
                                                                  logon
                                                                  group
                                                                  and
                                                                  account.
                                                                  This is
                                                                  the
                                                                  default
                                                                  for all
                                                                  users,
                                                                  regardless
                                                                  of
                                                                  capabilities.

                                            @.@                   All of
                                                                  the
                                                                  files
                                                                  in all
                                                                  of the
                                                                  groups
                                                                  in the
                                                                  logon
                                                                  account.

                                            @.@.@                 All of
                                                                  the
                                                                  files
                                                                  in the
                                                                  system.

                                            thisisit.  @.acct     Any
                                                                  file
                                                                  named
                                                                  thisisit
                                                                  in all
                                                                  of the
                                                                  groups
                                                                  in one
                                                                  particular
                                                                  account.

storefile             Specifies the name of the destination tape file to
                      which the stored files are to be written.  The
                      destination tape can be any magnetic tape from the
                      output set.

                      You must backreference this file using an asterisk
                      (*).  You can do this by first creating a file
                      equation before entering the STORE command.  For
                      instance, if you want to store files to a file
                      called DEST, you would enter the following file
                      equation before attempting the store operation:

                           :FILE DEST;DEV=TAPE 

                      A message appears on the console requesting the
                      tape identified by the storefile parameter to be
                      mounted and to allocate the device.

                      If you do not specify storefile, the STORE command
                      creates a default file name, which is your logon
                      username.  No file equation is used.

SHOW                  Instructs the STORE command to report information
                      for every stored file.  If you omit this parameter,
                      then only the names of the files not stored are
                      listed, along with the number of files stored and
                      the number of files not stored.  The listing goes
                      to $STDLIST (formal file designator SYSLIST) unless
                      you have used the FILE command to direct the
                      listing to another device.  For instance:

                           :FILE SYSLIST;DEV=LP 

                      sends the listing to the line printer if you enter
                      the file equation before you enter the STORE
                      command.

                      The format for the value showparmlist is:

                           showparm [,showparm[,showparm[,...]]]

                      where showparm can be one of the following:

                      SHORT                 Overrides a default of LONG
                                            and displays the file name,
                                            group name, account name,
                                            volume restrictions, file
                                            size (in sectors), file code
                                            (mnemonic if available), and
                                            reel number.

                      LONG                  Overrides a default of SHORT
                                            and displays all of the SHORT
                                            information plus the record
                                            size, blocking factor,
                                            maximum number of extents
                                            allowed, end-of-file, and
                                            file record limit.

                      DATES                 Displays the creation date,
                                            the last date of access, and
                                            the last date of
                                            modification.

                      SECURITY              Displays the file creator and
                                            the security matrix.

                      OFFLINE               Sends an additional copy to
                                            the device OFFLINE, which
                                            defaults to device LP.

                      If you specify the SHOW parameter and you omit the
                      value showparmlist, then the default is SHORT if
                      the recordsize of SYSLIST is less than 118
                      characters (114 in compatibility mode) or LONG if
                      the recordsize is equal to or greater than 118 (114
                      in compatibility mode).

DATE                  Instructs STORE to store only selected files.  An
                      accdate value limits storage to files accessed on
                      or before a particular date.  A moddate value
                      limits storage to files modified on or after a
                      particular date.

                      You express the date in the form mm/dd/yy[yy].  You
                      can express the year in two or four digits (91 or
                      1991, for example).

                      You cannot use this option for files attached to a
                      log set.

PURGE                 Instructs MPE/iX to purge all successfully stored
                      files after the store operation ends.  In an
                      interactive session, MPE/iX prompts you to enter
                      any omitted lockwords if you do not have system
                      manager (SM), account manager (AM), or system
                      supervisor (OP) capabilities.  In a job, if you do
                      not have SM, AM, or OP capability, you must provide
                      the lockword.  You can only purge a file with a
                      negative file code if you have privileged mode
                      (PM), system supervisor (OP), or system manager
                      (SM) capability.  If you cannot purge a file, an
                      error message appears indicating that the file was
                      not purged.

PROGRESS              Instructs the STORE command to report its progress
                      at regular intervals by displaying the message
                      STORE OPERATION IS nnn% COMPLETE. For interactive
                      usage, this message appears on $STDLIST. For jobs,
                      this message is sent to the console.

                      The minutes value is a positive number specifying
                      the number of minutes between progress messages.
                      The maximum is 60.  The default is 1 minute.

DIRECTORY             Instructs STORE to store the file system directory.
                      This option requires system manager (SM) or system
                      supervisor (OP) capability.

Operation Notes 

   *   Usage 

       You can enter this command from a session, a job, a program, but
       not in break mode.  Pressing Break suspends the execution of this
       command.

       Privileged mode (PM) capability is required to store files that
       have negative file codes.

       To store a file's access control definition (ACD), you must either
       have RACD capability for the file, be the file creator, have
       account manager (AM) capability for the account that the file is
       in, or have system manager (SM) capability.

   *   Using STORE with RUN 

       You can enter the STORE command with the RUN command (RUN
       STORE.PUB.SYS, for example).  You can use the INFO= parameter of
       the RUN command to specify the STORE option, filesets, and
       keywords.  If you do not specify any INFO= parameters, the STORE:
       prompt appears.  Acceptable responses are a complete STORE
       command, a complete RESTORE command, or a complete VSTORE command.

Examples 

   *   To store all files in the group GP4X in your logon account to a
       tape file named BACKUP, enter:

            :FILE BACKUP;DEV=TAPE 
            :STORE @.GP4X;*BACKUP;SHOW 

       The console receives a request to mount the tape identified as
       BACKUP. A listing of the files stored appears on your standard
       list device.

   *   To store all files on the system except the files in the SYS
       account, enter:

            :FILE TAP;DEV=TAPE 
            :STORE @.@.@-@.@.SYS;*TAP;SHOW=SECURITY,DATES& 
            :,LONG,OFFLINE 

       The console receives a request to mount the tape identified as
       TAP. A listing of the files stored appears on both standard list
       and at the system line printer.  The listing includes all
       information available from STORE.

   *   To store from the indirect file INDFILE, which contains the
       following

            FILE1,FILE2;SHOW
            FILE3,@.PUB.SYS;DATE>=9/1/91

       enter:

            :FILE T;DEV=TAPE 
            :STORE ^INDFILE;*T 

       The console receives a request to mount the tape identified as T.
       Files FILE1, FILE2, FILE3, and all files in PUB.SYS are stored if
       they have been modified since September 1, 1991.  A listing of the
       stored files appears on your standard list device.

   *   To store all files from a group and account with a default
       storefile, enter:

            :STORE @.GROUP.ACCOUNT 

       or

            :STORE 

       Note that the console receives a request to mount the tape
       identified as your user name.

   *   To store files from a group and account, then purge them after the
       store process, enter:

            :FILE T;DEV=TAPE 
            :STORE @.GROUP.ACCOUNT;PURGE 

Related Commands 

     LISTFILE
     RECALL
     REPLY
     RESTORE
     VSTORE



MPE/iX 5.0 Documentation