SAN0-1210-H4
UtilityZone (Spool Archive Utility)
SAN/400 (c) Version 2.1.0
Copyright (c) 1994, 2002 INPRO International, Inc.
All Rights Reserved
CONTENTS
PRODUCT OVERVIEW
Spool Problems/Release Changes?
Get Phenomenal Relief!!!!
What is SAN/400 (Spool Archiving Utility)?
SAN/400 is an exciting new SPOOL FILE ARCHIVE UTILITY for the
IBM iSeries platform. This tool gives the systems operations
people the ability to automatically roll spool files either off-line
to tape or after the specified number of days for an output queue
deleted from the system. The control is at the output queue level.
Spool files that have been archived to tape are in a compressed
format saving tape space. All files that are archived can be
searched for online and the correct tape volume id presented to the
operator for a restore operation, on this or the next OS/400 Release.
The utility provides a command interface that you simply run daily
out of your job scheduler, to do all the archiving automatically.
Spool files within an output queue can be online prior to archiving
for a maximum of 7 days. Until then the spool files are rotated
automatically with SAN/400's maintained internal output queues.
Options exist to only rotate those files in a non-ready status
due to conditions such as end-of-forms existing in several writer
and outqueue combinations on the system.
FEATURES
- Automatic Spool File Archiving/Deletion
- Simple menu driven application
- Extremely low overhead based on native SPOOL APIs
- Based on output queues and number of days by output queue
- User option to not rotate those files still in a ready status
by outqueue
- Tape compression exploited
- Restore of an archived spool file is automated with the
volume id to mount
- Dynamic maintenance of control files supported
- OS/400 Release to Release supported
ADVANTAGES
- Operator less functionality
- Printers that are out-of-forms can preserve their spoolfiles
- Small learning curve
- Helps manage system spool file storage saving disk space
- Restores are a breeze with supplied tape volume id for
mounting
- Selectively respool reports after OS/400 Release changes
NOTE:This is an overview of
the main concepts of
Spool Archive Now/400
REQUIREMENTS
OS/400 3.1.0 or higher
START HERE
- Return here after installation, see
SHARED FOLDERS STYLE INSTALLATION
or
NON-SHARED FOLDERS STYLE INSTALLATION.
- Unlock the product, see
UNLOCK PRODUCT.
- Add SANEXE to your library list.
- Issue the WRKARCID Command and setup control information on the
output queues you want SAN/400 to maintain. (DETAIL instructions
are contained in the REFERENCE Section of this document)
- Grant the *PUBLIC *USE authority to the following related user
space programs *PGM object type in QSYS:
- QSPCRTSP
- QSPGETSP
- QSPOPNSP
- QSPCLOSP
- QSPPUTSP
- Place the command SANEXE/MOVARCID with the *ALL option or a
specific Archive ID, in your automatic job scheduler system.
(see sample code)
The user profile running this command is assumed to have *SPLCTL
special authority on their profile. This command rotates the output queues and creates savefiles for
those outqueues that are specified for a saving and deletes the
final days output for those queues specified for deletion.
The SAVSPLARC command will move these savefiles later to tape and
deletes the savefiles from the system.
- The save to tape operation is evoked by using the command
SANEXE/SAVSPLARC to a specific tape device with the TAPE(xxxx)
parameter. The system operator will receive the tape mount message,
everything else is automatic and tapes are assumed to be initialized
according to your internal standards.
SAMPLE CODE
PGM
ADDLIBLE LIB(SANEXE) /* Put the product LIBRARY +
in the library LIST or DUP the command +
into your production library. All +
INPRO product commands point back to a +
product library, which is automatically+
added to your jobs library list. */
MOVARCID ARCID(*ALL)
SAVSPLARC TAPE(TAP01)
ENDPGM
REFERENCE MATERIAL
SCREEN CAPTURES
WRKARCID (Work with Archive ID)
NOTE:To add more to the
processing simply use the F6
command to add. SAN/400
internally keeps rotation
outqueues in SANDB that are
automatically being managed by
the program product.
ADD/EDIT Spool Archive ID
NOTE:When reducing the number of
days SAN/400 consolidates spoolfiles
from those days removed to the
last day internal outqueue SAN/400
is maintaining internally in the
system. When changing the source
or originating outqueue those spoolfiles
still existing in the source outqueue
will NOT be touched by SAN/400.
Archive IDs must be alpha characters.
AA, BB, etc.
Display Spool Archive ID
NOTE:(RDY) status processing options
only effect the primary or source
outqueue, not SAN/400 internal
processing queues.
Work Spool Archive ID
NOTE:This subfile is presented
in LIFO order for searching
purposes.
Work Spool File History
NOTE:A restored spool file is
respooled for you automatically
in outqueue SANDB/RESTORED for
your controlled reprinting etc.
The user running this request
MUST have *SPLCTL special authority
in their user profile to provide
them with the spool control
authority needed to respool the
file. SAN/400 will prompt you
for the TAPE drive to be used
for restoring.
Work History by User
NOTE:This searches across output
Queues in LIFO (Last In First
Out) order, for a specific user
profile.
Work With History
NOTE:The next screen displayed
will ask for a specific tape
volume ID to be mounted and
interactively restore and
respool the specific report
requested.
Restore Spool File
NOTE:This is an interactive
job step, with the spoolfile
being respooled in the
outqueue SANDB/RESTORED.
Roll Spool File Processing
NOTE:Activating the rolling process
of moving all spool files that
are not being actively printed
is accomplished with the MOVARCID
command as follows. All archives
can be rolled at once with the *ALL
option or a specific archive ID can
be rolled with the specific ID.
This process is actually building
savefiles in library SANDB for later
processing by the SAVARCID command
to take them to tape archival.
Save To Tape Processing
NOTE:For archiving to tape those
Outqueues specified for saving the
command SAVSPLARC is used. This
command will save all savefiles
created by the MOVARCID command
off to an initialized tape.
(Please use care in the naming
of tapes involved in this process
to allow for unique names and labels
on these tapes for future restoration
of a spooled file)
UNLOCK PRODUCT
NOTE:TRIALs of this
product work 10 times, then
this command must be run to
unlock this application permanently
on your system. Obtain the code
from INPRO International, Inc.
product support.
RELATED PUBLICATIONS
None.
ERROR MESSAGES
Errors are listed in error message file SANEXE/SANMSGF with probable
causes and recommended actions.
STATEMENT OF DIRECTION
Support for multiple archive moves per hour (in this release).
INPRO International, Inc., 701 Brazos, Suite 500, Austin, TX 78701-3232
(800) 63-INPRO, (512) 320-9107 Fax:(512) 444-4931, sales@inprointernational.com, www.inprointernational.com