The second folder monitor screen displays the details that can be entered This screen also allows the Status to be changed, use the F7 function key to set the status to Online and the F8 function key to set the status to Offline.

Note: From version 6.2.62, all folder paths will be validated but will only display warning messages as they could be unauthorised to user CPPDMM. If this is the case then you will need to make sure that you use a Job Description which has the User entry set to a User Id which does have authority otherwise the Folder Monitor will fail - for instance if you are using QNTC.

Entries

First Page

Monitor Type

From version 6.2.62 - This is the type of Folder Monitor selected and will be *STD by default. If you have chosen to use a bespoke Parameter Maintenance program then this will be say "Bespoke".

Monitor Name

From version 6.2.62 - This is the unique name for your Folder Monitor entry. This will be used as the name of the Job running in the CPPD Subsystem when it is active.

Description

From version 6.2.62 - Enter a description for your Folder Monitor entry. If you leave this blank then the folder being monitored will be displayed in the list.

Folder to Monitor

Specify the name of the folder that you wish to monitor e.g. /test/flrmon

Failed folder

Specify the name of the folder where you wish to place files that have failed e.g. /test/flrmon/failed.

Note 1: This cannot be the same name as the Folder to Monitor.

Note 2: If this entry is left blank and the folder monitor fails the file then, from version 6.2.62 (FLRMON V0.7), the file will be left in the original folder and picked up for retry. This should only be used with caution as, if you have the Polling interval set to 1 second and you only have this one failed file in the folder, it will keep trying this same file forever until the subsystem has ended and you delete the file.

Program to call

Specify the name of the Program that you wish to be called when a new file appears in the monitored folder. Please see Supplied Folder Monitor programs for a list of standard programs in library CPPD:

You may create your own Folder Monitor program, please see Creating a bespoke Folder Monitor program for details, or you ask Cobwebb to create one for you.

Note: Prior to version 6.2.62 - This is also the entry that is used as the Job Name when the job is running in the CPPD Subsystem.

Program Library

The library name where the above Program resides. This may be left as *LIBL for the Supplied Folder Monitor programs.

Polling interval (mins / secs)

Specify the number of minutes and/or seconds you wish to wait before checking for new files arriving in the monitor folder. These two entries will be added together for the polling interval. If nothing is entered here then the default polling interval is 5 minutes. Note: The addition of seconds is from version 6.2.53 only.

Job Description

Specify the name of the Job Description to use when running the monitor program - this will be FLRMON by default. We would suggest that you create a Job Description, perhaps with the same name as your Program, so that you can specify details such a Library List, Logging etc. We have supplied a FLRMON Job Description that you can copy which has the correct User and Job Queue entries to run in the CPPD Subsystem.

This Job Description will be used for the Folder Monitor entry when the CPPD subsystem starts; for instance, if you are printing output you can use OUTQ(*JOB) and it will default to the Output Queue specified in the Job Description. From version 6.2.54 only.

Also if you need the Folder Monitor to run with a different User, i.e. with access to QNTC, then you can change the User entry in the Job Description and this user will be used to run the Folder Monitor job in the CPPD subsystem - see QNTC Configuration for details.. From version 6.2.54 only.

Library

The library name where the above Job Description resides.

EBCDIC Code Page

The EDCDIC Code page used for file name conversions. If you wish to use a Code Page other than 1146 when processing files then enter a valid entry here. From version 6.2.53 only.

Locale

The Locale used for file name conversions. If you wish to use a Locale other than EN_GB when processing files then enter a valid entry here. From version 6.2.53 only.

Note: Use "WRKOBJ OBJ(QSYS/*ALL) OBJTYPE(*LOCALE)" to see currently installed locales. Use "DSPSYSVAL SYSVAL(QLOCALE)" to see current locale.

Call if no file

If you wish the Monitor program to be called every Polling interval even when there are no files to be processed then enter a 'Y'. The default is 'N i.e. the Monitor program will only be called if a file has been found in the folder being monitored. From version 6.2.53 only.

Status

This entry displays the status of the entry. Online means that this folder will be monitored when the CPPD Subsystem is started; Offline entries will not be monitored.

Second Page

From version 6.2.57.

Success Folder

Specify the name of the folder that you wish your successfully processed file to be move to e.g. /test/flrmon/success. If this is left blank then the files will be deleted once they have been successfully processed. Note: This cannot be the same name as the Folder to Monitor.

Note: Unless you are on Version 6.2.70 or above of the Cobwebb Server Software, if you are using a Docstore folder monitor which uses the STOREDOC command, this command deletes the file when it has been stored successfully so documents will not be copied to the Success folder.

Include Files Filter

This is where you may specify a comma separated string of file names that you wish to be included for processing by the Folder Monitor. This may include the standard generic replacement characters of * or ? E.g. *.tst, *.txt. If you leave this entry blank it will assume that any file name should be included as if you had specified *.*.

Exclude File Filter

This is where you may specify a comma separated string of file names that you wish to be excluded for processing by the Folder Monitor. This may include the standard generic replacement characters of * or ? E.g. *.tmp. Note: Only file names that fall within the Include File Filter above will be eligible for excluding.

Function keys