Object and set naming restrictions

Consider enclosing an object name or set name within single quotation marks (’) when using TOMEXEC API functions in addition to these naming restrictions:

  • Object names and set names can be up to 64 characters and cannot contain the following characters:
    • Slash (/)
    • Backwards slash (\)
    • Vertical bar (|)
    • Split vertical bar
    • Ampersand (&)
    • Left-pointed bracket (<) or right pointed bracket (>)
    • Apostrophe or single quotation mark (‘)
    • Double quotation mark (")
    • Asterisk (*)
    • Question mark (?)
    • Cent sign (¢)
    • Not sign (¬)
    • Plus sign (+)

Related topic

Coding-conventions

  • When you specify an object or set name as part of your syntax for a TOMEXEC function, you must enclose the name within single quotation marks (') if it contains lowercase characters, spaces, or non alphanumeric characters.

    • If the object name is CICS.testsystem.2, you must specify:
      OBJECT(‘CICS.testsystem.2’)
    • If the object name has spaces such as CICS.system F, you must specify:
      OBJECT(‘CICS.system f’)

    The syntax of OBJECT(CICS.systemD.test) that uses mixed upper and lower case letters but is not enclosed in single quotes represents the same object as the name OBJECT(CICS.SYSTEMD.TEST) that uses all upper case letters. However, TOM processing recognizes that object names that have part of the name enclosed within single quotation marks, such as OBJECT('cics.a') and OBJECT('cics.A'), as two separate objects.

Important

You should always enclose an object name or set name within single quotation marks (’) because TOM processing resolves values that do not use single quotation marks to uppercase characters.

If multiple objects have the same name but use different combinations of lowercase and uppercase characters, you must enclose the characters within single quotation marks or TOM will process the name as all uppercase.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*