The following article contains general instructions for creating a user defined file system for storing WebDocs Documents. A user defined file system is the only way to store documents on an alternate disk storage partition or ASP.
Some customers find it advantageous to create separate disk partitions where they can store documents so disk can be better managed and used for pre-defined purposes.
Example: Image documents are ONLY stored on disk partition 2.
Creating the User Defined File System
First, use the following command to create the User Defined File System:
CRTUDFS UDFS('/dev/qasp01/rjsimgdocudfs.udfs') DTAAUT(*RWX) OBJAUT(*ALL) CASE(*MONO) DFTFILEFMT(*TYPE2) TEXT('WebDocs User Defined File System')
Note: Specify the ASP name when storing to an ASP. Ex: QASP02 is disk ASP 2''
Creating the IFD Folder and Mounting the User Defined File System
To create an IFS Folder to Mount the User Defined File System Over:
MKDIR DIR('/rjsimgdocudfs') DTAAUT(*RWX) OBJAUT(*ALL)
Now, the user defined file system must be mounted over an IFS folder before storing documents. To mount the User Defined File System:
MOUNT TYPE(*UDFS) MFS('/dev/qasp01/rjsimgdocudfs.udfs') MNTOVRDIR('/rjsimgdocudfs')
The MOUNT command mounts the user defined file system over the IFS folder /rjsimgdocudfs. Now when any documents get copied into the /rjsimgdocudfs folder they will be automatically copied and stored as part of the UDFS.
Note: The MOUNT command should be run during system startup procedures to make sure the UDFS is always available when the system is active.
Unmounting the User Defined File System
The user defined file system should be unmounted prior to running system backups.
Unmount by Specifying the IFS Folder
UNMOUNT TYPE(*UDFS) MNTOVRDIR('/rjsimgdocudfs')
Or unmount by specifying the User Defined File System Name
UNMOUNT TYPE(*UDFS) MFS('/dev/qasp01/rjsimgdocudfs.udfs')
Note: The RMVMFS command can be used instead of UNMOUNT if desired. They do exactly the same thing.
Note: The UNMOUNT command should be run during system shutdown procedures if you will be backing up the entire UDFS as a single .UDFS object. See the SAV commands below.
Backing Up Files from a Mounted UDFS
When saving all individual files from a mounted UDFS, you simply back up all objects specified under the IFS folder.
To save all files from a mounted UDFS, enter the command:
SAV DEV(' / QSYS.LIB/TAP01.DEVD' ) OBJ(('/RJSIMGDOCFDS' *INCLUDE)) SUBTREE(*ALL)
In this example, the individual files stored within the UDFS are saved to tape drive TAP01
Backing Up an Unmounted UDFS
When saving a UDFS, save all the objects and the attributes of the UDFS.
To save an unmounted UDFS, enter the command:
SAV DEV(' / QSYS.LIB/TAP01.DEVD' ) OBJ(' / DEV/QASP01/RJSIMGDOCUDFS.UDFS' ) SUBTREE(*ALL)
In this example, the UDFS is saved to tape drive TAP01
Note: Backing up an unmounted UDFS should cause better throughput on a streaming tape drive because all files are backed up as part of the UDFS stream file object.
WebDocs Folder Settings when Storing Document on a User Defined File System
When storing documents into a user defined file system, the following IFS folder name should be entered into the WebDocs folder name: /rjsimgdocudfs
This will insure that all documents are stored on the user defined file system that was created above.