| Contents | Index | JAMS Home | Support |
|
||||
|
| Previous | Contents | Index |
The JAMS_SUBMIT_MENU routine provides an entry into JAMS at the menu level.
JAMS_SUBMIT_MENU 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_MENU routine:
The JAMS_K_MENUNAME item code is used to pass the name of a Menu Definition which should be used as the initial menu.
You cannot specify both JAMS_K_MENUNAME and JAMS_K_SYSTEMID in the same item list.
The JAMS_K_REMOTE_NODE item code is used to pass then name and access control information of a remote node where the menus are defined. The jobs selected 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_SYSTEMID item code is used to pass the name of a System Definition. A menu is constructed which consists of all of the Job and Job Setup definitions for the indicated System.
You cannot specify both JAMS_K_MENUNAME and JAMS_K_SYSTEMID in the same item list.
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. JAMS_M_ENABLE_CONNECTIONS Adds the Gold/C function key to the submit menu to allow the user to establish remote connections.
JAMS_SUBMIT_MENU can be called when you want to provide a menu of batch jobs which may be submitted. This routine requires one argument, an item list.When JAMS_SUBMIT_MENU is called, JAMS will take control of the terminal and display the selected menu of batch jobs and/or menus. The user is able to select and submit jobs. Control is not returned until the user exits the initial menu.
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. |