Customizing Services Menu Controls in the GUI for Running Batch Jobs

• Article Type: General
• Product: Aleph
• Product Version: 18.01

Description:
What do the tags in the pc_b_eng service menu job files mean?

Resolution:
[The second section of settings -- runtime, library, print ID -- are not defined in the pc_b_<lng> XML files and are not covered in the list below.]

Each dropdown or text box etc is called a <control> and contains sub-controls.

CONTROLS (related sub-controls):

checkbox (citems, always used with source = explicit)
expand_checkbox (always used with source = [source name], only for sub-libraries)
combo (cbitems, same as a dropdown, but allows deletion of content)
dropdown (cbitems, always used with source = explicit)
expand_drop_down (always used with source = [source name])
date_time
edit (textbox for characters)
edit_num (textbox for numbers)
radio (ritems, always used with source = explicit)

SUB-CONTROLS
Some sub-control types are only associated with one specific control Some sub-control types can appear in more than one control.

<admin_library>Y/N</admin_library>
Direct output to the ADM Library

<affected_field>F09</affected_field> [used in expand_drop_down]
Field X changes the values in field Y (the affected_field).

<argname>F05</argname>
** NEVER CHANGE **
Each Control has a unique argname

<borrower_code>...<borrower_code>
<budget_code>...<budget_code>
<supplier_code>...<supplier_code>
<vendor_code>...<vendor_code>
Contains sub-controls: <label><argname>
Text box followed by a "..." button that opens the borrower/budget/supplier/vendor selection dialog.

<cbitem> [used with dropdown control]
<value>02</value> = value of line
<display>Improved User Letter</display> = displayed content
</cbitem>

<char_case> U / L </char_case>
Used with edit control. Limits data entry to upper or lower case.

<check> (in an "Input File Name" dialog, checks for the existance of the file
<check_proc>b_check_filename </check_proc>
</check>

<citem> [used with checkbox control, note that each citem has its own argname]
<value>Y</value>
<display>Hold Requests</display>
<argname>F04</argname>
</citem>

<default>00</default>
Default content of field.

<empty_line>ALL</empty_line>
ALL, ALL_ZZ, NONE, NO-USE
Used with expand_drop_down.
ALL adds an "All" option to the control. For example, in a p*.xml file, deleting the "<empty_line>NO_USE</empty_line>" that follows the "<source>[VARIABLE-NAME]</source> or replacing it with an "<empty_line>ALL</empty_line>", will add "All" to the control.
ALL_ZZ adds both the All option and a "ZZ (space as a value)" option to the control.
NONE adds a "None" option to the control.
NO-USE prevents the display of the "All" option in the control.

<hidden> [a Control that is not displayed]
<argname>F04</argname>
<value>00</value>
</hidden>

<label>Letter Format</label>
Field label.

<label_only><label>Privileges Filters:</label></label_only>
Section label.

<ritem> [used with radio control]
<value>BIB</value>
<display>BIB Record Numbers</display>
</ritem>

<size>20<size>
Text box (edit control) size in characters.

<source>explicit</source>
Data source. Never change non-"explicit" entries.
Explicit means the source is within the control, using ritem, citem, or cbitem.
Anything else ("non-explicit", like "SUB-LIBRARY-CASH") means that the source is a predefined list which can usually be found in pc_tab_exp_field.<lng> using the given variable name. Used with expand_*.

<time_style>Y</time_style>
Only Y value. Used with date_time control to change the control from a date dialog (N) to a time dialog (Y).

SPECIAL TAGS
<dialog> </dialog>
<title> </title>
<proc> </proc>
Opens and closes each xml file.

<submit_lib>illsv</submit_lib>
Controls in which library the job runs

<allow_online> </allow_online> [adds the Online checkbox which allows a job to circumvent the batch queue]
<ignore_print_id> </ignore_print_id> [causes Print ID to be ignored]
<ignore_form_language> </ignore_form_language> [causes language value populated by the Language_Id field to be ignored, and uses the system language]
No content. Special commands

USED BY MENU FILES
menu
display
file
group_caption
item
sub
sub-menu

(FAQ pc_b_lng pc_b_eng)