Sample: newjob
==============

This sample illustrates the use of the SMS APIs in order to view,
create, and delete job folders.
There are four types of job folders:
        Run command on Workstation job
        Share package on Server job
        Remove package from Server job
        System job
All of these except system jobs can be created and deleted.


After logging on to a datasource, a job container is opened and populated.
No filtering is done since we want to see all the jobs that exist in the
system.
The program then enters a loop asking whether the user wants to view the
next job folder, delete the currently viewed folder, or create a new folder.

Both deletion and creation are two-stage processes. Only when the
SmsCommitFolder API is called will the folder be either deleted from or
inserted into the datasource.

Folder creation is handled in the CreateNewFolder function.
This creates an empty folder in the context of the parent which in this
case is the job container. The function then retrieves a description of
the folder via the SmsDescribeFolder API. This returns a FOLDER_INFO
structure which describes the folder in terms of its capabilities, see
the objectty.h header file (or the help file) for a full description of
this structure.

Included in FOLDER_INFO is a pointer to an array of SCALAR_INFO structures.
Each SCALAR_INFO describes one of the folder's scalars. The information
contained here is:
        the scalar's name,
        its type,
        its access mode.
CreateNewFolder loops through this array, for each scalar that has modify or
create access, it displays the name and asks the user to fill in the value.
Only nominal checking is done on the values, a real application would have
to go into much greater detail since job creation is a non-trivial task.
If there are any errors in the date/time fields they are set to the current
date and time.

This is a sample of a created workstation install job:


JS200009 (Workstation install job) contains 33 scalars
                           Job ID: JS200009
                         Job type: microsoft\SMS\workstation_script
                      Job comment: a descriptive comment
                    Activate time: Thu Jun 22 15:12:00 1995
                        Left icon: Package
                      Center icon: Machinegroup
                       Right icon: Site
                         Priority: 1
                      Repeat mode: 1
                      Cancel mode: 0
                       Job status: 1
                   Sending status: 1
                   Working status: 1
                    Cancel status: 1
                       Package ID: JS200049
                       Job target: 2
                 Distribute phase: 1
                       Send phase: 1
                   Limit to sites: 2
                 Include subsites: 1
                  Site limit name: jonshu2site
             Distribution servers: me
                         WCL name: Audit software
                         Query ID:
               Machine group name: My machine group
                     Machine path: *|*|*
                       Offer time: Thu Jun 22 15:15:00 1995
                   Mandatory time: Thu Jun 22 15:15:00 1995
               Use mandatory time: 0
             Force over slow link: 0
                      Expire time: Thu Jun 22 15:15:00 1995
                  Use expire time: 0
          Run workstation command: 1
============== JS200009 ===========