Commands SHOWLOG thru STORE

ALTLOG, CHANGELOG, GETLOG, LISTLOG, LOG, OPENLOG, RELLOG, RESUMELOG, SHOWLOGSTATUS, SWITCHLOG

Performing System Operation Tasks

System Startup, Configuration, and Shutdown Reference Manual

Displays status of the user logging file associated with the logging identifier, logid, created by the GETLOG command. Default is that the status of all logging identifiers is displayed.

MEANING

The name of the logging process.

Whether the CHANGELOG command is permitted (whether the name of the first logging file ends in 001).

Whether an automatic CHANGELOG has been enabled (whether the AUTO parameter has been specified through the ALTLOG or GETLOG command).

The number of users accessing the logging file.

ACTIVE, INACTIVE, INITIALIZING, or RECOVERING. INACTIVE is displayed when a process is waiting for information from user processes that involve intrinsics. INITIALIZING starts the log process. RECOVERING is displayed immediately after a START RECOVERY is issued.

The number of records in the log file.

The maximum number of records permitted.

The percentage of the maximum used.

The current file number in the set.

ALTLOG, CHANGELOG, GETLOG, LISTLOG, LOG, OPENLOG, RELLOG, RESUMELOG, SHOWLOG, SWITCHLOG

Performing System Operation Tasks

System Startup, Configuration, and Shutdown Reference Manual

MEANING

This is the session number. It may also be a job number.

An (IN PROGRAM), (IN BREAK), or (NOT IN BREAK) message to indicate whether SHOWME was executed programmatically, in BREAK, or directly from the MPE/iX command interpreter.

The RELEASE: V.UU.FF number is determined by Hewlett-Packard at build time of the operating system and provides an identity for software releases (also known as the MIT). This number cannot be changed. (Prior to MPE/iX release A.11.70, this was referred to as BASE.

The USER VERSION: V.UU.FF can be given a value during a SYSGEN and allows you to identify any changes to your total software package such as patch level, third party software, or other specifics. Any ASCII character can be used. In prior releases, this number was printed out immediately after the MPE/iX product number HP31900.

The PRODUCT V.UU.FF immediately follows the product number HP31900. It is determined by Hewlett-Packard when a new version of the MPE/iX operating system is compiled. This V.UU.FF number cannot be changed and is used when entering a service request (SR) against the MPE/iX operating system product for that particular release.

Shows the current time and date.

Shows the logon time.

Shows the central processor time (CPU) used by this job/session.

The amount of time the job/session has been connected.

The logical device number of the job or session's standard input device.

The standard list device number.

HELLO, JOB, SHOWJOB

None

Identifies a particular output device file for which you want information. The information is displayed in Type I format, which is described in the "Operation Notes" section of this command. The default is to display status information for all output device files used by the logon job or session.

The number of the device file identifier is identical to the LDEV number of the device. For example, if the LDEV number is 20, the device file identifier appears in the DFID column as #20.

Summarizes the status information for all current output device files. The information is displayed in Type II format, described in the "Operation Notes" section. The default is to display status information for all output device files used by the logon job or session.

Displays the status information for currently spooled output device files associated with the logon job or session. The information is displayed in a combination of two formats, Type I format followed by Type II format, which is described in the "Operation Notes" section. The default is to display status information for all output device files used by the logon job or session.

Displays the status of all current output device files as identified. If information for only one device file is displayed, the output appears in Type I format. If information for more than one device file is displayed, the output appears in Type I format followed by Type II format. The syntax for item follows:

Displays the status of output device files. The ldev parameter displays the files residing on the device identified by the logical device number. The classname parameter displays the status of the output device files residing on all devices in a class name.

Displays the status of output device files using one of the following options:

Displays status of all output files in the specified state. An ACTIVE file is one that is currently being produced on your printer or plotter. Only one output spoolfile can be ACTIVE at any one time. OPENED files are those being accessed by a program. A spoolfile will be OPENED when a spooler process is writing the file to disk; during that time, however, the file is not ready to be printed. READY files are completely spooled and ready to be output. A LOCKED file is READY but cannot be accessed until the system relinquishes its exclusive use of the file.

READY files may include one of the following:

MEANING

Logical device number or device class name of the device.

Device file identification, which begins with the letter O (not zero) followed by a number. The numeric portion of the DFID is identical to the LDEV number of the device.

The job/session number (jsnum) of job or session using the device file.

File name assigned to device file.

The status, indicated by one of the following subparameters:

The forms message indicator (the letter F) appears only if a forms alignment message applies to this device file.

The approximate disk space currently being used, expressed in sectors. This applies only to spooled output device files.

The ranking of the file and its order in the system with respect to other files of the same output priority and classname or ldev. A time stamp activated by the FCLOSE intrinsic determines the file's rank.

The letter D following RANK indicates a deferred file. This applies only to spooled device files. A file can be deferred if its priority is less than or equal to system outfence or to the outfence of a specific device.

The output priority requested by a user or as adjusted by the system operator for spooled device files only. A priority of 1 is lowest, and 13 is highest.

Number of copies needed, for spooled device files only.

The output may appear in two possible formats or in a combination of the two formats:

SHOWIN, LISTSPF

Performing System Operation Tasks

The process that you want to see.

The pinspec, expressed [#p ]pin, is a Process Identification Number (PIN). Specifying pinspec is optional and has no default; see jobspec.

An ordinary user may show processes matching their own user and account names (those which "belong to" the user) by specifying 0 as the pinspec. A user with SM or OP capabilities may show any process on the system. A user with SM capability (the system manager) may see system processes by specifying the SYSTEM option.

NOTREE is the default for all pinspec target processes, and can be overridden with the TREE option.

The USER and ANYUSER options do not apply to pinspec.

The name of the job or session whose processes you want to display. A jobspec can be any of the following: jobnumber, username, @S, @J, or @. A jobspec is optional and defaults to the user's current job ID, for example, #!HPJOBTYPE!HPJOBNUM.

The jobnumber must be in the form #Jnnn or #Snnn. SM or OP capability is required to specify another user's job or session number. The username must be in the form user[.account]. SM or OP capability is required to specify another user's username. If there is more than one job or session under the same username, all are displayed.

You can use wildcards; they have the following meanings:

An ordinary user can only see their own processes, even when jobspec is wildcarded. For example, if the user name is JEFF.MFG and you enter the command as shown below, then only processes for jobs logged on as JEFF.MFG are displayed.

  :SHOWPROC job=@J

On the other hand, if the user STEVE.UI (who has OP or SM capability) enters the command shown below, then all processes for all jobs on the system are displayed.

  :SHOWPROC job=@J

If the user STEVE.UI only wants to see his own job processes, he must enter:

  :SHOWPROC job=@J; user

The USER option, and its counterpart option, ANYUSER, are described below.

The SYSTEM option is ignored for all jobspec target processes.

TREE is the default for all jobspec target processes, and can be overridden with the NOTREE option.

This format displays a subset of a process' attributes. These include the subqueue name, process priority, CPU time, execution state, associated JOB or SESSION number, PIN (indented to show tree structure), program name, and INFO=string, if any (or command step if the process is CI.PUB.SYS). The INFO=string and command step information is only visible to the system manager and to processes that belong to the user. SUMMARY is the default format.

This format displays a more comprehensive set of the attributes associated with a process.

This option displays each process specified, as well as all of its descendents. TREE is the default for all jobspec target processes.

This option displays only the process specified. No information appears for the process's descendants. NOTREE is the default for all pinspec target processes.

The SYSTEM option is required if the target process from pinspec is a system process. It displays system processes as well as descendant user processes. SM capability is required. SYSTEM is ignored for all jobspec processes.

The USER option filters output when jobspec is wildcarded by displaying only processes matching the user's name. USER is the default for users without OP and SM capability.

This option defeats the filtering of the wildcarded jobspec and displays all matching processes. SM or OP capability is necessary to specify ANYUSER, and users with these capabilities get ANYUSER by default. OP or SM users may reduce the SHOWPROC output to just their own processes by using the USER option.

The TRUNC option truncates output records that would exceed the record width of $STDLIST for the user. A $ replaces the last character of the line to signify truncation. TRUNC is the default option.

This option displays output records in their full form. As a result, output from the command may wrap around the display.

CPUTIME is consumed in hh:mm:ss or m:ss.mls. A pair of asterisks (**) appears in the hours field when hours overflows. The three-character "mls" sub-field holds milliseconds.

The job or session number for the process.

The job/session, user, and account name associated with this process.

Process Identification Number for the process' parent (decimal). This field is unique to the DETAIL format. The DETAIL format displays PARENT so that process relationships can be determined. A zero indicates that the process does not have a parent (for example, PROGEN).

Process Identification Number for the process (decimal). The SUMMARY format indents the PIN column by two spaces for each child process so that you can clearly see a process' descendants. The DETAIL format precedes the pin with a percent sign (%) to indicate that the process is an artificial member of its workgroup, and does not indent the display.

The priority at which the process is currently executing. A lower numeric value indicates a higher priority. It also indicates whether the process is linear, runs with fixed priority (L), or is decayable (D). This field is unique to the DETAIL format.

The file name of the program the process is executing.

The scheduling queue attribute associated with this process. The QUEUE field is unique to the DETAIL format.

A combination of SUBQUEUE and PRIORITY which appears as Qnnn[*]. Q is a single character abbreviation of the process' scheduling queue attribute. The nnn is the process' priority, and * indicates that this process is a system process. The QPRI field is unique to the SUMMARY format.

The execution state of the process, which can be one of the following:

The command that the displayed CI process is currently executing. This field is not shown for non-CI processes.

The workgroup of which the process is a member. WORKGROUP appears as [%]name, where % indicates that the process is an artificial member of the workgroup, and name is the workgroup name. A process becomes an artificial member when it is explicitly placed into the workgroup via ALTPROC or AIFPROCPUT instead of naturally meeting the membership criteria of the workgroup.

TUNE, ALTPROC, SHOWQ, NEWWG, ALTWG, PURGEWG, SHOWWG

MPE/iX Intrinsics Reference Manual

Displays only the processes currently running or those about to run. This is the right-hand portion of the display. The STATUS lines are printed last.

Reduces the output from SHOWQ to the final status lines of display (base and limit priorities, quantum bounds).

TUNE, ALTPROC, SHOWPROC, NEWWG, ALTWG, PURGEWG, SHOWWG

MPE/iX Intrinsics Reference Manual

Performing System Management Tasks

SETCLOCK, SHOWCLOCK

None

The name of the variable for which the current value is to be displayed.

The job or session number who's variables are to be displayed. Example: #J123 or S4321. SM capability is required to see the variables from another job or session. Only user-defined variables are visible when "jobID" is specified. It is recommended to always specify the USER option when using JOB=. This adds clarity to scripts and job streams, and preserves their functionality should JOB= be enhanced to display predefined variables.

Selects only the user-defined variables matching each varid. USER is the default when varid is omitted. It is recommended to use USER in conjunction with JOB=, see the note above.

Selects only the predefined HP variables matching each varid.

Allows all variables matching varid to be seen. ANY is the default when one or more varids are supplied, as long as jobid is not specified>

Specifies zero or more alphanumeric characters, or the underbar character (_). Used by itself, it specifies all possible combinations of such characters. Used with other characters it indicates all the possible names that include the specified characters (@ABC@ = all names that include ABC anywhere in the name).

Specifies one numeric character. A###@ = all names that begin with A followed by any three digits, followed by any combination of zero to three alphanumeric (or underbar) characters.

Specifies one alphanumeric character. A?# = all three-character names that begin with A, followed by an alphanumeric character, followed by a digit.

Specifies a set or range of characters. The set may appear anywhere in the name. This range specification is not case sensitive and, therefore, [A-K] is the same as [a-k]. If you specify a null set such as [k-a], then MPE/iX gives you a warning that this specification is invalid.

All names containing a, b, or c and ending in a single digit.

All names that begin with any one of the letters a through k.

Not valid in variables and would be flagged as an error.

DELETEVAR, INPUT, ECHO, SETVAR, SHOWJCW

Appendix A, "Predefined Variables in MPE/iX"

Using the HP 3000 Series 900: Advanced Skills

=LOGOFF

System Startup, Configuration, and Shutdown Reference Manual

The logical device number of the device.

The device class name of the devices.

The device name of the device. Note that it is not possible to have a device class name and a device name that are the same. If you enter an alphanumeric character string, the command searches the device class list first, and then the device name list.

The SHOW parameter displays the current queue state (enabled or unenabled) of the devices specified with the SHUTQ command.

The @ parameter globally disables all currently open spooling queues without closing the spooling queues. Thus when the spooling queues are globally reenabled with the OPENQ @ command, all spooling queues that were opened before being globally disabled will again be open.

Refer to the Native Mode Spooler Reference Manual (32650-90166) for more discussion on enabling and disabling of spooling queues.

Use the @ option without any other parameter. The SHOW option entered with the @ option returns an error.

OPENQ, STARTSPOOL, SPOOLER

Native Mode Spooler Reference Manual

Performing System Operation Tasks

The new input speed in characters-per-second (CPS). The input and output speeds must always be equal. Acceptable values for newinspeed and newoutspeed are 30, 120, 240, 480, 960, and 1920.

The new output speed in characters-per-second (CPS). The input and output speeds must always be equal. Acceptable values for newinspeed and newoutspeed are 30, 120, 240, 480, 960, and 1920.

Used with the SET command to specify both input and output speeds, which are equal. Refer to the SET command.

SET

MPE/iX Intrinsics Reference Manual

Actual file designator of the input file from which the source program is read. This can be any ASCII input file. The formal file designator is SPLTEXT. Default is $STDIN.

Actual file designator of the user subprogram library (USL) file to which the object code is written. This can be any binary output file created with a file code of USL or 1024. Its formal file designator is SPLUSL. If the uslfile parameter is omitted, the object code is saved to the temporary file $OLDPASS. If the uslfile parameter is entered, it indicates that the file was created in one of four ways:

Actual file designator of the file to which the program listing is written. This can be any ASCII output file. The formal file designator is SPLLIST. Default is $STDLIST.

Actual file designator of the master file with which textfile is merged to produce a composite source. This can be any ASCII input file. The formal file designator is SPLMAST. Default is that the master file is not read; input is read from textfile, or from $STDIN if textfile is not specified.

Actual file designator of the file created by merging textfile and masterfile. This can be any ASCII output file. Formal designator is SPLNEW. Default is that no file is written.

	NOTE: The formal file designators used in this command (SPLTEXT, SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list. For further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE command.

A sequence of ASCII characters bounded by a pair of single quotation marks (apostrophes) or by double quotations marks. If you want a quotation to appear within quotedstring, the quotation and its quotation marks must also be bounded by quotation marks. For example, to insert "and" into a quotedstring, it must appear as ""and"". Similarly, 'and' must appear as ""and"". The maximum length of the string, including delimiters, is 255 characters. Refer to "Operation Notes."

For SPL to recognize quotedstring, a dollar sign ($) must follow the quotation marks at the beginning of the quotedstring. This feature is used to specify compiler options which appear at the beginning of the source listing. For more information, refer to the Systems Programming Language Reference Manual (30000-90024).

SPLGO, SPLPREP, PREP, RUN

Systems Programming Language Reference Manual

Actual file designator of the input file from which the source program is read. This can be any ASCII input file. The formal file designator is SPLTEXT. Default is $STDIN.

Actual file designator of the file to which the program listing is written. This can be any ASCII output file. The formal file designator is SPLLIST. Default is $STDLIST.

Actual file designator of the master file that is merged against textfile to produce a composite source. This can be any ASCII input file. Formal file designator is SPLMAST. Default is that the master file is not read; input is read from textfile, or from $STDIN if textfile is not specified. If two files being merged have identical line numbers, the lines from textfile or from $STDIN overwrite those in masterfile.

Actual file designator of the file produced by merging textfile and masterfile. This can be any ASCII output file. The formal file designator is SPLNEW. Default is that no file is written.

	NOTE: The formal file designators used in this command (SPLTEXT, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list. For further information, refer to the "Implicit FILE Commands for Subsystems" discussion of the FILE command.

A sequence of ASCII characters bounded by a pair of single quotation marks (apostrophes) or by double quotation marks. If you want a quotation to appear within quotedstring, the quotation and its quotation marks must also be bounded by quotation marks. For example, to insert "and" into a quotedstring, it must appear as ""and"". Similarly, 'and' must appear as ''and''. The maximum length of the string, including delimiters, is 255 characters.

For SPL to recognize quotedstring, a dollar sign ($) must follow the quotation marks at the beginning of the quotedstring. This feature is used to specify compiler options that appear in front of the source listing.

SPL, SPLPREP, PREP, RUN

MPE Segmenter Reference Manual

Systems Programming Language Reference Manual

Actual file designator of the input file from which the source program is read. This can be any ASCII input file. Formal file designator is SPLTEXT. Default is $STDIN.

Actual file designator of the program file to which the prepared program segments are written. When you omit progfile, the MPE segmenter creates the program file, which then resides in the temporary file domain as $OLDPASS. If you do create your own program file, you must do so in one of two ways:

Actual file designator of the file to which program listing is written. This can be any ASCII output file. Formal designator is SPLLIST. Default is $STDLIST.

Actual file designator of the master file that is merged against textfile to produce a composite source. This can be any ASCII input file. The formal file designator is SPLMAST. Default is that the master file is not read; input is read from textfile, or from $STDIN if textfile is not specified. If two files being merged have identical line numbers, the lines from textfile or from $STDIN overwrites those in masterfile.

Actual file designator of the file produced by merging textfile and masterfile. This can be any ASCII output file. The formal file designator is SPLNEW. Default is that no file is written.

	NOTE: The formal file designators used in this command (SPLTEXT, SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced as actual file designators in the command parameter list. For further information refer to the "Implicit FILE Commands for Subsystems" section of the FILE command.

A sequence of ASCII characters bounded by a pair of single quotation marks (apostrophes) or by double quotation marks. If you want a quotation to appear within quotedstring, the quotation and its quotation marks must also be bounded by quotation marks. For example, to insert "and" into a quotedstring, it must appear as ""and"". Similarly, 'and' must appear as ''and''. The maximum length of the string, including delimiters, is 255 characters. Refer to "Operation Notes."

For SPL to recognize quotedstring, a dollar sign ($) must follow the quotation marks at the beginning of the quotedstring. This feature is used to specify compiler options which appear at the beginning of the source listing.

SPL, SPLGO, PREP, RUN

MPE Segmenter Reference Manual

System Programming Language Reference Manual

The logical device number of the spooled device.

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

The device name of the spooled device. devname must begin with a letter and consist of eight or fewer alphanumeric characters. Note that it is not possible to have a device class name and a device name that are the same. If you enter an alphanumeric character string, the command searches the device class list first, and then the device name list.

OUTPUT SPOOLERS:

The START parameter creates and activates a new spooler process to own and manage the device and print spool files destined for it. If a class is specified, then a spooling process is created and activated for each device in the class. If neither the OPENQ nor the SHUTQ option is specified, OPENQ is taken as the default.

INPUT SPOOLERS:

The START parameter creates and activates a new spooler process to own and manage the device, to read data from it, and to create job or data input spool files for later processing by a CI (job) or user process (data). If a class is specified, then a spooling process is created and activated for each device in the class.

OUTPUT SPOOLERS:

The STOP parameter terminates the spooling process associated with the specified device. If a class is specified, then spooling processes for all devices in the specified class are terminated. A spooler in the active state first moves to the STOP pending state (shown as *STOP with the SHOW option) while it finishes its work on its current file (including any required trailer). When this is complete, or if the spooler was previously in the idle state, the spooler displays the following on the console (or the $STDLIST of an associated user) and terminates. If neither the OPENQ nor the SHUTQ option is specified, SHUTQ is taken as the default.

Output spooler, LDEV #ldev: Stopped.

You may determine the spooler state at any time by entering the following:

SPOOLER ldev;SHOW

or

SPOOLER devclass;SHOW

or

SPOOLER devname;SHOW

The STOP option is valid only if a spooler is in the ACTIVE, SUSPEND or IDLE state, or (if accelerating a previous STOP ;FINISH to STOP ;NOW) the STOP pending (*STOP) state. If neither the NOW nor the FINISH option is specified, NOW is taken as the default.

	NOTE: Because of the large amount of data buffered in the file system and the device, an output device may continue to print, making it appear as if the STOP parameter has not had any effect. In reality, 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 spooler process notifies you via the following message that it has processed the command: IOutput spooler, LDEV ldev: Received a command while outputting a file If the STOP is received while the spooler is printing a file, the page number of the last complete page that was printed is saved in the spool file's file label extension (FLABX). The next time the file is selected for printing by any spooler, the output resumes at the page following the page number saved in the FLABX.

INPUT SPOOLERS:

The STOP parameter terminates the spooling process associated with the specified device. If a class is specified, then spooling processes for all devices in the specified class are terminated. The spooler first moves to the STOP pending state (shown as *STOP with the SHOW option) while it finishes its work on its current file (closing and deleting it; rewinding the tape and placing it offline). When this is complete, the spooler displays the following message on the console (or the $STDLIST of an associated user) and terminates:

Input spooler, LDEV #ldev: Stopped.

You may determine the spooler state at any time by entering the following:

SPOOLER ldev;SHOW

The STOP option is valid only if a spooler is in the IDLE or ACTIVE state. Except for a short period during startup when it is in the START state, an input spooler is always in the IDLE or ACTIVE state.

The NOW, FINISH, OPENQ, and SHUTQ options are not applicable to an input spooler process and result in an error message if any is used.

The SUSPEND option is valid only for output spooler processes. It suspends output to one or more spooled devices. The associated spooler processes remain alive, but inactive. A spooler in the ACTIVE state first moves to the SUSPEND pending state (shown as *SUSPEND with the SHOW option) while it finishes its work on its current file (including any required trailer). When this is complete, or if the spooler was previously in the IDLE state, the spooler displays the following on the console (or the $STDLIST of an associated user) and enters the SUSPEND state.

Output spooler, LDEV #ldev: Suspended.

If neither the NOW nor the FINISH option is specified, NOW is taken as the default. If neither the KEEP nor the NOKEEP option is specified, KEEP is taken as the default. If the OFFSET option is not specified, the spooler retains the present location in the output spool file. This is the default.

The combination of the NOW, KEEP, and no OFFSET parameters (all defaults) is a special case. When an active spooler receives this form of the SUSPEND option, it suspends after processing the current record. A subsequent SPOOLER...; RESUME with no OFFSET parameter and without an intervening SPOOLER...;RELEASE causes the spooler to resume at the next record, as if it had never been interrupted.

If a spooler process is suspended in the middle of a spool file and the file is not retained by the spooler, a page number is saved in the spool file's file label extension (FLABX). This page number is either the last complete page that was printed (if no OFFSET was specified) or one page prior to that specified by the final OFFSET applied to the file (with a lower limit of 0). The next time the file is selected for printing by any spooler, output resumes at the page following the page saved in the FLABX.

	NOTE: Because of the large amount of data buffered in the file system and the device, the device may continue to print, making it appear as if the SUSPEND parameter has not had any effect. In reality, the spooler stops sending data to the device when the command is received but must wait until all buffered data has been printed before suspending. 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 spooler process notifies you via the following message that it has processed the command: IOutput spooler, LDEV ldev: Received a command while outputting a file

If a spooler process is suspended in the middle of a spool file and the file is not retained by the spooler, a page number is saved in the spool file's file label extension (FLABX). This page number is either the last complete page that was printed (if no OFFSET was specified) or one page prior to that specified by the final OFFSET applied to the file (with a lower limit of 0). The next time the file is selected for printing by any spooler, output resumes at the page following the page saved in the FLABX.

The RESUME option resumes a suspended spooler process and is therefore valid only for output spoolers. The spooler must be in the SUSPEND state. If the spooler retains a spool file when it is suspended (meaning the KEEP option was specified or taken by default), and the spool file is not subsequently released, the OFFSET option is valid. If no offset is specified with either the earlier SUSPEND or the present RESUME, then output resumes where it left off. If an OFFSET is specified at either time (or both), the spooler resumes at the final location indicated by the offsets. If OFFSET is specified and the spooler does not have a retained file, a warning is generated and the spooler prints the next available spool file from the beginning.

The RELEASE parameter directs a suspended output spooler to close (release) a spool file that it is currently retaining due to an earlier SUSPEND ;KEEP option. It is invalid and generates a warning if used in any other context. The OFFSET option may be used to change the resumption point of the file the next time it is selected for printing.

When the file is released by the spooler, a page number is saved in the spool file's file label extension (FLABX). This page number is either the last complete page that was printed (if no OFFSET was specified) or one page prior to that specified by the final OFFSET applied to the file (with a lower limit of 0). The next time the file is selected for printing by any spooler, output resumes at the page following the page saved in the FLABX.

Directs the spooler to complete the currently active spool file and then suspend or stop. This option may be used only in conjunction with the SUSPEND or STOP options. If it is used in any other context, a warning is issued and the FINISH option is ignored. The FINISH parameter may not be used with either the KEEP/NOKEEP or OFFSET parameters.

The FINISH option is not valid for spooled input devices.

Either a STOP or SUSPEND that includes the FINISH option may be accelerated to a higher-priority command without waiting for the present spool file to finish printing. For example, SPOOLER...; SUSPEND; FINISH may be followed by:

SPOOLER...;SUSPEND;NOW

or

SPOOLER...;STOP;FINISH

or

SPOOLER...;STOP;NOW

Similarly, a SPOOLER...;STOP;FINISH may be accelerated to SPOOLER...;STOP;NOW. To go in the opposite direction is an error.

Directs the spooler to immediately stop the current output. This option may be used only in conjunction with the SUSPEND or STOP options. If it is used in any other context, a warning is issued. This is the default.

If NOW is used on the SUSPEND option with either the NOKEEP or OFFSET parameters, the spooler prints a trailer if required; otherwise output pauses and may be resumed later at the point of suspension.

The NOW option is not valid for spooled input devices.

Directs the device to retain ownership of the spool file that it is currently processing. This is the default. KEEP is valid only if all three of the following conditions are satisfied:

If the OFFSET parameter is not specified (or this condition is taken by default), the spooler suspends after processing the current record.

Directs the spooler to close the spool file that it is currently processing. NOKEEP is valid only if all three of the following conditions are satisfied:

The spooler stops sending data after the current record, ejects a page, processes any specified OFFSET, saves the result of that processing (or the last completely printed page if no OFFSET was specified) in the FLABX (file label extension), prints a trailer with (INCOMPLETE) on it if trailers are enabled, and returns the file to the READY state. The next spooler that prints the file starts the first copy with the page following the page number saved in the FLABX and the file's header and trailer (if any) include (RESUMED) if printing starts anywhere but at the first page.

The page parameter may be used only in conjunction with the SUSPEND, RESUME, or RELEASE option. The page parameter must be an integer representing a physical page offset, either absolute or relative, within the file. Offsets are applied in the order they are entered, whether absolute or relative. If + is specified, the offset is adjusted forward relative to the current location by the number of pages specified. If - is specified, the adjustment is backward. If page is specified without + or -, then printing resumes at that page, absolute from the beginning of the file. No matter which combination of offsets are specified, the final location is limited by the bounds of the file.

A page is defined as follows:

The spooler's serial printer storage manager makes an approximate guess as to the correct page. However, it is only a guess based on an extremely limited interpretation of the spool file by the storage manager, because a serial printer does not return page data to its storage manager.

The storage manager does not attempt to interpret the spool file data, looking for escape sequences that may advance paper, eject a page, or change the page length or line density. This would degrade performance to an unacceptable level. Instead, it checks the carriage control character supplied as part of the user's FWRITE intrinisc call.

If that character is an ASCII "1" or an octal 300 (indicating skip to VFC channel 1, which by industry standard, is a page eject), it notes that this type of page control is in use and assembles its own checkpoint based on the location of this record in the spool file. If a RESUME with OFFSET is later required, it counts these checkpoints to try to find the proper restarting point. The storage manager ignores any other carriage-control character.

The page eject carriage control is not required in user data, and many applications do not use it. In this case, the storage manager is forced to assume a static number of records (60) per page. Historically, this is the number of lines that fit on a standard 11-inch page at 6 lines per inch, allowing three lines of margin at the top and the bottom of the page. This is often a flawed assumption, as the following examples show:

The last two examples come about because the storage manager does not interpret the data in the spool file, as mentioned earlier, and so cannot detect these situations.

In summary, if the storage manager cannot interact with the device to determine page boundaries, it uses a carriage control "1" or %300, or 60 records per page to simulate checkpoints for SPOOLER ldev;RESUME. Therefore, for the most consistent results with serial printers you should always include an OFFSET=1 parameter, with the SUSPEND option. You can also include the parameter with a subsequent RESUME option, but this does not prevent another spooler process from printing the file from the "wrong" place in the meantime.

The SHOW parameter displays the status of the spooling process(es) associated with the device(s) specified. All other parameters on this command are processed first, so the SHOW option reflects the updated state of the process(es) at the completion of the command executor. Please refer to the note following the example below.

The OPENQ option or parameter enables spooling for a specified logical device, device name, or all devices of a device class. This allows users to generate spool files on that device(s). See the OPENQ command for more information.

OPENQ is the default value for the START option.

The SHUTQ option or parameter disables spooling for a specified logical device, device name, or all devices of a device class. This prevents users from generating spool files on that device(s). See the SHUTQ command for more information.

SHUTQ is the default value for the STOP option.

SPOOLF, LISTSPF, OPENQ, SHUTQ

Native Mode Spooler Reference Manual

One or more spool file IDs: #Innn for input spool files or #Onnn for output spool files. These IDs are assigned by the spooling subsystem at spool file creation time. The # is optional. So is the O if you are displaying output spool files; that is, if you specify neither [#]O nor [#]I, [#]Onnn is assumed. Do not attempt to specify a qualified file name. You must enter spoolid or fileset.

There is no default.

A console user or a user with SM or OP capability who specifies O@ acts on all output spool files on the system. A user with AM capability who specifies O@ acts on all output spool files created by users in the same account. All other users are limited to files they have created.

Specifies the set of files to be printed. You must enter either fileset or spoolid. There is no default.

This positional parameter has this form:

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

You may use wildcards. Files that are not of the type SPOOL are ignored. An error is returned for each input spool file in the fileset.

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, it must be supplied 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 the user for each required lockword. In any case, if the lockword is not correctly provided, the print option on that file fails with a warning message, and the command continues on the rest of the files, if any.

The selection equation is used as a filter on the set of spool files selected. Only spool files whose attributes satisfy all filter requirements are listed.

For example, you use the following command to delete all the output spool files to which you have access and that have less than 100 pages from user.acct:

SPOOLF O@;DELETE;SELEQ=[(OWNER=user.acct)AND(PAGES<100)]

Begin and end selection equations with square brackets, as shown in the preceding example.

The following command prints the output spool files to which you have access with a priority greater than 2 and that were created before September 30, 1994.

SPOOLF O@;PRINT;SELEQ=[(PRI>2)AND(DATE<09/30/89)]

Selection equations have the following format. In this display, when the expression is expanded, interpret the symbol ::= as "can be replaced by."

Specifies the name of a file containing the selection equation. It must be preceded by a caret (^). The selection equation contained in the file may not exceed 509 characters in length, including the brackets in which it must reside. There is no restriction on the indirect file code. If the record size exceeds 509, only 509 characters per record are read and a warning is issued. Backreferencing to a formal file designator is also allowed for an indirect_file name; that is, ^*filename is also allowed. Any file is accepted as an indirect_file, unless the file system returns an error from FOPEN or FREAD.

There is no limit to the number of records in the indirect_file, only the total character count.

Records are processed as follows:

The ALTER option alters the characteristics of specified output spool files. Private output spool files may be altered in a limited fashion; only the keywords PRI, DEFER, and UNDEFER are allowed. A system manager (SM) user may also specify DEV=.

	NOTE: You cannot alter the attributes of spool files in the SPSAVE state. If you use the DEFER or DEV keyword on a spool file that is being printed, the spooler process printing the file is interrupted. The spooler process saves the page number of the last complete page that was printed in the spool files's file label extension (FLABX). The next time the file is selected for printing by any spooler, output resumes at the page saved in the FLABX. Because of the large amount of data buffered in the file system and the device, an output device may continue to print, making it appear as if the DEFER or DEV keyword has not had any effect. In reality, 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.

The PRINT option copies the specified filesets to the HPSPOOL account and links the new output spool files into the spool queues for printing. It is especially useful for generating more copies of a spool file in the SPSAVE state.

If the target device or class information exists in the file label extension, that device or class is used as the default. The DEV= option may be used to override this default. If there is no target device in the file label extension or the device specified is not valid, the DEV= parameter must be specified or an error message results. The default values of PRI (8) and COPIES (1) may also be overridden by user-specified parameters.

You must have nonshareable (ND) capability to use the SPOOLF...;PRINT command. Private files cannot be printed using the PRINT option.

The DELETE option purges all specified private or nonprivate spool files to which the user has 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, it is placed in DELPND state. Any spooler process printing it is notified, and printing stops at that point. Each of these files is deleted when its last user closes it, except in the case of STORE, as described below.

	NOTE: Because of the large amount of data buffered in the file system and the device, an output device may continue to print, making it appear as if the DELETE option has not had any effect. In reality, 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.

Specifies the logical device number of the spool file's new destination device.

If the spool file is in the PRINT state, it is returned to the READY state. It may immediately enter the PRINT state on ldev if all requirements are met.

Printing of a spool file is interrupted only if the newly specified target ldev, devclass, or devname is different than the previous target ldev, devclass, or devname.

Specifies the new destination device class name for the spool file. If the spool file is in the PRINT state, it is returned to the READY state. It may immediately enter the PRINT state on a device in devclass if all requirements are met.

The devclass parameter must begin with a letter and consist of eight or fewer alphanumeric characters. Note that MPE/iX does not allow the same name to be configured as a device class name and a device name. See the NOTE accompanying ldev.

Specifies the device name of the spool file's new destination device. If the spool file is in the PRINT state, it is returned to the READY state. It may immediately enter the PRINT state on devname if all requirements are met. Note that this occurs even if devname is the same as the device currently printing the file.

The devname parameter must begin with a letter and consist of eight or fewer alphanumeric characters. Note that MPE/iX does not allow the same name to be configured as a device class name and a device name. See the NOTE accompanying ldev.

Specifies the output priority of the designated spool files, where 0 is the lowest and 14 is the highest. Only an OP user or the console can specify an outpri of 14; other users are limited to 13.

The default is 8 with the PRINT option and no change for the ALTER option.

Specifies the number of copies of the designated spool files to be printed. The allowable range is 1 through 65,535. (The comma is for clarity; do not enter any commas in the actual command.)

The default is 1 for the PRINT option and no change for the ALTER option.

The SPSAVE option specifies that the selected spool files are not to be deleted after their last copy has printed. Instead they are retained in the HPSPOOL account in the SPSAVE state until deleted manually. Among other advantages, this option allows documents to be copied to user file space, to be reprinted without being reformatted, and so on.

Private spool files may not be saved.

When a file enters the SPSAVE state, its priority is set to 8 and its number of copies is set to 1. This is so that it will have the proper defaults should it be printed later.

The DEFER option changes the spool file's state to DEFER. If it is currently in the PRINT state, its spooler is notified and printing stops at that point. (See the note about buffer retention under the DELETE option.) The spool file's priority remains unchanged. If this option is used with the PRINT option, the spool file is copied to OUT.HPSPOOL and linked to the spooling system, but the state of the spool file is DEFER. The spool file is not printed until a subsequent SPOOLF...;UNDEFER is entered.

	NOTE: If the DEFER option is used on any file in the CREATE state (opened for original creation), the spool file only enters the DEFER state after it is completed (closed for the last time).

The UNDEFER option changes a spool file's state from DEFER to READY and causes a spooler to start printing it if the spool file is qualified for an idle printer to print. The spool file's priority remains unchanged.

The SHOW option allows a user to display the results of the SPOOLF command. All other parameters are processed before the SHOW. Here is an example:

SPOOLER, LISTSPF, LISTFILE, ALTSPOOLFILE, DELETESPOOLFILE

Native Mode Spooler Reference Manual

The logical device number of the target terminal. This terminal must be a real physical device and cannot be a virtual terminal or a distributed system (DS) pseudo terminal. The terminal must be configured as type 16 and as subtype 0 or 4.

Arbitrary name used in conjunction with the user and acct parameters to form a fully qualified session identity. The name may contain from one to eight alphanumeric characters, beginning with an alphabetic character. Default is that no session name is assigned.

User name, established by the account manager, that allows you to log on to this account. The name may contain from one to eight alphanumeric characters, beginning with an alphabetic character.

User password, optionally assigned by the account manager. The password may contain from one to eight alphanumeric characters, beginning with an alphabetic character. If a password exists, but is not supplied in the command syntax, STARTSESS will prompt you for it if:

If the password is supplied in the command syntax it must be preceded by a slash (/).

Account name established by the system manager. The name may contain from one to eight alphanumeric characters, beginning with an alphabetic character. A period (.) must precede the acct parameter.

Account password, optionally assigned by the system manager. The password may contain from one to eight alphanumeric characters, beginning with an alphabetic character. If a password exists, but is not supplied in the command syntax, STARTSESS will prompt you for it if:

Group name to be used for the local file domain and the CPU-time charges established by the account manager. The name may contain from one to eight alphanumeric characters, beginning with an alphabetic character. Default is the specified users home group if you are assigned one by the account manager. The parameter is required if a home group is not assigned.

The grouppass parameter is not needed when the user logs on under the user's home group, even if a password has been established. The grouppass is needed when the user logs on under any other group for which a password exists. If a password exists, but is not supplied in the command syntax, STARTSESS will prompt you for it if:

If the password is supplied in the command syntax it must be preceded by a slash (/).

Determines terminal-type characteristics. The value of the termtype parameter determines the type of terminal used for input. MPE/iX uses this parameter to determine device-dependent characteristics such as delay factors for carriage returns. The value must be 10, 18, 20, or 21. The default value for termtype is assigned by the system supervisor during system configuration. This parameter is required to ensure correct listings if your terminal is not the default termtype.

If group and/or account names are omitted, the proposed logon group and/or account name is substituted. Refer to appendix C, "Terminal and Printer Types."

Maximum CPU-time that a session may use, entered in seconds. When the limit is reached, the session is aborted. It must be a value from 1 to 32,767, provided that it does not exceed any limit imposed by the system or account manager. To specify no limit, enter a question mark (?) or UNLIM, or omit the parameter. Default is no limit.

The execution priority queue that the command interpreter uses for your session, and the default priority for all programs executed within the session. BS is highest priority; ES is lowest. If you specify a priority that exceeds the highest permitted for your account or user name by the system, MPE/iX assigns the highest priority possible below BS. DS and ES are intended primarily for batch jobs; their use for sessions is generally discouraged.

	CAUTION: Care should be used in assigning the BS queue, because processes in this priority class lock out other processes. For information on the guidelines for these priority queues, refer to the TUNE command in this chapter. Default is CS.

Determines the input priority of the job or session. The inputpriority option is the relative input priority used in checking against access restrictions imposed by the jobfence. The inputpriority option takes effect at logon time and must be a value from 1 (lowest priority) to 13 (highest priority). If you supply a value less than or equal to the current jobfence set by the system operator, the session is denied access. Default is 8.

The HIPRI option is used for two different purposes when logging on. It can be used to override the system jobfence, or it can be used to override the session limit:

If the HIPRI option is used without SM or OP capability, the following warning is displayed:

MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI,
MAXIMUM INPRI OF 13 IS USED (CIWARN 1460)

Request that the session starts executing immediately without waiting for a Return on the terminal. If this parameter is specified and the target terminal is the system console, system manager (SM) capability is required.

An INFO string to be passed to the command interpreter. For the MPE/iX CI, it is the first command to be executed by the command interpreter. This parameter replaces the :( ) COMMAND
LOGON command and approximates its function. The :( ) COMMAND LOGON command caused the session to terminate after executing the specified command. In contrast, the ciinfo parameter does not terminate the session unless ciparm is set to 1, 3, or 5.

Running the CI as a child process in this way restricts the flexibility of ciparm. More flexibility is available by running the CI as a standalone program.

The command interpreter parameter number you wish to use. If you are using the MPE/iX command interpreter, the numbers accepted are:

Any other value is treated as zero (0). The MPE/iX CI distinguishes between a ciparm 1, 3, 5 and 0, 2, 4 when it is run from within the CI, that is, after the session has logged on.

If a user without SM capability uses -1 or -2, the system substitutes a parameter value of 0. An error message is not produced.

TUNE

Process Management Programmer's Guide

Performing System Operation Tasks

The logical device number of a spooled device. When the spooler gains control of the specified device, it controls spooling to it as well as to all device classes that reference the device.

The device class specified in the I/O configuration. Only this device class becomes spooled; it does not affect other device classes or any devices in the class.

The spooler prints files waiting in the queue for device ldev, but prevents the creation of new spool files. The SHUTQ parameter is valid for ldev only.

STOPSPOOL

Performing System Operation Tasks

The logical device number of a spooled device. The spooler process gives up ownership of the spooled device. If the OPENQ parameter is omitted, the device becomes available only for nonspooled I/O. When a logical device is assigned to more than one device class, to restart spooling for a specific device class issue an explicit STARTSPOOL request for that class.

The device class specified in the system I/O configuration. Subsequent I/O directed to this device class does not take place to/from a spool file. I/O goes directly to/from a logical device if one is available within the device class. If none is available, the program is unable to open the file.

May be specified with the ldev parameter only. The spooler process leaves the queue in an OPEN state, or opens the queue if previously shut. Default is SHUTQ.

STARTSPOOL

STORE and TurboSTORE/iX Manual

Volume Management Reference Manual

Specifies the set of files to be stored. The default set is @ meaning all files in the current working directory (CWD) regardless of the user's capabilities. If the DIRECTORY option is specified, the default file set is empty (no files).

The filesetlist parameter has the form shown below:

filesetitem[,filesetitem[...

where filesetitem can be ^indirectfile or fileset.

A file name that backreferences a disk file. The syntax is

^indirectfile or !indirectfile

This file may consist of fileset(s) and option(s), but only options can appear after the first semicolon (:) on each line. An option specified on one line will operate on all files in the filesetlist.

^indirectfile is the preferred format. If you use !indirectfile, the CI will interpret this as a variable reference, so you will have to specify !!indirectfile instead.

Specifies a set of files to be stored and optionally those files to be excluded from the STORE operation. The fileset parameter has the form:

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

An alternate syntax exists for use with the RENAME option:

filestostore[-filestoexclude[-...[=targetname]

The system stores any file that matches filestostore unless the file also matches filestoexclude, which specifies files to be excluded from the STORE operation. You may specify an unlimited number of filestoexclude.

Since "-" is a valid character for HFS syntax file names, a blank character must separate it from HFS file sets to obtain the special negative file set meaning.

Both filestostore and filestoexclude may be entered in MPE or HFS syntax. Wildcards are permitted for both MPE and HFS syntax.

The MPE syntax is as follows:

filename[.groupname[.accountname

A lockword may be specified for files to be stored, in the form:

filename/lockword.group.account

The HFS syntax is as follows:

/dir_lev_1/dir_lev_2/.../dir_lev_i/.../filedesig

or

./dir_lev_i/dir_lev_j/.../dir_lev_k/.../filedesig

If the name begins with a dot (.), then it is fully qualified by replacing the dot with the current working directory (CWD).

Each of the components dir_lev_i and filedesig can have a maximum of 255 characters with the full path name being restricted to 1023 characters. Each of the components dir_lev_i and filedesig can use the following characters:

For HFS name syntax, the lowercase letters are treated distinctly from the uppercase letters (no upshifting). Names in MPE syntax are upshifted.

Both MPE and HFS name components can use the characters @, #, and ? as wildcard characters. These wildcard characters have the following meaning:

These wildcard characters can be used as follows

Also, character sets may be specified in the following syntax:

Examples of using character sets are:

You may specify up to a maximum of sixteen characters for each character set and you may not nest brackets. You may not use character sets with the TRANSPORT option.

A character set specifies a range for only one (1) ASCII character. The range [a-d]@ gets all files that begin with the letter a through the letter d. The ranged [ad-de] may cause unpredictable results.

Since the hyphen (-) is a valid character for HFS syntax file names, it is allowed inside a character set, immediately following a left bracket ([) or preceding a right bracket (]). When specified between two characters, the hyphen implies a range of characters.

Specifying Database Files

When specifying TurboIMAGE and ALLBASE/SQL databases to be stored, only the root file or DBCon file needs to be specified. STORE will determine which other files belong to that database, and will store all of them. If dataset file(s) are specified without specifying a root file, then a warning will be printed for each file, and they will not be stored. Individual database files can be stored without the root file by specifying the ;PARTIALDB option on the STORE command line.

Database corruption may result if not all database files are restored from a backup. Be sure that you only want to restore certain database files before overriding the default behavior with ;PARTIALDB.

MPE and HFS Naming Equivalences

When an MPE name component is a single @ wildcard, the @ will be "folded" to include all MPE and HFS named files at that level and below. To specifiy only MPE-named files, use ?@ instead.

MPE wildcards are not expanded in filestoexclude. This means that @.@.@-@.@.@ is NOT an empty fileset. It contains all of the HFS named files on the system.

A fileset may be entered in any of the following formats and may use wildcard characters. Equivalent MPE and HFS formats are grouped together as follows.

Specifies the name and creator for the file on the store media. The targetname parameter has the form:

filename[:creator[.creatoraccount

The filename can be any legal MPE filename or HFS pathname. The creator and creatoraccount must be legal creator and account names, respectively. The only wildcard character allowed is a single @ for each component of the filename, creator or creatoraccount. The wildcard character @ indicates that the source value for that component should be used. An HFS pathname which ends in a / is considered an HFS directory and no wildcard characters are allowed in the filename.

The RENAME option must be specified if the targetname is used.

The name of the device to which the stored files are to be written. This may be any magnetic tape or DDS device. This file must be backreferenced, by using an asterisk (*). You must do this by using a File equation before invoking STORE.

A message is displayed on the system console requesting the operator to mount the tape identified by the storefile parameter and to allocate the device.

The storefile can now reference a remote device. For example, if you issue the following commands, NM Store will store all files to the specified remote device.

 :FILE REMOTE;DEV=REMSYS#TAPE
 :STORE @;*REMOTE;SHOW

NM STORE will store all files to the specified remote device. Although the initial tape mount request will appear on the remote console, all of the STORE console messages will be displayed on the local console. Currently, labeled tapes and Magneto-optical devices cannot be used for remote backup.

A message is displayed on the system console requesting the operator to mount the tape identified by the storefile parameter and to allocate the device.

If storefile is not supplied and the STORESET option is not used, then STORE creates a default storefile name. The default file name is the user's logon username. No file equation is used.

Sequential and parallel devices are specified with the STORESET option. Similarly, magneto-optical devices are specified using the MOSET option. Storefile should not be specified when using STORESET or MOSET.

If using TurboSTORE/iX 7x24 True-Online Backup, a disk file can also be specified with a file equation for storefile. An example of such a file equation would be:

:FILE MYDISC=DISCBACK.DAILY.BACKUP;DEV=DISC

Note that DEV=DISC must be specified for STORE to recover files from disk backups. All other information in the file equation will be ignored by STORE. STORE creates a binary, fixed record file containing the backup data. This disk file can be restored using the same file equation for RESTORE.

By default, STORE creates the disk file with a 4Gig limit. If the data being stored exceeds this, or an existing file with a smaller limit is specified for the backup, then STORE will create and write to additional disk files. It will append the "reel" number to the disk file name originally specified. For example, if the backup disk file specified was /SYS/BACKUPS/DAILY, and STORE ran out of room, it would create /SYS/BACKUPS/DAILY.2, /SYS/BACKUPS/DAILY.3, and so on. The additional files are HFS-named files.

TurboSTORE/iX 7x24 True-Online Backup must be used to create disk backups.

Specifies that STORE is to report information for every file that is stored. If you omit the SHOW 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. This listing is sent to $STDLIST (formal file designator SYSLIST) unless a FILE command is entered to send the listing to some other device. For instance, if you enter the following file equation before issuing the STORE command, the listing will be sent to a line printer.

FILE SYSLIST; DEV=LP

Tells STORE what information to display for the files that are stored. If you specify ;SHOW and omit showparmlist, then the default is SHORT if the recordsize of SYSLIST is less than 132 characters, or LONG if the recordsize is equal to or greater than 132 characters. The format for showparmlist is:

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

where showparm may be one of the options described below.

If an HFS-named file is specified in the filesetlist, or the expansion of a wildcard includes an HFS-named file, then an HFS-style output listing will be used. This listing shows the same information as the MPE format, but puts the name of the file at the right end of the listing to allow for longer HFS names. If an HFS name is too long to fit in the record size of the output file, it will be wrapped onto the next line. Wrapping is signified by a "*" as the last character on the line.

If a 7x24 True-Online backup is performed with the sync point at the end of the backup, additional information will be written to the listing. This information consists of a single character immediately following the volume restrictions. The possible values and meanings of this character are as follows:

For more information on performing 7x24 True-Online backups, refer the the Store and TurboSTORE/iX Manual (30319-90001).

Tells STORE what to do if there is a tape write error. If you omit this parameter, then the default option is REDO. ONERR is a synonym for ONERROR.

Instructs STORE to store only selected files. A moddate value (indicated by >=, equal to or greater than) limits the STORE to those files that were modified on or after a particular date.

An accdate value (indicated by <=, less than or equal to) limits the STORE to those files that were accessed on or before a particular date.