| Contents | Index | JAMS Home | Support |
|
||||
|
| Previous | Contents | Index |
The JAMS_SUBMIT_JOB routine is used to submit a single batch job via the JAMS batch job submission sub-system.
JAMS_SUBMIT_JOB item-list
VMS usage: cond_value type: longword (unsigned) access: write only mechanism: by value
item-list
VMS usage: item_list_3 type: longword (unsigned) access: read only mechanism: by reference
This argument is a pointer to an item list. An item list is an array of item descriptors, each of which specifies one input or output data item.The item list is terminated by an item descriptor with a value of zero in the item code and buffer length fields.
The following item codes are supported by the JAMS_SUBMIT_JOB routine:
The JAMS_K_DEPEND_ENTRY item code is used to pass the VMS queue entry number of another job which the job being submitted should depend on. The job being submitted will remain in a pending state until the job specified with this item code has completed successfully.
You can specify this item code up to 32 times in the same item list so a job which you submit can depend on up to 32 other jobs.
The JAMS_K_JOBNAME item code is used to pass the name of the Job which is to be submitted. The JAMS_K_JOBNAME item code may be used only once in an item list.
In most cases, the order of the item codes in an item list is insignificant. The order is significant with the JAMS_K_JOBNAME and JAMS_K_SETUPNAME item codes. If you pass only one of these two item codes, the position in the item list is insignificant. However, if you pass both of these item codes the position is significant, and both items must specify the same value.
What you are really saying when you pass both of these item codes is "This name is either a Job name or a Setup name." If the JAMS_K_JOBNAME item code is first in the item list, then a Job with the specified name is searched for. If the Job is not found, then a Setup is searched for. Specify the JAMS_K_SETUPNAME item code first if you want to search for a Setup before searching for a Job.
The JAMS_K_OPTIONS item code is used to pass a longword which specifies the options which should be activated during this call. Each bit in the longword corresponds to one option. You can initialize this longword by ORing (or adding) together one or more of the following symbols.
Symbol Function JAMS_M_DEBUG The Job should be submitted in debug mode. JAMS_M_NOPROMPT The user should not be prompted for parameter values or report overrides. JAMS_M_NOSUBMIT The Job should not be submitted, instead a parsed job file is created in the current default directory with the extension .JAMS. JAMS_M_USE_SYMBOLS DCL symbols should be used to determine the default value of parameters. JAMS_M_SET_SYMBOLS A DCL symbol for each of the Job's parameters should be defined after the Job is submitted. The JAMS_K_PARAM_NAME item code is used to pass the name of a parameter. This item code is used form JAMS parameters which have a name other than P1 through P8. You can use this item code to pass the name of a parameter which is defined in the Job definition or to create a new parameter which is not defined in the Job's definition.
The item list entry must point to a valid parameter name which may, or may not be, defined in the Job definition.
The JAMS_K_PARAM_NAME item code must be directly followed by one of the following item codes:
- JAMS_K_PARAM_TEXT
- JAMS_K_PARAM_DATETIME
- JAMS_K_PARAM_INTEGER
These item codes are used to pass the value of the parameter named by the JAMS_K_PARAM_NAME item code.
The JAMS_K_PARAM_TEXT item code is used to pass a text value to the parameter named in the preceeding JAMS_K_PARAM_NAME item list entry.
The JAMS_K_PARAM_DATETIME item code is used to pass a VMS quadword date & time value to the parameter named in the preceeding JAMS_K_PARAM_NAME item list entry.
The JAMS_K_PARAM_INTEGER item code is used to pass an integer value to the parameter named in the preceeding JAMS_K_PARAM_NAME item list entry.
The JAMS_K_REMOTE_NODE item code is used to pass then name and access control information of a remote node where the Job to be submitted is defined. The job will be submitted on the remote node. The format of the specification is the standard DECnet format, nodename"username password". If you have proxy access to the remote node, you only need to specify the nodename.
The JAMS_K_SETUPNAME item code is used to pass the name of the Setup definition which is to be submitted. The JAMS_K_SETUPNAME item code may be used only once in an item list.
In most cases, the order of the item codes in an item list is insignificant. The order is significant with the JAMS_K_JOBNAME and JAMS_K_SETUPNAME item codes. If you pass only one of these two item codes, the position in the item list is insignificant. However, if you pass both of these item codes the position is significant, and both items must specify the same value.
What you are really saying when you pass both of these item codes is "This name is either a Job name or a Setup name." If the JAMS_K_JOBNAME item code is first in the item list, then a Job with the specified name is searched for. If the Job is not found, then a Setup is searched for. Specify the JAMS_K_SETUPNAME item code first if you want to search for a Setup before searching for a Job.
The JAMS_SUBMIT_JOB routine also supports all of the item codes supported by the SCJ$_ENTER_FILE function of the SYS$SNDJBC system service. Please refer to the VMS System Services Reference Manual for more information on these item codes.
JAMS_SUBMIT_JOB can be called when you want to submit a single batch job and you want to take advantage of the advanced features of the JAMS batch job submission subsystem.
JAMS_CANTSUBMIT Errors encountered while trying to submit job. JAMS_INVIL Invalid item list. SS$_NOPRIV Insufficient privileges
| Previous | Next | Contents | Index |
 | Copyright © 2000, MVP Systems, Inc. All rights reserved. |