csubJobEntry 1.3.6.1.4.1.9.9.786.1.3.7.1

An entry describing a subscriber session job. At this time, subscriber session jobs can perform one of two tasks: - Subscriber Session Query This type of job invokes the report generator, which builds a list of subscriber sessions matching criteria specified by the corresponding row in the csubJobMatchParamsTable. The list built by the report generator must conform to parameters specified by the corresponding row in csubJobQueryParamsTable, which at this time only affects sorting order. - Subscriber Session Clear This type of job causes the system to terminate those subscriber sessions matching criteria specified by the corresponding row in the csubJobMatchParamsTable. The following procedure summarizes how the EMS/NMS can start and monitor a subscriber session job: 1) The EMS/NMS must start by reading csubJobIdNext. If it is zero, continue polling csubJobIdNext until it is non-zero. 2) The EMS/NMS creates a row in the csubJobTable using the instance identifier retrieved in the last step. Since every object contained by the entry with a MAX-ACCESS of 'read-create' specifies a default value, it makes little difference whether the EMS/NMS employs create-and-wait or create-and-go semantics. 3) The EMS/NMS sets the type of subscriber session job by setting the corresponding instance of csubJobType. 4a) If the job is a 'query', then the EMS/NMS must configure the query before starting it by setting columns contained by the corresponding rows in the csubJobMatchParamsTable and csubJobQueryParamsTable. 4b) If job is a 'clear', then the EMS/NMS must configure the job before starting it by setting columns contained by the corresponding row in the csubJobMatchParamsTable. 5) The EMS/NMS can now start the job by setting the corresponding instance of csubJobControl to 'start'. 6) The EMS/NMS can monitor the progress of the job by polling the corresponding instance of csubJobState. It can also wait for a csubJobFinishedNotify notification. When the state of the job transitions to 'finished', then the system has finished executing the job. 7) The EMS/NMS can determine the final status of the job by reading the corresponding instance of csubJobFinishedReason. If job is a 'query' and the corresponding instance of csubJobFinishedReason is 'normal', then the EMS/NMS can safely read the report by retrieving the corresponding rows from the csubJobReportTable. 8a) After a job has finished, the EMS/NMS has the option of destroying it. It can do this by simply setting the corresponding instance of csubJobStatus to 'destroy'. Alternatively, the EMS/NMS may retain the job and execute it again in the future (by returning to step 5). Additionally, nothing would prevent the EMS/NMS from changing the job's type, which causes the automatic destruction of the corresponding report. 8b) If the job is a 'query' and the EMS/NMS opts to retain the job, then it may consider releasing the corresponding report after reading it. It can do this by setting the corresponding instance of csubJobControl to 'release'.