Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    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)

    Additional Information

    faq


    • Article last edited: 10/8/2013