Creating a User Defined File System to Store WebDocs Documents

From Support

The following lists 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: Customer wants ONLY their image documents on disk partition 2.

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: If storing to an alternate Disk ASP, specify the ASP name. Ex: QASP02 is disk ASP 2

Create an IFS Folder to Mount the User Defined File System Over

 MKDIR DIR('/rjsimgdocudfs') DTAAUT(*RWX) OBJAUT(*ALL)    

Mounting the User Defined File System The user defined file system must be mounted over an IFS folder prior to storing documents

 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.