A. Customizing xlsbatch Menu Items

You can customize the menu items of xlsbatch by specifying customizedMenu resource in the X resource file. With this feature, you can:

• remove a pull-down menu from the menu bar
• remove a menu item from a pull-down menu
• remove a sub-pull-down menu from a pull-down menu
• remove a menu item from a sub-pull-down menu
• add a new item in the menu bar
• add a new item in a pull-down menu with an executable (the executable is run when the menu item is chosen)
• add a new item in a sub-pull-down menu with an executable
• replace an item's command in the pull-down menu by a new executable
• replace an item's command in the sub-pull-down menu by a new executable

The format of the customizedMenu resource is:

xlsbatch*customizedMenu:`A1 B1 C1 D1 A2 B2 C2 B2 ... An Bn Cn Dn'

where the resource value is a character string enclosed in double quotes, whose components are separated by spaces.

From the beginning of the string, each four consecutive components constitute a group that customizes one menu item. Each component is either a character string or several character strings encompassed by parentheses.

The following define the valid syntax for a menu item group:

• Remove a pull-down menu from the menu bar:
  Ai: the pull-down menu name to be removed from the menu bar
  Bi: 0 (zero)
  Ci: 0 (zero)
  Di: 0 (zero)

For example, remove the `Calendar' pull-down menu from the menu bar:

xlsbatch*customizedMenu:"Calendar 0 0 0"

• Remove a menu item from a pull-down menu:
  Ai: the pull-down menu name where some item will be removed
  Bi: the menu item name to be removed
  Ci: 0 (zero)
  Di: 0 (zero)

For example, remove the `Restart...' menu item from the `Job' pull-down menu:

xlsbatch*customizedMenu:"Job Restart... 0 0"

• Remove a sub-pull-down menu from a pull-down menu:
  Ai: the pull-down menu where some sub-pull-down will be removed
  Bi: the sub-pull-down menu name to be removed
  Ci: 0 (zero)
  Di: 0 (zero)

For example, remove the `View' sub-pull-down menu from the `Job' pull-down menu:

xlsbatch*customizedMenu:"Job View 0 0"

• Remove a menu item from a sub-pull-down menu:
  Ai: the pull-down menu where the sub-pull-down menu resides
  Bi: the sub-pull-down menu name where some item will be removed
  Ci: the menu item name to be removed
  Di: 0 (zero)

For example, remove the `Chkpnt...' menu item from the `Manipulate' sub-pull-down menu of the `Job' pull-down menu:

xlsbatch*customizedMenu:"Job Manipulate Chkpnt... 0"

• Add a new item in the menu bar:
  Ai: new menu name to be added
  Bi: 0 (zero)
  Ci: 0 (zero)
  Di: same as Ai

For example, add the `Others' menu item in the menu bar:

xlsbatch*customizedMenu:"Others 0 0 Others"

• Add a new item in a pull-down menu with an executable:
  Ai: the pull-down menu name where the new item will be added
  Bi: new menu item name to be added
  Ci: 0 (zero)
  Di: executable name which will be executed when this item is chosen

For example, add the `xlsadmin' menu item in the `File' pull-down menu which runs xlsadmin with gray background:

xlsbatch*customizedMenu:"File xlsadmin 0 (xlsadmin -bg gray)"

• Add a new item in a sub-pull-down menu with an executable:
  Ai: the pull-down menu name where the sub-pull-down menu resides
  Bi: the sub-pull-down menu name where the new item will be added
  Ci: new menu item name to be added
  Di: executable name which will be executed when this item is chosen

For example, add the `My Job View' menu item in the `View' sub-pull-down menu of the `Job' pull-down menu, which runs the myView executable:

xlsbatch*customizedMenu:"Job View (My Job View) myView"

• Replace an item's command in the pull-down menu by a new executable:
  Ai: the pull-down menu name where some item's command will be replaced
  Bi: the menu item name whose command will be replaced
  Ci: 0
  Di: executable name which will be executed when the item specified in Bi is chosen

For example, replace the `Submit...' menu item's command in the `Job' pull-down menu by a new myBsub executable:

xlsbatch*customizedMenu:"Job Submit...  0 myBsub"

• Replace an item's command in the sub-pull-down menu by a new executable:
  Ai: the pull-down menu name where the sub-pull-down menu resides
  Bi: the sub-pull-down menu name where some item's command will be replaced
  Ci: the menu item name whose command will be replaced
  Di: executable name which will be executed when the item specified in Ci is chosen

For example, replace the `Chkpnt...' menu item's command in the `Manipulate' sub-pull-down menu by a new myChkpnt executable:

xlsbatch*customizedMenu:"Job Manipulate Chkpnt... myChkpnt"

xlsbatch puts the jobIDs of those selected in the job list of the Main Window into a group of UNIX environment variables:

JOBID0 JOBID1 ... JOBIDk

Starting with JOBID0, each variable contains at most 200 job IDs separated by spaces, the variable group ends with a null variable.