Skip to main content
OCLC Support

ControlHeadingsAll

  1. Last updated
  2. Save as PDF
Find the syntax, use, parameters, return values, and an example for the ControlHeadingsAll macro command in Connexion client.
Syntax BOOL = CS.ControlHeadingsAll
Use to In the current record, control all controllable headings that are not already controlled.

Same as using the command Edit > Control Headings > All.
Parameters None
Comment You must be logged on to use this macro command.
Return values TRUE if the action is successful, or FALSE if not.
 

 Note: A return of FALSE indicates only that the action was unsuccessful. It does not differentiate specifically whether the command itself failed or whether one or more headings could not be controlled.
Example Sub Main()
 

     Dim CS As Object
     Set CS = GetObject(,“Connex.Client”)

     If CS.IsOnline = False Then
          CS.Logon ““, ““, ““
     End If

     CS.Search “WC”, “#1”

     CS.AddFieldLine 1, "650 0Ballet dancing " & Chr(223) & "v" & " Fiction"
     CS.AddFieldLine 2, "650 0Horseback riding " & Chr(223) & "v" & " Fiction"
     CS.AddFieldLine 3, "650 0Baton twirling " & Chr(223) & " Fiction"
     CS.AddFieldLine 4, "650 0Swimming " & Chr(223) & "v" & " Fiction"

     CS.ControlHeadings

     All CS.CloseRecord False

     CS.Search “WC”, “#1”

     CS.AddFieldLine 1, "650 0Ballet dancing " & Chr(223) & "v" & " Fiction"
     CS.AddFieldLine 2, "650 0Horseback riding " & Chr(223) & "v" & " Fiction"
     CS.AddFieldLine 3, "650 0Baton twirling " & Chr(223) & "v" & " Fiction"
     CS.AddFieldLine 4, "650 0Swimming " & Chr(223) & "v" & " Fiction"

     If CS.ControlHeadingsAll() = True Then
          MsgBox “Control Headings All successful”
     End If
End Sub
What this example does
  • Logs on to Connexion if not already logged on, using the default authorization and password you selected in Tools > Options > Authorizations tab.
  • Searches WorldCat for record number 1.
  • Adds four new fields to the record as the first, second, third, and fourth fields (specified by line number), each containing:
    • No first indicator (blank space)
    • Second indicator 0
    • Heading text in subfield a (Line 1: Ballet dancing, Line 2: Horseback riding, Line 3: Baton twirling, and Line 4: Swimming)
    • A space
    • The subfield delimiter character: Chr(223) (See ASCII and hexadecimal codes for diacritics and special characters for a list of character codes)
    • Subfield designation $v
    • A space
    • Heading text (In all 4 lines: Fiction)
  • Controls all headings in the record.
  • Closes the record without saving it.
  • Calls up record number 1 from WorldCat again.
  • Adds the same four new fields with the same indicators and text in the same position.
  • Controls all headings in the record and confirms that the headings were controlled by returning the message: Control Headings All successful.