JAMS 6.x Help
Folder Class Members
Properties  Methods  Events


The following tables list the members exposed by Folder.

Public Constructors
 NameDescription
Public ConstructorFolder ConstructorCreates a new Folder.  
Top
Public Properties
 NameDescription
Public PropertyACLAccess Control List  
Public PropertyAlertsGets the list of Alerts for this Folder.  
Public PropertyAlertsModifiedGets a boolean which indicates if the Alerts were modified after the Alert was Loaded.  
Public PropertyBatchQueueGets or sets the JAMS Batch Queue that Jobs within the Folder should be submitted to.  
Public PropertyBatchQueueIDGets and Sets the ID of the Batch Queue.  
Public PropertyBatchQueueNameGets or sets the batch queue that Jobs within the Folder should be submitted to.  
Public PropertyDescriptionA description of this Folder.  
Public PropertyErrorGets an error message that describes the errors in the object. (Inherited from MVPSI.JAMS.BasePublicObject)
Public PropertyFolderIDThe FolderID is a unique number used to identify a Folder.  
Public PropertyFolderNameThe name of the Folder  
Public PropertyHasErrorsThe HasErrors property can be used to determine if the object has any errors. If the object needs to be validated, it is done before returning. (Inherited from MVPSI.JAMS.BasePublicObject)
Public PropertyHomeDirectoryThis field specifies the directory where jobs should begin execution.  
Public PropertyInEditIs this object in the middle of an edit? (Inherited from MVPSI.JAMS.BasePublicObject)
Public PropertyItemReturns any error messages currently associated with this column. (Inherited from MVPSI.JAMS.BasePublicObject)
Public PropertyKeepLogsWhen the field is true, batch log files will not be deleted at the completion of the Job.  
Public PropertyLastChangeThe date and time that this Folder definition was last changed.  
Public PropertyLastChangedByUser who last changed this Folder.  
Public PropertyLastChangeUTCThe UTC date and time that this Folder definition was last changed.  
Public PropertyLoadedFromReturns the JAMS Server that this Folder was loaded from.  
Public PropertyLogLocationThis field specifies the location (device/directory) where batch log files should be placed.  
Public PropertyModifiedThe Modified property keeps track of modified state of this object. You cannot set the Modified property. If you modify the object, the modified property will be true until you end or cancel the update. (Inherited from MVPSI.JAMS.BasePublicObject)
Public PropertyNameThe name of the Folder  
Public PropertyNewObjectThe NewObject property indicates that this object has just been created and has never been saved on a JAMS Server. (Inherited from MVPSI.JAMS.BasePublicObject)
Public PropertyNotifyEMailThis is a list of Mail addresses, separated by commas. If a Job in this Folder requires notification, a mail message will be sent to this list of addresses.  
Public PropertyNotifyJobA JAMS Job which should be submitted when notification is required.  
Public PropertyNotifyJobIDGets and Sets the ID of the notification job. This property is designed to be used by JAMS, not user code.  
Public PropertyNotifyJobNameGets and Sets the name of the notification job.  
Public PropertyNotifyJobNameIsRelativeGets or Sets the "Notify Job Name Is Relative" property. If set to true, it means NotifyJobName is a relative path. Otherwise, NotifyJobName is an absolute path.  
Public PropertyNotifyOtherNotifyOther is used to an additional notification method. For OpenVMS based JAMS servers, this is a list of operator classes, separated by commas. If a Job in this Folder requires notification, a message will be sent to these operator classes.  
Public PropertyNotifyUsersThis is a list of usernames, separated by commas. If a Job in this Folder requires notification, a message will be broadcast to these users (if they are logged on at the time.)  
Public PropertyParametersGets the list of Parameters for this Folder.  
Public PropertyParamsModifiedGets a boolean which indicates if the Parameters were modified after the Method was Loaded.  
Public PropertyParentFolderGets or sets the JAMS Folder that this Folder is a member of.  
Public PropertyParentFolderIDGets the Parent Folder ID for this Folder. This property is designed to be used by JAMS, not user code.  
Public PropertyParentFolderNameGets or sets the name of the JAMS Folder that this folder is a member of.  
Public PropertyPrintLocationThis field specifies the directory where print files should be placed.  
Public PropertyPrintQueueSpecifies the default print queue for Reports in this Folder. Report definitions are part of a Job’s definition. This queue can be overridden in the Report definition.  
Public PropertyQualifiedNameReturn the fully-qualified name for this folder  
Public PropertyRecoveryInstructionsRecovery instructions to be included in notification e-mail messages.  
Public PropertyRequirementsResource Requirements for this Folder.  
Public PropertyRequirementsModifiedReturns true if the Requirements were modified during an edit.  
Public PropertyRetainOptionSpecifies the default retention policy for Jobs in this Folder. The options are:

Always (A) Jobs are always retained until specifically deleted.
Never (N) Never retain jobs.
Error (E) Jobs are retained if they complete with a severity of Warning or worse.
Timed (T) Jobs are retained for the specified time after completion.

 
Public PropertyRetainTimeLength of time the job should be retained if the retain option is set to "Timed".  
Public PropertyRevisionHistoryGets a list of Folder versions.  
Public PropertyRunawayElapsedPerThe Runaway Job Elapsed Time Percent specifies how long a job may run before it is considered a runaway job. This is specified as a percentage of the jobs average elapsed time. When the job is considered runaway, JAMS will perform notification for the job.  
Public PropertySchedulingPriorityModifierThis number is used to calculate the scheduling priority for Jobs in this Folder. When a Job is submitted by the JAMS, the scheduling priority is calculated by adding together the default scheduling priority, the Folder’s priority modifier and the Job’s priority modifier.  
Public PropertySearchPathThe Folder's Search Path  
Public PropertyShortElapsedPerThe Short Job Elapsed Time Percent specifies a minimum elapsed time for a job. If the job completes successfully in less than this amount of time it is considered a Short Job. This is specified as a percentage of the jobs average elapsed time. When a job is determined to be a short job, JAMS will perform notification for the job and may change the completion severity of the job.  
Public PropertyShortSeverityIf specified, when a job is determined to be a Short Job, the completion severity will be changed to the severity specified here.  
Public PropertyStalledTimeSpecifies how much time may elapse after a jobs scheduled time before the job is considered to be stalled. When the job is considered stalled, JAMS will perform notification for the job.  
Public PropertyTemplateLibraryThe Template Library specifies the full file specification which contains the JAMS templates used when parsing a Job. Refer to Templates and Job Parsing for a complete description of template libraries.  
Public PropertyTimestampLogsWhen the field is true, batch log files be time stamped with an extension of .LOG_yyyymmdd_hhmmsscc.  
Public PropertyUserIDGets and Sets the UserID for jobs in this Folder. This property is designed to be used by JAMS, not user code.  
Public PropertyUserNameThe default username for Jobs in this Folder.  
Public PropertyUserSecurityJAMS UserSecurity.  
Public PropertyValidatedThe Validated property keeps track of the validation state of this object. If the object has been modified, Validated will be false until the object has been successfully validated by the Validate method. (Inherited from MVPSI.JAMS.BasePublicObject)
Top
Public Methods
 NameDescription
Public MethodBeginEditStarts an edit of this object. (Inherited from MVPSI.JAMS.BasePublicObject)
Public MethodCancelEditCancels an edit of this object. (Inherited from MVPSI.JAMS.BasePublicObject)
Public Methodstatic (Shared in Visual Basic)CheckCheck to see if a Folder is valid and the caller has the access desired.  
Public MethodClearErrorClears the error message for a property. (Inherited from MVPSI.JAMS.BasePublicObject)
Public MethodClearModifiedOverridden. Clear the modified flag of this Folder and all of the attached lists.  
Public MethodCloneImplementation of ICloneable Clone.  
Public MethodCompareToImplementation of IComparable CompareTo. Compares this instance to the one specified.  
Public MethodCopyToCopy the Folder with a new name and/or server  
Public MethodDeleteOverloaded. Delete the Folder definition.  
Public MethodEndEditEnds an edit of this object. Any changes are saved. (Inherited from MVPSI.JAMS.BasePublicObject)
Public MethodEqualsChecks for equality.  
Public Methodstatic (Shared in Visual Basic)ExistsOverloaded. Test to determine if a given Folder exists on the default server.  
Public Methodstatic (Shared in Visual Basic)FindOverloaded. Returns a Collection of Folders contained in the specified folder.  
Public MethodForceModifiedForces the Folder and all of the Folder's sub-objects to be marked as modfied.  
Public MethodGetAccessControlOverloaded. Gets a FolderSecurity object that encapsulates the access control list (ACL) entries for the Folder described by the current Folder object.  
Public MethodGetChildNamesGets a list of Child Names of the Folder  
Public MethodGetFolderDescendantsReturns a collection of descendant FolderIDs  
Public MethodGetHashCodeReturns a hashcode.  
Public MethodGetNumberOfChildrenFetch the number of children for this folder  
Public MethodInitializeInitializes a Folder to default values.  
Public MethodIsAncestorOfDetermines if a folder is an ancestor of another folder  
Public Methodstatic (Shared in Visual Basic)LoadOverloaded. Load the Folder with the specified name from the specified JAMS Server.  
Public MethodMoveToSave the Folder with a new name and/or server and remove the old instance of the folder.  
Public Methodstatic (Shared in Visual Basic)PathExistsTest to determine whether ANY type of folder object (or folder) exists at the given path on the specified server.  
Public MethodResetStatisticsResets the Statistics of Jobs and Setup's within a Folder.  
Public MethodSaveAsSave the Folder with a new name and/or server.  
Public MethodSetAccessControlApplies access control list (ACL) entries described by a FolderSecurity object to the Folder described by the current Folder object.  
Public MethodSetErrorSets the error message for a property. (Inherited from MVPSI.JAMS.BasePublicObject)
Public MethodSetModifiedMarks the object as modified. (Inherited from MVPSI.JAMS.BasePublicObject)
Public MethodToStringConvert a Folder to a String  
Public MethodUndoEditsOverridden. Undo changes that have not been saved to the database.  
Public MethodUpdateOverloaded. Save the Folder definition on the specified JAMS Server.  
Public MethodValidateOverloaded. Overridden. Validate all properties.  
Top
Protected Methods
 NameDescription
Protected MethodRaisePropertyChangedAttempts to raise the PropertyChanged event (Inherited from MVPSI.JAMS.BasePublicObject)
Protected MethodRaisePropertyChangingAttempts to raise the PropertyChanging event (Inherited from MVPSI.JAMS.BasePublicObject)
Protected MethodSaveOriginalSaveOriginal is called when an edit is about to begin. You override this method to save the original values. (Inherited from MVPSI.JAMS.BasePublicObject)
Top
Public Events
 NameDescription
Public EventPropertyChangedEvent Handler for Property Changed Event (Inherited from MVPSI.JAMS.BasePublicObject)
Public EventPropertyChangingEvent Handler for Property Changing Event (Inherited from MVPSI.JAMS.BasePublicObject)
Top
See Also

Reference

Folder Class
MVPSI.JAMS Namespace

Send Feedback