[Contents] [Prev] [Next] [End]

Appendix 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.

Copyright © 1994-1997 Platform Computing Corporation.
All rights reserved.