Reference Guide › Utilities › semsgtool Utility—Maintain the Message File

semsgtool Utility—Maintain the Message File

The semsgtool utility lets you:

• Show a single message from the CA ControlMinder message file
• List an entire section of messages
• Dump the entire file into ASCII files, one ASCII file for each section
• Build a new message file
• Change message to a new one
• List messages, including substring
• Validate the message file

You can only specify one command each time you execute semsgtool.

The default location of the message file is ACInstallDir/data/seos.msg

Notes: The CA ControlMinder message file is comprised of sections and message numbers. Each section holds messages for different CA ControlMinder modules or sub‑modules.

This command has the following format:

semsgtool {-build|-b} asciiSourceFile OutputMessageFile

semsgtool {-change|-c} [messageFile] {0xerror-code|section# msg#} new-message

semsgtool {-dump|-d} messageFile

semsgtool {-list|-l} [messageFile] sectionNumber

semsgtool {-number|-n} [messageFile] subString

semsgtool {-show|-s} [messageFile] [0xerror-code|section# msg#]

semsgtool {-validate|-v} [messageFile]

‑build|‑b

Creates a new CA ControlMinder message file from an ASCII source file.

-number|-n

Lists messages in the message file that include a defined string.

-change|-c

Creates a new message file, named messageFile.new, where the specified message has the defined modified string.

‑dump|‑d

Dumps the message file into several files, one file for each section of the message file. This creates ASCII source files that later can be used to create new CA ControlMinder message files.

‑h

Displays the help for this utility.

‑list|‑l

Lists all the messages in a given section in the message file.

‑show|‑s

Shows the message associated with a specific message code.

-validate|-v

(Windows only). Validates the message file by checking for duplicate messages and messages that exceed the allocated boundaries.

0xerror-code

Defines the hex number of the error code for the message that you want to display or change.

asciiSourceFile

Defines the source file in ASCII format from which semsgtool builds a new message file.

messageFile

Defines the name of the message file. If you omit this option, semsgtool uses the message file as specified in the configuration settings.

OutputMessageFile

Defines the name of a new message file to build.

section# msg#

Defines the section number and message number of the error code for the message that you want to display or change.

sectionNumber

Defines the section number of the section you want to list all the messages for.

Example

• To list the message associated with the error code 0x205, enter the following command:

  semsgtool -s seos.msg 0x205
  

• To list the messages in section 512, enter the following command:

  semsgtool -l seos.msg 512
  

• To create a modified CA ControlMinder message file, follow these steps:
  1. Create a new message file with a modified message:

     semsgtool -c 0x2501 "This is the new message"
     

     A new message file, seos.msg.new, is created with the modified message.

  2. Copy the new file over the CA ControlMinder message file:

     copy seos.msg.new seos.msg
     

     Copies the new message file with the modified message on top of the old seos.msg file.

• To show the message associated with the error code 0x0205, enter the following command:

  semsgtool ‑s 0x205