When your application creates a Share Package On Server job (F_SRVINSTALLJOB folder), some scalars (such as Activate time and Send phase) must have valid values so that the job activates, sends, distributes, and completes successfully. Other scalars (such as Job comment) are optional or are used by the SMS system to report status (such as Job status) or other system information (such as Job ID and Cancel mode). Still other scalars must be set if another scalar is set to a certain value (for example, the Site limit name scalar must be set if Limit to sites is set to JOBTGT_SITEGROUP or JOBTGT_SITE).
This section lists the scalars that must be set to create a valid Share Package On Server job.
Note that Required means that a valid value must be set. For more information about the range of valid values for a scalar, click on the scalar name in the following table. Your application is responsible for verifying that the value it sets for a scalar is valid.
For F_SRVINSTALLJOB folders, the following scalars must be set:
| Scalar name | Data type | Requirement |
|---|---|---|
| Job comment | String | Optional. |
| Activate time | Time | Required. |
| Priority | Integer | Required. |
| Repeat mode | Integer | Required. |
| Package ID | String | Required. |
| Limit to sites | Integer | Required. |
| Include subsites | Integer | If Limit to sites is set to JOBTGT_SITEGROUP or JOBTGT_SITE, this scalar is required. Otherwise, it is not used. |
| Site limit name | String | If Limit to sites is set to JOBTGT_SITEGROUP or JOBTGT_SITE, this scalar is required. Otherwise, it is not used. |
| Send phase | Integer | Required. |
| Distribute phase | Integer | Required. |
| Distribution servers | String | If Distribute phase is set to SHAREJOB_DIST_SPECIFIED, this scalar is required. If this scalar is set to NULL, the Default Servers machine group will be used. Otherwise, it is not used. |